游戏引擎 / 系统课时

完成一次多平台发布验收

完成一次多平台发布验收

构建成功不代表可以发布: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 指纹。目录指纹按相对路径和文件内容生成,用来识别发布目录是否被改动。

python
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 文件。

bash
python3 release_check.py --web "<PATH_WEB>" --wechat "<PATH_WECHAT>" --android "<PATH_APK>" --ios "<PATH_IPA>"

预期输出(四项均合格时):

text
Web: PASS sha256=<SHA256>
WeChat: PASS sha256=<SHA256>
Android: PASS sha256=<SHA256>
iOS: PASS sha256=<SHA256>

按发布闸门做最终判定

功能回归需要同时覆盖正常链路与失败恢复:清理缓存后重新进入、从旧版本升级、网络中断后重试、切后台再恢复,以及远程 Bundle 更新。将失败证据绑定到平台、版本、设备与重现步骤,不能用“其他三个平台通过”抵消当前平台故障。

放行前核对以下条件:

  • 四平台对应的结构检查、签名/身份校验与真机测试均通过,包体满足渠道限制。
  • 登录、关键场景、资源加载及实际启用的支付/分享能力通过;阻断级故障为零。
  • 产物指纹、构建日志、配置快照、测试记录、截图或日志以及回退版本已归档。

若任一阻断项失败,停止该平台发布,修复后生成新产物并重新核对指纹、受影响功能和关联平台。最终归档对象必须是实际提交或分发的二进制与站点目录,而不是先前通过测试的临时文件。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成一次多平台发布验收

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

登录哪都通