Android 中如何使用 App Links

Android 中如何使用 App Links
1. 简介

什么是 App Links呢？App Links 是 Android 6.0 (API 级别23) 引入的新功能，它是基于 DeepLinking，允许应用自动处理网站的 URL，而无需提示用户启动相应的应用。

例如：如果你在手机浏览器中输入了某个网站，而你的应用已经支持了那个网站，那么操作系统会直接打开你的手机应用，而并不是浏览器打开网站的网页。

2. DeepLinks

了解 App Links 之前，我们需要了解一下 DeepLinks，因为上面已经聊过了 App Links 是基于 DeepLinks。 DeepLinks 简单来说，就是能够在网页上跳转进入 App 某个功能页面的技术。也比较简单，现在带大家来做一个：

首先我们定义一个简单的 Activity，然后在 AndroidManifest.xml 中配置：
```
        <activity android:name="com.xing.jnigo.DeepLinksUI" android:exported="true">
            <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:scheme="mydeeplink"
                      android:host="open.my.application"/>
            intent-filter>
        activity>

1
2
3
4
5
6
7
8
9
10
11
12
```
在这里， ”mydeeplink“ 是我定义的方案名称，”open.my.application“ 是我自定义的主机名称。当其它 app 或者 web 页面跳转时，需要这样使用 url scheme：

mydeeplink://open.my.application

在 DeepLinksUI中，我们还可以在 onCreate() 或者 onNewIntent() 方法中获取从其它应用传输过来的数据：
```
public class DeepLinksUI extends AppCompatActivity {

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.deep_links_ui_layout);

        Uri data = this.getIntent().getData();
        if (data != null) {
            Log.i("MyApp", "data: " + data);
        }
        
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
```
3. 测试 DeepLinks 是否有效

首先安装已经写好的的 App 到手机中，此时我们可以写一个网页，内容如下：
```
<html>
  	<title>测试DeepLinkstitle>
  	
  	 <body>
  			<a href='mydeeplink://open.my.application'>点击我进入appa>     
	  body>
  
html>
1
2
3
4
5
6
7
8
```
然后部署在服务器上，让App去访问，尝试点击上面的超链接，查看是否能打开我们的目标App。

当然，这么做比较麻烦，那么有没有稍微不那么麻烦的方法么？当然有了，我们可以直接使用 adb 工具测试即可。

在控制台，输入以下 adb 命令：

adb shell am start -W -a android.intent.action.VIEW -d “mydeeplink://open.my.application?name=Tom&age=20”

然后我们可以看到启动日志：

可以看到页面已经启动成功了，那么就说明我们自定义的 DeepLinks 成功匹配到目标 Activity.

4. App Links

如果你对 DeepLinks 有了解，那么 App Links 就会非常容易，首先我们修改一下 AndroidManifest.xml 的配置，使得它能适配 App Links:
```
<activity android:name="com.xing.jnigo.DeepLinksUI" android:exported="true">
     <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:scheme="mydeeplink"
                      android:host="open.my.application"/>
     intent-filter>

     <intent-filter android:autoVerify="true">
                <action android:name="android.intent.action.VIEW" />

                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />

                <data android:scheme="https"
                    android:host="www.myapplication.com"/>
            intent-filter>

      activity>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
```
这里我重新定义了一个 intent-filter，修改了其 scheme 和 host；当然这里也需要添加一个 autoVerify=“true” 属性，它表示的意思是如果应用安装时设备链接到网络，系统会自动去尝试验证相应的网站 URL。

5. 为网站创建 Digital Asset Links 文件

此时，我们需要在我们网站（例如 www.myapplication.com/.well-konow/）中添加一个 json 格式的 assetlinks.json 文件。

文件格式如下：
```
[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.xing.jnigo",
    "sha256_cert_fingerprints":
    ["FA:2A:03:CB:38:9C:F3:BE:28:E3:CA:7F:DA:2E:FA:4F:4A:96:3B:DF"]
  }
}]
1
2
3
4
5
6
7
8
9
```
你现在需要改的地方有两个
1. package_name 需要你修改成你自己的包名；
2. sha256_cert_fingerprints 需要获取你的apk 的sha-256签名
tips 确认你的网站启用了https，默认情况下，Digital Asset Links 仅支持 https 的网站。

