关于 Xcode 27 与 iOS 27 的微信 OpenSDK 适配提醒

查看 llm.txt

最后一次编辑于 2026-10-22

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 实际使用的微信相关功能。