Unity平台 | 快速集成华为AGC AppLinking服务

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

我们应用需要使用跨平台的分享链接，刚好华为AppGallery Connect的AppLinking服务满足我们的使用场景。

关于集成步骤，官网的资料写的有点多，我总结一下步骤：

创建应用，开通AppLinking服务并且创建链接签注。
在Unity项目里集成AppLinking SDK。
在Unity里导入HuaweiService的package。
创建AppLinking。
接收AppLinking链接并且测试。

1、开通AppLinking服务& 创建链接前缀

1、在AGC控制台，创建应用，或者使用已有的应用），在界面上找到 我的项目 -> 增长–>AppLinking，点击立即开通 。

2、在刚刚开通的AppLinking下面，点击链接前缀页签，点击添加链接前缀，根据需要创建一个现网唯一的前缀。
系统会自动帮你检测，保证你域名的全网唯一。

2、在unity项目里面集成AppLinking SDK

首先需要在unity项目里开通配置好安卓环境：
1、在Edit-Project Setting-Player-Publish Setting中启用Android的自定义清单和gradle

注意：进行此步操作前需要先在Unity Hub中安装Android编译依赖。如下图：

2、在AGC我的项目 -> 项目设置–> 常规下面，下载agconnect-services.json文件到你的unity项目的Assets / Plugins / Android路径下。

3、在Other Setting中配置包名：注意需要和AGC官网的包名保持一致：

4、配置项目级gradle，此处对应Assets\Plugins\Android路径下的baseProjectTmeplate.gradle文件，添加如下内容

allprojects {
        buildscript {
            repositories {
                maven { url 'https://developer.huawei.com/repo/' }
            }
        }
        repositories {
 
            maven { url 'https://developer.huawei.com/repo/' }
        }
    }

5、配置应用级gradle，此处对应Assets\Plugins\Android路径下的LauncherTmeplate.gradle文件，添加如下内容：

dependencies {
    implementation 'com.huawei.agconnect:agconnect-applinking:1.4.1.300'
}

3、在Unity里导入HuaweiService的package；

1、先将对应的package导入到工程里：可以直接在unity的window-asset-store中，直接搜索huawei，下载获取。或者可以直接使用此链接下载：

2、下载完成后，在Unity中点击assets – Import package，然后，然后选择需要的包，点击Import即可

4、创建AppLinking

有两种方式创建AppLinking一种是直接在AGC界面上创建，另外一个是在unity项目里面用代码的API接口创建：下面就只介绍在Unity 项目中创建了。

1、创建按钮

点击GameObject- UI –Button创建两个按钮：按钮Text分别为create和share，点击按钮，然后在右侧选择 Add Component，创建并且添加一个Script文件。

2、添加创建链接的方法：

在testapp的Script文件中，并且添加如下方法：

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using HuaweiService.AppLinking;
using HuaweiService;
 
public class testApp : MonoBehaviour
{
    private const string URI_PREFIX = "https://testcocos1203.drcn.agconnect.link";
    private const string DEEP_LINK = "https://developer.huawei.com/consumer/cn/service/josp/agc/index.html";
 
void Start()
    {
        
    }
 
    void Update()
    {
        
    }
 
public void createLongLink() {
        AGConnectAppLinking.getInstance();
        AppLinking.Builder builder = createBuilder();
        Uri applinkingUri = builder.buildAppLinking().getUri();
        var link = applinkingUri.toString();
        Debug.Log ("AppLinking create" + link);
        GUIUtility.systemCopyBuffer = link;
    }
 
    public AppLinking.Builder createBuilder(){
        return AppLinking.newBuilder()
        .setUriPrefix(URI_PREFIX)
        .setDeepLink(Uri.parse(DEEP_LINK))
        .setAndroidLinkInfo(
            AppLinking.AndroidLinkInfo.newBuilder()
            .build());
    }
 
    public void OpenLink()
    {
        var activity = new Activity();
        var intent = new Intent();
        intent.setData(Uri.parse(GUIUtility.systemCopyBuffer));
        activity.startActivity(intent);
     }
}

3、方法与按钮绑定：

回到Unity界面，点击按钮，然后在按钮右侧找到click，添加对应的控件：

同样的方法，为share按钮也添加按钮方法。

注意：可以将create按钮创建的.cs文件拖动到share按钮右侧面板的“add component”区域进行复用，添加click事件。

5、接收相关AppLinking

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

1、 配置manifest文件：注意这里是将DeepLink的域名的Scheme配置进去：

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

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

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

1、应用运行以后，点击Create按钮，创建一个AppLinking链接，然后点击share按钮，将按钮分享到浏览器。

2、此时浏览器可以直接拉起应用，表示链接使用正常。

7、总结

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

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

参考文档：

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

Unity的AppLinking服务开发文档： https://docs.unity.cn/cn/Packages-cn/[email protected]/manual/applinking.html#integrating-huawei-analytics-kit

Unity Editor安装和Apk打包：https://developer.huawei.com/consumer/cn/forum/topic/0204405811539110247?fid=18

原文链接：https://developer.huawei.com/consumer/cn/forum/topic/0201428957991340017?fid=0101271690375130218

原作者：Mayism