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

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