Android M App Links: 实现, 缺陷以及解决办法

原文：Android M App Links: implementation, drawbacks and solutions

在上次的I/O大会上，谷歌宣布了Android M 支持app链接（App Links），谷歌正在不遗余力的推动深度链接（deep linking）。这将对Android M的用户体验造成深远的积极影响，用户点击一个web链接就能直接跳转到app。

在Android M之前，点击一个链接会产生一个弹出框，询问用户打开哪个应用－包括浏览器应用。但是谷歌在Android M 实现了一个自动认证（auto-verify）机制，让开发者可以避开这个弹出框，使用户不必去选择一个列表，直接跳转到他们的app。

在app的manifest中添加 auto-verify（左边）并且在web服务器上添加一个statements JSON 文件（右边）就可以让你的web链接打开一个app。

译者注：statements JSON 文件即一个叫statements.json的文件，后面会提到。

要找到谷歌的App Links文档与理解它需要花点时间（你只能搜索“Android M App Links”关键词才能找到）。这个文档目前只是简要的描述了这个话题，但是我们将帮助你详细了解实现的细节，它的缺陷以及如何使用我们的smart links解决这些问题。HOKO的每个客户端目前都已经支持谷歌的App Link，轻松加愉快。

什么是App Links？

谷歌的App Link让用户在点击一个普通web链接的时候可以打开指定app的指定页面，前提是这个app已经安装并且经过了验证，否则会显示一个打开选项的弹出框。自此，在安卓中打开一个链接的用户体验大大提高，用户可以在链接与app之间快速切换。

比如，点击谷歌关于食谱的移动搜索结果或者一个别人发来的食谱链接会直接导航你到与该链接域名相关的app的食谱页面。

而点击一条推特的web链接会直接带你到Twitter应用的相关推文页面。

注：用页面形容app的屏貌似也不太准确哈～

web链接可以在任意地方发送，发布，或者打开，因为他们就是普通的链接，而且如果出现了什么错误，则会像平常一样用浏览器打开这个web页面。

实现App Links其实非常简单，但是首先你需要保证满足一些列需求：

有一个注册了的域名
域名的SSL通道
具有上传JSON文件到域名的能力
Android Studio 1.3 Preview (download)
Gradle 版本 — com.android.tools.build:gradle:1.3.0-beta3
设置 compileSdkVersion 为 android-MNC
buildToolsVersion — 23.0.0 rc2

如果以上要求全都满足，只需按照以下三步就可以让App Links 工作在你的app上。

1. 在app中激活App links

让我们通过告诉安卓系统去验证app与域名之间的关系来激活App Links 吧。从此不再又任何的弹出框，因为我们已经在app中注册了该域名。找到AndroidManifest.xml文件，在处理深度链接路由的activity（第三步将讲解如何创建这样的Activity）中添加android:autoVerify="true"到intent-filter：

<activity  
  android:name="com.your.app.activity.ParseDeepLinkActivity"
  ...>
  <intent-filter android:autoVerify="true">
    <data android:scheme="http" android:host="yourdomain.com" />
    <data android:scheme="https" android:host="yourdomain.com" />
    ...
  </intent-filter>
</activity>

这个配置告诉安卓去验证一个文件，这个文件地址是https://yourdomain.com/.well-known/statements.json。如果存在这个文件，同时验证成功，那么用户点击该域名之下的链接时，就可以直接到app，弹出框就可以避免。否则app就没有成为默认选项，弹出框就会呈现给用户。下一步，我们将学会如何构建这个文件。

2. 上传web-app关联文件（statements.json）

基于安全的原因，这个文件必须通过SSL的GET请求获得。你可以代开一个文本编辑器，然后写入如下形式的JSON：

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

可以在AndroidManifest.xml 文件中找到app的package name。你还需要通过在终端中执行ava keytool 产生一个sha256指纹：

keytool -list -v -keystore /path/to/app/release-key.keystore

你需要向keystore添加持有app release keys的 app路径。这个路径依赖于项目设置，因此不同的app是不同的。可以在谷歌的文档中找到更多关于如何找到keystore的信息。

最后，上传这个文件到服务器的/.well-known/statements.json。为了避免今后每个app链接请求都访问网络，安卓只会在app安装的时候检查这个文件。如果你能在请求https://yourdomain.com/.well-known/statements.json 的时候看到这个文件（替换成自己的域名哈），那么可以继续下一步了。

注：目前可以通过http获得这个文件，但是在M最终版里则只能通过HTTPS验证。确保你的web站点支持HTTPS请求。

3. 在app中处理深度链接

到现在，如果你已经有了一个处理深度链接的activity，那么我们已经准备好处理app links了。

如果没有，你需要创建一个能处理深度链接的activity。这个activity的目的是为了实现一种这样的机制：负责捕获与解析深度链接，同时转发用户到正确的视图。

