游戏引擎 / 系统课时
包标识和应用版本怎样配置
包标识和应用版本怎样配置
Cocos Creator 导出的 Android 包如果标识或版本填错,轻则被系统当作另一款应用,重则无法覆盖安装或被渠道拒收。本课以一次正式版本发布为例,统一包标识、展示版本和内部构建号,并用最终 APK 反查结果。
学习目标
- 区分应用 ID、
versionName和versionCode的作用。 - 找到 Cocos Creator 构建面板和 Android 工程中的配置位置。
- 核对安装升级条件与最终包内的版本信息。
先确定三项发布标识
| 项目 | 示例 | 实际用途 |
|---|---|---|
| 应用 ID(包标识) | com.example.runner |
区分已安装应用;同一产品升级时应保持稳定 |
versionName |
1.3.0 |
面向用户和运营的可读版本字符串 |
versionCode |
42 |
Android 用来比较版本先后、应用商店用来识别新版的正整数 |
包标识不是桌面显示的游戏名称,也不等于渠道编号。不同渠道若需要互相覆盖升级,应先确认应用 ID 和签名规则一致;如果要让测试版与正式版并存,则应明确设计不同的应用 ID,而不是发布时临时改名。
versionName 可以用于展示语义化版本,但不能代替递增的 versionCode。例如上一版是 versionCode=41,本次即使界面仍显示 1.3.0,也应按发布计划把内部版本码提高到 42。已向 Google Play 提交过的版本码不能重复使用。
在构建任务与原生配置中设置
- 在 Cocos Creator 3.8 打开“项目 → 构建发布”,新建或编辑 Android 构建任务,找到“应用 ID 名称”,填写
com.example.runner,并确认启动场景已设置。 - 执行“构建”,再生成 Android 原生工程;需要时使用 Android Studio 打开项目。
- 检查应用模块的
build.gradle中最终生效的versionCode和versionName。使用默认原生模板的项目,还应检查native/engine/android/app/build.gradle等上游配置来源,避免只修改build/android下的临时产物,下一次构建又被覆盖。
下面是放入现有 Android 应用模块 defaultConfig 内的片段示例,不是完整的 build.gradle 文件:
// 片段示例:放在现有 android { defaultConfig { ... } } 内
versionCode 42
versionName "1.3.0"该片段依赖现有 Android Gradle 工程,不能独立运行。修改后重新打包;若项目存在构建变体或自定义脚本覆盖这些值,以最终发布产物为准。请勿把 namespace 直接当作安装时使用的应用 ID。
从 APK 反查实际值
安装 Android SDK Command-line Tools 后,可使用 apkanalyzer 查看已经生成的 APK。以下命令适用于 macOS、Linux 或已具备 Bash 的终端;请将 <PATH> 换成 APK 的实际路径,并确认工具位于 PATH 环境变量中。
# 读取最终 APK,而不是只检查编辑器里的输入框
APK_PATH="<PATH>"
apkanalyzer apk summary "$APK_PATH"预期输出(与上述示例配置一致时):
com.example.runner 42 1.3.0该输出依次是应用 ID、versionCode、versionName;实际值随构建而不同。若发布的是 AAB,不能把 AAB 文件直接交给这条 APK 检查命令,应改用对应的 Bundle 检查方式。
排除覆盖安装与渠道冲突
| 现象 | 优先核查 | 处理 |
|---|---|---|
| 设备出现两个游戏图标 | 新旧 APK 的应用 ID 是否不同 | 恢复约定的应用 ID 后重新构建 |
| 提示版本降级 | 新包的 versionCode 是否更低 |
递增版本码并重新发布 |
| 同包名却不能覆盖安装 | 新旧 APK 的签名证书是否一致 | 用原有发布密钥签名;不要直接更换正式证书 |
| 渠道识别不符合预期 | 包标识、渠道配置和商店登记信息 | 分别核对,不把渠道号混同于包名 |
正式提交前,应把“应用 ID、展示版本、版本码、签名证书指纹、渠道及 APK/AAB 文件”记录在同一份发版清单中。最终以包内查到的值为准,而不是仅凭构建面板看起来填写正确。