跳转到内容

应用模块装配 ​

应用入口显式选择模块、构造依赖并接入宿主。不为装配新增业务进程,也不引入未实现的运行期 Starter 容器。

装配与部署 ​

CMake target 决定构建和链接依赖;应用配置决定本次启动启用什么;宿主负责已经注册的服务生命周期。三者不能互相代替。

业务程序所属服务边界
loginServer认证、服务目录、在线目录不保存玩法档案
gateway连接、准入、分开的 Base/World 转发不推进模拟或修改档案
baseServerbase::Avatar、基础业务、结算校验向 database 提交存储请求
worldServercell 注册、Space/Cell 分配、拓扑与迁移记录管理职责,对照 CellAppMgr
cellWorldHost、Scene/Instance、Avatar、Lua 的执行职责玩法快照和逐玩家 Base 关联,独立入口待实现
database存储操作、队列、journal、连接不制定奖励或战斗规则
machined本机拉起、监督与重启不决定玩家归属或跨服落点

apps/common 是可复用实现库,Base/database 独立入口已存在,默认编队的宿主归属和网络接线仍需迁移,见服务器应用。共享代码不合并进程职责,World 独立注册不依赖同机 machined。

模块依赖 ​

应用通过既有 CMake target 链接模块。组件依赖应在构建和启动期显式可见,不在消息处理时按字符串动态搜索实现,也不通过运行期扫描来决定进程拓扑。

需要构造注入时使用 ApplicationContextBuilder;需要生命周期管理时使用 ApplicationHost / ServiceHost 或 WorldHost。是否使用依赖注入不改变服务的唯一所有者。当前应用仍有显式构造与停止逻辑,不能写成全部已迁入容器。

启动与停止 ​

  1. 校验应用配置及契约产物。
  2. 初始化日志、崩溃采集和应用所需设施。
  3. 构造所属服务及其依赖,启动监听与执行线程。
  4. 按服务就绪状态开放准入。
  5. 停止时关闭新准入、排空工作并释放业务状态,再逆序关闭依赖。

以上是装配规则;各入口的就绪闸、排空期限和异常补偿必须分别实现和验证。CMake 链接成功不代表网络端点就绪,也不代表启动失败能完整恢复。

Lua 与热更新 ​

当前脚本后端使用 Lua C API 和 ScriptRuntime。补丁只在所属逻辑边界提交,不运行期增删 C++ 服务。代码更新和协议更新分开验收。

跨服预留 ​

普通与跨服场景复用同一 World 管理与 cell 执行职责、Scene/Instance 原语。以后可按部署配置选择承载跨服活动的 World 池,不能据此引入新的进程角色或同义对象。参见跨服场景设计。

关联文档 ​

基于 MIT 许可发布