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

2022-02-14 04:15:27

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

关于集成步骤，官网的资料写的有点多，我总结一下步骤
i. 步骤一：创建应用，开通AppLinking服务

ii. 步骤二：创建一个链接前缀

iii. 步骤三：在Android项目里集成AppLinking SDK；

iv. 步骤四：创建AppLinking

v. 步骤五：接收AppLinking链接并且测试。

1、创建应用，开通AppLinking服务

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

开通好以后，记得去我的项目 -> 项目设置–> 常规下面，下载agconnect-services.json文件到你的Android项目的app路径下。

2、创建一个链接前缀

在刚刚开通的AppLinking下面，点击链接前缀页签，点击添加链接前缀，根据需要创建一个现网唯一的前缀。

系统会自动帮你检测，保证你域名的全网唯一。

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

配置SDK地址，打开Android工程，在项目级build.gradle文件中，配置如下内容

buildscript {
repositories {
//….
        maven {url ‘https://developer.huawei.com/repo/‘}
    }
    dependencies {
        //….
        classpath ‘com.huawei.agconnect:agcp:1.4.1.300‘![在这里插入图片描述](https://img-blog.csdnimg.cn/20201229190623817.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

    }
}
 
allprojects {
    repositories {
//….
        maven {url ‘https://developer.huawei.com/repo/‘}
    }
}

打开应用级的build.gradle文件，配置好AppLinking和华为分析的SDK，配置下面标红的内容即可

…
apply plugin: ‘com.huawei.agconnect‘
 ...
dependencies {
 ...
implementation "com.huawei.agconnect:agconnect-applinking:1.4    
implementation ‘com.huawei.hms:hianalytics:5.0.4.301‘.1.300"
}

4、创建AppLinking

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

4.1 AGC界面创建AppLinking：

1、界面入口如下：点击创建AppLinking，然后根据步骤一步一步创建即可。

2、默认的深度链接配置，我就直接随意找了一个华为官网的。注意Android的深度链接的配置。

3、安卓链接行为，配置为：在Android应用中打开。

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

4.2 端侧代码创建AppLinking

1、在activity_main.xml里面先把界面配置好：整两个按钮，一个创建，一个分享；再创建一个TextView显示框，用来显示AppLinking。

<Button
        android:id="@+id/create"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Create App Linking"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.4" />
 
    <TextView
        android:id="@+id/showLink"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="your App Linking"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.5" />
 
    <Button
        android:id="@+id/shareLink"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Share App Linking"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.8" />

如下图所示：

2、然后把刚刚创建的链接前缀，复制添加到常量，另外再先把需要打开的DeepLink地址配置好。

private static final String DOMAIN_URI_PREFIX = "https://testapplinking1016.drcn.agconnect.link";
 private static final String DEEP_LINK = " https://consumer.huawei.com/cn/";
private static final String Android_DEEP_LINK = "myapp://testapplinking/?data=1016";
 private String shortLink;

2、在MainActivity的OnCreate里面，利用create按钮创建AppLinking

findViewById(R.id.create).setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
                 AppLinking.Builder builder = new AppLinking.Builder()
                         .setUriPrefix(DOMAIN_URI_PREFIX)
                         .setDeepLink(Uri.parse(DEEP_LINK))
                         .setAndroidLinkInfo(new AppLinking.AndroidLinkInfo.Builder()
.setAndroidDeepLink(Android_DEEP_LINK).build());.build());
 
                 builder.buildShortAppLinking().addOnSuccessListener(shortAppLinking -> {
                         shortLink = shortAppLinking.getShortUrl().toString();
                         TextView showAppLinking = findViewById(R.id.showLink);
                         showAppLinking.setText(shortLink);
                 }).addOnFailureListener(e -> {
                         Log.e("AppLinking", "Failure + "+ e.getMessage());
                 });
    }
});

3、在用shareLink按钮将刚刚创建的AppLinking分享出去

findViewById(R.id.shareLink).setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        Intent intent = new Intent(Intent.ACTION_SEND);
        intent.setType("text/plain");
        intent.putExtra(Intent.EXTRA_TEXT, shortLink);
        startActivity(intent);
    }
});

5、接收相关AppLinking

接收的时候有两步操作，一个是需要配置manifest文件，另外一个在链接的入口配置getAppLinking方法：
1、配置manifest文件：注意这里是将DeepLink的域名的Scheme配置进去：
比如我这里的DeepLink是：DEEP_LINK = "myapp://testapplinking/?data=1016";
private static final String DEEP_LINK = "myapp://testapplinking/?data=1016";

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

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:host="testapplinking" android:scheme="myapp" />
</intent-filter>

2、在OnCreate的主入口里面，配置getAppLinking，获取并且显示链接

AGConnectAppLinking.getInstance().getAppLinking(this).addOnSuccessListener(resolvedLinkData -> {
        if (resolvedLinkData != null) {
                 String Result = resolvedLinkData.getDeepLink().toString();
                 TextView showAppLinking = findViewById(R.id.showLink);
                 showAppLinking.setText(Result);
        }
});