应用生命周期与系统管理

1. 模块定位与设计思路#

游戏层不是由一个巨大 main() 从头到尾顺序运行。CApp 接入 RAGE 的 fwApp，负责应用状态与帧边界；CGame 管理游戏子系统的分阶段初始化、更新、绘制组织与关闭；CGameSessionStateMachine 推进新游戏、存档、登录与关卡切换。这三种生命周期具有不同粒度，理解它们是理解其他模块依赖的前提。

Core/main.cpp 的 Main() 明确断言 GTA V 使用 App 风格入口。因此，这个函数不是适合追踪正常游戏主循环的起点。平台启动细节属于 RAGE 和平台适配，游戏层阅读应从 Core/app.h、app.cpp 开始。

2. 核心对象与责任边界#

3. 一帧怎样执行#

以下顺序来自 app.cpp 1344 行附近；图示保留关键同步点，不表示所有子系统都串行执行。

CGame::Render() 的调用点注释说明，它在这里主要构建 draw lists 和 contexts。因此 CPU 的 Render 区段、渲染线程和 GPU 工作并不是同一件事。定位卡顿应分别检查游戏更新、同步等待、绘制准备与 GPU 时间，不能用单个 Render() 耗时替代整个图形管线耗时。

游戏更新通过 REGISTER_UPDATE_CALL 及计时变体组织。在公共更新中可以看到存档、配置、DLC、统计、网络和脚本管理更新；主游戏路径进一步包含 Streaming、Ped/Vehicle assets、世界人口、实体处理、摄像机、TimeCycle、HUD 与音频。暂停、前端及商城等路径有各自的更新集合。

特别要区分 CTheScripts::Update 与 CTheScripts::Process：二者分别出现在注册表的不同位置，而且当前快照的 Update() 函数体为空，真正的脚本处理在 Process/InternalProcess。确定某状态下脚本是否执行，必须沿当前选择的更新集合追踪，不能仅根据 Update 注册项判断。

4. 生命周期是可组合的阶段#

game.cpp 同时存在初始化、关闭和更新注册。Streaming 还有 InitLevelWithMapUnloaded、加载地图后的初始化及会话关闭等不同接口，说明“启动应用”“启动一局”“重载关卡”不是同一个操作。

这种设计避免每次切换会话都重建所有长期存活的静态数据，也允许在关卡或会话级别释放对象。代价是每个模块必须准确匹配资源所属阶段：会话对象若被长期管理器持有，重启后容易残留；长期资源若被会话关闭释放，则后续重入可能失效。这是由接口结构导出的维护风险，并非本次确认的缺陷。

会话状态枚举包括 START_AUTOLOAD、LOAD_PROFILE、ENUMERATE_SAVED_GAMES、WAIT_FOR_SAVE_GAME、LOAD_LEVEL、CHANGE_LEVEL 等。在 PC 条件分支下还包括 RGSC、entitlement 和 Steam 验证状态，部分平台有 Landing Page 流程。不能把这个枚举直接画成所有状态必经的线性启动链；不同平台、登录状态和用户选择决定跳转。

5. 任务并发与输入#

TaskScheduler.h 定义 CTaskParams，包含 3 个 union 用户参数；管理器维护 32 个 task handle 槽位，以及 batch size、batch count 等状态。AddTask、Flush、StartBatchingTasks、WaitOnResults 构成提交和收敛接口。这里的 32 是此封装的槽位数，不是 CPU 线程数，也不能据此判断引擎最多并行执行 32 个任务。

批处理减少重复提交成本，但会让“调用 AddTask”和“工作已经完成”之间出现时间差。所有由异步任务读取的参数、对象和缓冲区都必须覆盖实际执行期；后续阶段消费结果前需要使用规定的同步接口。app.cpp 在输入更新与绘制列表准备之间安排重叠，是这类并发设计的一个直接实例。

输入目录中同时存在原始设备类、控制映射、手势和设置管理。分析输入问题时，应沿“设备状态 → 映射语义 → 当前上下文 → 角色/菜单消费”定位，而不要仅检查某个按键是否按下；前端与玩法争用输入的判定位于不同层。

6. 平台、资格与观测边界#

UserEntitlementService、IUserEntitlementDataProvider、平台 dongle 文件及 system/EntitlementManager 显示资格流程有服务接口与平台实现。security/ 和 TamperActions 属于游戏运行的保护性支持设施；它们不应被误列为任务或世界模拟模块。是否参与当前构建需以宏与工程条目为准，不能把目录中的全部分支叠加为一个运行流程。

大量 __BANK、__DEV、__FINAL、平台宏同时控制调试 UI、统计、验证和平台行为。profiling 注册中的毫秒预算是开发观测标签，不能直接当作实际测试结果或当前硬件的性能保证。

7. 维护与阅读建议#

新增子系统需要依次明确初始化阶段、更新相对顺序、暂停/前端行为、异步收敛点和关闭阶段。修改更新时间应检查所有注册路径，而不仅是正常世界更新。排查会话切换残留时，优先比较第一次启动与重新进入会话的 init/shutdown 集合。

重点静态复核场景包括：从菜单进入游戏、存档重载、切换关卡、暂停恢复、登录变化、退出时尚有异步工作。本文未运行这些场景；它们是根据生命周期边界提出的后续验证方向。

8. 源码依据#

关联：场景、流式加载、脚本、调试与性能。