Android Studio 打包 APK

文章目录

- [一、Debug 包与 Release 包的区别](#一、Debug 包与 Release 包的区别)
- 二、准备工作
- 三、创建签名文件（Keystore）
- - [1. 打开签名 APK 生成向导](#1. 打开签名 APK 生成向导)
  - [2. 创建新的 Keystore](#2. 创建新的 Keystore)
- [四、生成签名 APK](#四、生成签名 APK)
- [五、使用 Gradle 命令行打包](#五、使用 Gradle 命令行打包)
- - [1. 在 `build.gradle` 中配置签名信息](#1. 在 build.gradle 中配置签名信息)
  - [2. 执行打包命令](#2. 执行打包命令)
- [六、验证 APK 签名](#六、验证 APK 签名)
- 七、注意事项与常见问题
- - [1. 签名文件的安全](#1. 签名文件的安全)
  - [2. 版本更新](#2. 版本更新)
  - [3. 构建失败排查](#3. 构建失败排查)
- 八、总结

在 Android 开发过程中，当我们的应用完成开发、测试并准备发布时，就需要将其打包成一个 APK（Android Package）文件，以便用户安装使用。Android Studio 提供了非常便捷的打包工具，无论是生成用于测试的 Debug 包，还是用于正式发布的 Release 签名包，都可以通过简单的几步完成。

本文将参考《第一行代码》中的思路，详细介绍如何使用 Android Studio 将项目打包成 APK 安装包，涵盖签名文件的创建、正式签名 APK 的生成以及一些注意事项，帮助你顺利地将应用交付给用户。

一、Debug 包与 Release 包的区别

在 Android 开发中，APK 通常分为两种构建类型：

Debug 包 ：用于开发调试，默认使用 Android Studio 自动生成的调试签名，无需手动配置签名文件，安装后可被 adb 等工具调试。
Release 包：用于正式发布，需要开发者使用自己的签名文件（Keystore）进行签名，以确保应用的来源可信、防止篡改，并且可以开启代码混淆、资源压缩等优化。

通常我们所说的"打包安装包"指的就是生成 Release 签名 APK。

二、准备工作

在开始打包之前，请确保：

项目能够正常编译运行，没有明显的错误。

在 app/build.gradle 文件中已经配置好应用的基本信息，如 applicationId、versionCode、versionName 等，这些会影响到 APK 的标识和版本。

groovy 复制代码

android {
    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion 21
        targetSdkVersion 33
        versionCode 1
        versionName "1.0"
    }
}

如果需要开启混淆，可以在 build.gradle 中设置 minifyEnabled true，并配置相应的混淆规则文件 proguard-rules.pro（新手可暂时关闭）。

三、创建签名文件（Keystore）

签名文件是应用发布的重要凭证，一旦丢失或泄露，将无法对已发布的应用进行更新。因此，请务必妥善保管。

1. 打开签名 APK 生成向导

在 Android Studio 中，点击菜单栏的 Build → Generate Signed Bundle / APK...。

选择 APK ，然后点击 Next。

2. 创建新的 Keystore

如果还没有签名文件，点击 Create new... 按钮，弹出新建签名文件对话框。

填写以下信息：

Key store path：选择签名文件的保存路径（建议放在项目外部，避免随代码上传到版本库）。
Password：设置签名文件的密码，用于保护整个 Keystore。
Confirm：再次输入密码确认。
Alias：密钥别名，用于区分同一 Keystore 中的多个密钥（一般一个应用使用一个别名）。
Key password：密钥密码，可以与 Keystore 密码相同，也可以不同。
Validity (years)：有效期，一般默认 25 年或更长。
Certificate：证书信息，至少填写 First and Last Name（例如你的名字或公司名），其他可随意。

填写完成后点击 OK，向导会自动填充签名文件的路径和密码。

提示：签名文件一旦创建，请立即备份！如果丢失，你将无法为后续版本更新签名，用户也无法覆盖安装新版本。

四、生成签名 APK

在 Generate Signed APK 向导中，完成以下配置：

Module ：选择要打包的模块（通常是 app）。
Key store path：选择刚刚创建的 Keystore 文件。
Key store password：输入 Keystore 密码。
Key alias：选择对应的别名。
Key password：输入密钥密码。
Destination Folder ：选择 APK 输出目录（可选，默认在项目 release 目录）。
Build Variants ：选择构建类型，通常选择 release（正式版）或 debug（测试版）。
Signature Versions：勾选签名版本。

V1 (Jar Signature)：旧版签名，兼容 Android 7.0 以下系统。
V2 (Full APK Signature)：新版签名，Android 7.0 及以上系统必须使用。

建议：同时勾选 V1 和 V2，以兼容所有 Android 版本。

点击 Finish ，Android Studio 会开始构建并签名 APK。构建完成后，右下角会弹出通知，点击 locate 即可在文件管理器中打开 APK 所在目录。

默认的 APK 输出路径为：app/release/app-release.apk。

五、使用 Gradle 命令行打包

除了使用图形界面，你还可以通过命令行快速生成 Release APK，这在持续集成或脚本化构建中非常有用。

1. 在 `build.gradle` 中配置签名信息

在 app/build.gradle 文件的 android 块中添加 signingConfigs 和 buildTypes 配置：

groovy 复制代码

android {
    signingConfigs {
        release {
            storeFile file("path/to/your.keystore")
            storePassword "你的Keystore密码"
            keyAlias "你的别名"
            keyPassword "你的密钥密码"
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            signingConfig signingConfigs.release
        }
    }
}

安全提醒 ：不要把签名密码直接写在 build.gradle 中并提交到公共代码库，可以考虑使用环境变量或外部配置文件。

2. 执行打包命令

在项目根目录打开终端，执行：

bash 复制代码

./gradlew assembleRelease

构建完成后，APK 位于 app/build/outputs/apk/release/ 目录下。

六、验证 APK 签名

生成 APK 后，你可以使用 apksigner 工具验证签名是否正确：

bash 复制代码

apksigner verify --print-certs app-release.apk

如果输出证书信息且没有错误，说明签名成功。

七、注意事项与常见问题

1. 签名文件的安全

签名文件等同于应用的"身份证"，请妥善保存，建议进行多次备份。
不要将 Keystore 文件提交到版本控制系统（如 Git），除非是私有仓库且严格控制访问权限。
如果签名文件丢失，将无法对已发布的应用发布更新，只能更换包名重新发布。

2. 版本更新

每次发布新版本时，需要确保 versionCode 递增，versionName 可自定义，否则用户无法安装新版本。

3. 构建失败排查

签名密码错误：检查 Keystore 密码和密钥密码是否正确。
V2 签名不兼容：如果应用需要支持 Android 7.0 以下系统，必须同时勾选 V1 签名。
内存不足 ：大型项目打包时可能遇到内存不足，可以在 gradle.properties 中增加 org.gradle.jvmargs=-Xmx2048m。

八、总结

通过本文的介绍，你应该已经掌握了使用 Android Studio 打包 APK 的基本流程：

创建签名文件（Keystore）；
通过 Generate Signed APK 向导生成签名 APK；
或者使用 Gradle 命令行打包；
验证 APK 签名并妥善保管签名文件。

打包 APK 是 Android 应用发布的必经之路，熟练操作后可以大大提高开发效率。希望这篇教程对你有所帮助，祝你开发顺利！