游戏客户端架构 / 系统课时

划分构建目标

划分构建目标

本课将工程拆成 engine 静态库、game 游戏程序和 asset_tool 工具程序三个独立目标。这样可以复用引擎代码、缩短无关模块的重新编译时间,并为后续测试、编辑器和资源流水线预留清晰边界。

学习目标

  • 使用 CMake 分别声明库目标和可执行目标
  • 正确设置目标之间的链接依赖与头文件可见范围
  • 单独构建并运行游戏程序和工具程序

为什么要拆分构建目标

如果引擎、游戏逻辑和工具代码全部放进一个可执行目标,任何文件变化都可能触发大范围重新编译,工具程序也会被迫依赖窗口、渲染或运行时模块。构建目标的职责是描述一个可独立编译和链接的产物,而不是简单对应一个源码文件夹。

本课采用单向依赖:game 和 asset_tool 都可以使用 engine,但 engine 不反向引用具体游戏或工具。该方向能避免循环依赖,也便于以后为引擎库添加单元测试。

引擎库与程序目标的依赖关系

创建工程目录

建立下面的目录结构。公共头文件放在 engine/include,实现文件放在 engine/src,两个可执行程序分别保留自己的入口文件。

text
engine-target-demo/
├── CMakeLists.txt
├── engine/
│   ├── include/engine/Application.hpp
│   └── src/Application.cpp
├── game/main.cpp
└── tools/asset_tool.cpp

这种布局让使用者通过 #include <engine/Application.hpp> 引用公共接口,而无需知道引擎实现文件的位置。

定义三个构建目标

在根目录创建 CMakeLists.txt。engine 使用静态库,两个程序通过 target_link_libraries 显式声明对它的依赖。

cmake
cmake_minimum_required(VERSION 3.24)
project(engine_target_demo LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

add_library(engine STATIC
    engine/src/Application.cpp
)

target_include_directories(engine
    PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}/engine/include
)

add_executable(game
    game/main.cpp
)
target_link_libraries(game PRIVATE engine)

add_executable(asset_tool
    tools/asset_tool.cpp
)
target_link_libraries(asset_tool PRIVATE engine)

target_include_directories 使用 PUBLIC,因为 engine 的使用者需要看到公共头文件目录。两个可执行程序链接引擎时使用 PRIVATE,表示它们不会继续向其他目标传播该依赖。

实现可复用的引擎接口

公共头文件只暴露调用者需要的接口,不放置游戏专属规则。创建 engine/include/engine/Application.hpp。

cpp
#pragma once

#include <string>

namespace engine {

class Application {
public:
    explicit Application(std::string name);
    void run() const;

private:
    std::string name_;
};

}

创建 engine/src/Application.cpp,在库内部完成具体实现。

cpp
#include <engine/Application.hpp>
#include <iostream>
#include <utility>

namespace engine {

Application::Application(std::string name)
    : name_(std::move(name)) {
}

void Application::run() const {
    std::cout << "Running application: " << name_ << "\n";
}

}

头文件属于稳定接口,实现文件属于库的内部细节。以后替换日志、窗口或渲染实现时,只要公共接口不变,调用方通常无需修改源码。

编写游戏与工具入口

游戏入口创建引擎应用并启动运行流程。创建 game/main.cpp。

cpp
#include <engine/Application.hpp>

int main() {
    const engine::Application game{"Sample Game"};
    game.run();
    return 0;
}

工具程序也复用同一个引擎接口,但拥有独立入口和输出职责。创建 tools/asset_tool.cpp。

cpp
#include <engine/Application.hpp>
#include <iostream>

int main() {
    const engine::Application tool{"Asset Tool"};
    tool.run();
    std::cout << "Assets validated successfully\n";
    return 0;
}

两个入口互不引用,因此修改工具流程不会把工具代码链接进游戏程序,修改游戏规则也不会影响工具目标的源码边界。

构建并验证目标

先完成配置,再分别构建两个可执行目标。--target 可以避免编译当前不需要的程序。

bash
cmake -S . -B build
cmake --build build --target game
cmake --build build --target asset_tool
./build/game
./build/asset_tool

预期输出

text
Running application: Sample Game
Running application: Asset Tool
Assets validated successfully

多配置生成器的可执行文件可能位于 build/Debug 或 build/Release。还可以运行 cmake --build build --target engine,只验证引擎静态库能否独立编译。

边界与常见错误

不要使用全局 include_directories 或 link_libraries 把配置扩散到所有目标,否则工具程序可能在不知情的情况下依赖游戏模块。目标缺少头文件时,应检查依赖方向和 PUBLIC、PRIVATE、INTERFACE 的传播规则,而不是直接添加全局搜索路径。

如果两个库必须互相链接,通常意味着职责划分不清。应提取双方共同需要的接口到更底层目标,或通过抽象接口反转依赖,而不是依赖链接器顺序掩盖循环关系。

本课总结

  • 构建目标代表独立产物,应按引擎库、游戏程序和工具程序的职责拆分
  • 目标之间通过显式链接形成单向依赖,避免全局配置和循环引用
  • 公共头文件路径应随库目标传播,内部实现目录不应暴露给调用方

下一课预告

下一课将基于当前工程骨架加入统一的配置、日志或测试入口,使多个构建目标在保持独立的同时共享一致的开发规范。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

划分构建目标

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通