小米快捷链接无法跳转常用应用

Question

问题：小米手机快捷链接（如网页或通知中的URL Scheme）无法跳转至已安装的常用应用（如淘宝、微信等），点击后仅在浏览器中打开网页版。排查发现，系统级“应用链接”权限未正确配置，或目标应用未声明支持对应域名的数字资产链接（Digital Asset Links）。此外，MIUI系统更新后默认关闭部分第三方应用的自动跳转权限，导致Deep Link失效。如何在MIUI 13/14中正确配置应用链接权限并确保快捷链接正常唤醒本地应用？

Answer 1

小米手机快捷链接无法唤醒本地应用的深度排查与解决方案

1. 问题背景与现象描述

在MIUI 13/14系统中，用户点击网页或通知中的URL Scheme（如 taobao:// 或 weixin://）时，预期应跳转至已安装的对应App（如淘宝、微信），但实际行为却是在浏览器中打开网页版。该问题影响用户体验，尤其在营销活动、H5页面引流等场景下尤为突出。

初步排查发现，问题根源涉及三个层面：系统级“应用链接”权限配置、目标App是否声明Digital Asset Links（数字资产链接）、以及MIUI系统策略变更对自动跳转权限的限制。

2. 技术原理：Deep Link、App Link 与 Digital Asset Links

• URL Scheme：传统方式，如 weixin://profile，由App自行注册，存在安全风险且易被劫持。
• HTTP Deep Link：通过标准HTTP(S)链接跳转，依赖系统解析并匹配到App。
• Android App Links：基于HTTPS域名的自动跳转机制，需App与网站通过Digital Asset Links完成双向验证。
• Digital Asset Links：Google提出的安全机制，位于 https://domain.com/.well-known/assetlinks.json，用于声明哪些App可处理该域名的链接。

{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.taobao.taobao",
    "sha256_cert_fingerprints": ["AA:BB:CC:..."]
  }
}

上述JSON文件必须可通过公网访问，且签名指纹与发布版本一致。

3. MIUI 13/14 的系统级权限变更分析

MIUI版本	默认行为	影响范围	可配置性
MIUI 12及以下	允许第三方App默认处理链接	广泛支持Deep Link	高
MIUI 13	默认关闭非系统App的自动跳转	淘宝、京东等均受影响	需手动开启
MIUI 14	延续MIUI 13策略，增强隐私控制	所有第三方App需显式授权	通过设置中心配置

MIUI为提升安全性，默认禁用“应用链接”自动跳转功能，即使App已正确配置Digital Asset Links，仍需用户手动授权。

4. 排查流程与诊断方法

1. 确认目标App是否已在设备上安装且为最新版本。
2. 检查链接类型：是自定义Scheme（如 tbopen://）还是HTTPS链接（如 https://item.taobao.com/...）。
3. 验证目标网站是否部署有效的 assetlinks.json 文件。
4. 使用ADB命令测试链接解析：
   adb shell am start -W -a android.intent.action.VIEW -d "https://m.taobao.com"
5. 查看Logcat日志中是否有 PackageManager 拒绝跳转的记录。
6. 进入MIUI设置，检查“应用链接”权限状态。
7. 测试其他品牌手机（如Pixel、三星）是否正常跳转，以排除App侧问题。
8. 确认App是否在Google Play或小米应用商店上线，未上线App可能不被信任。
9. 检查App的 AndroidManifest.xml 中是否声明了正确的 <intent-filter>。
10. 模拟器测试：使用原生Android系统验证基础逻辑。

5. 解决方案：系统与应用双端配置

5.1 用户端操作：开启MIUI应用链接权限

路径：设置 → 应用设置 → 默认应用 → 外部链接默认行为 → 选择对应App → 允许“打开支持的链接”

或进入单个App信息页：应用信息 → 默认启动项 → 打开支持的链接 → 选择“始终询问”或“自动打开”

5.2 开发者端优化：确保Digital Asset Links完整性

开发者需确保：

• 在官网根目录部署 /.well-known/assetlinks.json
• 文件可通过HTTPS访问且返回状态码200
• SHA256指纹与线上APK签名一致（可用以下命令提取）：

keytool -list -v -keystore your-release-key.keystore -alias your-alias

同时，在 AndroidManifest.xml 中添加：

<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
  <data android:scheme="https" android:host="www.taobao.com" />
</intent-filter>

6. 高级调试：使用ADB与Chrome Intent工具

graph TD A[点击网页链接] --> B{是否为HTTPS?} B -- 是 --> C[检查assetlinks.json] B -- 否 --> D[仅支持Scheme跳转] C --> E{验证通过?} E -- 是 --> F[MIUI是否允许自动跳转?] E -- 否 --> G[跳转失败，降级网页] F -- 是 --> H[成功唤醒App] F -- 否 --> I[提示用户手动选择]

可通过Chrome地址栏输入：chrome://inspect/#devices 调试PWA或H5页面发送的Intent请求。

7. 企业级应对策略

对于拥有自有App的企业，建议：

• 建立定期检测机制，监控 assetlinks.json 可访问性与内容正确性。
• 在用户引导流程中嵌入“一键配置MIUI跳转权限”的指引弹窗。
• 使用Firebase Dynamic Links或阿里百川Link SDK等中间层服务，兼容多品牌机型差异。
• 收集用户设备信息（含MIUI版本）进行归因分析，识别跳转失败率高的群体。
• 与小米开放平台对接，申请白名单或参与“可信应用”计划。
• 在App内提供“复制链接→粘贴至App”备用方案，保障转化路径不断。
• 监控第三方统计平台（如友盟、GrowingIO）中的Deep Link点击与激活数据。