原生移动开发 / 系统课时
APK、AAB 与应用标识
APK、AAB 与应用标识
Android 构建配置里有几组看起来都像“包名或版本”的字段,但它们承担的职责完全不同。本课把 namespace、applicationId、versionCode、versionName 与 APK/AAB 输出放到同一条构建链路中,并用命令验证最终产物。
学习目标
- 区分
namespace与applicationId,知道哪个决定代码命名空间,哪个决定应用身份 - 正确使用
versionCode与versionName - 理解 APK 与 AAB 的发布方式差异,并能构建对应产物
三组标识分别解决什么问题
namespace 属于 Android 模块的代码命名空间,主要决定生成的 R、BuildConfig 等类放在哪个包下。applicationId 是安装到设备和发布到应用商店时识别应用的唯一身份;一旦正式发布,通常不应随意改变,否则系统和商店会把它视为另一个应用。
versionCode 是用于比较版本新旧的整数,发布新版本时必须递增;versionName 是展示给用户看的字符串,例如 2.3.0,并不负责判断升级顺序。
| 配置项 | 主要用途 | 是否适合随构建变体变化 |
|---|---|---|
namespace |
生成代码的命名空间 | 通常保持稳定 |
applicationId |
安装与商店中的应用身份 | 测试变体可加后缀,生产身份应稳定 |
versionCode |
版本升级顺序 | 发布时递增 |
versionName |
用户可见版本名 | 可按发布策略调整 |
配置应用身份与版本
下面是 app/build.gradle.kts 中的完整 android 配置片段,重点只放与本课相关的标识和版本字段。
android {
namespace = "com.example.catalog"
compileSdk = 36
defaultConfig {
applicationId = "com.example.catalog"
minSdk = 24
targetSdk = 36
versionCode = 42
versionName = "2.3.0"
}
buildTypes {
debug {
applicationIdSuffix = ".debug"
versionNameSuffix = "-debug"
}
release {
isMinifyEnabled = false
}
}
}这里的 release 应用身份仍是 com.example.catalog,而 debug 变体会得到 com.example.catalog.debug,从而允许调试版和正式版同时安装。namespace 没有跟着变化,因此代码中的 R 和 BuildConfig 仍保持稳定的包路径。
APK 与 AAB 的交付链路
APK 是可直接安装到 Android 设备上的包;AAB 是面向应用商店的发布格式,本身不是给终端用户直接安装的最终包。以 Google Play 为例,上传 AAB 后,商店会根据设备配置生成并分发更合适的 APK 集合。

选择产物时可以用一个简单原则:本地安装、测试或侧载通常使用 APK;面向支持 App Bundle 的应用商店发布时优先使用 AAB。AAB 的价值主要在于让分发端按设备拆分资源和原生库,而不是把 AAB 当成“更高级的 APK”。
构建并检查产物
在项目根目录同时构建 debug APK 和 release AAB:
./gradlew :app:assembleDebug :app:bundleRelease预期输出
> Task :app:assembleDebug
> Task :app:bundleRelease
BUILD SUCCESSFUL成功后,APK 通常位于 app/build/outputs/apk/debug/app-debug.apk,AAB 通常位于 app/build/outputs/bundle/release/app-release.aab。实际日志可能包含更多任务和缓存信息。
如果 Android SDK 命令行工具已安装,可以进一步读取 APK 中最终生效的应用标识与版本号:
apkanalyzer manifest application-id app/build/outputs/apk/debug/app-debug.apk
apkanalyzer manifest version-code app/build/outputs/apk/debug/app-debug.apk
apkanalyzer manifest version-name app/build/outputs/apk/debug/app-debug.apk预期输出
com.example.catalog.debug
42
2.3.0-debug这一步验证的是最终 APK,而不是只看 Gradle 源文件,因此能发现后缀或变体覆盖是否按预期生效。发布前最需要守住的边界是:生产 applicationId 保持稳定、versionCode 单调递增,并确认交付渠道真正需要 APK 还是 AAB。