Android M的App Links实现详解

谷歌2015年的I/O大会上宣布了一个新特性：允许开发者将app和他们的web域名关联。这一举措是为了最小化用户遇到“打开方式”对话框的概率。

比如，我们安装了两个Twitter应用 - 官方的和Falcon Pro。当你在某个地方点击了Twitter URL的时候，你会看到如下的对话框：

但是在安卓M中，如果一个app明确的指定了App链接-这个对话框将不复存在。点击一个链接将立即打开官方的app，没有第三方app的机会，更不会打开一个浏览器。

在上图的例子中，当你点击了那个链接，安卓系统会检查是否有一个app可以处理twitter.com URL，然后跟twitter.com核对哪个app（s）可以处理该域名的链接，这样我们就能避免影响用户。

注意安卓并不会在点击链接的时候才核对这些链接，因此在安卓决定使用哪个app之前并不会有网络阻塞。关于这点后面有更多讨论。

虽然这会使安卓更方便- 多数情况下，你确实希望点击一个链接打开的是最合适的那个app- 但是对于那些喜欢使用第三方app的人来说，似乎是一件坏事。不过这种行为可以在Android M的系统设置中关掉。

app开发者如何实现App Links

实现的细节可以在Android Developers' Preview 网站上找到。

如果你有一个需要处理链接（比如example.com）的app，你应该：

• 有上传文件到example.com根路径的权限，如果没有，你无法让你的app成为这些链接的默认打开方式。
• 在build.gradle文件中设置compileSdkVersion 'android-MNC'。
• 为每个这样的<intent-filter>标签

<intent-filter>
    <data android:scheme="http" />
    ...
</intent-filter>

添加属性android:autoVerify="true"。http也可以是https。

注：这里对filter的写法略去了很多，其实官网（上面的那个链接）有完整的示例：

<activity ...>
    <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="http" android:host="www.android.com" />
        <data android:scheme="https" android:host="www.android.com" />
    </intent-filter>
</activity>

认证是以主机名为单位的而不是以intent filter为单位的，因此从技术上讲，并不需要为每个标签都添加该属性，但是添加了也不会出什么问题。

创建JSON文件

为了能让安卓可以认证，你的app需要被允许使用app链接行为，为此，需要提供一个JSON文件，JSON文件中需要包含app的ID以及APK的公钥证书。

这个文件必须包含一个JSON数组，数组中可以有一个或者多个对象，每个对象对应一个你想认证的app ID:

[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.myapp",
      "sha256_cert_fingerprints": ["6C:EC:C5:0E:34:AE....EB:0C:9B"]
    }
  }
]

比如，你现在有一个com.example.myapp的发行版app，同时还有一个叫com.example.myapp.beta的beta版app，你可以通过在数组中设置两个对象来允许两者都可以接受认证，每个对象带有各自的app ID和公钥值。

注意，这个文件的验证是非常严格的：数组中的每个对象都必须和上面的那个一模一样。在数组中添加了任意其他的对象，或者对象中有额外的属性都会导致整个验证失败。- 即便这个app对象是有效的。

为了防止为同一个构建注册了不同的key，貌似一个app可以指定多个SHA256指纹证书，不管怎样，指纹证书可以通过如下方式获得：

echo | keytool -list -v -keystore app.keystore 2> /dev/null | grep SHA256:

上传JSON文件

创建完文件之后，你需要上传它同时保证它可以使用这个URL访问http://example.com/.well-known/statements.json。

目前这个URL是http的，最终的M版本将只允许通过HTTPS访问该URL。 在第一个M预览版中，重定向到HTTPS，或者任何其他重定向（301，302或者307）貌似都会被忽略并被视为失败。

URL的scheme和<intent-filter>标签中的android:scheme值是互不相干的，即使你有一个只接受HTTPS URLs的filter，认证URL仍然需要通过HTTP访问。

在了解了安卓如何使用这些信息之后，我们来看看如果debug这个过程。

Android M是如何实现App Links的

App链接认证涉及到安卓系统的两个组建：Package Manager和Intent Filter Verifier。

PackageManager是一个无处不在的标准组建 - 它负责验证所安装的apk是否有效，授予app权限，另外还可以通过它知道系统上安装了些什么app。

而Intent Filter Verifier则是Android M上才有的新玩意儿。这个组建负责获取链接指向的JSON认证，解析它，验证它，然后将报告返回给PackageManger。

虽然这个组建不是用户轻易就能替换的，但似乎系统中只能有一个活动状态的Intent Filter Verifier - 想要注册成为一个verifier，必须要有android.permission.INTENT_FILTER_VERIFICATION_AGENT权限，而这个权限只有签名了系统密钥的app才能得到。

你可以通过如下的命令查看当前激活的intent filter verifier：

