HarmonyOS鸿蒙Next中如何用Deeplink为快应用提供多个快速直达入口

HarmonyOS鸿蒙Next中如何用Deeplink为快应用提供多个快速直达入口 开发者将快应用上架应用市场后，希望能有多个入口直达快应用，从而提高其快应用的曝光率，带来更多的流量。而快应用开放的标准deeplink能力可以满足开发者的需求。

应用场景

Deeplink可以应用在如下场景：

  • 社交分享
    将快应用的Deeplink链接，通过社交软件进行分享，用户点击链接就可以直接打开快应用。

  • 广告推广
    将快应用的Deeplink链接，放入广告推广页面，用户点击链接就可以直接打开快应用。

  • 运营活动
    进行运营活动时，如果使用快应用来吸引用户参与到活动中，可以将快应用的Deeplink链接嵌入到运营活动宣传页面，从而方便用户的参与。

格式支持

快应用Deeplink支持以下链接格式：

推荐使用：

hap://app/<package>/[path][?key=value]
https://hapjs.org/app/<package>/[path][?key=value]

仅适用于华为手机：

hwfastapp://<package>/[path][?key=value]
  • package：应用包名，必选。
  • path：应用内页面的path，可选，不填写的话，默认为首页。
  • key-value：需要传给页面的参数，可选，可以有多个。传递的参数值有可能被其他应用获取，建议不要传递安全敏感度较高的数据。

开发过程

以下我们以跳转包名为com.huawei.quickapp的快应用demo为例，讲解Deeplink的使用。

通过快应用demo的manifest.json文件，我们可以获得如下信息：

  • 包名：com.huawei.quickapp。
  • 应用名称：demo。
  • 页面：包含Hello和Detail两个页面，其中Hello为首页。

在快应用中调用Deeplink打开快应用demo的示例代码如下：

import router from '@system.router'
router.push({
    uri: 'hap://app/com.huawei.quickapp'
})

在网页中通过点击链接打开快应用demo的示例代码如下：

<html>
    <head>
        <meta charset="UTF-8">
        <title></title>
    </head>
    <body>
        <a href="hap://app/com.huawei.quickapp">跳转到快应用demo</a>
    </body>
</html>

以上例子没有配置跳转的具体页面，所以默认进入快应用demo的首页Hello，如果想调整到Detail页面，代码可以修改为：

import router from '@system.router'
router.push({
    uri: 'hap://app/com.huawei.quickapp/Detail'
})

如果还需要向Detail页面传递参数，可以将参数以key-value形式拼接在后面，多个参数使用&连接。假设向Detail页面传递source和name参数，则代码修改为：

import router from '@system.router'
router.push({
    uri: 'hap://app/com.huawei.quickapp/Detail?source=net&name=aa'
})

接入Detail页面后获取参数值的代码如下：

onShow: function () {
    var nameValue = this.name;
    var sourceValue = this.source;
}

开发完，可以在本地对Deeplink进行测试，从而验证跳转链接的准确性。

注意： 测试前，请确保华为快应用加载器中有目标快应用的使用记录。

测试

方法一：使用android adb命令（电脑需配置好adb环境）

adb shell am start -a android.intent.action.VIEW -d hap://app/com.huawei.quickapp/Detail

注意： 使用命令测试不适用传递多个参数的场景。

方法二：在一个本地网页中添加需测试的Deeplink超链接

<!DOCTYPE html>
<html>    
    <head>
        <meta charset="UTF-8">
        <title></title>
    </head>
<body>
    <script type="text/javascript">
        window.location.href="hap://app/com.huawei.quickapp/Detail?source=net&name=aa";
    </script>   
</body>
</html>

欲了解更多详情，请参阅：


更多关于HarmonyOS鸿蒙Next中如何用Deeplink为快应用提供多个快速直达入口的实战教程也可以访问 https://www.itying.com/category-93-b0.html

3 回复

在微信网页中，好像通过链接方式进入快应用是不支持的。

更多关于HarmonyOS鸿蒙Next中如何用Deeplink为快应用提供多个快速直达入口的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


微信可能存在屏蔽hap链接的情况，请尝试使用https://hapjs.org/app/package/path?[key=value]

在HarmonyOS鸿蒙Next中，使用DeepLink为快应用提供多个快速直达入口，可以通过以下步骤实现：

  1. 定义DeepLink URL：在快应用配置文件中，为每个入口定义唯一的DeepLink URL。

  2. 配置路由：在config.json中，配置每个DeepLink对应的页面路由，确保URL能正确映射到特定页面。

  3. 处理DeepLink请求：在快应用代码中，监听DeepLink请求，解析URL参数，并根据参数跳转到相应页面。

  4. 测试验证：通过开发者工具或实际设备，测试每个DeepLink入口，确保能准确跳转到指定页面。

通过以上步骤，可以为快应用提供多个快速直达入口，提升用户体验。

回到顶部