游戏引擎 / 系统课时

正式包提交前检查什么

正式包提交前检查什么

正式包能在开发机运行,不代表可以直接交给应用商店。本课把 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。下面的命令在签名无效或文件不存在时停止,成功后打印清单所需字段。

bash
#!/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 决定):

text
签名验证:通过
包信息:com.example.game 42 1.4.0
可调试:false

apksigner verify 成功只说明签名结构有效,不代表签名身份就是预期证书;仍应运行 apksigner verify --print-certs release.apk,把证书指纹与历史发布或渠道记录比较。权限可通过 apkanalyzer manifest permissions release.apk 查看,并回查合并后的清单。

用真机补齐静态检查无法发现的问题

至少覆盖一台目标低端设备和一台较新设备,安装同一份待提交产物。逐项记录冷启动至首屏、进入主玩法、音效、资源下载、断网后重试、后台恢复,以及旧版本覆盖升级。远程资源要在正式 CDN 域名下验证,不要让本地缓存掩盖缺文件和路径大小写错误。

涉及相机、相册、麦克风、通知或登录 SDK 的功能,应同时测试允许、拒绝和再次进入场景。核对权限弹窗、隐私说明与渠道配置;权限被拒绝时,非必要功能应可降级,不能拖垮整个启动链路。

怎样决定是否提交

每项检查留下结果、设备或渠道、测试版本及证据链接;任何一项不通过,就阻止提交并在修复后重新产包。只有产物标识和版本匹配、签名身份正确、资源可用、真机关键路径通过且权限声明一致,才把该文件交给平台审核。

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

目录与阅读设置

阅读设置

17

记录一个想法

正式包提交前检查什么

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

登录哪都通