15.8 阶段 7 打包发行与热更新
本页目录
一、阶段定位
本阶段解决「让玩家从应用商店下载并能持续更新」:多平台构建、签名、分包、Asset Bundle、热更新、版本号与回滚。前面阶段做的 Demo 在编辑器里跑,本阶段做完能在手机上安装、能下热更包、出问题能回滚。这些概念如果只靠「点 Build」,到包体超限、热更失败、版本号错乱这三类上线事故时会完全不知道从哪下手。
不掌握本阶段会在后面具体卡在哪:
- 包体 1.2GB,应用商店审核不通过。
- 热更包下载失败,玩家卡在启动页。
- 版本号 1.0.0 发出去后,下一个版本不知道该写 1.0.1 还是 1.1.0。
- iOS 出包必须用 Mac,Windows 上不知道怎么搞。
判断卡住的标志:让你说清「从代码到玩家手机」的完整链路,你只能说「点 Build」,说不出签名、Provisioning Profile、AB 分包、CDN、版本号这些环节。出现任一现象,先把本阶段六个模块过一遍再进 阶段 8 商业化与工程化(可选)。
二、阶段目标与投入
| 能力目标 | 验证方式 |
|---|---|
| 能出 Android APK/AAB 与 iOS IPA | 真机安装运行 |
| 能配置签名与 Provisioning Profile | 出包不报错 |
| 能用 Asset Bundle 或 Addressables 做资源分包 | 首包只含必需资源 |
| 能做热更:启动检查版本、下载差量、失败回滚 | 真机跑通一次完整流程 |
| 能说清版本号规则(SemVer) | 版本号递增合理 |
| 能配置 CDN 与回滚 | 热更包可回滚到上一版 |
建议学时:全职 2.5–3 周(约 60–70 小时);在职每天 2 小时约 6–7 周。学时分配:多平台构建 20%、签名与证书 15%、分包与 AB 25%、热更流程 25%、版本号与回滚 15%。
三、先修自检
| 先修项 | 合格标准 | 不合格时怎么办 |
|---|---|---|
| 阶段 5 | 能跑通包体瘦身 | 回到 15.6 |
| 阶段 6 | 能跑通联机 | 回到 15.7 |
| 命令行 | 知道怎么跑脚本 | 模块 5.2 会讲 |
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| 构建 | Build Settings、Scene List、Build 选项 | 会用 | 13.7 工程化、热更新与发行 |
| 签名 | Android Keystore、iOS Provisioning | 会用 | 13.7 工程化、热更新与发行 |
| 分包 | Asset Bundle、Addressables、Pak、PCK | 能讲清原理 | 13.7 工程化、热更新与发行 |
| 热更 | 版本检查、差量下载、回滚、CDN | 能讲清原理 | 13.7 工程化、热更新与发行 |
| 版本号 | SemVer、版本对比、强制更新 | 会用 | 13.7 工程化、热更新与发行 |
| 平台 | Android / iOS / 微信小游戏 / PC | 了解 | 13.5 Cocos Creator 与小游戏 |
五、分模块精讲
5.1 多平台构建
为什么需要它:PC 跑的代码不能直接在手机上跑,需要切平台配置、选架构、配图标。
核心机制:
- Build Settings:选平台、选 Scene List。
- Android:APK(调试)与 AAB(上架 Google Play)。
- iOS:必须 Mac,出 IPA。
- 微信小游戏:Cocos 一键出微信包。
- 架构:ARM64(手机)、x86(PC)。
最小可运行示例:
# Unity Android 出包
1. File → Build Settings → 选 Android
2. 勾 Development 调试、Release 上架
3. Player Settings 配包名、版本号、图标
4. 点 Build
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 出包报错 SDK 没装 | Android SDK 未配 | Unity Hub 装 SDK |
| iOS 出包失败 | 没 Mac | 用 Mac 云构建 |
面试考法:问「APK 与 AAB 的区别」。要答到「APK 调试、AAB 上架 Google Play」。
5.2 签名与证书
为什么需要它:Android 没签名不能安装,iOS 没 Provisioning Profile 不能真机调试。
核心机制:
- Android Keystore:一个密钥文件,所有版本都用它签。
- iOS Certificate:Apple Developer 申请,配 Provisioning Profile。
- 证书丢失:下次更新不能上架,必须备份。
- 证书与包名绑定:换包名要重签。
最小可运行示例:
# Android 签名
1. Unity Player Settings → Publishing Settings
2. 勾 Create New Keystore
3. 设密码、别名、有效期
4. 备份 Keystore 到安全位置
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 更新不能上架 | Keystore 丢了 | 永远找不回,必须备份 |
| iOS 真机装不上 | Provisioning 未配 | 用 Xcode 自动管理 |
面试考法:问「Android 签名为什么要备份」。要答到「丢了下次更新不能上架」。
5.3 分包与 Asset Bundle
为什么需要它:首包 200MB 限制,玩家下载意愿随大小指数下降。把非必需资源做成 AB,启动时按需下载。
核心机制:
- Asset Bundle:把资源打包成独立文件,运行时加载。
- Addressables:Unity 官方 AB 高层封装,按地址引用。
- Pak:Unreal 资源包。
- PCK:Godot 资源包。
- 依赖管理:AB 之间有依赖,要先生成依赖图。
最小可运行示例:
// Unity Addressables 加载
using UnityEngine;
using UnityEngine.AddressableAssets;
public class LoadLevel : MonoBehaviour
{
async void Start()
{
var handle = Addressables.LoadSceneAsync("Level1");
await handle.Task;
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| AB 重复加载 | 没缓存 | 用 Addressables 自动缓存 |
| AB 依赖错 | 没先生成依赖 | 用 Addressables 自动管理 |
面试考法:问「AB 与 Resources 的区别」。要答到「Resources 打进首包、AB 可热更、Resources 不灵活」。
5.4 热更新流程
为什么需要它:玩家装了首包,后续内容更新不用重新下载整个游戏。启动时检查版本,下载差量。
核心机制:
- 启动页:显示进度条,先查版本。
- 版本清单:CDN 上一个 JSON,列出最新资源与 hash。
- 差量下载:对比本地与清单,只下缺失的。
- 失败回滚:下载失败用旧资源,不卡死。
- 强制更新:版本过低强制更新客户端。
最小可运行示例:
# 热更流程
1. 启动 → 查 CDN 上 version.json
2. 对比本地版本
3. 不同 → 下载 diff manifest
4. 逐个下载缺失 AB,校验 hash
5. 全部成功 → 启动游戏
6. 失败 → 回滚到上一版本
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 卡启动页 | 下载失败 | 失败回滚旧资源 |
| 热更后白屏 | hash 校验错 | 重新下载 |
| 强制更新弹窗 | 版本过低 | 引导去商店 |
面试考法:问「热更失败怎么处理」。要答到「失败回滚、用旧资源、不卡死」。
5.5 版本号规则
为什么需要它:版本号混乱会导致热更判断错误、强制更新错乱。
核心机制:
- SemVer:MAJOR.MINOR.PATCH,如 1.2.3。
- MAJOR:不兼容改动。
- MINOR:新功能向后兼容。
- PATCH:bug 修复。
- 版本对比:逐段比较,1.10.0 > 1.9.0。
最小可运行示例:
# 版本号示例
1.0.0 首版上架
1.0.1 修 bug
1.1.0 加新关卡
2.0.0 大改不兼容
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 热更判断错 | 版本号字符串比较 | 逐段数字比较 |
| 1.10.0 < 1.9.0 | 字符串比较 | 逐段数字比较 |
面试考法:问「SemVer 是什么」。要答到「主.次.修订,语义化版本」。
5.6 CDN 与回滚
为什么需要它:热更包要让玩家快速下载,用 CDN 加速。出问题要能回滚到上一版。
核心机制:
- CDN:多节点分发,国内用阿里云/腾讯云 CDN。
- 版本目录:
/v1/、/v2/,不删旧版本。 - 回滚:version.json 指向旧版本。
- 灰度:先放 10% 用户,观察崩溃率再全量。
最小可运行示例:
# CDN 目录结构
cdn.example.com/game/
version.json # 当前指向 v2
v1/ab/... # 旧版本保留
v2/ab/... # 新版本
hotfix/ab/... # 紧急修复
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 下载慢 | CDN 没配 | 用国内 CDN |
| 回滚后玩家仍下新版 | CDN 缓存 | 刷新 CDN 缓存 |
面试考法:问「热更怎么灰度」。要答到「先 10% 用户、观察崩溃率、再全量」。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 出 Android 包 | 真机安装运行 | 不报错 | 3 小时 |
| 配 Keystore | 备份到安全位置 | 下次更新能签 | 1 小时 |
| 用 Addressables 分包 | 首包不含 Level2 | 启动后下载 Level2 | 4 小时 |
| 热更流程 | 启动检查版本、下载、启动 | 真机跑通 | 6 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 热更失败回滚 | 断网模拟失败 | 回滚旧资源不卡死 | 3 小时 |
| 版本号对比 | 1.10.0 > 1.9.0 | 逐段数字比较 | 1 小时 |
| 灰度发布 | 10% 用户先更新 | 版本清单带用户标签 | 3 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 设计分包方案 | 首包/热更资源各含什么 | 首包 < 200MB | 2 小时 |
| 设计热更清单 | version.json 字段 | 含版本号、AB 列表、hash | 2 小时 |
| 设计回滚策略 | 出问题怎么回滚 | 不丢用户进度 | 1 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
| 出包报错 SDK 没装 | Android SDK 未配 | Unity Hub 看模块 | 装 SDK |
| 真机装不上 Android | 没签名 | 看 Player Settings | 配 Keystore |
| iOS 出包失败 | 没 Mac | 看构建机 | 用 Mac 云构建 |
| 热更卡启动页 | 下载失败 | 看日志 | 失败回滚 |
| 热更后白屏 | hash 校验错 | 看 manifest | 重新下载 |
| 热更判断错 | 版本号字符串比较 | 看版本对比代码 | 逐段数字比较 |
| 下载慢 | CDN 没配 | 看下载速度 | 用国内 CDN |
| 回滚后仍下新版 | CDN 缓存 | 看 CDN 节点 | 刷新缓存 |
八、出口条件
全部勾选后进入 阶段 8 商业化与工程化(可选)。
- [ ] 能出 Android APK 与 iOS IPA,真机安装
- [ ] 能配置签名并备份 Keystore
- [ ] 能用 Addressables 做资源分包
- [ ] 能做热更:检查版本、下载差量、失败回滚
- [ ] 能说清 SemVer 版本号规则
- [ ] 能配置 CDN 与回滚策略
- [ ] 排障表里随机抽三个现象,能在 5 分钟内给出排查路径
自测题:
- APK 与 AAB 的区别?
- 要点:APK 调试、AAB 上架 Google Play。
- Android 签名为什么要备份?
- 要点:丢了下次更新不能上架。
- AB 与 Resources 的区别?
- 要点:Resources 打进首包、AB 可热更。
- 热更失败怎么处理?
- 要点:失败回滚、用旧资源、不卡死。
- SemVer 是什么?
- 要点:主.次.修订,语义化版本。
- 热更怎么灰度?
- 要点:先 10% 用户、观察崩溃率、再全量。