# @generac/react-native-local-network-permission 中文文档

规范地址：https://npmcn.com/package/%40generac/react-native-local-network-permission/

版本：1\.3\.0
npm 元数据更新时间：2026-06-01T17:47:42.956Z
中文译文更新时间：2026-11-16T02:55:19.361Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40generac/react-native-local-network-permission
原文对照：https://npmcn.com/package/%40generac/react-native-local-network-permission/?lang=original
项目主页：https://github.com/neurio/react-native-local-network-permission#readme
源码仓库：https://github.com/neurio/react-native-local-network-permission

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：29.3 kB，41 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：expo \*，react \*，react-native \*
- 首次发布：2023-12-18T23:55:14.441Z
- 最新版本发布：2026-06-01T17:47:42.651Z
- 近 30 天下载量：13552（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 1 个）

## 中文简介

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

## 安装

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

也可以使用：`pnpm add @generac/react-native-local-network-permission`、`yarn add @generac/react-native-local-network-permission`、`bun add @generac/react-native-local-network-permission`

## README

# 反应本地本地网络权限

一个处理使用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](https://github.com/react-native-community/discussions-and-proposals/pull/994) (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>
```

_见 还: [苹果文档](https://developer.apple.com/documentation/bundleresources/information_property_list/nslocalnetworkusagedescription)_

#### NSBonjour 服务

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

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

_见 还: [苹果文档](https://developer.apple.com/documentation/bundleresources/information_property_list/nsbonjourservices)_

#### 博览

如果您正在使用世博会管理的工作流程, 您无法直接编辑您的 `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项目,也可用于博览会项目. 说明:

-   如果使用博览会,则需要 [创建发展架构](https://docs.expo.dev/develop/development-builds/create-a-build/)使用"博览会去"应用将无法工作;
-   如果使用赤裸反射原生, 您需要将 Expo 模块添加到您的工程中, 查看 [博览会文献](https://docs.expo.dev/bare/installing-expo-modules/)。 。 。 .

```typescript
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`数字 :

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

## 提交信件

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

你一定要好好做,因为.. 页:1 [语义释放](https://github.com/semantic-release/semantic-release) 自动化取决于承诺消息 以适当的关键词开头,以确定主要、次要或 补丁 [语义版本](https://semver.org/) 应当指定.

## 另见

-   [Apple FAQ 1 (英语)](https://developer.apple.com/forums/thread/663858)
-   [Apple FAQ 2 (英语)](https://developer.apple.com/forums/thread/663874)
-   [此库的堆叠流提示](https://stackoverflow.com/questions/63940427/ios-14-how-to-trigger-local-network-dialog-and-check-user-answer/67758105#67758105)

## 常见问题

### @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 和提交记录判断。

