Ionic 5+Angular 8 Deeplink配置异常排查求助

你的Deeplink配置不正确，问题主要集中在以下几个核心点：

1. 插件配置未写入config.xml #

ionic-plugin-deeplinks的参数必须在config.xml中明确声明，否则插件无法识别deeplink规则，这是导致路径丢失的直接原因之一。

修复操作： #

手动在config.xml中添加插件配置节点：

<plugin name="ionic-plugin-deeplinks" spec="^1.0.24">
    <variable name="URL_SCHEME" value="myapp" />
    <variable name="DEEPLINK_SCHEME" value="https" />
    <variable name="DEEPLINK_HOST" value="app.myapp.io" />
    <variable name="ANDROID_PATH_PREFIX" value="/" />
</plugin>

添加完成后执行ionic cordova build android重新构建项目，确保配置生效。

2. Android 10+的Deeplink验证缺失 #

cordova-android 10.1.2对应Android 11及以上版本，系统要求HTTPS类型的deeplink必须通过**数字资产链接（Digital Asset Links）**验证，否则无法完整传递路径参数。

修复操作： #

• 在你的网站根目录（app.myapp.io下）放置assetlinks.json文件，内容示例：

  [{
      "relation": ["delegate_permission/common.handle_all_urls"],
      "target": {
          "namespace": "android_app",
          "package_name": "你的应用包名",
          "sha256_cert_fingerprints": ["你的应用签名SHA256指纹"]
      }
  }]
  

• 确认AndroidManifest.xml中对应标签包含android:autoVerify="true"（插件通常会自动生成，若未生成需手动添加）。

3. 路由处理逻辑可能存在问题 #

检查你的Deeplink路由订阅代码，确保正确提取路径参数：

this.deeplinks.route({
  '/reset_password': ResetPasswordPage
}).subscribe(match => {
  console.log('匹配成功的路径:', match.$link.path);
  // 此处添加页面跳转逻辑
}, nomatch => {
  console.error('未匹配的链接:', nomatch.$link);
});

注意：需从match.$link.path中获取实际路径，而非直接解析原始URL。

4. 测试方式需规范 #

避免直接在浏览器中输入链接测试，改用adb命令模拟外部唤起场景：

adb shell am start -W -a android.intent.action.VIEW -d "https://app.myapp.io/reset_password" 你的应用包名

这种方式能准确复现外部链接打开应用的流程，排除浏览器跳转干扰。

内容的提问来源于stack exchange，提问作者David MOSCA