adb shell dumpsys package ifv

在第一个M预览版中，com.android.statementservice完全扮演了这个角色。

How App Links are verified

App链接认证在安装的时候就一次性完成。这就是为什么刚刚我们说不必在每次点击链接的时候都阻塞网络。

当一个package安装的时候，或者现有的package升级的时候：

• 1.PackageManager对即将安装的apk做常规的验证。
• 2.如果成功，这个package将被安装，同时发出一个带有android.intent.action.INTENT_FILTER_NEEDS_VERIFICATION的广播intent，intent中还携带有该package的信息。
• 3.Intent Filter Verifier的广播接收器将获取这个广播。
• 4.从package的<intent-filter>标签中编译出一个特有主机名的列表。
• 5.verifier尝试从每个特有的主机名中获取statements.json。
• 6.每一个被获取的JSON文件都会检查它的application ID和安装包的证书。
• 7.只有当所有文件同时满足时，才会发送成功信息到PackageManager，否则失败。
• 8.PackageManager存储结果。

如果认证失败，app链接将无法指向你的app - 你的app会像往常一样出现在“打开方式”对话框中（除非另一个app通过了同一域名的验证）。

就我所了解的而言，认证只会在安装和升级的时候会发生，因此对大多数用户来说，再次通过验证的机会是在app下一次升级的时候。

Intent Filter Verifier的行为

主机名

example.com和www.example.com会被认为是两个独立的主机名。因此要求statements.json在两个主机名下都是可直达的。

比如，如果你将所有的请求都重定向到http://www.example.com/ to https://example.com/，则会让这个主机名的认证失败，从而导致整个app链接认证失败。

这种情况下，你可能需要为你的web服务器做特殊的配置，确保每个对于statements.json的请求都有能直接返回HTTP 200。这个约束在后面的版本中可能会有所放松。

响应时间

如果verifier不能在5秒之内和你的web服务器建立链接并接收到HTTP响应，认证会失败。

缺少链接环境

同样的，如果在认证开始的时候设备是离线的，或者网络环境很差，认证也会失败。

HTTP 缓存

目前Intent Filter Verifier的实现基本遵循HTTP缓存规则。

如果你的statements.json响应包含了Cache-Control: max-age=[seconds]头部，那么这个响应将被verifier缓存到磁盘。虽然 60秒以下的'max-age'会被忽略，但是60秒似乎也足够了。同样的一个Expires header 也会被缓存。

如果你有ETag或者最近更新的headers，那么verifier将在下一次视情况使用这些值来验证相应的主机。据我所知，如果这些header子退出之后没有明确指定缓存控制头，那么响应的缓存时间将是不确定的。

缓存头部只理会http 200的响应，如果是一个404响应，那么下次将忽略，verifier需要直接连接主机。

Debugging App Links

当安卓系统试图认证你的app链接时，PackageManager除了向logcat中报告true/false值之外，还有一些其他反馈，比如：

IntentFilter ActivityIntentInfo{1a61a0a com.example.myapp/.MainActivity}
 verified with result:true and hosts:example.com www.example.com

但是，你可在任意时刻向系统查询package的app链接认证状态：

adb shell dumpsys package d

这会返回如下的认证条目信息：

Package Name: com.example.myapp
Domains: example.com www.example.com
Status: always

可能会有多个关于你package的条目：一个是系统的，零个或者多个用户的- 有些用户的偏好覆盖了系统参数。

可能会产生的状态值大致如下：

• undefined —  app没有在manifest中启用链接自动验证功能。

• ask — app验证失败（会通过打开方式对话框询问用户）

• always — app通过了验证（点击这个域名总是打开这个app）

• never — app通过了验证，但是系统设置关闭了此功能。

如果你没能通过认证，你可以再次尝试重新安装同一版本：

adb install -r app/build/outputs/apk/app-debug.apk

如果你在安装的时候没有在服务器上看见statements.json URL的请求，你可以清空Intent Verifier服务的HTTP缓存，这样下次就会直接请求服务器：

adb shell pm clear com.android.statementservice

如果你不知道statements.json的内容是否正确返回，可以使用安卓模拟器的-tcpdump选项来检查网络上发送的是什么 - 注意安卓M最终版出来之后就没那么容易了，因为数据是加密的。

还有一种选择，那就是使用模拟器的-http-proxy选项，让所有的网络请求都通过代理，比如Charles代理。

总结

虽然在开始我担心App Links会取代目前安卓上非常酷的intent机制，但是也乐于看到这对于大多数情况都是有用的，况且如果用户不喜欢，使用简单的方法就可以把它关掉。

考虑到verifier服务对JSON解析和HTTP请求异常严格，希望这里所提到的一些细节对你实现app linking有所帮助。祝你好运！