快速集成華為AGC-AppLinking服務-Cocos平台

本文轉載自查看原文 2021-01-05 17:51 1309 Android

我們應用需要使用跨平台的分享鏈接，剛好華為AppGallery Connect的AppLinking服務滿足我們的使用場景。

關於集成步驟，官網的資料寫的有點多，我總結一下步驟

i. 創建應用，開通AppLinking服務

　 ii. 創建一個鏈接前綴

　 iii. 在Android項目里集成AppLinking SDK；

　　 iv. 創建AppLinking

　　 v. 接收AppLinking鏈接並且測試。

1、創建應用，開通AppLinking服務

（1）在AGC控制台，創建應用，或者使用已有的應用），在界面上找到 我的項目 -> 增長–>AppLinking，點擊立即開通。

（2）開通好以后，記得去 我的項目 -> 項目設置–> 常規 下面，下載agconnect-services.json文件到你的Cocos項目的setting路徑下。

2、創建一個鏈接前綴

　在剛剛開通的AppLinking下面，點擊鏈接前綴頁簽，點擊添加鏈接前綴，根據需要創建一個現網唯一的前綴。

　系統會自動幫你檢測，保證你域名的全網唯一。
在這里插入圖片描述

3、在Cocos項目里面集成AppLinking SDK

　首先需要在Cocos Creator的你的項目里開通AppLinking服務：

（1）在右側的Service面板找到AppLinking，進去先關聯一個應用，

在這里插入圖片描述

如果沒有應用，需要先去Cocos的控制台先創建一個：按需選擇，隨便創建一個
在這里插入圖片描述

在這里插入圖片描述

創建好以后，再返回Cocos Creator界面，刷新以后，選擇剛剛創建的應用，點擊激活

在這里插入圖片描述

4、創建AppLinking

有兩種方式創建AppLinking一種是直接在AGC界面上創建，另外一個是在Android項目里面用代碼的API接口創建：

4.1 AGC界面創建AppLinking：

（1）界面入口如下：點擊創建AppLinking，然后根據步驟一步一步創建即可。

在這里插入圖片描述

（2）默認的深度鏈接配置，我就直接隨意找了一個華為官網的。注意Android的深度鏈接的配置。
在這里插入圖片描述

（3）安卓鏈接行為，配置為：在Android應用中打開。

在這里插入圖片描述

創建好以后，就可以復制下來使用了

在這里插入圖片描述

4.2 端側代碼創建AppLinking

（1）界面布局：
創建兩個按鈕，一個用來創建AppLinking，一個用來分享AppLinking。在加上一個Label控件來顯示創建的鏈接

在這里插入圖片描述

（2）在代碼里面創建AppLinking鏈接:

先把之前創建的鏈接前綴放到代碼里。

在這里插入圖片描述

創建一個短鏈接：

   buildLink:function() {
        console.log("begin to build Applinking");
        let linkInfo = new huawei.agc.applinking.AppLinking();
        let linkBuilder = new huawei.agc.applinking.Builder();
        linkBuilder.setUriPrefix(PREFIX_URL);
        linkBuilder.setDeepLink(DEEP_LINK);
        linkInfo.setBuilder(linkBuilder);
  
        huawei.agc.applinking.appLinkingService.once(huawei.agc.applinking.AGC_APP_LINKING_EVENT_LISTENER_NAME.BUILD_SHORT_LINK, (data) => {
            if (data.code === 1) {
                console.log('build short link success:', data.data);
                this._shortLink = data.data;
            }
        }, this);
        huawei.agc.applinking.appLinkingService.buildShortLink(linkInfo);
  
    },

將剛剛創建鏈接分享出去：

  sharebutton:function () {
        console.log("this is shortLink: ",this._shortLink);
        huawei.agc.applinking.appLinkingService.shareLink(this._shortLink);
    },

在這里插入圖片描述

5、接收相關AppLinking

　兩個步驟，一個是配置過濾器，一個是配置getAppLinking方法。

（1）配置manifest文件：注意這里是將DeepLink的域名的Scheme配置進去：

例如我的DeepLink是 DEEP_LINK = 'https://consumer.huawei.com/cn/';

那么manifest文件就需要這樣配置

在這里插入圖片描述

（2）在Start的主入口里面，配置getAppLinking，獲取並且顯示鏈接

huawei.agc.applinking.appLinkingService.on(huawei.agc.applinking.AGC_APP_LINKING_EVENT_LISTENER_NAME.RECEIVE_LINK_CALLBACK, (data) => {
            if (data.code === 1) {
                console.log('receive deepLink:', data.getDeepLink());
            }
        }, this);
        
        huawei.agc.applinking.appLinkingService.getAppLinking();

在這里插入圖片描述