安装 Apollo
环境要求
- 操作系统: Windows 10+, Linux (Ubuntu 20.04+), macOS 11+
- 编译器(日志内核使用 C++20
std::source_location,因此标准库需提供<source_location>):- Windows: MSVC STL 19.26+ (Visual Studio 2019 16.6+)
- Linux: GCC 11+ 或 Clang 16+(libstdc++ 11+ / libc++ 16+)
- macOS: Apple Clang 16+ 且 libc++ 16+(Xcode 16+)
- CMake: 3.20+
- vcpkg: 2023.0+ (用于依赖管理)
安装步骤
1. 安装 vcpkg
bash
# 克隆 vcpkg
git clone https://github.com/microsoft/vcpkg.git C:/vcpkg
cd C:/vcpkg
# 运行 bootstrap
./bootstrap-vcpkg.bat # Windows
# 或
./bootstrap-vcpkg.sh # Linux/macOS2. 安装依赖
bash
# 仓库采用 vcpkg 清单模式(vcpkg.json),CMake configure 期自动安装全部依赖
#(openssl / lua / protobuf / gtest / curl / nlohmann-json / pugixml,Linux 另含 readline / crashpad),
# 无需手工逐个安装:
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=<vcpkg-root>/scripts/buildsystems/vcpkg.cmake3. 克隆 Apollo
bash
git clone https://github.com/cuihairu/apollo.git
cd apollo4. 配置与构建
Windows
bash
cmake -B build -DCMAKE_BUILD_TYPE=Release ^
-DCMAKE_TOOLCHAIN_FILE=C:/vcpkg/scripts/buildsystems/vcpkg.cmake ^
-DAPOLLO_ENABLE_MODULAR_LAYOUT=ON
cmake --build build --config ReleaseLinux/macOS
bash
cmake -B build -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_TOOLCHAIN_FILE=/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake \
-DAPOLLO_ENABLE_MODULAR_LAYOUT=ON
cmake --build build -j$(nproc)5. 验证安装
bash
# 运行测试
ctest --test-dir build --output-on-failure
# 运行示例(world 入口自检)
./build/apps/world/world --help目录结构
apollo/
├── apps/ # 可执行程序
├── modules/ # 模块源码
│ ├── base/ # 基础模块
│ ├── core/ # 核心模块
│ ├── runtime/ # 运行时模块
│ ├── data/ # 数据访问模块
│ ├── net/ # 网络模块
│ ├── protocol/ # 协议模块
│ ├── contract/ # 契约模块
│ ├── game/ # 游戏模块
│ └── bigworld/ # BigWorld 兼容层
├── include/ # 公共头文件
├── tests/ # 测试代码
└── docs/ # 文档下一步
安装完成后,继续阅读 快速开始。
