華為應(yīng)用市場App Linking使用入門

App Linking服務(wù)提供了客戶端SDK，您的應(yīng)用必須集成App Linking SDK才能在應(yīng)用中創(chuàng)建和接收App Linking。應(yīng)用集成App Linking SDK后，App Linking服務(wù)能夠在用戶對(duì)鏈接進(jìn)行操作時(shí)自動(dòng)上報(bào)用戶點(diǎn)擊鏈接后事件數(shù)據(jù)，供您分析App Linking的效果。本文檔重點(diǎn)介紹App Linking服務(wù)的開通方法和集成App Linking SDK的步驟。

集成AGC SDK

集成App Linking SDK前您需確認(rèn)AGC SDK和AGC插件已經(jīng)集成，詳細(xì)步驟請(qǐng)參考AppGallery Connect服務(wù)使用入門。

開通App Linking服務(wù)

1.登錄AppGallery Connect網(wǎng)站，點(diǎn)擊“我的項(xiàng)目”。

2.在項(xiàng)目列表中找到您的項(xiàng)目，在項(xiàng)目下的應(yīng)用列表中選擇需要開通App Linking的應(yīng)用。

3.點(diǎn)擊“增長;App Linking”，進(jìn)入App Linking頁面，點(diǎn)擊“立即開通”。

說明：

由于開通服務(wù)時(shí)需要設(shè)置數(shù)據(jù)存儲(chǔ)位置，設(shè)置數(shù)據(jù)存儲(chǔ)位置后會(huì)刷新agconnect-services.json文件里的配置。如果您首次開通服務(wù)，在開通完成后您需要重新下載agconnect-services.json文件并集成到您的工程中，具體操作參見添加配置文件。

集成Analytics Kit

對(duì)App Linking的事件進(jìn)行數(shù)據(jù)統(tǒng)計(jì)時(shí)需要使用華為分析服務(wù)，如果您還未集成Analytics Kit，您需要在應(yīng)用級(jí)gradle文件中（通常在app/build.gradle）添加如下代碼集成Analytics Kit。

implementation'com.huawei.hms:hianalytics:{version}'

version替換為Analytics Kit的最新版本號(hào)，參見集成Analytics Kit SDK。

集成App Linking SDK

AndroidStudio開發(fā)環(huán)境

在應(yīng)用級(jí)gradle文件中（通常在app/build.gradle）添加如下代碼集成App Linking SDK。

implementation'com.huawei.agconnect:agconnect-applinking:1.4.1.300'

Eclipse開發(fā)環(huán)境

使用aar2eclipse工具轉(zhuǎn)換aar包時(shí)dependencies依賴配置如下：

dependencies { 

    embed "com.huawei.agconnect:agconnect-applinking:1.4.1.300" 

}

具體步驟參見Eclipse開發(fā)環(huán)境集成AGC SDK。

集成App Linking SDK后，您下一步就可以在AGC界面或應(yīng)用客戶端中創(chuàng)建App Linking。

配置讀取剪切板開關(guān)

集成App Linking SDK的應(yīng)用啟動(dòng)時(shí)，App Linking SDK會(huì)讀取剪切板內(nèi)容來獲取鏈接信息，到達(dá)應(yīng)用內(nèi)指定的內(nèi)容。如果您希望應(yīng)用每次啟動(dòng)時(shí)都會(huì)讀取剪切板或不讀取剪切板，您可通過配置來選擇是否開啟讀取剪切板功能。在AndroidManifest.xml的Application節(jié)點(diǎn)下增加如下配置：

<meta-data 

    android:name="com.huawei.agconnect.applinking.READ_CLIPBOARD_PERMISSION" 

    android:value="xxxx"/>

當(dāng)value為Available時(shí)，App Linking SDK在應(yīng)用每次啟動(dòng)時(shí)都會(huì)讀取剪切板。

當(dāng)value為Unavailable時(shí)，App Linking SDK不讀取剪切板。

不配置metadata時(shí)，將默認(rèn)App Linking SDK僅在應(yīng)用首次啟動(dòng)時(shí)讀取剪切板。