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

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

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

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

iii. 步骤三:在Android项目里集成AppLinking SDK;

iv. 步骤四:创建AppLinking

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

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

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

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

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

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

2、创建一个链接前缀

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

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

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

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

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,然后根据步骤一步一步创建即可。

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

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

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

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

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

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

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

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" />

如下图所示:

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

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;

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

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

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

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>

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

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

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

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

1、应用运行以后,点击Create按钮,创建一个AppLinking链接,显示在界面上。

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

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

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

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

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

https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-applinking-introduction

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

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

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

7、总结

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

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

参考文档:

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


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

原作者:Jessyyyyy

你可能感兴趣的:(android)