游戏引擎 / 系统课时
正式包提交前检查什么
正式包提交前检查什么
正式包能在开发机运行,不代表可以直接交给应用商店。本课把 Cocos Creator 3.8 的 Android 和 iOS 发布检查收敛成六个放行条件,并通过核对真实安装包、签名信息与真机行为,避免把调试包或缺资源的包提交审核。
学习目标
- 建立包标识、版本、签名、资源、启动和权限六项验收清单。
- 使用 Android SDK 工具检查正式 APK 的签名及版本信息。
- 以真机测试证据判断是否允许提交渠道审核。
先确定唯一待提交产物
先在 Cocos Creator 的「项目 → 构建」确认目标平台、启动场景、构建模式及资源选项,再完成原生编译和正式签名。验收对象必须是最后生成的 APK、AAB 或 IPA,而不是编辑器预览、调试安装包或签名前的中间文件。
给产物记录构建时间、Git 提交、渠道、版本号和文件校验值。只要重新构建、换签名或替换资源,就要重新验收;不能拿上一次安装包的通过记录给新文件背书。
按六项标准逐项放行
| 检查项 | 核对位置 | 通过标准 |
|---|---|---|
| 包标识 | Android applicationId、iOS Bundle ID |
与渠道后台及既有正式应用一致 |
| 版本 | Android versionName/versionCode、iOS 版本号/构建号 |
展示版本正确;构建号满足渠道的递增要求 |
| 签名 | Android 正式证书或上传密钥、iOS 分发证书与描述文件 | 不是调试身份;与发布渠道及应用标识匹配 |
| 资源 | 启动场景、内置 Asset Bundle、远程资源地址 | 依赖完整;正式环境可下载、加载且版本一致 |
| 启动 | 正式包冷启动、升级安装及前后台切换 | 无白屏、闪退或卡死;失败时有恢复路径 |
| 权限 | 最终 Android Manifest、iOS Info.plist 与隐私声明 |
只申请必要权限;用途说明与实际功能一致 |
Android 更新包还要核对历史签名证书;启用 Google Play App Signing 时应区分上传密钥与商店托管的应用签名密钥。iOS 则要同时核对 Team、Bundle ID、分发方式、Provisioning Profile 与启用的能力,不能只看 Xcode 显示构建成功。
用命令检查 Android 正式 APK
安装 Android SDK 的相关工具,确保 apksigner 和 apkanalyzer 可从终端调用;把实际待验的已签名 APK 复制到当前目录并命名为 release.apk。下面的命令在签名无效或文件不存在时停止,成功后打印清单所需字段。
#!/usr/bin/env bash
set -euo pipefail # 任一步失败都中止验收
apk="release.apk" # 当前目录中的最终签名 APK
apksigner verify "$apk"
printf '签名验证:通过\n'
printf '包信息:'
apkanalyzer apk summary "$apk"
printf '可调试:'
apkanalyzer manifest debuggable "$apk"预期输出(示例包的标识和版本;实际值由 APK 决定):
签名验证:通过
包信息:com.example.game 42 1.4.0
可调试:falseapksigner verify 成功只说明签名结构有效,不代表签名身份就是预期证书;仍应运行 apksigner verify --print-certs release.apk,把证书指纹与历史发布或渠道记录比较。权限可通过 apkanalyzer manifest permissions release.apk 查看,并回查合并后的清单。
用真机补齐静态检查无法发现的问题
至少覆盖一台目标低端设备和一台较新设备,安装同一份待提交产物。逐项记录冷启动至首屏、进入主玩法、音效、资源下载、断网后重试、后台恢复,以及旧版本覆盖升级。远程资源要在正式 CDN 域名下验证,不要让本地缓存掩盖缺文件和路径大小写错误。
涉及相机、相册、麦克风、通知或登录 SDK 的功能,应同时测试允许、拒绝和再次进入场景。核对权限弹窗、隐私说明与渠道配置;权限被拒绝时,非必要功能应可降级,不能拖垮整个启动链路。
怎样决定是否提交
每项检查留下结果、设备或渠道、测试版本及证据链接;任何一项不通过,就阻止提交并在修复后重新产包。只有产物标识和版本匹配、签名身份正确、资源可用、真机关键路径通过且权限声明一致,才把该文件交给平台审核。