Apple 调整了 scheme 查询白名单限制:使用 Xcode 27 编包且运行在 iOS 27 上时,LSApplicationQueriesSchemes 的有效查询项数从 50 项减少到 25 项,仅前 25 项生效。
如果微信 OpenSDK 所需的 scheme 排在第 25 项之后,对应查询会失败,可能导致微信安装状态或相关能力判断异常,进而影响登录、分享、支付、拉起小程序等功能。
请计划升级至 Xcode 27 的开发者,检查最终发布包中的 LSApplicationQueriesSchemes 配置,并将所需项目放在前 25 项。
1. 各版本组合的表现
| 编包版本 | 运行系统 | 查询白名单表现 |
|---|---|---|
| Xcode 26 | iOS 26 | 50 项上限 |
| Xcode 26 | iOS 27 | 50 项上限 |
| Xcode 27 | iOS 26 | 50 项上限 |
| Xcode 27 | iOS 27 | 25 项上限,仅前 25 项生效 |
2. 需要保留的 scheme 配置
| Scheme | 作用 | 配置要求 |
|---|---|---|
weixin |
检测微信是否安装;通过 scheme 拉起微信,包括 Universal Link 失败后的降级拉起 | 必配,缺失会导致 registerApp 返回 NO |
weixinULAPI |
探测微信是否支持 Universal Link 调用协议 | 必配,缺失会导致 registerApp 返回 NO |
weixinURLParamsAPI |
探测微信是否支持 iOS 15 及以上的 URL 传参,减少对剪贴板的依赖 | 强烈建议保留;缺失会使相关请求退回剪贴板传参,可能影响分享、拉起小程序等调用 |
weixinStateAPI |
探测是否支持分享到微信状态 | 使用该能力时配置 |
weixinQRCodePayAPI |
探测是否支持二维码拉起微信支付 | 使用该能力时配置 |
3. 配置建议
-
不建议为节省名额自行删减微信 OpenSDK 所需配置。
-
请通过调整排列顺序,将必配、建议保留及实际使用的能力配置放在前 25 项。
-
完成配置调整后,请在 iOS 27 真机上回归验证 App 实际使用的微信相关功能。