# Android 应用签名配置指南 ## 配置步骤 ### 1. 放置密钥文件 将你的 `key.jks` 文件放在项目根目录: ``` 项目根目录/ ├── key.jks ← 放在这里 ├── app/ ├── gradle/ └── ... ``` ### 2. 创建配置文件 复制 `keystore.properties.example` 为 `keystore.properties`: ```bash cp keystore.properties keystore.properties ``` ### 3. 填写配置信息 编辑 `keystore.properties` 文件,填入你的实际信息: ```properties storePassword=你的密钥库密码 keyPassword=你的密钥密码 keyAlias=你的密钥别名 storeFile=key.jks ``` ### 4. 构建发布版本 ```bash # Windows gradlew assembleRelease # Linux/Mac ./gradlew assembleRelease ``` 生成的 APK 文件位于:`app/build/outputs/apk/release/app-release.apk` ## 安全提示 ⚠️ **重要:不要将以下文件提交到版本控制系统** - `key.jks` - 你的密钥文件 - `keystore.properties` - 包含密码的配置文件 这些文件已经添加到 `.gitignore` 中,确保它们不会被意外提交。 ## 如果没有密钥文件 如果你还没有创建密钥文件,可以使用以下命令创建: ```bash keytool -genkey -v -keystore key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-key-alias ``` 按照提示输入信息: - 密钥库密码 - 密钥密码 - 姓名、组织等信息 ## 备份密钥 ⚠️ **非常重要:请妥善保管你的密钥文件和密码** - 将 `key.jks` 文件备份到安全的地方 - 记录密钥库密码、密钥密码和别名 - 如果丢失密钥,将无法更新已发布的应用 ## 调试版本 调试版本不需要配置签名,Android Studio 会自动使用调试密钥: ```bash # Windows gradlew assembleDebug # Linux/Mac ./gradlew assembleDebug ```