跳转到内容

模块系统 ​

Apollo 采用分层模块化架构,每个模块职责清晰,可以独立使用。

模块分层 ​

┌─────────────────────────────────────────────────────────────────┐
│                        Applications                              │
└─────────────────────────────────────────────────────────────────┘
                                ↓
┌──────┬──────┬──────┬───────┬────────┬─────────┬─────────┬──────┐
│  net │ data │ game │protocol│contract│bigworld │ runtime │ core │
└──────┴──────┴──────┴───────┴────────┴─────────┴─────────┴──────┘
                                ↓
┌─────────────────────────────────────────────────────────────────┐
│                        Base                                      │
└─────────────────────────────────────────────────────────────────┘

使用模块 ​

CMakeLists.txt 配置 ​

cmake
add_subdirectory(path/to/apollo)

target_link_libraries(my_app
    apollo::core
    apollo::net_core
)

条件加载 ​

cmake
if(APOLLO_BUILD_GAME_MODULE)
    target_link_libraries(my_app apollo::game_world)
endif()

模块依赖 ​

重要规则:

  • 上层模块可以依赖下层模块
  • 下层模块不能依赖上层模块
  • 同层模块尽量避免相互依赖
net ← runtime
data ← core
game ← core

自定义模块 ​

1. 创建模块目录 ​

modules/
└── mymodule/
    ├── include/
    │   └── apollo/
    │       └── mymodule/
    │           └── api.hpp
    ├── src/
    │   └── impl.cpp
    └── CMakeLists.txt

2. 编写 CMakeLists.txt ​

cmake
add_library(apollo_mymodule STATIC
    include/apollo/mymodule/api.hpp
    src/impl.cpp
)

target_include_directories(apollo_mymodule
    PUBLIC
        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
        $<INSTALL_INTERFACE:include>
)

target_link_libraries(apollo_mymodule
    PUBLIC apollo::base
    PRIVATE apollo::core
)

add_library(apollo::mymodule ALIAS apollo_mymodule)

下一步 ​

了解 配置系统。

基于 MIT 许可发布