posts

《移动游戏产品的架构·客户端与移动运行时》 · 全书目录与章节索引（45 篇）

卷一《客户端与移动运行时》45 篇索引：13 章覆盖双案例与移动约束、四层分层、引擎与壳、生命周期、配置、资源内存、UI、设备、帧率功耗、存档、区域化、可观测性与收口基线，附可运行的 mga-lab 实验工程与三篇附录，每章三节构成一条可复盘的判断链。

全书 45 篇 = 序、前言、目录 3 篇 + 13 章 39 节 + 附录 A/B/C 3 篇。
双案例：《潮汐消消》（休闲）为主案例，《潮汐方舟》（中重度）为对照；两者共用一个发行中台。
正文代码块带 // file: / // tier: / // verify: 头，可在实验工程 mga-lab 中逐字节还原并运行测试。

这本卷回答什么

移动游戏的客户端架构不是「把引擎 API 包一层」，而是在内存、电量、发热、网络、机型五条约束下，决定哪些能力共用、哪些实现隔离。卷一给出这套判断的可执行版本：四层依赖、Host 契约、生命周期状态机、配置契约、资源与内存预算、UI 与输入仲裁、帧预算、存档恢复与可观测性，最后收口到两款产品的客户端基线。

阅读前提

熟悉 TypeScript 或任一静态类型语言，能读懂接口与状态机。
做过至少一个移动端项目，知道冷启动、切后台、弱网和机型分档的真实含义。
不要求会写引擎；本书把引擎当作 Host，重点在引擎之上的产品架构。

全卷概览

章	主题	节数	核心产物
1	架构问题与双案例	3	`src/core/layers.ts`, `src/core/result.ts`
2	客户端分层与模块边界	3	`src/core/layers.ts`, `src/domain/match3.ts`
3	引擎与原生壳的边界	3	`src/platform/host-mock.ts`, `src/platform/host.ts`
4	应用生命周期与恢复	3	`src/runtime/lifecycle.ts`, `src/runtime/resume.ts`
5	配置驱动的玩法数据	3	`src/config/schema.ts`, `src/config/table.ts`, `src/config/version-migrate.ts`
6	资源管线与内存	3	`src/resource/cache.ts`, `src/resource/graph.ts`, `src/resource/memory-budget.ts`
7	UI 架构与交互	3	`src/ui/layout-model.ts`, `src/ui/popup-arbiter.ts`, `src/ui/screen-stack.ts`
8	设备与输入适配	3	`src/input/device-tiers.ts`, `src/input/form-factors.ts`, `src/input/gesture.ts`
9	帧率、功耗与发热	3	`src/runtime/frame-budget.ts`, `src/runtime/thermal.ts`
10	存档与云存档	3	`src/save/merge.ts`, `src/save/migrate.ts`, `src/save/store.ts`
11	多语言、时区与区域化	3	`src/i18n/catalog.ts`, `src/i18n/region.ts`, `src/i18n/timezone.ts`
12	客户端可观测性	3	`src/obs/crash-model.ts`, `src/obs/event.ts`, `src/obs/sampling.ts`
13	卷一收口：双案例客户端基线	3	`src/lab/module-matrix.ts`, `src/lab/review-gate.ts`, `src/resource/perf-baseline.ts`

前置

第 1 章架构问题与双案例

节	文章	代码产物
1.1	1.1 一个 IP 两款产品：为什么客户端架构不能按品类复制	`src/core/layers.ts`
1.2	1.2 移动端约束清单：内存、电量、发热、网络、机型	`src/core/layers.ts`
1.3	1.3 mga-lab 的分层骨架与验收口径	`src/core/result.ts`

第 2 章客户端分层与模块边界

节	文章	代码产物
2.1	2.1 表现、玩法、系统、平台四层与依赖方向	`src/core/layers.ts`
2.2	2.2 纯逻辑内核：把玩法从引擎里拆出来	`src/domain/match3.ts`
2.3	2.3 边界测试：依赖规则写成可执行断言	`src/core/layers.ts`

第 3 章引擎与原生壳的边界

