@generac/react-native-local-network-permission

中文文档
1.3.0发布于 2026/06/02MITTypeScriptCommonJS零依赖构建来源已验证近 30 天下载 1.4万

一个反应原生/博览会模块,用于请求访问iOS上本地网络的许可

中文使用文档
文档目录7 节
  1. 开始
  2. Swift 软件包管理器支持
  3. iOS 手动配置
  4. 使用量
  5. 笑话
  6. 提交信件
  7. 另见

反应本地本地网络权限

一个处理使用iOS 14. 引入的本地网络权限的库. 它只与iOS有关,而与Android或 网页.

开始

将此库添加到您的工程中 :

npm install @generac/react-native-local-network-permission

yarn add @generac/react-native-local-network-permission

Swift 软件包管理器支持

可可花(通过捆绑) .podspec)仍然是主要的安装路径,并且为今天的每个React Introduct和Expoapp工作.

该模块还搭载了SPM脚手架,用于迁移,如: 反应原生 RFC 0994 (CocoaPods贬值,2026年12月):

  • spm.config.json ——被世博会消耗 et prebuild 管道(EXPO_USE_PRECOMPILED_MODULES=1)生成XCF框架. 通过博览会自动连接自动取出;没有额外设置.
  • Package.swift ——向前相容的明细表. 库目标宣布依赖 ExpoModulesCore - 消费者的自动连接管道(RN CLI的SPM自动连接一旦着陆,或手写棕地清单)负责提供 .package(path: ".../node_modules/expo-modules-core")因此 Package.swift 在今天的Xcode中.

iOS 手动配置

NS 地方网络

你需要添加一个 NSLocalNetworkUsageDescription 键 Info.plist 文档。 这应该是说明为什么 您的应用程序需要本地网络权限 :

<key>NSLocalNetworkUsageDescription</key>
<string>App requires local network access to do ...</string>

见 还: 苹果文档

NSBonjour 服务

你需要添加一个 NSBonjourServices 键 Info.plist 文档。 这应该是一系列的Bonjour服务 您的应用程序使用 :

<key>NSBonjourServices</key>
<array>
  <string>_bonjour._tcp</string>
  <string>_lnp._tcp.</string>
</array>

见 还: 苹果文档

博览

如果您正在使用世博会管理的工作流程, 您无法直接编辑您的 Info.plist中,可以添加 跟着你 app.json 或者说 app.config.js数字 :

expo: {
  ios: {
    infoPlist: {
      NSLocalNetworkUsageDescription: 'App requires local network access to do ...',
      NSBonjourServices: ['_bonjour._tcp', '_lnp._tcp.'],
    },
  },
}

使用量

这个库既可用于React Introduct项目,也可用于博览会项目. 说明:

  • 如果使用博览会,则需要 创建发展架构使用"博览会去"应用将无法工作;
  • 如果使用赤裸反射原生, 您需要将 Expo 模块添加到您的工程中, 查看 博览会文献。 。 。 .
import {
  checkLocalNetworkAccess,
  requestLocalNetworkAccess,
} from '@generac/react-native-local-network-permission';

//you need to make sure the local network permission dialog popup once
const result = await requestLocalNetworkAccess();

//then use checkLocalNetworkAccess when you need
const result = await checkLocalNetworkAccess();
//here run the code depends local network access

笑话

如果您在 Jest 测试中需要嘲弄此库, 您可以使用以下代码 : testSetup.ts 文档 您需要参考 jest.config.js 下级 setupFilesAfterEnv数字 :

jest.mock('@generac/react-native-local-network-permission', () => ({
    checkLocalNetworkAccess: jest.fn(),
    requestLocalNetworkAccess: jest.fn(),
  }),
);

提交信件

此寄存器使用 承诺信息公约 由承诺前钩子执行 如果您执行 npm run commit 改为 git commit -m "some message" 你们 将遵循各种步骤,写出可接受的承诺信息.

你一定要好好做,因为.. 页:1 语义释放 自动化取决于承诺消息 以适当的关键词开头,以确定主要、次要或 补丁 语义版本 应当指定.

另见

版本与发布记录

@generac/react-native-local-network-permission 共发布 4 个版本,首次发布于 2023/12/19;过去 12 个月发布了 1 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.3.0latest2026/06/025 个月前
1.2.02024/06/272 年前
1.1.02024/02/062 年前
1.0.02023/12/192 年前

关于 @generac/react-native-local-network-permission 的常见问题

@generac/react-native-local-network-permission 是什么?

一个反应原生/博览会模块,用于请求访问iOS上本地网络的许可

如何安装 @generac/react-native-local-network-permission?

在项目目录运行 npm install @generac/react-native-local-network-permission,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:expo(*)、react(*)、react-native(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@generac/react-native-local-network-permission 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@generac/react-native-local-network-permission 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@generac/react-native-local-network-permission 可以商用吗?

@generac/react-native-local-network-permission 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@generac/react-native-local-network-permission 的下载量有多少?

根据 npm 官方下载统计,@generac/react-native-local-network-permission 在 2026/10/16 – 2026/11/14 这 30 天内被下载 13,552 次,日均约 452 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@generac/react-native-local-network-permission 还在维护吗?

最新版本 1.3.0 发布于 2026/06/02(5 个月前);至今共发布 4 个版本,其中过去 12 个月发布了 1 个;首次发布于 2023/12/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。