快速集成华为AGC-AppLinking服务-Cocos平台

我们应用需要使用跨平台的分享链接，刚好华为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();

在这里插入图片描述