深度链接
什么是应用签名证书指纹?
一句话解释
应用签名证书指纹是给 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 密钥的指纹。
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
10 位字符,在 Apple Developer 账号的 Membership details 中。
在 Xcode 的应用 target 中查看,例如 com.example.app。
会打开应用的路径
规则从上到下依次匹配,先匹配到的规则生效,所以排除规则要放在范围更大的规则之前。* 匹配任意数量的字符,? 只匹配一个字符。
- 规则 1
用 & 连接的 name=value 对
其他服务
你的文件
apple-app-site-association
示例。填写你的信息后会被替换。
{
"applinks": {
"details": [
{
"appIDs": [
"ABCDE12345.com.example.app"
],
"components": [
{
"/": "/*"
}
]
}
]
}
}在你的浏览器中生成,不会发送到任何地方。
放在哪里
文件托管位置
- 上传到
https://你的域名/.well-known/apple-app-site-association,不要加.json扩展名。 - 通过 HTTPS 提供,证书有效,直接返回 200,不要重定向。
- 返回
Content-Type: application/json响应头。 - 链接中用到的每个主机都要配置:
example.com和www.example.com是两个主机,各自需要文件和applinks:条目。 - Apple CDN 会在 24 小时内抓取新文件。在此期间可以用
?mode=developer测试。
不想自己托管文件?智能链接免费使用;在 Enterprise 套餐中,Appy 会在应用的专属链接域名上提供这两个文件。
免费创建链接常见问题
去哪里查 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,电脑端打开网站。没有广告,不用绑卡。