应用模块装配
应用入口显式选择模块、构造依赖并接入宿主。不为装配新增业务进程,也不引入未实现的运行期 Starter 容器。
装配与部署
CMake target 决定构建和链接依赖;应用配置决定本次启动启用什么;宿主负责已经注册的服务生命周期。三者不能互相代替。
| 业务程序 | 所属服务 | 边界 |
|---|---|---|
| loginServer | 认证、服务目录、在线目录 | 不保存玩法档案 |
| gateway | 连接、准入、分开的 Base/World 转发 | 不推进模拟或修改档案 |
| baseServer | base::Avatar、基础业务、结算校验 | 向 database 提交存储请求 |
| worldServer | cell 注册、Space/Cell 分配、拓扑与迁移记录 | 管理职责,对照 CellAppMgr |
| cell | WorldHost、Scene/Instance、Avatar、Lua 的执行职责 | 玩法快照和逐玩家 Base 关联,独立入口待实现 |
| database | 存储操作、队列、journal、连接 | 不制定奖励或战斗规则 |
| machined | 本机拉起、监督与重启 | 不决定玩家归属或跨服落点 |
apps/common 是可复用实现库,Base/database 独立入口已存在,默认编队的宿主归属和网络接线仍需迁移,见服务器应用。共享代码不合并进程职责,World 独立注册不依赖同机 machined。
模块依赖
应用通过既有 CMake target 链接模块。组件依赖应在构建和启动期显式可见,不在消息处理时按字符串动态搜索实现,也不通过运行期扫描来决定进程拓扑。
需要构造注入时使用 ApplicationContextBuilder;需要生命周期管理时使用 ApplicationHost / ServiceHost 或 WorldHost。是否使用依赖注入不改变服务的唯一所有者。当前应用仍有显式构造与停止逻辑,不能写成全部已迁入容器。
启动与停止
- 校验应用配置及契约产物。
- 初始化日志、崩溃采集和应用所需设施。
- 构造所属服务及其依赖,启动监听与执行线程。
- 按服务就绪状态开放准入。
- 停止时关闭新准入、排空工作并释放业务状态,再逆序关闭依赖。
以上是装配规则;各入口的就绪闸、排空期限和异常补偿必须分别实现和验证。CMake 链接成功不代表网络端点就绪,也不代表启动失败能完整恢复。
Lua 与热更新
当前脚本后端使用 Lua C API 和 ScriptRuntime。补丁只在所属逻辑边界提交,不运行期增删 C++ 服务。代码更新和协议更新分开验收。
跨服预留
普通与跨服场景复用同一 World 管理与 cell 执行职责、Scene/Instance 原语。以后可按部署配置选择承载跨服活动的 World 池,不能据此引入新的进程角色或同义对象。参见跨服场景设计。
