如何使用Play App Signing为安卓应用签名以上传至Alpha track

第一步：校验pepk生成的update.jks有效性 #

• 打开终端/命令提示符，切换到update.jks所在目录
• 执行keytool -list -v -keystore update.jks
• 对比输出中的证书SHA1值与Google Play Console Setup/App Integrity栏目下Upload key certificate的对应SHA1值，完全匹配即说明密钥文件生成无错误
• 命令执行过程中输入pepk运行时设置的密钥库密码即可，终端不会显示明文输入内容，属于正常现象

第二步：使用该密钥完成Release安装包签名 #

• 打开安卓项目app模块下的构建配置文件（Gradle项目为build.gradle或build.gradle.kts）
• 在android配置块下新增签名规则，关联生成的update.jks，参考配置如下：

android {
    signingConfigs {
        release {
            // 替换为本地update.jks的实际路径
            storeFile file("keystores/update.jks")
            // 替换为pepk运行时设置的密钥库密码
            storePassword "你设置的store密码"
            // pepk生成的密钥固定别名，无需修改
            keyAlias "upload"
            // 替换为pepk运行时设置的密钥密码
            keyPassword "你设置的key密码"
        }
    }
    buildTypes {
        release {
            // 关联上述签名配置
            signingConfig signingConfigs.release
        }
    }
}

• 执行打包操作生成Release版本AAB安装包，禁止使用旧的私有密钥对生成的包做二次签名覆盖
• 打包完成后可执行apksigner verify --print-certs 你的release.aab做二次校验，输出的证书签名值与Upload key certificate匹配，即本地签名环节完成

第三步：完成Alpha轨道上传 #

• 进入Google Play Console对应应用的测试-封闭测试（即原Alpha轨道） 页面
• 选择对应目标轨道分支，点击“新建发布”
• 上传已完成本地签名的AAB包，系统会自动校验签名匹配度，校验通过即可填写版本更新说明、设置测试人员范围，提交后即可进入Alpha分发流程

实操注意事项：

• 全程无需本地使用App signing key对安装包做签名，应用上架的最终签名由Google Play服务端在包上传完成后自动完成
• 若上传时提示签名不匹配，优先排查打包流程是否错误关联了旧的密钥文件，而非pepk生成的update.jks
• Alpha轨道的首次发布无需人工审核，Google完成自动签名处理后即可对测试账号可见，通常处理时长在10分钟以内

内容的提问来源于stack exchange，提问作者ror