開發者將快應用上架應用市場后,希望能有多個入口直達快應用,從而提高其快應用的曝光率,帶來更多的流量。而快應用開放的標准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
作者:鼓樓趙又廷