鴻蒙NEXT元服務：利用App Linking實現無縫跳轉與二維碼拉起

zhongcx發表於2024-11-27
鴻蒙APP

【效果】

元服務連結格式（API>=12適用）：https://hoas.drcn.agconnect.link/ggMRM

生成二維碼後效果：

​

【參考網址】

使用App Linking實現元服務跳轉：https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-Guides/agc-applinking-atomic-link-0000002046440041

草料二維碼：https://cli.im/

【引言】

本文將詳細介紹如何使用App Linking技術實現元服務之間的無縫跳轉，並透過生成二維碼的方式快速拉起元服務，從而簡化使用者操作流程，增強應用的互動性和推廣效率。

【什麼是元服務連結？】

元服務連結是一種專為開發者設計的受控URL服務，允許使用者點選後直接進入特定的元服務內容頁。這種即點即享的功能極大地簡化了使用者的操作流程，並且可以精準控制使用者訪問的時間範圍。對於已上架的元服務，開發者能夠為其生成並配置專屬連結，同時設定有效期，以確保使用者在有效期內能夠訪問到最新的內容或功能。

【使用場景】

• 掃碼直達：使用者可以透過掃描二維碼直接進入特定的元服務頁面。

• 社交分享：方便使用者透過社交媒體分享特定的服務內容。

• 喚醒沉默使用者：透過推送通知中的連結快速啟用不活躍的使用者。

• 營銷推廣：作為廣告內容的一部分，引導使用者進入體驗服務，提高轉化率。

【建立元服務連結】

要建立一個元服務連結，首先需要滿足以下前提條件：

1. 在AGC（AppGallery Connect）平臺上建立專案。

2. 開通App Linking服務。

3. 專案中存在已上架且支援HarmonyOS API 12及以上的元服務。

接下來，按照以下步驟建立連結：

1. 登入AppGallery Connect，選擇“我的專案”。

2. 選擇專案後，在左側導航欄找到“增長 > App Linking”，選擇“元服務連結（API>=12適用）”頁籤。

3. 點選“建立”，填寫連結名稱、設定連結的有效期等資訊。

4. 可以選擇新增自定義引數，以便更精確地定位到元服務中的指定頁面。

5. 最後，儲存或釋出連結。

【自定義引數】

為了更靈活地控制跳轉行為，開發者可以在建立元服務連結時設定自定義引數。這些引數通常用於指定頁面路徑或是導航目標。例如，可以透過pagePath引數指定具體的頁面路徑，或者使用navRouterName引數指向特定的導航目的地。如果涉及分包，則還需要提供subPackageName引數。

【應用內整合】

在應用內部，開發者可以使用UIAbilityContext.openLink介面來開啟元服務連結。根據設定的不同，如果匹配到相應的元服務則會直接開啟；否則，可能會丟擲異常或者嘗試透過瀏覽器開啟連結。此外，還可以設定appLinkingOnly引數來控制是否僅限於透過App Linking開啟元服務。

// 示例程式碼
import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
let link: string = "https://hoas.drcn.agconnect.link/9P7g";
context.openLink(link, { appLinkingOnly: true })
  .then(() => {
    console.info('openlink success.');
  })
  .catch((error: BusinessError) => {
    console.error(`openlink failed. error:${JSON.stringify(error)}`);
  });

【錯誤處理與除錯】

當元服務連結過期或無效時，系統會給出相應的錯誤提示。開發者可以根據這些提示來進行錯誤處理。例如，當appLinkingOnly設為true時，如果遇到非法或失效連結，系統會丟擲錯誤碼"16000019"。在這種情況下，開發者應當準備好相應的錯誤處理邏輯，以保證良好的使用者體驗。

【二維碼生成】

最後一步，開發者可以使用草料二維碼工具將生成的元服務連結轉換成二維碼，方便使用者透過掃描二維碼的方式訪問元服務。這不僅提升了使用者體驗，也增加了應用的互動性和傳播性。

【結論】

透過以上步驟，開發者可以輕鬆地利用App Linking技術實現鴻蒙元服務之間的無縫跳轉，並透過二維碼方式快速拉起元服務。這項技術不僅有助於簡化使用者操作，還能增強應用的互動性和推廣效果。希望本文能幫助開發者更好地理解和運用這一強大功能，為使用者提供更加流暢便捷的服務體驗。

相關文章