游戏引擎 / 系统课时

包标识和应用版本怎样配置

包标识和应用版本怎样配置

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 提交过的版本码不能重复使用。

在构建任务与原生配置中设置

  1. 在 Cocos Creator 3.8 打开“项目 → 构建发布”,新建或编辑 Android 构建任务,找到“应用 ID 名称”,填写 com.example.runner,并确认启动场景已设置。
  2. 执行“构建”,再生成 Android 原生工程;需要时使用 Android Studio 打开项目。
  3. 检查应用模块的 build.gradle 中最终生效的 versionCode 和 versionName。使用默认原生模板的项目,还应检查 native/engine/android/app/build.gradle 等上游配置来源,避免只修改 build/android 下的临时产物,下一次构建又被覆盖。

下面是放入现有 Android 应用模块 defaultConfig 内的片段示例,不是完整的 build.gradle 文件:

groovy
// 片段示例:放在现有 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 环境变量中。

bash
# 读取最终 APK,而不是只检查编辑器里的输入框
APK_PATH="<PATH>"
apkanalyzer apk summary "$APK_PATH"

预期输出(与上述示例配置一致时):

text
com.example.runner 42 1.3.0

该输出依次是应用 ID、versionCode、versionName;实际值随构建而不同。若发布的是 AAB,不能把 AAB 文件直接交给这条 APK 检查命令,应改用对应的 Bundle 检查方式。

排除覆盖安装与渠道冲突

现象 优先核查 处理
设备出现两个游戏图标 新旧 APK 的应用 ID 是否不同 恢复约定的应用 ID 后重新构建
提示版本降级 新包的 versionCode 是否更低 递增版本码并重新发布
同包名却不能覆盖安装 新旧 APK 的签名证书是否一致 用原有发布密钥签名;不要直接更换正式证书
渠道识别不符合预期 包标识、渠道配置和商店登记信息 分别核对,不把渠道号混同于包名

正式提交前,应把“应用 ID、展示版本、版本码、签名证书指纹、渠道及 APK/AAB 文件”记录在同一份发版清单中。最终以包内查到的值为准,而不是仅凭构建面板看起来填写正确。

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

目录与阅读设置

阅读设置

17

记录一个想法

包标识和应用版本怎样配置

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

登录哪都通