正常情况下了，你在手机浏览器访问：

https://www.myapplication.com

即可打开你的app。

6. 使用 App Links Assistant 验证你的 App Links

当然，如果手头暂时没有可用的网站，但是又想验证一下你的 App Links 是否配置正常，那么就可以使用 Android Studio 自带的 App Links Assistant 来验证了。
1. 在Android Studio中打开 “App Links Assistant”：点击 “Tools” > “App Links Assistant”。
1. 在 “App Links Assistant” 窗口中选择 “Open URL Mapping Editor”，然后点击 “Add” 在当前 Activity 上添加 URL。
1. 填入你的 URL 模式，例如 https://www.myapplication.com，点击 “OK”。
2. 在 “App Links Assistant” 窗口中，选择 “Test App Links”。
1. 在“Test URLs”区域中，输入你想测试的网址，如 https://www.myapplication.com`，然后点击 “Run Test”
可以看到，这个url成功适配，说明成功了。

7. www.myapplication.com 、assetlinks.json 和 App 之间的关系

首先，假设我们从手机浏览器中输入 “https://www.myapplication.com”, 那么会有如下逻辑：
1. 浏览器读取这个 URL ，发现这是一个自定义的 URL Scheme，于是就去询问 Android 系统有没有能处理这个 URL 的应用。
2. Android 系统查看所有的 App，如果有与之匹配的 intent-filter（就是你在 AndroidManifest.xml 中定义的），那么 Android 系统就知道该 App 能够处理这个 URL。如果有多个 App 能够处理，那么就会弹出一个对话框让用户选择哪一个 App 可以打开。
3. 在 Android 6.0（API 级别 23）以后，Google 提供了更好的解决方案，将一些 URL 直接映射到你的 App，而不出现选择对话框，这就是 App Links。
4. 当设置了 App Links 后，Android 系统在上述的第2步时会进行一些额外的步骤来看是否存在一个确定的 App 来打开这个 URL。它会去查看所有匹配的 App 是否设置了 android:autoVerify="true", 如果设置了，系统就会去这个 App 对应的网站检查 assetlinks.json 文件。
5. 当访问到 assetlinks.json 中，系统会比较文件中声明的 package_name 和 sha256_cert_fingerprints 是否与想要接收的 App 是否匹配，如果匹配，那么下一步；否则不能直接打开应用，而是选择直接在浏览器中打开。
6. 在 assetlinks.json 中，你声明了你的 App 拥有某个 URL 的所有权(relation)。系统就会根据这个文件决定哪个 App 能打开这个 URL（如果有多个都声明了所有权，那么还是会出现选择对话框，这个和 DeepLink 的选择是不同的对话框）。
7. 一旦系统决定了哪个 App 能打开这个 URL，你的 App 就会被唤醒，你在 onCreate 方法或 onNewIntent 方法中就能收到这个 Intent 和对应的数据。
总的来说，DeepLink 通过定义 intent-filter 来匹配 URL 并唤醒你的 App，App Links 在这基础上添加了所有权验证，使得一些 URL 可以直接映射到你的 App 而无需用户选择。
相关阅读:
用最少的代码模拟gRPC四种消息交换模式
 深入理解ThreadLocal源码
 【多目标优化算法】基于帕累托包络（PESA-II）的选择算法（Matlab代码实现）
Fasttext解读(1)
Fastlane 一键打包/发布APP - 使用记录及踩坑
 JS内置对象Math和String
11月16日，每日信息差
 设计模式笔记之装饰器模式(结构型)
Qt的WebEngineView加载网页时出现Error: WebGL is not supported
触发器简单解释
原文地址：https://blog.csdn.net/u013762572/article/details/134043077

1. 简介

2. DeepLinks

3. 测试 DeepLinks 是否有效

4. App Links

5. 为网站创建 Digital Asset Links 文件

tips 确认你的网站启用了https，默认情况下，Digital Asset Links 仅支持 https 的网站。

6. 使用 App Links Assistant 验证你的 App Links

7. www.myapplication.com 、assetlinks.json 和 App 之间的关系