快速集成华为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下面,点击链接前缀页签,点击添加链接前缀,根据需要创建一个现网唯一的前缀。

   系统会自动帮你检测,保证你域名的全网唯一。
快速集成华为AGC-AppLinking服务-Cocos平台_第1张图片

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

   首先需要在Cocos Creator的你的项目里开通AppLinking服务:

(1)在右侧的Service面板找到AppLinking,进去先关联一个应用,

快速集成华为AGC-AppLinking服务-Cocos平台_第2张图片

如果没有应用,需要先去Cocos的控制台先创建一个:按需选择,随便创建一个
快速集成华为AGC-AppLinking服务-Cocos平台_第3张图片

快速集成华为AGC-AppLinking服务-Cocos平台_第4张图片

创建好以后,再返回Cocos Creator界面,刷新以后,选择刚刚创建的应用,点击激活

快速集成华为AGC-AppLinking服务-Cocos平台_第5张图片

4、创建AppLinking

有两种方式创建AppLinking一种是直接在AGC界面上创建,另外一个是在Android项目里面用代码的API接口创建:

4.1 AGC界面创建AppLinking:

(1)界面入口如下:点击创建AppLinking,然后根据步骤一步一步创建即可。

快速集成华为AGC-AppLinking服务-Cocos平台_第6张图片

(2)默认的深度链接配置,我就直接随意找了一个华为官网的。注意Android的深度链接的配置。
快速集成华为AGC-AppLinking服务-Cocos平台_第7张图片

(3)安卓链接行为,配置为:在Android应用中打开。

快速集成华为AGC-AppLinking服务-Cocos平台_第8张图片

创建好以后,就可以复制下来使用了

快速集成华为AGC-AppLinking服务-Cocos平台_第9张图片

4.2 端侧代码创建AppLinking

(1)界面布局:
创建两个按钮,一个用来创建AppLinking,一个用来分享AppLinking。在加上一个Label控件来显示创建的链接

快速集成华为AGC-AppLinking服务-Cocos平台_第10张图片

(2)在代码里面创建AppLinking链接:

  • 先把之前创建的链接前缀放到代码里。

快速集成华为AGC-AppLinking服务-Cocos平台_第11张图片

  • 创建一个短链接:
   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);
    },

快速集成华为AGC-AppLinking服务-Cocos平台_第12张图片

5、接收相关AppLinking

   两个步骤,一个是配置过滤器,一个是配置getAppLinking方法。

(1)配置manifest文件:注意这里是将DeepLink的域名的Scheme配置进去:

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

那么manifest文件就需要这样配置

快速集成华为AGC-AppLinking服务-Cocos平台_第13张图片

(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();

快速集成华为AGC-AppLinking服务-Cocos平台_第14张图片

6、打包测试,查看现象。

(1)应用运行以后,点击Create按钮,创建一个AppLinking链接,查看日志是创建成功的。

快速集成华为AGC-AppLinking服务-Cocos平台_第15张图片

(2)点击Share按钮,将AppLinking链接分享到便签里面暂存,然后,在便签里点击链接,通过浏览器打开。浏览器可以直接打开应用,测试完成。

(从界面上创建的AppLinking也是一样的,可以先复制到便签里面,然后通过便签点击测试)

快速集成华为AGC-AppLinking服务-Cocos平台_第16张图片

(3)相关的日志如下:

快速集成华为AGC-AppLinking服务-Cocos平台_第17张图片

7、总结

   集成简单,SDK依赖体积小,可以实现跨平台的分享,Android和iOS都可以支持,不需要在不同的平台做不同的适配了,节约工作量。

   运营做推广可以再AGC界面上创建,开发做分享功能可以在端侧用代码创建,简直完美。

   欲了解更多详情,请参见:

   华为AGC AppLinking服务开发文档:https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-applinking-introduction

   Cocos 的AppLinking服务开发文档:https://docs.cocos.com/creator/manual/zh/cocos-service/agc-applinking.html


原文链接:
https://developer.huawei.com/consumer/cn/forum/topic/0201406707373400282?fid=0101271690375130218
作者:Jessyyyyy

你可能感兴趣的:(android)