快速集成华为AGC-AppLinking服务-Android平台
<p>最近，我的应用需要使用跨平台的分享链接，刚好华为AppGallery Connect的AppLinking服务满足我的使用场景。</p><p>关于集成步骤，官网的资料写的有点多，我总结一下步骤<br>
i. 步骤一：创建应用，开通AppLinking服务</p>
<p>ii. 步骤二：创建一个链接前缀</p>
<p>iii. 步骤三：在Android项目里集成AppLinking SDK；</p>
<p>iv. 步骤四：创建AppLinking</p>
<p>v. 步骤五：接收AppLinking链接并且测试。</p>
<h2 id="1创建应用开通applinking服务">1、创建应用，开通AppLinking服务</h2>
<p>在AGC控制台，创建应用， 或者使用已有的应用，在界面上找到 我的项目 -> 增长–>AppLinking，点击立即开通 。</p>
<p><img src="https://img-blog.csdnimg.cn/20201229190330296.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p>开通好以后，记得去 我的项目 -> 项目设置–> 常规 下面，下载agconnect-services.json文件到你的Android项目的app路径下。</p>
<p><img src="https://img-blog.csdnimg.cn/20201229190353390.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<h2 id="2创建一个链接前缀">2、创建一个链接前缀</h2>
<p>在刚刚开通的AppLinking下面，点击链接前缀页签，点击添加链接前缀，根据需要创建一个现网唯一的前缀。</p>
<p>系统会自动帮你检测，保证你域名的全网唯一。</p>
<p><img src="https://img-blog.csdnimg.cn/20201229190426428.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p><img src="https://img-blog.csdnimg.cn/20201229190441966.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<h2 id="3在android项目里面集成applinking-sdk">3、在Android项目里面集成AppLinking SDK</h2>
<p>配置SDK地址，打开Android工程，在项目级build.gradle文件中，配置如下内容</p>
<pre><code class="language-java">buildscript {
repositories {
//….
maven {url 'https://developer.huawei.com/repo/'}
}
dependencies {
//….
classpath 'com.huawei.agconnect:agcp:1.4.1.300'
}
}
allprojects {
repositories {
//….
maven {url 'https://developer.huawei.com/repo/'}
}
}
</code></pre>
<p>打开应用级的build.gradle文件，配置好AppLinking和华为分析的SDK，配置下面标红的内容即可</p>
<pre><code class="language-java">…
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"
}
</code></pre>
<h2 id="4创建applinking">4、创建AppLinking</h2>
<p>有两种方式创建AppLinking: 一种是直接在AGC界面上创建，另外一个是在Android项目里面用代码的API接口创建。</p>
<h3 id="41-agc界面创建applinking">4.1 AGC界面创建AppLinking：</h3>
<p>1、界面入口如下：点击创建AppLinking，然后根据步骤一步一步创建即可。</p>
<p><img src="https://img-blog.csdnimg.cn/20201229190852625.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p>2、默认的深度链接配置，我就直接随意找了一个华为官网的。注意Android的深度链接的配置。</p>
<p><img src="https://img-blog.csdnimg.cn/20201229191001843.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p>3、安卓链接行为，配置为：在Android应用中打开。</p>
<p><img src="https://img-blog.csdnimg.cn/20201229191024342.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p>创建好以后，就可以复制下来使用了</p>
<p><img src="https://img-blog.csdnimg.cn/20201229191229290.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<h3 id="42-端侧代码创建applinking">4.2 端侧代码创建AppLinking</h3>
<p>1、在activity_main.xml里面先把界面配置好：整两个按钮，一个创建，一个分享；再创建一个TextView显示框，用来显示AppLinking。</p>
<pre><code class="language-java"><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" />
</code></pre>
<p>如下图所示：</p>
<p><img src="https://img-blog.csdnimg.cn/20201229191427450.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p>2、然后把刚刚创建的链接前缀，复制添加到常量，另外再先把需要打开的DeepLink地址配置好。</p>
<pre><code class="language-java">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;
</code></pre>
<p><img src="https://img-blog.csdnimg.cn/2020122919162911.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p>2、在MainActivity的OnCreate里面，利用create按钮创建AppLinking</p>
<pre><code class="language-java">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());
});
}
});
</code></pre>
<p>3、在用shareLink按钮将刚刚创建的AppLinking分享出去</p>
<pre><code class="language-java">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);
}
});
</code></pre>
<p><img src="https://img-blog.csdnimg.cn/20201229191838696.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<h2 id="5接收相关applinking">5、接收相关AppLinking</h2>
<p>接收的时候有两步操作，一个是需要配置manifest文件，另外一个在链接的入口配置getAppLinking方法：<br>
1、配置manifest文件：注意这里是将DeepLink的域名的Scheme配置进去：<br>
比如我这里的DeepLink是：DEEP_LINK = "myapp://testapplinking/?data=1016";<br>
private static final String DEEP_LINK = "myapp://testapplinking/?data=1016";</p>
<p>那么manifest文件就需要这样配置</p>
<pre><code class="language-java"><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>
</code></pre>
<p><img src="https://img-blog.csdnimg.cn/20201229192001664.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p>2、在OnCreate的主入口里面，配置getAppLinking，获取并且显示链接</p>
<pre><code class="language-java">AGConnectAppLinking.getInstance().getAppLinking(this).addOnSuccessListener(resolvedLinkData -> {
if (resolvedLinkData != null) {
String Result = resolvedLinkData.getDeepLink().toString();
TextView showAppLinking = findViewById(R.id.showLink);
showAppLinking.setText(Result);
}
});
</code></pre>
<p><img src="https://img-blog.csdnimg.cn/20201229192043810.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<h2 id="6打包测试查看现象">6、打包测试，查看现象。</h2>
<p>1、应用运行以后，点击Create按钮，创建一个AppLinking链接，显示在界面上。</p>
<p><img src="https://img-blog.csdnimg.cn/20201229192129455.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p><img src="https://img-blog.csdnimg.cn/20201229192145120.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p>2、点击Share按钮，将AppLinking链接分享到便签里面暂存，然后，在便签里点击链接，通过浏览器打开。浏览器可以直接打开应用，测试完成。</p>
<p>（从界面上创建的AppLinking也是一样的，可以先复制到便签里面，然后通过便签点击测试）</p>
<p>欲了解更多详情，请参见：</p>
<p> https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-applinking-introduction</p>
<p><img src="https://img-blog.csdnimg.cn/20201229192238899.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p><img src="https://img-blog.csdnimg.cn/20201229192301578.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<p><img src="https://img-blog.csdnimg.cn/20201229192322647.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<h2 id="7总结">7、总结</h2>
<p>集成简单，SDK依赖体积小，可以实现跨平台的分享，Android和iOS都可以支持，不需要在不同的平台做不同的适配了，节约工作量。</p>
<p>运营做推广可以再AGC界面上创建，开发做分享功能可以在端侧用代码创建，简直完美。</p>
<p>参考文档：</p>
<p>华为AGC AppLinking服务开发文档：https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-applinking-introduction</p>
<hr>
<p>原文链接：https://developer.huawei.com/consumer/cn/forum/topic/0204406653695530273?fid=0101271690375130218</p>
<p>原作者：Jessyyyyy</p><br><br>
来源：https://www.cnblogs.com/developer-huawei/p/14208434.html
頁:
[1]