LSApplicationQueriesSchemes 无法识别？

Question

在iOS开发中，开发者常遇到“LSApplicationQueriesSchemes 无法识别”的问题。该问题通常出现在项目中的`Info.plist`文件配置不当，导致系统无法正确识别应用间通信所需的URL Scheme白名单。具体表现为应用调用`canOpenURL:options:completionHandler:`时返回`NO`，甚至引发崩溃或警告：`This app is not allowed to query for scheme xxx`。造成此问题的常见原因包括：未正确声明`LSApplicationQueriesSchemes`数组、拼写错误、或尝试访问未授权的私有URL Scheme。解决方法包括：检查`Info.plist`中`LSApplicationQueriesSchemes`的拼写与格式，确保其为字符串数组；确认目标URL Scheme确实在白名单中；避免使用未公开或受限制的URL Scheme。合理配置可有效提升应用间跳转与通信的稳定性与安全性。

Answer 1

一、问题背景与基础认知

在iOS开发中，应用之间通过URL Scheme进行跳转或通信是一种常见做法。然而，从iOS 9开始，苹果为了增强应用的安全性，引入了LSApplicationQueriesSchemes白名单机制。如果开发者没有在Info.plist中正确声明目标URL Scheme，调用canOpenURL:options:completionHandler:方法时将返回NO，并可能在控制台输出警告信息：This app is not allowed to query for scheme xxx。

这一机制的引入，使得开发者必须显式声明所要查询的URL Scheme，否则系统将禁止该查询操作。

二、问题表现与影响

• canOpenURL返回NO：即使目标应用存在，系统也无法识别其URL Scheme。
• 控制台警告：输出类似This app is not allowed to query for scheme xxx的警告信息。
• 应用崩溃：在某些系统版本或极端情况下，可能导致应用异常崩溃。

这些问题不仅影响功能的正常使用，也可能导致用户体验下降，甚至被用户误认为是产品缺陷。

三、常见错误与原因分析

造成LSApplicationQueriesSchemes无法识别的常见原因如下：

错误类型	具体表现	可能原因
未声明白名单	直接调用canOpenURL失败	未在Info.plist中添加LSApplicationQueriesSchemes键
拼写错误	白名单中存在拼写错误	例如将weixin误写为weixn
格式错误	白名单未使用数组格式	未将每个Scheme作为独立字符串项加入数组
使用私有/未公开Scheme	系统拒绝访问	尝试访问非公开或受限的URL Scheme

四、解决方案与最佳实践

要解决该问题，建议开发者遵循以下步骤进行排查和配置：

1. 打开项目的Info.plist文件；
2. 添加或检查是否存在LSApplicationQueriesSchemes键；
3. 确保该键的值为一个字符串数组（Array of Strings）；
4. 将需要查询的URL Scheme作为独立字符串项加入数组；
5. 避免使用未公开或受限的URL Scheme（如系统私有API）；
6. 测试时使用真实设备而非模拟器，因模拟器有时不完全模拟白名单机制。

以下是一个配置示例：

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>weixin</string>
    <string>alipay</string>
    <string>tel</string>
</array>

五、流程图解析

以下是一个关于LSApplicationQueriesSchemes配置流程的Mermaid图示：

graph TD
      A[开始] --> B[检查Info.plist]
      B --> C{是否存在LSApplicationQueriesSchemes?}
      C -->|是| D[检查数组格式]
      C -->|否| E[添加LSApplicationQueriesSchemes数组]
      D --> F[检查每个URL Scheme拼写]
      F --> G[是否包含私有Scheme?]
      G -->|是| H[移除或替换为公开Scheme]
      G -->|否| I[完成配置]
      H --> I
      I --> J[结束]

六、进阶建议与调试技巧

为了更高效地排查和解决此类问题，建议开发者：

• 使用Xcode的Property List Editor来编辑Info.plist，减少格式错误；
• 在项目构建脚本中加入plist格式校验步骤；
• 使用plutil命令行工具验证plist文件的语法是否正确；
• 在开发文档或第三方SDK说明中查找推荐的URL Scheme列表；
• 利用日志系统记录调用canOpenURL时的Scheme名称，便于定位问题。

例如，使用plutil验证plist文件：

plutil -s Info.plist