<activity
  android:name="com.your.app.activity.ParseDeepLinkActivity"
  android:alwaysRetainTaskState="true"
  android:launchMode="singleTask"
  android:noHistory="true"
  android:theme="@android:style/Theme.Translucent.NoTitleBar">
  
  <intent-filter android:autoVerify="true">
    <data android:scheme="http" android:host="yourdomain.com" />
    <data android:scheme="https" android:host="yourdomain.com" />
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
  </intent-filter>
</activity>

AndroidManifest.xml by GitHub

public class ParseDeepLinkActivity extends Activity {
  public static final String PRODUCTS_DEEP_LINK = "/products";
  public static final String XMAS_DEEP_LINK = "/campaigns/xmas";
  
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);
 
    // Extrapolates the deeplink data
    Intent intent = getIntent();
    Uri deeplink = intent.getData();
 
    // Parse the deeplink and take the adequate action 
    if (deeplink != null) {
      parseDeepLink(deeplink);
    }
  }
  
  private void parseDeepLink(Uri deeplink) {
    // The path of the deep link, e.g. '/products/123?coupon=save90'
    String path = deeplink.getPath();
 
    if (path.startsWith(PRODUCTS_DEEP_LINK)) {
      // Handles a product deep link
      Intent intent = new Intent(this, ProductActivity.class);
      intent.putExtra("id", deeplink.getLastPathSegment()); // 123
      intent.putExtra("coupon", deeplink.getQueryParameter("coupon")); // save90
      startActivity(intent);
    } else if (XMAS_DEEP_LINK.equals(path)) {
      // Handles a special xmas deep link
      startActivity(new Intent(this, XmasCampaign.class));
    }  else {
      // Fall back to the main activity
      startActivity(new Intent(context, MainActivity.class));
    }
  }
}

ParseDeepLinkActivity.java hosted with ❤ by GitHub

让我们先从在AndroidManifest.xml 文件中添加名为ParseDeepLinkActivity的activity开始。安卓系统会在每次存在一个https://yourdomain.com开头的深度链接时调用这个activity。

注意yourdomain.com 与 www.yourdomain.com 被看成两个不同的域名，因此你需要为每个域名添加一对http/https：

<data android:scheme="http" android:host="yourdomain.com" />  
<data android:scheme="https" android:host="yourdomain.com" />  
<data android:scheme="http" android:host="www.yourdomain.com" />  
<data android:scheme="https" android:host="www.yourdomain.com" />

当这个activity创建的时候，我们调用getIntent()获得它的intent并调用getData()获得这次调用的URI。然后，我们把这个URI传递到一个匹配路径与行为的方法中。

在此例子中，我们有一个/products 的路径以及一个 /campaigns/xmas/路径。

对于前者，我们需要接续URI并检查URI引用的是哪个产品，最后让用户转向负责显示产品新的的视图。我们使用deeplink.getLastPathSegment()来获取产品的id（路径的最后一个参数），使用getQueryParameter("coupon") 来检查是否有coupon参数。最后一步则是触发显示产品的activity。

而对于后面一个，则只是简单的调用处理 xmas campaign逻辑的activity。你可以尝试执行下面的命令测试这个activity：

$ adb shell am start
        -W -a android.intent.action.VIEW
        -d "https://yourdomain.com/products/123?coupon=save90" com.example.android

这应该会打开模拟器活着设备上的app，并调用ParseDeepLinkActivity来接续链接。确保现在你的网站上存在web-app 关联文件。

App Links的缺陷

App Links是开发者的一大福音，但是也有几个让你犹豫不决的缺陷：

App Links只能工作在谷歌的Android M上

在配置好了app对App Links的支持之后，只有运行Android M的用户才能体验到这项技术的好处。之前安卓版本的用户无法直接点击链接进入app，而是回到浏览器的web页面。

但是HOKO为Android 1.6之后的设备提供了移动深度链接。自此你的深度链接将可以在几乎所有的安卓设备上工作，即使它们并没有运行Android M。

要使用App Links开发者必须维护一个与app相关联的网站

这对于那些小型开发者而言是个坏消息，因为他们没有能力为app维护一个网站，但是它们仍然希望通过web链接获得流量。

HOKO 就是解决这个问题的办法，因为它扮演着开发者网站的角色，每个app维护在不同的子域名下。这样，开发者只需创建smart link并发布他们的URL，每个URL将无缝的打开相应的app。

app与网站的关联是通过开发者网站下的一个配置文件实现的

有了HOKO，你可以跳过这烦人的一步，因为我们已经实现。而且，我们的服务器在安全和性能方面都是业内顶尖的配置，可以为这个配置提供更快速的服务。

要让你的app支持深度链接，学些更多关于HOKO的知识。

另外，还可以查看我们的Apple's Universal Links 详细指南！