ios 获取WiFi信息

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

根据知识库中的信息，针对 iOS 获取 WiFi 信息（SSID、BSSID）的问题，提供以下基于官方文档和插件资料的解决方案：

官方推荐方案：uni-WiFi 插件（uni ext api）

iOS 平台获取 WiFi 信息需使用官方提供的 uni-WiFi 插件（uni ext api 方式），要求 HBuilderX 3.6.8+。

关键配置要求：

1. 开启 Access WiFi Information 能力
   登录苹果开发者网站，在 "Certificates, Identifiers & Profiles" 页面选择对应的 App ID，确保开启 "Access WiFi information"，保存后重新生成 profile 文件。

2. 配置 entitlements
   在插件的 package.json 中配置 capabilities：

   "capabilities": {  
      "entitlements": {  
          "com.apple.developer.networking.wifi-info": true  
      }  
   }  

   本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

3. iOS 13+ 必须获取定位权限
   iOS 13 及以上系统，获取当前连接的 WiFi 信息必须先获取系统定位权限，调用接口时会触发定位权限申请弹窗。需在 manifest.json 中配置位置权限描述：

   "ios": {  
      "privacyDescription": {  
          "NSLocationWhenInUseUsageDescription": "获取WiFi信息需要定位权限",  
          "NSLocationAlwaysAndWhenInUseUsageDescription": "获取WiFi信息需要定位权限"  
      }  
   }  

   本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

插件市场原生插件方案

如需使用原生插件，知识库中有 WiFi信息获取插件（sand-plugin-wifi），但需注意：

• 该插件标注支持 iOS 9 - 15
• 同样需要在 Capabilities 中添加 Access WIFI Information
• 代码示例：

  var sand = uni.requireNativePlugin("sand-plugin-wifi");  
  sand.getWIFIInfo({}, (ret) => {  
    console.log(ret.ssid, ret.bssid);  
  });  

  本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

已知问题与注意事项

根据对话知识库记录，有开发者反馈 uni-wifi 插件存在打包报错问题（cannot find type 'wifioption' in scope），如遇到此类问题，建议：

1. 检查 HBuilderX 版本是否为最新（当前正式版 5.04）
2. 确认插件的 iOS 编译环境配置正确

关于 iOS 26+ 版本

知识库中暂未找到 iOS 26+ 特定版本的兼容性说明。目前文档主要覆盖到 iOS 15-18 左右的版本。如插件市场的插件在 iOS 26+ 无法正常工作，建议：

1. 优先检查上述权限配置（Access WiFi Information + 定位权限）是否完整
2. 到 插件市场 搜索是否有更新的 WiFi 插件支持高版本 iOS
3. 考虑使用 UTS 语言编写自定义插件（需置于 uni_modules 下），通过 iOS 原生 API NEHotspotConfiguration 或 CNCopyCurrentNetworkInfo 实现（需遵守苹果最新隐私政策）

详细配置文档可参考：iOS 插件包配置 - capabilities 和 WiFi API 文档。

目前使用的就是原生插件的 WiFi信息获取插件（sand-plugin-wifi）Ios系统版26+无法获取到WiFi信息