uniapp ios端如何申请本地网络权限

在uniapp开发中，iOS端如何申请本地网络权限？我已经在manifest.json中配置了相关权限，但在真机调试时系统没有弹出权限请求弹窗。是否需要额外配置info.plist文件？具体应该添加哪些键值？还有没有其他需要注意的细节？

2 回复

在uniapp中，iOS端申请本地网络权限需在manifest.json的App模块配置中勾选“Local Network”能力，并在代码中使用uni.authorize方法请求权限。同时需在项目的info.plist中添加NSLocalNetworkUsageDescription描述用途。


在 UniApp 中，iOS 端申请本地网络权限主要用于访问局域网设备（如打印机、智能家居设备等）。以下是详细步骤和注意事项：

1. 在 manifest.json 中配置

在 manifest.json 的 app-plus → distribute → ios 节点下添加权限描述：

{
  "app-plus": {
    "distribute": {
      "ios": {
        "permissions": {
          "LocalNetwork": {
            "description": "需要访问本地网络以连接您的智能设备"
          }
        }
      }
    }
  }
}
  • description 字段会显示在系统权限弹窗中，需简洁说明用途。

2. 在 Xcode 中配置（HBuilderX 云打包无需操作）

如果使用本地打包，需在 Xcode 项目中手动添加权限：

  • 在 Info.plist 中添加键：
    <key>NSLocalNetworkUsageDescription</key>
<string>需要访问本地网络以连接您的智能设备</string>
  • 同时添加 Bonjour 服务（如需要特定服务）：
    <key>NSBonjourServices</key>
<array>
    <string>_yourapp._tcp</string>
</array>

3. 代码中请求权限（iOS 14+）

使用 uni.request 或网络操作触发系统弹窗：

// 示例：通过访问本地IP触发权限申请
uni.request({
  url: 'http://192.168.1.100:8080/test', // 替换为实际设备地址
  success: (res) => {
    console.log('网络请求成功');
  },
  fail: (err) => {
    console.log('网络请求失败', err);
  }
});
  • 注意：首次访问本地网络时，iOS 会自动弹出权限申请窗口。

4. 检查权限状态

iOS 未提供直接API检查本地网络权限状态，可通过尝试连接并捕获错误间接判断。

注意事项：

  • 仅 iOS 14+ 需要：低版本系统无需申请。
  • 审核说明：在 App Store 审核时，需明确说明使用本地网络的目的，避免被拒。
  • 权限触发：必须在实际需要时（如用户操作后）触发权限申请，避免启动时直接弹出。

完成以上配置后，云打包或本地打包即可支持本地网络权限申请。

回到顶部