游戏引擎 / 系统课时
完成一次多平台发布验收
完成一次多平台发布验收
构建成功不代表可以发布:Web 可能命中旧缓存,小游戏可能只在开发工具中正常,原生包也可能签名正确却无法启动。本课把四个平台的同一版本串成验收流程,落实产物核对、真机回归、故障阻断和归档证据。
学习目标
- 为 Web、微信小游戏、Android、iOS 建立同版本的交付与测试清单。
- 校验构建产物结构、安装启动、关键能力和更新行为。
- 用统一的发布闸门决定放行或回退,并保存可追溯证据。
冻结发布版本和环境
先确定唯一发布标识,并锁定 Git 提交、Cocos Creator 版本、构建任务配置、业务版本号、资源版本和后端环境。四份产物都应来自同一批准的代码基线;如果某平台有专属修复,要记录补丁差异并重新确认验收范围。
准备好 Web 可访问测试地址、微信小游戏预览或体验版、Android 正式签名安装包,以及通过 Xcode 签名导出的 iOS 测试分发包。不要拿 Creator 生成的原生工程目录冒充已经签名的 APK 或 IPA;iOS 真机安装测试需要有效的签名与分发方式。

在真实宿主里跑完四平台矩阵
每个平台至少覆盖首次安装或首次访问、冷启动、前后台切换、断网恢复、资源下载、登录及返回主界面。支付、分享、设备能力仅按项目实际接入项执行,支付优先使用渠道提供的沙箱或测试交易,不制造真实扣款。
| 平台 | 交付与执行环境 | 必查结果 |
|---|---|---|
| Web Mobile | 部署整个构建目录,通过 HTTPS 测试站点访问 | 入口可达、资源无 404、横竖屏及触控正常、刷新后版本一致 |
| 微信小游戏 | 使用对应 AppID 在开发者工具构建并用真机扫码体验 | 主包与分包合规、真机启动、授权/分享及远程资源可用 |
| Android | 安装目标渠道要求的正式签名 APK;若交付 AAB,另走对应渠道测试流程 | 包名版本与签名匹配、安装升级/冷启动、系统返回键及生命周期正常 |
| iOS | 通过 Xcode 归档并以授权的真机或 TestFlight 分发 | Bundle ID、版本、签名与描述文件正确;冷启动、前后台和系统权限正常 |
只在模拟器、浏览器调试器或开发者工具中通过,不能代替真机结果。各平台至少记录设备型号、系统版本、测试账号、网络条件、执行人和结果时间;环境变化时需要重新测试受影响项。
自动筛掉缺失或损坏的产物
把下面的 Python 3 脚本保存为 release_check.py。它核对 Web 入口、小游戏基础文件,以及 APK、IPA 的 ZIP 完整性和关键条目;同时为每个产物生成 SHA-256 指纹。目录指纹按相对路径和文件内容生成,用来识别发布目录是否被改动。
import argparse
import hashlib
from pathlib import Path
from zipfile import ZipFile, is_zipfile
def ensure(ok, message):
if not ok:
raise ValueError(message)
# 静态结构检查不能替代签名校验和设备端运行。
def validate(label, path):
ensure(path.exists(), f"{label}: 产物不存在")
if label in ("Web", "WeChat"):
ensure(path.is_dir(), f"{label}: 需要构建目录")
required = ["index.html"] if label == "Web" else [
"game.js", "game.json", "project.config.json"
]
for name in required:
ensure((path / name).is_file(), f"{label}: 缺少 {name}")
else:
ensure(path.is_file() and is_zipfile(path), f"{label}: 需要 APK/IPA")
with ZipFile(path) as archive:
names = archive.namelist()
ensure(archive.testzip() is None, f"{label}: ZIP CRC 错误")
if label == "Android":
ensure("AndroidManifest.xml" in names, "Android: 缺少清单")
else:
ensure(any(name.startswith("Payload/") and
".app/Info.plist" in name for name in names),
"iOS: 缺少应用 Info.plist")
def fingerprint(path):
digest = hashlib.sha256()
files = sorted(p for p in path.rglob("*") if p.is_file()) if path.is_dir() else [path]
for file in files:
relative = file.relative_to(path).as_posix() if path.is_dir() else file.name
# 相对路径参与摘要,避免目录内容改名后指纹不变。
digest.update(relative.encode("utf-8") + b"\0")
with file.open("rb") as stream:
for chunk in iter(lambda: stream.read(1024 * 1024), b""):
digest.update(chunk)
return digest.hexdigest()
parser = argparse.ArgumentParser()
for flag in ("web", "wechat", "android", "ios"):
parser.add_argument(f"--{flag}", type=Path, required=True)
args = parser.parse_args()
artifacts = [("Web", args.web), ("WeChat", args.wechat),
("Android", args.android), ("iOS", args.ios)]
# 先完整校验四份产物,再统一输出通过结果。
try:
for label, path in artifacts:
validate(label, path)
for label, path in artifacts:
print(f"{label}: PASS sha256={fingerprint(path)}")
except (OSError, ValueError) as exc:
raise SystemExit(f"FAIL: {exc}")将尖括号路径替换为实际路径。<PATH_WEB> 和 <PATH_WECHAT> 指向完整构建目录,另外两个指向最终 APK、IPA 文件。
python3 release_check.py --web "<PATH_WEB>" --wechat "<PATH_WECHAT>" --android "<PATH_APK>" --ios "<PATH_IPA>"预期输出(四项均合格时):
Web: PASS sha256=<SHA256>
WeChat: PASS sha256=<SHA256>
Android: PASS sha256=<SHA256>
iOS: PASS sha256=<SHA256>按发布闸门做最终判定
功能回归需要同时覆盖正常链路与失败恢复:清理缓存后重新进入、从旧版本升级、网络中断后重试、切后台再恢复,以及远程 Bundle 更新。将失败证据绑定到平台、版本、设备与重现步骤,不能用“其他三个平台通过”抵消当前平台故障。
放行前核对以下条件:
- 四平台对应的结构检查、签名/身份校验与真机测试均通过,包体满足渠道限制。
- 登录、关键场景、资源加载及实际启用的支付/分享能力通过;阻断级故障为零。
- 产物指纹、构建日志、配置快照、测试记录、截图或日志以及回退版本已归档。
若任一阻断项失败,停止该平台发布,修复后生成新产物并重新核对指纹、受影响功能和关联平台。最终归档对象必须是实际提交或分发的二进制与站点目录,而不是先前通过测试的临时文件。