开发者将快应用上架应用市场后,希望能有多个入口直达快应用,从而提高其快应用的曝光率,带来更多的流量。而快应用开放的标准deeplink能力可以满足开发者的需求。
应用场景
Deeplink可以应用在如下场景:
社交分享
将快应用的Deeplink链接,通过社交软件进行分享,用户点击链接就可以直接打开快应用。
广告推广
将快应用的Deeplink链接,放入广告推广页面,用户点击链接就可以直接打开快应用。
运营活动
进行运营活动时,如果使用快应用来吸引用户参与到活动中,可以将快应用的Deeplink链接嵌入到运营活动宣传页面,从而方便用户的参与。
格式支持
快应用Deeplink支持以下链接格式:
推荐使用:
hap://app//[path][?key=value]
https://hapjs.org/app//[path][?key=value]
仅适用于华为手机:
hwfastapp:///[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的示例代码如下:
以上例子没有配置跳转的具体页面,所以默认进入快应用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超链接
window.location.href="hap://app/com.huawei.quickapp/Detail?source=net&name=aa";