---
title: "什么是应用签名证书指纹（SHA-256）？ · Appy"
description: "SHA-256 指纹标识的是给 Android App 签名的证书。去哪里查，assetlinks.json 为什么要写它，Play 应用签名的坑在哪里。"
source: "https://appy.to/zh/glossary/app-signing-fingerprint"
---

1.  [首页](https://appy.to/zh)
2.  [术语表](https://appy.to/zh/glossary)
3.  应用签名证书指纹（SHA-256）

深度链接

# 什么是应用签名证书指纹？

一句话解释

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

用 AI 总结[ChatGPT](https://chatgpt.com/?q=%E8%AF%B7%E6%80%BB%E7%BB%93%E8%BF%99%E4%B8%AA%E9%A1%B5%E9%9D%A2%E5%B9%B6%E5%88%97%E5%87%BA%E8%A6%81%E7%82%B9%EF%BC%9A%20https%3A%2F%2Fappy.to%2Fzh%2Fglossary%2Fapp-signing-fingerprint) [Claude](https://claude.ai/new?q=%E8%AF%B7%E6%80%BB%E7%BB%93%E8%BF%99%E4%B8%AA%E9%A1%B5%E9%9D%A2%E5%B9%B6%E5%88%97%E5%87%BA%E8%A6%81%E7%82%B9%EF%BC%9A%20https%3A%2F%2Fappy.to%2Fzh%2Fglossary%2Fapp-signing-fingerprint) [Perplexity](https://www.perplexity.ai/search?q=%E8%AF%B7%E6%80%BB%E7%BB%93%E8%BF%99%E4%B8%AA%E9%A1%B5%E9%9D%A2%E5%B9%B6%E5%88%97%E5%87%BA%E8%A6%81%E7%82%B9%EF%BC%9A%20https%3A%2F%2Fappy.to%2Fzh%2Fglossary%2Fapp-signing-fingerprint)

## 它标识的是什么

每个 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 文件。

iOSapple-app-site-associationAndroidassetlinks.json

### 应用

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

1.  应用 1

Team ID

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

Bundle ID

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


再添加一个应用

### 会打开应用的路径

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

所有路径示例：Appy 自己的规则SendGrid 邮件链接Amazon SES 邮件链接

1.  规则 1

在应用中打开排除

路径 (/)

查询参数 (?)

用 & 连接的 name=value 对

片段 (#)

注释


添加规则

### 其他服务

添加 webcredentials这样密码自动填充就能在你的应用里提供为这个网站保存的密码。

添加 appclips让这个域名可以启动你的 App Clip。

你的文件

apple-app-site-association

复制下载

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

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

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

## 放在哪里

文件托管位置

你的网站SendGridBrazeKlaviyo

你的域名（可选）

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` 测试。

[用验证工具检查域名](https://appy.to/zh/tools/universal-link-validator)

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

[免费创建链接](https://appy.to/zh/account/register)

[延伸阅读AASA 与 assetlinks.json 生成器填入包名和 SHA-256 指纹，就能得到一份可以直接上传的 assetlinks.json 文件。](https://appy.to/zh/tools/aasa-assetlinks-generator)

## 常见问题

### 去哪里查 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 文件](https://appy.to/zh/glossary/assetlinks-json)

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

-   [Android 应用链接（App Links）](https://appy.to/zh/glossary/android-app-links)

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

-   [Bundle ID（包名）](https://appy.to/zh/glossary/bundle-id)

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


[查看全部术语](https://appy.to/zh/glossary)

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

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

[免费创建链接](https://appy.to/zh/account/register)
