Flutter iOS Chromecast无法触发NSLocalNetworkUsageDescription权限弹窗

已确认的前置配置状态 #

• 使用Google Cast SDK版本为google-cast-sdk ~> 4.7.0
• 已在Entitlements文件中添加com.apple.developer.networking.wifi-info能力
• 已在Info.plist配置Cast要求的权限字段与Bonjour服务，包含默认接收器（ID: CC1AD845）对应的_CC1AD845._googlecast._tcp服务项
• 蓝牙权限申请可正常弹出，仅NSLocalNetworkUsageDescription对应的本地网络权限弹窗始终不触发，系统设置页无对应权限开关入口

排查修复步骤 #

1. 补全本地网络扫描必需的Entitlement配置
   iOS 14及以上系统，触发本地网络权限申请的核心前提是App签名包含com.apple.developer.networking.multicast权限，仅添加com.apple.developer.networking.wifi-info无法满足Bonjour扫描的权限要求。
   操作流程：

   • 登录苹果开发者后台，找到对应App的App ID配置页，勾选Multicast Networking能力
   • 重新生成对应的Provisioning Profile文件，导入本地Xcode
   • 在工程的Entitlements文件中新增com.apple.developer.networking.multicast项，值类型设为Boolean，值为true
   • 重新打包后可通过以下命令校验签名是否包含该权限：

   codesign -d --entitlements - /你的App安装路径/Runner.app
   

   注意：仅在本地Entitlements文件手动添加该字段、未在开发者后台配置对应能力的话，签名时会被系统忽略，不会生效。

2. 校验Info.plist配置的生效范围
   Flutter工程容易出现多环境配置不同步问题，需确认：

   • Debug、Profile、Release三种构建模式对应的Info.plist文件都同步添加了NSBonjourServices数组和NSLocalNetworkUsageDescription字段，不要仅修改Debug模式下的配置文件
   • Bonjour服务名无多余空格、后缀，格式完全匹配：

   <key>NSBonjourServices</key>
   <array>
       <string>_googlecast._tcp</string>
       <string>_CC1AD845._googlecast._tcp</string>
   </array>
   <key>NSLocalNetworkUsageDescription</key>
   <string>App访问本地网络用于发现同一WiFi下的投屏设备</string>
   

   • 检查第三方Flutter Cast插件是否自带Info.plist文件覆盖主工程配置，可在构建完成后打开生成的ipa包，查看包内Info.plist的实际字段值确认。

3. 清理系统权限缓存
   iOS系统会保留App的权限授权记录最长24小时，仅卸载重装不会重置权限状态：

   • 卸载设备上已安装的测试包
   • 打开系统设置 > 通用 > 传输或还原iPhone > 还原 > 还原位置与隐私
   • 重启设备后重新编译安装App，即可重置所有权限状态。

4. 调整SDK初始化时机
   不要在AppDelegate的didFinishLaunchingWithOptions阶段、或者App处于后台态时初始化GCKCastContext触发设备扫描，该阶段发起的本地网络请求会被系统直接拦截，且不会触发权限申请，也不会在设置页生成权限入口。需将Cast SDK的初始化逻辑挪到App进入前台活跃状态、首个页面渲染完成后执行。

验证结果 #

完成以上配置后，首次调用GCKCastContext.sharedInstance().presentCastDialog()方法时，系统会先弹出本地网络权限申请弹窗，用户授权后，系统设置的App详情页会出现「本地网络」开关项，设备扫描功能可正常发现同一局域网内的Cast设备。

内容的提问来源于stack exchange，提问作者bypass112