构建系统现代化

BigWorld 的构建系统混合了 Make、CMake 和平台脚本，版本老旧。本文档规划构建系统的现代化路径。

当前状态

构建入口

入口	平台	状态
programming/Makefile	Linux	主要
programming/bigworld/CMakeLists.txt	Windows	主要
build/docker/Dockerfile	Docker	辅助
build/*.bat	Windows	辅助

版本基线

工具	当前版本	推荐版本
CMake	2.8.12	3.20+
GCC	4.8.x	11+
Clang	-	14+ (可选)
Make	GNU Make	保持
Docker	CentOS 7	Ubuntu 22.04

升级路径

第一阶段：CMake 现代化

目标: 从 CMake 2.8 升级到 3.20+

主要变更:

1. 最低版本要求

# 旧
cmake_minimum_required(VERSION 2.8.12)

# 新
cmake_minimum_required(VERSION 3.20)

2. 目标属性

# 旧
include_directories(${CMAKE_SOURCE_DIR}/lib)
add_executable(bigworld main.cpp)
target_link_libraries(bigworld network)

# 新
add_executable(bigworld main.cpp)
target_include_directories(bigworld PRIVATE ${CMAKE_SOURCE_DIR}/lib)
target_link_libraries(bigworld PRIVATE network)

3. 生成器表达式

# 旧
if(CMAKE_BUILD_TYPE STREQUAL "Debug")
    add_definitions(-DDEBUG)
endif()

# 新
target_compile_definitions(bigworld PRIVATE
    $<$<CONFIG:Debug>:DEBUG>
)

第二阶段：平台基线更新

目标: 从 CentOS 7 升级到现代 Linux

新 Dockerfile:

# 旧
FROM centos:7

# 新
FROM ubuntu:22.04

RUN apt-get update && apt-get install -y \
    build-essential \
    cmake \
    python3-dev \
    libssl-dev \
    libmysqlclient-dev \
    libsqlite3-dev \
    && rm -rf /var/lib/apt/lists/*

依赖变更:

CentOS 7 包	Ubuntu 22.04 包
python-devel	python3-dev
mariadb-devel	libmysqlclient-dev
sqlite-devel	libsqlite3-dev
openssl-devel	libssl-dev

第三阶段：编译器升级

目标: 支持 C++17/20

CMake 配置:

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

编译器标志:

# 警告级别
add_compile_options(-Wall -Wextra -Wpedantic)

# 安全检查
add_compile_options(-fstack-protector-strong -D_FORTIFY_SOURCE=2)

CI/CD 集成

GitHub Actions

name: Build

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-22.04
    strategy:
      matrix:
        compiler: [gcc-11, clang-14]
    
    steps:
    - uses: actions/checkout@v3
    
    - name: Install dependencies
      run: |
        sudo apt-get update
        sudo apt-get install -y cmake python3-dev libssl-dev
    
    - name: Configure
      run: cmake -B build -DCMAKE_BUILD_TYPE=Release
    
    - name: Build
      run: cmake --build build -j$(nproc)
    
    - name: Test
      run: cd build && ctest --output-on-failure

Docker 构建

# 构建镜像
docker build -t bigworld-build -f build/docker/Dockerfile .

# 运行构建
docker run --rm -v $(pwd):/src bigworld-build \
    cmake -B build -DCMAKE_BUILD_TYPE=Release
docker run --rm -v $(pwd):/src bigworld-build \
    cmake --build build -j$(nproc)

迁移步骤

步骤一：CMake 升级

1. 更新 cmake_minimum_required
2. 替换废弃命令
3. 添加现代目标属性
4. 测试所有平台

步骤二：平台升级

1. 创建新 Dockerfile
2. 更新依赖包名
3. 测试构建
4. 更新文档

步骤三：编译器升级

1. 设置 C++ 标准
2. 修复编译警告
3. 启用安全检查
4. 性能测试

风险与缓解

风险	影响	缓解措施
CMake 命令废弃	构建失败	逐步替换，保持兼容
依赖包名变更	安装失败	文档更新，脚本适配
编译器警告增多	构建噪音	逐步修复，分阶段启用
性能回退	运行变慢	基准测试，回退机制

验证清单

• [ ] Linux 构建通过
• [ ] Windows 构建通过
• [ ] Docker 构建通过
• [ ] 单元测试通过
• [ ] 集成测试通过
• [ ] 性能无回退
• [ ] 文档更新

参考资料

• CMake 文档
• GCC 文档
• 构建与运行体系