开发者将快应用上架应用市场后,希望能有多个入口直达快应用,从而提高其快应用的曝光率,带来更多的流量。而快应用开放的标准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>
欲了解更多详情,请参阅:
快应用开发指导文档:https://developer.huawei.com/consumer/cn/doc/development/quickApp-Guides/quickapp-whitepaper
Deeplink接入指南:https://developer.huawei.com/consumer/cn/doc/development/quickApp-Guides/quickapp-develop-deeplink
参与开发者讨论请到Reddit社区:https://www.reddit.com/r/HMSCore/
下载demo和示例代码请到Github:https://github.com/HMS-Core
解决集成问题请到Stack Overflow:https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest
原文链接:https://developer.huawei.com/consumer/cn/forum/topicview?tid=0203357572509390834&fid=18
作者:鼓楼赵又廷
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。