Android程序签名打包

作者likuolei

Android 程序签名打包是将 Android 应用编译为 APK 或 AAB 文件并使用数字证书签名的过程，确保应用的安全性、完整性和来源可信。签名是 Google Play 发布应用的强制要求，也是设备安装应用的验证机制。本教程基于 Android Studio（截至 2025 年 9 月，最新版本 Koala 2024.1.1）详细讲解 Android 程序签名打包的步骤、工具、文件解析和常见问题，适合初学者和需要深入了解的开发者。内容涵盖手动签名、自动签名、APK/AAB 格式和最佳实践。

1. 什么是 Android 程序签名打包？

  • 打包：将应用代码、资源和配置文件编译为 APK（Android Package）或 AAB（Android App Bundle）。
  • 签名：使用私钥对 APK/AAB 签名，确保应用未被篡改，并与开发者身份绑定。
  • 目的：
  • 验证开发者身份。
  • 防止未经授权的修改。
  • 满足 Google Play 和设备安装要求。
  • 格式：
  • APK：传统格式，包含所有资源，适合直接安装。
  • AAB：现代格式，动态分发，优化安装大小，推荐用于 Google Play。

2. 前置条件

  • Android Studio：已安装（推荐最新版 Koala 2024.1.1）。
  • 项目：已完成开发的 Android 应用（参考前文“Android 工程相关解析”）。
  • JDK：17 或更高（Android Studio 内置或手动安装）。
  • Keystore 文件：用于签名的密钥库文件（可新建或使用现有）。
  • 环境配置：确保 Gradle 和 Android SDK 已正确配置。

3. 签名打包流程

Android Studio 提供自动和手动签名方式，以下是详细步骤。

3.1 创建 Keystore 文件

Keystore 是存储私钥和证书的文件，用于签名。

  1. 通过 Android Studio 创建：
  • 打开 Android Studio > Build > Generate Signed Bundle/APK。
  • 选择 “APK” 或 “Android App Bundle”，点击 Next。
  • 在 “Key store path” 选择 “Create new”。
  • 填写：
    • Key store path：保存路径（如 C:\keystores\myapp.jks）。
    • Password：设置 Keystore 密码。
    • Alias：密钥别名（如 myappkey）。
    • Key password：密钥密码（可与 Keystore 密码相同）。
    • Validity：有效期（建议 25 年以上，如 10000 天）。
    • Certificate：填写开发者信息（如姓名、组织）。
  • 点击 OK，生成 .jks 文件。
  1. 通过命令行创建（可选）：
   keytool -genkeypair -v -keystore myapp.jks -keyalg RSA -keysize 2048 -validity 10000 -alias myappkey
  • 按提示输入密码和信息。
  • 保存 myapp.jks 文件，记录密码和别名。

注意：备份 Keystore 文件和密码，丢失将无法更新应用！

3.2 自动签名（推荐）

Android Studio 提供图形界面简化签名和打包。

  1. 打开向导：
  • Build > Generate Signed Bundle/APK。
  • 选择：
    • Android App Bundle（推荐，Google Play 要求）。
    • APK（用于本地分发或旧设备）。
  1. 选择 Keystore：
  • Key store path：选择 .jks 文件。
  • 输入 Keystore 密码、Alias 和 Key 密码。
  1. 配置构建：
  • Build Variant：选择 release（发布模式）。
  • Signature Versions：勾选 V1（Jar Signature）和 V2（Full APK Signature）（推荐）。
  1. 生成：
  • 点击 Finish，生成文件：
    • APK：app/build/outputs/apk/release/app-release.apk.
    • AAB：app/build/outputs/bundle/release/app-release.aab.
  1. 验证：
  • 检查输出目录，确认文件生成。
  • 使用 jarsigner 验证签名：
    bash jarsigner -verify -verbose app-release.apk

3.3 手动签名（进阶）

手动签名适用于命令行操作或 CI/CD 环境。

  1. 生成未签名 APK：
  • Android Studio：Build > Build Bundle(s)/APK(s) > Build APK(s)。
  • 输出：app/build/outputs/apk/release/app-release-unsigned.apk.
  1. 签名 APK：
  • 使用 apksigner（Android SDK 工具）：
    bash apksigner sign --ks myapp.jks --ks-key-alias myappkey app-release-unsigned.apk
  • 输入 Keystore 和 Key 密码。
  • 输出：app-release-unsigned.apk 被覆盖为签名版本。
  1. 验证签名：
   apksigner verify app-release-unsigned.apk
  1. AAB 签名：
  • 使用 bundletool 转换 AAB 为 APK（测试用）：
    bash bundletool build-apks --bundle=app-release.aab --output=app.apks --ks=myapp.jks --ks-key-alias=myappkey
  • 安装测试：
    bash bundletool install-apks --apks=app.apks

3.4 配置 Gradle 自动签名

