原生移动开发 / 系统课时

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 配置片段,重点只放与本课相关的标识和版本字段。

kotlin
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 与 AAB 的构建和分发关系

选择产物时可以用一个简单原则:本地安装、测试或侧载通常使用 APK;面向支持 App Bundle 的应用商店发布时优先使用 AAB。AAB 的价值主要在于让分发端按设备拆分资源和原生库,而不是把 AAB 当成“更高级的 APK”。

构建并检查产物

在项目根目录同时构建 debug APK 和 release AAB:

bash
./gradlew :app:assembleDebug :app:bundleRelease

预期输出

text
> 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 中最终生效的应用标识与版本号:

bash
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

预期输出

text
com.example.catalog.debug
42
2.3.0-debug

这一步验证的是最终 APK,而不是只看 Gradle 源文件,因此能发现后缀或变体覆盖是否按预期生效。发布前最需要守住的边界是:生产 applicationId 保持稳定、versionCode 单调递增,并确认交付渠道真正需要 APK 还是 AAB。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

APK、AAB 与应用标识

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通