Appy

深度链接

什么是应用签名证书指纹?

一句话解释

应用签名证书指纹是给 Android App 签名的那张证书的 SHA-256 哈希值,写成 32 组用冒号隔开的十六进制字符。Android 用它来准确识别哪个安装包可以代表某个域名,所以 assetlinks.json 把它和包名写在一起。

它标识的是什么

每个 Android App 都要先用证书签名才能安装。指纹是这张证书的一段长度固定的简短摘要。用同一个密钥签名的两个包,指纹相同;用别的密钥签的包,指纹就不同。

对 Android App Links 来说,这就是身份证明。光有包名,谁都能照抄。包名加上指纹,发布在你域名下的 assetlinks.json 里,才等于告诉 Android:这个特定签名的 App 可以打开你的链接。这个字段是一个列表,所以一个文件能覆盖多个密钥。

Play 应用签名的坑

启用 Play 应用签名(Play App Signing)后有两个密钥。你用上传密钥给上传的包签名,Google Play 再用它保管的应用签名密钥,给最终到达用户手机的 App 签名。两个密钥的指纹不一样。

测试时好好的 App Links 到了线上却失效,最常见的原因就在这里。Android 的文档说得很直白:如果用了 Play 应用签名,你在本地运行 keytool 得到的指纹,通常和用户设备上的对不上。debug 包用的又是另一个密钥。文件里如果只写了你自己电脑上的那个指纹,Play 上的包永远通不过验证,链接就在浏览器里打开。

去哪里找正确的指纹

Play 上的包,去 Play Console 的应用签名页面找。那里显示应用签名密钥证书和它的 SHA-256 指纹,按 Android 文档的说法,还有一段现成的 Digital Asset Links 代码。把应用签名密钥下列出的指纹全部复制过来。

自己保管的密钥,运行 keytool -list -v -keystore 加上密钥库文件,看 SHA256 那一行。想知道测试机上实际装的是什么,adb shell pm get-app-links 加包名会打印出 App 的签名,旁边是每个域名的验证状态。先把 Play 的指纹写进文件,如果还想让测试包也能打开链接,再加上上传密钥或 debug 密钥的指纹。

示例SHA-256 证书指纹
14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5

在这里试试

为你的 App 生成文件

填入 Team ID 和 bundle ID,或包名和签名指纹,即可得到可直接放到服务器上的 apple-app-site-association 或 assetlinks.json 文件。

应用

添加所有需要打开这个域名链接的应用。每个应用都会成为 appIDs 中的一项。

  1. 应用 1

    10 位字符,在 Apple Developer 账号的 Membership details 中。

    在 Xcode 的应用 target 中查看,例如 com.example.app。

会打开应用的路径

规则从上到下依次匹配,先匹配到的规则生效,所以排除规则要放在范围更大的规则之前。* 匹配任意数量的字符,? 只匹配一个字符。

  1. 规则 1

    用 & 连接的 name=value 对

其他服务

你的文件

apple-app-site-association

示例。填写你的信息后会被替换。

{
  "applinks": {
    "details": [
      {
        "appIDs": [
          "ABCDE12345.com.example.app"
        ],
        "components": [
          {
            "/": "/*"
          }
        ]
      }
    ]
  }
}

在你的浏览器中生成,不会发送到任何地方。

放在哪里

文件托管位置

  1. 上传到 https://你的域名/.well-known/apple-app-site-association,不要加 .json 扩展名。
  2. 通过 HTTPS 提供,证书有效,直接返回 200,不要重定向。
  3. 返回 Content-Type: application/json 响应头。
  4. 链接中用到的每个主机都要配置:example.com 和 www.example.com 是两个主机,各自需要文件和 applinks: 条目。
  5. Apple CDN 会在 24 小时内抓取新文件。在此期间可以用 ?mode=developer 测试。
用验证工具检查域名

不想自己托管文件?智能链接免费使用;在 Enterprise 套餐中,Appy 会在应用的专属链接域名上提供这两个文件。

免费创建链接
延伸阅读AASA 与 assetlinks.json 生成器填入包名和 SHA-256 指纹,就能得到一份可以直接上传的 assetlinks.json 文件。

常见问题

去哪里查 App 的 SHA-256 指纹?

用户从 Google Play 下载的包,在 Play Console 的应用签名页面,应用签名密钥证书一栏下。自己电脑上的密钥库,运行 keytool -list -v -keystore 加上密钥库文件。启用了 Play 应用签名时,这两个值不一样。

上传密钥和应用签名密钥有什么区别?

上传密钥是你自己的,用来给发往 Play Console 的 bundle 签名。应用签名密钥由 Google Play 保管,用来给下发到设备的 App 签名。Android 核对链接时看的是下发到设备的那个 App,所以 assetlinks.json 里要写应用签名密钥的指纹。

assetlinks.json 里可以写多个指纹吗?

可以。sha256_cert_fingerprints 是一个数组,Android 的文档说,多个指纹可以用来支持 App 的不同版本,比如 debug 包和正式包。把 Play 应用签名密钥和你的 debug 密钥都列上,两种包里链接都能打开。

  • assetlinks.json 文件

    assetlinks.json 是放在域名 /.well-known/ 目录下的 Digital Asset Links 文件,告诉 Android 哪个 App 有权打开这个域名的链接。里面写明 handle_all_urls 关系、包名和签名证书的 SHA-256 指纹。没有它,App Links 通不过验证,链接只会在浏览器里打开。

  • Android 应用链接(App Links)

    Android App Links(Android 应用链接)是 Android 已经验证过归属于你 App 的 https 链接,点击后直接打开 App,不再询问用哪个应用打开。它适用于 Android 6 及以上、装有 Google 服务的设备,需要带 autoVerify 的 intent 过滤器,以及域名下的 assetlinks.json 文件。

  • Bundle ID(包名)

    bundle ID 是标识 iOS App 的唯一字符串,比如 com.example.app。Android 上对应的是应用 ID(application ID),通常叫包名。两者都由你自己选,一般采用反向域名的写法,App 发布之后都不应该再改。Google Play 链接和 assetlinks.json 用的是包名。

查看全部术语

一条链接,搞定 App Store、Google Play 和网站

Appy 免费版提供 4 条链接和对应的二维码:按设备自动跳转 App Store、Google Play、华为应用市场、三星 Galaxy Store 或小米 GetApps,电脑端打开网站。没有广告,不用绑卡。