在 app/build.gradle 中配置签名信息，简化构建。

  1. 添加签名配置：
   android {
       compileSdk 34
       defaultConfig { ... }
       signingConfigs {
           release {
               storeFile file("path/to/myapp.jks")
               storePassword "your-keystore-password"
               keyAlias "myappkey"
               keyPassword "your-key-password"
           }
       }
       buildTypes {
           release {
               signingConfig signingConfigs.release
               minifyEnabled true
               proguardRules getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
           }
       }
   }
  1. 构建：
   ./gradlew assembleRelease  # 生成 APK
   ./gradlew bundleRelease    # 生成 AAB
  • 输出路径同自动签名。

注意：不要将密码硬编码到 build.gradle，建议使用 gradle.properties 或环境变量：

# gradle.properties
storePassword=your-keystore-password
keyPassword=your-key-password
keyAlias=myappkey
storeFile=/path/to/myapp.jks

4. APK vs. AAB

特性APKAAB
全称Android PackageAndroid App Bundle
大小包含所有资源，较大动态分发，仅包含用户所需资源
分发本地安装、第三方商店Google Play 推荐
签名直接签名签名后需 Play 签名（App Signing）
适用场景调试、本地分发Google Play 发布、优化大小
  • 推荐：Google Play 强制使用 AAB，建议优先生成 AAB。

5. 发布到 Google Play

  1. 注册 Google Play 开发者账户：费用 25 美元（一次性）。
  2. 上传 AAB：
  1. 启用 App Signing：
  • Google Play 提供应用签名服务，上传 Keystore 或公钥。
  • 备份上传密钥（.pepk 文件）。
  1. 填写信息：应用名称、描述、图标、截图等。
  2. 发布：选择内部测试、封闭测试或公开版本。

6. 示例：签名打包计数器应用

基于前文“Android 工程相关解析”的计数器应用，展示签名打包。

6.1 项目准备

  • 确保 app/build.gradle 和 AndroidManifest.xml 配置正确（参考前文）。
  • 创建 Keystore：如 myapp.jks（密码：123456，别名：myappkey）。

6.2 配置 Gradle

android {
    compileSdk 34
    defaultConfig {
        applicationId "com.example.myapp"
        minSdk 21
        targetSdk 34
        versionCode 1
        versionName "1.0"
    }
    signingConfigs {
        release {
            storeFile file("myapp.jks")
            storePassword "123456"
            keyAlias "myappkey"
            keyPassword "123456"
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
            minifyEnabled true
            proguardRules getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

6.3 生成 AAB

  1. 运行：
   ./gradlew bundleRelease
  1. 输出：app/build/outputs/bundle/release/app-release.aab.
  2. 验证：
   bundletool build-apks --bundle=app/build/outputs/bundle/release/app-release.aab --output=app.apks --ks=myapp.jks --ks-key-alias=myappkey

6.4 测试安装

  • 安装到设备：
  bundletool install-apks --apks=app.apks
  • 或直接安装 APK（若生成 APK）：
  adb install app/build/outputs/apk/release/app-release.apk

7. 常见问题与解决方案

问题解决方法
Keystore 密码错误确认密码；若丢失，需生成新 Keystore（无法更新已发布应用）。
签名验证失败检查 V1/V2 签名是否启用；运行 apksigner verify 诊断。
AAB 无法直接安装使用 bundletool 转换为 APK 测试；AAB 需 Play Store 分发。
ProGuard 混淆错误检查 proguard-rules.pro，添加必要规则（如 -keep class com.example.** { *; }）。
Google Play 拒绝确保 AAB 使用正确签名，检查权限声明（如 INTERNET）。

8. 最佳实践

  • 备份 Keystore：将 .jks 文件和密码存储到安全位置。
  • 使用 AAB：优先选择 AAB，优化分发大小。
  • 启用 ProGuard/R8：缩小 APK/AAB 大小，优化性能。
  • 示例 proguard-rules.pro：
    proguard -keep class androidx.** { *; } -dontwarn com.google.**
  • 版本管理：递增 versionCode 和 versionName。
  • 自动化构建：在 CI/CD（如 GitHub Actions）中配置签名：
  jobs:
    build:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v4
        - name: Set up JDK 17
          uses: actions/setup-java@v3
          with: { java-version: '17' }
        - name: Build AAB
          run: ./gradlew bundleRelease
        - name: Upload AAB
          uses: actions/upload-artifact@v3
          with:
            name: app-release
            path: app/build/outputs/bundle/release/app-release.aab
  • 安全性：不要将 Keystore 提交到 Git，使用 .gitignore 排除。

9. 总结

Android 程序签名打包是发布应用的关键步骤，通过 Android Studio 的自动签名或 Gradle 配置可以简化流程。使用 AAB 更适合 Google Play 分发，Keystore 管理至关重要。结合 ProGuard 和版本控制，确保应用安全和可维护。对于 Android 开发者，熟练掌握签名打包流程是发布高质量应用的基础。

如果需要更复杂示例（如多模块项目签名、Google Play 上传细节）、特定问题排查，或其他 Android 相关指导，请告诉我！

类似文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注