uniapp iOS调用plus.runtime.isApplicationExist检测快手失败

Question

在使用 UniApp 开发 iOS 应用时，调用 `plus.runtime.isApplicationExist` 检测快手（Kuaishou）是否安装常出现判断失败的问题。即使设备已安装快手，接口仍返回 `false`，主要原因为 iOS 系统限制第三方应用通过 URL Scheme 探测其他应用。尽管已在 `manifest.json` 中配置相关白名单（如 `urltypes` 和 `LSApplicationQueriesSchemes`），但若未正确添加快手的 Scheme（如 `kuaishou://`），或 Xcode 打包环境配置不完整，仍会导致检测失效。此外，HBuilderX 版本过旧或基座不支持也会影响 API 正常行为，需确保使用最新版本并自定义打包验证。

Answer 1

1. 问题背景与现象描述

在使用 UniApp 开发跨平台移动应用时，开发者常需实现“检测第三方 App 是否安装”的功能，例如跳转至快手（Kuaishou）进行内容分享或拉起应用。iOS 平台下，UniApp 提供了 plus.runtime.isApplicationExist 接口用于判断目标应用是否存在。然而，在实际开发中，即使设备已安装快手 App，该接口仍频繁返回 false，导致逻辑判断失败。

此问题并非个例，而是广泛存在于多个 HBuilderX 项目中，尤其在未正确配置 iOS 白名单或使用旧版编译环境时更为明显。其根本原因涉及 iOS 系统安全机制、URL Scheme 白名单策略以及 H5+ 运行时的兼容性限制。

2. 技术原理分析：iOS 的 URL Scheme 检测机制

• iOS 自 9.0 版本起 引入了 canOpenURL 的白名单限制，应用必须在 Info.plist 中声明欲查询的 URL Scheme，否则系统将默认拒绝并返回 false。
• UniApp 底层通过调用 Native 层的 [[UIApplication sharedApplication] canOpenURL:] 方法实现 plus.runtime.isApplicationExist 功能。
• 若未在 manifest.json 中正确配置 LSApplicationQueriesSchemes，则生成的 Info.plist 不包含对应 Scheme，检测必然失败。
• 快手官方使用的 Scheme 主要为：kuaishou://、ksnebula://（快影）、kwai:// 等，需逐一验证。

3. 常见错误配置与排查清单

检查项	正确配置示例	常见错误
LSApplicationQueriesSchemes	["kuaishou", "kwai", "ksnebula"]	拼写错误如 kuaishow、遗漏 kwai
urltypes 配置	无需主动添加，HBuilderX 自动生成	手动修改导致冲突
HBuilderX 版本	v3.6.8 及以上	低于 v3.5.0 存在基座缺陷
打包方式	自定义基座或离线打包	使用标准云打包未更新白名单
Xcode 编译环境	Xcode 14+，Deployment Target ≥ 11.0	旧版本 Xcode 缓存未清除

4. 正确配置步骤详解

1. 打开项目根目录下的 manifest.json 文件；
2. 进入 “App常用其它设置” → “iOS设置”；
3. 在 LSApplicationQueriesSchemes 数组中添加以下值：

   [
     "kuaishou",
     "kwai",
     "ksnebula",
     "kuaishoushare",
     "ksnebulapro"
   ]

4. 保存后执行“重新编译”操作；
5. 务必使用“自定义调试基座”进行真机测试，确保配置生效；
6. 若使用离线打包，需手动在 Xcode 工程的 Info.plist 中追加上述 Schemes；
7. 清理 Xcode 缓存（Product → Clean Build Folder）；
8. 重新运行应用并调用检测代码：

const exist = plus.runtime.isApplicationExist({
  action: 'kuaishou://'
});
console.log('快手是否安装:', exist); // 预期返回 true

5. 深层问题：H5+ 基座与运行时兼容性

UniApp 的 plus API 实际依赖于 DCloud 提供的 H5+ Runtime 基座支持。不同版本的 HBuilderX 内置的运行时版本存在差异：

• 旧版基座（≤v3.4.0）对 isApplicationExist 的 Scheme 解析存在 Bug，无法正确传递参数；
• 云打包服务若未同步最新基座模块，可能导致白名单配置被忽略；
• 建议始终使用“自定义调试基座”进行联调，以确保环境一致性；
• 可通过 uni.getSystemInfoSync().appVersion 查看当前运行时版本信息。

6. 调试与验证流程图

graph TD A[开始检测快手是否安装] --> B{manifest.json 配置 LSApplicationQueriesSchemes?} B -- 否 --> C[添加 kuaishou, kwai, ksnebula] B -- 是 --> D[是否使用最新 HBuilderX?] D -- 否 --> E[升级至 v3.6.8+] D -- 是 --> F[生成自定义调试基座] F --> G[真机运行测试] G --> H[调用 plus.runtime.isApplicationExist] H --> I{返回 true?} I -- 是 --> J[检测成功，可跳转] I -- 否 --> K[检查 Xcode Info.plist 实际内容] K --> L[确认 Scheme 存在且无拼写错误] L --> M[清理缓存并重试]

7. 替代方案与增强健壮性设计

鉴于 iOS 对 URL Scheme 探测的不确定性，建议采用多重判断策略提升用户体验：

• 结合前端引导提示：“未检测到快手，请手动打开”；
• 使用 Universal Link（如快手提供）替代 Scheme，提高成功率；
• 记录用户历史行为，缓存上次检测结果减少频繁调用；
• 通过服务器端维护主流 App Scheme 列表，动态下发配置；
• 在无法确定安装状态时，直接尝试 plus.runtime.openURL 并捕获异常。