应用签名与密钥——通往Google Play的第一把锁

签名，说白了就是给你的App贴上一张独一无二的数字身份证。每次上传到Google Play，平台都通过这张证来判断：这个APK/AAB到底是不是你发的。我刚开始接手一个老项目时，连密钥文件都找不到，只能重新生成一个——结果所有用户的旧版本和新版本签名不一致，更新都上不了。那之后我才真正理解签名的分量。

为什么应用需要签名？

• 身份验证——证明这个安装包出自你手，不是别人冒名顶替的。
• 完整性校验——签名一旦被篡改，安装时就报错，防中间人改包。
• 更新权限——只有使用同一签名密钥的版本，才能覆盖安装更新。换个签名，系统就当成两个不同的App。
• 应用市场准入——Google Play要求每个App必须用同一个签名密钥持续更新。

你可能觉得签名就是跑个命令的事。但请注意：签名密钥一旦丢失或泄露，后果非常严重。我个人习惯把密钥文件和密码分别存在两个安全的地方，比如公司密码箱加个人加密U盘。

生成签名密钥——你的数字身份

Android官方推荐用 keytool 命令来生成。打开终端或命令行，敲下面这条命令：

keytool -genkey -v -keystore my-release-key.jks \
        -alias my-alias \
        -keyalg RSA \
        -keysize 2048 \
        -validity 10000

解释一下各个参数的意思：

执行过程中会要求你填写姓名、组织、城市等信息，还有最重要的——密钥库密码和密钥密码。这两个密码最好不同，且长度至少12位，包含大小写和数字。我曾经因为偷懒设了个简单密码，结果项目换了个人维护，密码忘了……最后只能重新发版。嗯，教训深刻。

配置应用签名——让安装包带上你的指纹

有两种方式：

方式一：Android Studio 图形界面签名

1. 菜单栏 → Build → Generate Signed Bundle / APK
2. 选择 Android App Bundle 或 APK（推荐Bundle）
3. 选择已有keystore或新建
4. 填写密码和别名，点Next完成签名

这种方式适合手动打包，但自动化构建时就不方便了。

方式二：通过 Gradle 配置（推荐）

在项目 app/build.gradle 的 android 块中加上 signingConfigs：

android {
    signingConfigs {
        release {
            storeFile file("../keystore/my-release-key.jks")
            storePassword "你的密码"
            keyAlias "my-alias"
            keyPassword "你的密钥密码"
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
            // 其他配置...
        }
    }
}

配置完成后，执行 ./gradlew assembleRelease 就会自动签名。你可以在 app/build/outputs/ 下找到签名后的产物。

密钥安全与Google Play App Signing

这里必须提一下Google Play推出的应用签名（App Signing）功能。我当初踩过一个坑：把发布密钥搞丢了，结果想上传更新却找不到原来的keystore。如果你启用了Google Play App Signing，上传密钥（upload key）和平台签名密钥是分开的——丢了上传密钥还能找Google帮你换，但丢了平台签名密钥就真没救了。

建议新项目都开启Google Play App Signing。在首次发布时，Play Console会让你上传一个由上传密钥签名的AAB，然后帮你生成应用签名密钥。这样你即使丢了上传密钥，也能联系支持团队更换。

避坑总结

• 密钥文件务必备份多份——我习惯在Git私有仓库加密存储一份，本地U盘一份，公司密钥管理平台一份。
• 密码不要写在代码里——用环境变量或Gradle属性文件，并加入 .gitignore。
• 如果启用Google Play App Signing——一定要把上传密钥的keystore备份好，并且记住每个密码。
• 测试轨道的签名验证——和正式轨道完全一致。你不需要为测试轨道单独生成密钥，就用同一个release密钥。

嗯，基本上把密钥这块理清楚了。我每次给新项目初始化签名配置时，都会把上面这三步过一遍：生成→配置→验证。确保密钥文件能正常签名，然后跑一次测试轨道，比什么都管用。