挣脱物理跳转的束缚,鸿蒙系统深层链接与 App Linking 实战

上个月公司搞双十一大促,投了一大笔钱在抖音和小红书上做推广。结果上线第一天,数据分析部门就发来战报:点击推广链接进入 App 的转化率不足 5%!用户辛辛苦苦在外部浏览器点了链接,跳转到 App 后,居然直接停在了首页,还得自己手动去搜索活动商品。这体验,难怪没人买账。

要实现从外部链接直接唤起 App,并且精准落地到活动详情页,这在移动端被称为"深度链接(DeepLink)"。在鸿蒙系统里,做深链不仅要配置好 module.json5,还得防住冷热启动的参数丢失。

配置 Want 的隐式匹配规则

在鸿蒙中,外部拉起应用主要依靠 Want 的隐式匹配。我们需要在 module.json5 的 skills 节点中,声明我们应用能够响应的 URL 协议。

json

复制代码
{
  "module": {
    "abilities": [
      {
        "name": "EntryAbility",
        "skills": [
          {
            "actions": ["ohos.want.action.viewData"],
            "entities": ["entity.system.browsable"],
            "uris": [
              {
                "scheme": "https",
                "host": "promo.example.com",
                "path": "activity/detail"
              }
            ]
          }
        ]
      }
    ]
  }
}

这段配置的意思是:当外部系统试图打开 https://promo.example.com/activity/detail 时,鸿蒙系统会通过隐式匹配,找到并拉起我们的应用。

解析冷热启动的 Want 参数

当应用被拉起后,外部的 URL 会被封装在 Want 对象的 uri 属性里传进来。

如果应用完全没有启动(冷启动),系统会走 onCreate;如果应用已经在后台(热启动),系统会走 onNewWant。很多人只写了 onCreate,结果导致应用在后台时,点击深链毫无反应。

typescript

复制代码
export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    this.handleDeepLink(want);
  }

  onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam) {
    this.handleDeepLink(want);
  }

  private handleDeepLink(want: Want) {
    if (want.uri && want.uri.includes('promo.example.com')) {
      // 核心动作:提取活动 ID
      const activityId = this.parseActivityId(want.uri);
      
      // 警示:绝不能在这里直接 router.pushUrl,此时页面栈可能没建好
      // 必须将参数存入全局,交由 UI 层处理
      AppStorage.setOrCreate('deep_link_activity_id', activityId);
    }
  }
}

https://image_placeholder_2/

(配图建议:代码截图,标出 onNewWant 的处理逻辑)

在正确的时机执行路由跳转

数据存进了 AppStorage,接下来就是 UI 层的事情了。在首页的 aboutToAppear 或者 onPageShow 里,我们需要去消费这个参数。

typescript

复制代码
@Entry
@Component
struct IndexPage {
  aboutToAppear() {
    const activityId = AppStorage.get<string>('deep_link_activity_id');
    if (activityId) {
      // 此时 UI 已经初始化完毕,可以安全跳转
      router.pushUrl({ 
        url: 'pages/ActivityDetail', 
        params: { id: activityId } 
      });
      
      // 极其重要:消费完必须清空,否则用户返回首页会再次触发跳转
      AppStorage.setOrCreate('deep_link_activity_id', undefined);
    }
  }
}

校验校验与应用市场白名单机制

在测试深链时,我遇到了一个极其恶心的问题:如果我用的是 HTTP 协议,系统根本不理我;如果用 HTTPS,有时候浏览器还会弹出一个选择框,让用户选是用浏览器打开还是用 App 打开。

要想彻底消除这个弹窗,实现无缝直达,必须申请 App Linking(应用链接)。这要求你的域名必须在华为 AppGallery Connect 后台进行校验,并且应用必须发布到应用市场。对于还在开发调试阶段的应用,必须在开发者模式下进行特殊配置。

综合来看,深链技术是流量变现的最后一公里。配好 module.json5,管好冷热启动,踩准路由跳转的时机,才能让用户丝滑地从网页降落至你的 App 内部。