游戏引擎 / 系统课时

Android 构建产物该怎么区分

Android 构建产物该怎么区分

Android 发布目录可能同时包含原生工程、调试包、正式包和渠道上传文件,拿错一个就会卡在安装或提交阶段。本节按“还要编译什么、交给谁、怎样验证”区分产物,建立包格式、构建模式与签名身份三条独立检查线。

学习目标

  • 区分 Creator 生成的原生工程与后续得到的 APK、AAB。
  • 理解调试、发布模式与签名身份不能只靠文件名判断。
  • 为 Android 产物保存能追溯到构建和验收环境的记录。

原生工程是继续编译的输入

Cocos Creator 3.8 LTS 的 Android 路线包含项目构建与原生编译打包。生成的原生工程中有 Gradle 配置、原生源代码或工程依赖,它需要匹配的 Android 工具链继续处理。一个文件夹里出现 build.gradle,不说明安装包已经生成。

以构建面板任务和日志显示的实际输出路径为准。进入 Android Studio 后应核对当前工程、构建变体与输出位置;不要从磁盘搜索一个同名旧 APK 就认为它属于刚完成的任务。Creator Android 发布入口

原生工程分别生成安装和上传产物

APK 与 AAB 的交付对象不同

APK 是 Android 安装包格式,可供设备安装;设备是否接受它还取决于签名、系统版本、ABI 和包的完整性。若产物是一组拆分 APK,不能随便只选其中一个安装,应使用对应的完整安装流程。

AAB 是发布格式,包含供分发平台处理的代码与资源。Google Play 可以依据设备配置生成优化的 APK。AAB 不能改后缀当 APK,也不能直接交给 adb install;本地测试应使用相应工具生成适配安装包,或走平台测试渠道。Android App Bundle 说明

产物 主要接收方 不能据此断言
Android 原生工程 Android Studio / Gradle 已能安装到设备
APK 设备安装流程或接受 APK 的渠道 已通过正式签名与功能验收
AAB 支持该格式的分发平台 可以直接作为 APK 安装

Creator Android 构建选项提供生成 App Bundle 的设置。是否启用应由目标渠道决定,不要把所有渠道强行统一成同一种产物。Android 构建选项

调试模式与签名分别检查

调试构建通常用于排障,正式路线需要核对发布模式、调试能力、服务环境和日志策略。签名是另一条维度:Android 安装的 APK 需要有效签名,调试包也有签名;有签名不等于使用了预期的正式身份。

文件名带 release 不能证明包不可调试,文件名带版本号也不能证明内部版本正确。应查看实际构建变体和最终包信息,并核对签名证书指纹。Creator 的调试选项、原生构建模式和签名选择都需要确认,不能只改一个开关。

用交付记录绑定实际产物

下面是团队自定义记录示例,不是 Creator 构建配置,也不是 Android 清单文件。其中值表示一个教学用的待验收 APK;正式使用时由真实构建与检查工具填入,增加产物摘要和证书指纹字段,不能把预期身份当成实测结果。

json
{
  "buildId": "android-demo-42",
  "artifact": "game-demo.apk",
  "format": "APK",
  "intendedVariant": "debug",
  "intendedSigning": "debug-keystore",
  "deviceInstallVerified": false,
  "coldStartVerified": false
}

这份记录的作用是明确交付意图和未完成检查,两个 false 表示不能宣称真机验收通过。验证时把记录与实际文件对应起来,再检查包内标识、版本、ABI、签名和安装结果;只解析 JSON 不能验证 APK 的真实性。

练习整理一次构建输出,把原生工程与最终包分开保存,为每个包记录格式、构建变体、签名摘要和用途。最后说明哪个用于本地安装、哪个用于渠道上传,禁止用旧包替代新包的验收证据。

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

目录与阅读设置

阅读设置

17

记录一个想法

Android 构建产物该怎么区分

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

登录哪都通