Ijs/SIGNING_GUIDE.md

Android 应用签名配置指南

配置步骤

1. 放置密钥文件

将你的 key.jks 文件放在项目根目录：

项目根目录/
├── key.jks          ← 放在这里
├── app/
├── gradle/
└── ...

2. 创建配置文件

复制 keystore.properties.example 为 keystore.properties：

cp keystore.properties keystore.properties

3. 填写配置信息

编辑 keystore.properties 文件，填入你的实际信息：

storePassword=你的密钥库密码
keyPassword=你的密钥密码
keyAlias=你的密钥别名
storeFile=key.jks

4. 构建发布版本

# Windows
gradlew assembleRelease

# Linux/Mac
./gradlew assembleRelease

生成的 APK 文件位于：app/build/outputs/apk/release/app-release.apk

安全提示

⚠️ 重要：不要将以下文件提交到版本控制系统

• key.jks - 你的密钥文件
• keystore.properties - 包含密码的配置文件

这些文件已经添加到 .gitignore 中，确保它们不会被意外提交。

如果没有密钥文件

如果你还没有创建密钥文件，可以使用以下命令创建：

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

按照提示输入信息：

• 密钥库密码
• 密钥密码
• 姓名、组织等信息

备份密钥

⚠️ 非常重要：请妥善保管你的密钥文件和密码

• 将 key.jks 文件备份到安全的地方
• 记录密钥库密码、密钥密码和别名
• 如果丢失密钥，将无法更新已发布的应用

调试版本

调试版本不需要配置签名，Android Studio 会自动使用调试密钥：

# Windows
gradlew assembleDebug

# Linux/Mac
./gradlew assembleDebug