节	文章	代码产物
3.1	3.1 引擎负责什么，原生壳负责什么	`src/platform/host.ts`
3.2	3.2 桥接层设计：消息、线程与生命周期	`src/platform/host-mock.ts`
3.3	3.3 双案例壳层差异：轻壳与重壳	`src/platform/host-mock.ts`

第 4 章应用生命周期与恢复

节	文章	代码产物
4.1	4.1 冷启动、热启动与后台挂起	`src/runtime/lifecycle.ts`
4.2	4.2 状态保存与恢复：快照与操作日志	`src/runtime/resume.ts`
4.3	4.3 杀进程与异常退出的兜底	`src/runtime/lifecycle.ts`

第 5 章配置驱动的玩法数据

节	文章	代码产物
5.1	5.1 配置 schema 与版本化	`src/config/schema.ts`
5.2	5.2 校验、引用完整性与灰度	`src/config/table.ts`
5.3	5.3 策划工作流：从表格到线上	`src/config/version-migrate.ts`

第 6 章资源管线与内存

节	文章	代码产物
6.1	6.1 资源句柄、引用计数与生命周期	`src/resource/graph.ts`
6.2	6.2 内存水位与低端机降级	`src/resource/memory-budget.ts`
6.3	6.3 资源泄漏定位与回归	`src/resource/cache.ts`

第 7 章 UI 架构与交互

节	文章	代码产物
7.1	7.1 UI 栈、弹窗队列与返回键语义	`src/ui/screen-stack.ts`
7.2	7.2 多分辨率、刘海屏与安全区	`src/ui/layout-model.ts`
7.3	7.3 触控仲裁与误触防护	`src/ui/popup-arbiter.ts`

第 8 章设备与输入适配

节	文章	代码产物
8.1	8.1 触控、陀螺仪与传感器抽象	`src/input/gesture.ts`
8.2	8.2 机型分档与画质策略配置化	`src/input/device-tiers.ts`
8.3	8.3 平板、折叠屏与异形屏	`src/input/form-factors.ts`

第 9 章帧率、功耗与发热

节	文章	代码产物
9.1	9.1 帧率分级与动态分辨率	`src/runtime/frame-budget.ts`
9.2	9.2 每帧预算与主线程任务切片	`src/runtime/frame-budget.ts`
9.3	9.3 功耗与发热的验收方法	`src/runtime/thermal.ts`

第 10 章存档与云存档

节	文章	代码产物
10.1	10.1 存档格式与迁移	`src/save/store.ts`
10.2	10.2 云存档冲突与合并	`src/save/merge.ts`
10.3	10.3 防篡改与回滚	`src/save/migrate.ts`

第 11 章多语言、时区与区域化

节	文章	代码产物
11.1	11.1 文本、字体与排版	`src/i18n/catalog.ts`
11.2	11.2 时区、服务器时间与本地时间	`src/i18n/timezone.ts`
11.3	11.3 区域化配置与内容分级	`src/i18n/region.ts`

第 12 章客户端可观测性

节	文章	代码产物
12.1	12.1 崩溃、ANR 与卡顿的采集边界	`src/obs/crash-model.ts`
12.2	12.2 日志分级、采样与隐私脱敏	`src/obs/sampling.ts`
12.3	12.3 线上问题定位闭环	`src/obs/event.ts`

第 13 章卷一收口：双案例客户端基线

节	文章	代码产物
13.1	13.1 模块矩阵与依赖报告	`src/lab/module-matrix.ts`
13.2	13.2 性能预算与机型分档基线	`src/resource/perf-baseline.ts`
13.3	13.3 卷一评审与进入卷二	`src/lab/review-gate.ts`

附录

篇	内容
附录 A 术语与指标速查	全书统一口径：帧预算、内存水位、包体、崩溃率、Jank 率
附录 B 双案例唯一事实表	两款产品的 DAU、平台、机型、包体、帧率、联网与收入结构
附录 C 客户端架构评审清单	分层、生命周期、资源、UI、性能、存档、可观测性七组检查项