HarmonyOS鸿蒙Next手机系统从5.0.2升级到6.0.0.115 App linking失效

可能有多个原因导致，可以试试下面找到的办法，我还没有实测：

的OpenHarmony 5.0.2 升级到 6.0 后 App linking 失效问题，核心原因是两方面的变更叠加：一是 OpenHarmony 6.0 对深层链接（App linking）的配置要求升级，二是 Chromium 内核从 114 升级到 132 后，WebView 的自定义 Scheme 唤起策略更严格。以下是具体原因和修复步骤：

一、核心原因分析

1. OpenHarmony 6.0 对深层链接（App linking）的配置要求变更OpenHarmony 6.0 强化了 Ability 的skills匹配规则，旧版本中松散的 scheme/host 配置，在 6.0 中需要更精确的声明（比如补充action/category），否则系统无法识别链接对应的应用。

2. Chromium 132 内核的安全策略收紧高版本 Chromium（132）对自定义 Scheme 唤起外部应用增加了 2 个关键限制：

   • 必须通过用户主动交互（如点击按钮）触发（禁止自动跳转、定时器跳转）；
   • WebView 默认不允许直接唤起外部应用，需手动拦截 URL 并处理。

二、修复步骤（按优先级排序）

步骤 1：更新 Ability 的skills配置（解决应用配置不兼容）

OpenHarmony 6.0 要求深层链接对应的 Ability 必须在module.json5中精确配置action、category，补充后系统才能识别链接并唤起应用。

旧版本可能的配置（5.0.2）：

{
  "abilities": [
    {
      "name": ".MainAbility",
      "type": "page",
      "skills": [
        {
          "entities": [],
          "actions": [],
          "uris": [
            {
              "scheme": "myapp", // 你的App自定义Scheme
              "host": "test"
            }
          ]
        }
      ]
    }
  ]
}

6.0 需补充的配置：

{
  "abilities": [
    {
      "name": ".MainAbility",
      "type": "page",
      "skills": [
        {
          "entities": [],
          "actions": ["ohos.intent.action.VIEW"], // 必须补充：深层链接默认action
          "categories": ["ohos.intent.category.BROWSABLE"], // 必须补充：标记为可被浏览器/ WebView唤起
          "uris": [
            {
              "scheme": "myapp", // 保持原Scheme
              "host": "test",    // 保持原Host
              "path": "/*"       // 补充：匹配所有子路径
            }
          ]
        }
      ]
    }
  ]
}

步骤 2：适配 WebView 的 URL 拦截（解决 Chromium 132 限制）

高版本 Chromium 的 WebView 默认不会自动唤起自定义 Scheme 的应用，需手动拦截 URL 并调用系统 Intent 唤起。

修复代码（ArkTS）：

import webview from '@ohos.web.webview';
import featureAbility from '@ohos.ability.featureAbility';
import Want from '@ohos.app.ability.Want';

@Entry
@Component
struct WebViewPage {
  private webController: webview.WebviewController = new webview.WebviewController();

  build() {
    Column() {
      Web({
        src: "你的Web页面URL", // 包含App linking链接的页面
        controller: this.webController
      })
      .width('100%')
      .height('100%')
      .javaScriptAccess(true)
      // 关键：拦截URL并手动处理自定义Scheme
      .onUrlLoadingIntercept((event) => {
        const url = event.url;
        // 检测是否是你的App自定义Scheme（如myapp://）
        if (url.startsWith("myapp://")) {
          // 调用系统Intent唤起应用
          this.launchAppByUrl(url);
          // 阻止WebView默认处理
          event.result = true;
        }
      })
    }
  }

  // 手动唤起应用
  private async launchAppByUrl(url: string) {
    try {
      const want: Want = {
        action: "ohos.intent.action.VIEW",
        uri: url, // 传入自定义Scheme链接
        parameters: {}
      };
      // 唤起应用（如果已安装）
      await featureAbility.startAbility({ want: want });
    } catch (e) {
      console.error("唤起应用失败：", e);
      // 可选：唤起失败时跳转到应用市场
    }
  }
}

步骤 3：确保链接由用户主动交互触发（解决 Chromium 安全限制）

Chromium 132 禁止自动跳转（如页面加载后定时器跳转、JS 自动跳转）的自定义 Scheme 唤起，必须通过用户主动点击按钮触发。

Web 页面端修复示例：

<!-- 错误：自动跳转（6.0中会被拦截） -->
<script>
  // 升级前可能的写法，6.0中失效
  window.onload = () => {
    window.location.href = "myapp://test/page1";
  };
</script>

<!-- 正确：用户点击按钮触发（6.0中有效） -->
<button onclick="openApp()">打开我的应用</button>
<script>
  function openApp() {
    window.location.href = "myapp://test/page1";
  }
</script>

步骤 4：验证系统唤起能力（排查是否是配置遗漏）

如果上述步骤后仍失效，可通过hdc命令行测试系统是否能识别你的 App 链接，判断是应用配置问题还是 WebView 问题：

# 在电脑端执行（设备已连接hdc）
hdc shell am start -a ohos.intent.action.VIEW -d "myapp://test/page1"

• 如果命令能成功唤起应用：说明应用配置已生效，问题出在 WebView 的处理；
• 如果命令无法唤起：说明module.json5的skills配置仍有问题，需重新检查步骤 1。

三、总结

这次失效是OpenHarmony 6.0 的配置升级+Chromium 132 的安全收紧共同导致的，按以下顺序修复即可恢复：

1. 补充 Ability 的skills配置（action/category/path）；
2. 在 WebView 中手动拦截自定义 Scheme 并调用 Intent 唤起；
3. 确保 Web 页面中链接由用户主动点击触发。

完成后 App linking 即可恢复正常拉起应用的功能。