游戏客户端架构 / 系统课时
划分构建目标
划分构建目标
本课将工程拆成 engine 静态库、game 游戏程序和 asset_tool 工具程序三个独立目标。这样可以复用引擎代码、缩短无关模块的重新编译时间,并为后续测试、编辑器和资源流水线预留清晰边界。
学习目标
- 使用 CMake 分别声明库目标和可执行目标
- 正确设置目标之间的链接依赖与头文件可见范围
- 单独构建并运行游戏程序和工具程序
为什么要拆分构建目标
如果引擎、游戏逻辑和工具代码全部放进一个可执行目标,任何文件变化都可能触发大范围重新编译,工具程序也会被迫依赖窗口、渲染或运行时模块。构建目标的职责是描述一个可独立编译和链接的产物,而不是简单对应一个源码文件夹。
本课采用单向依赖:game 和 asset_tool 都可以使用 engine,但 engine 不反向引用具体游戏或工具。该方向能避免循环依赖,也便于以后为引擎库添加单元测试。

创建工程目录
建立下面的目录结构。公共头文件放在 engine/include,实现文件放在 engine/src,两个可执行程序分别保留自己的入口文件。
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_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。
#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,在库内部完成具体实现。
#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。
#include <engine/Application.hpp>
int main() {
const engine::Application game{"Sample Game"};
game.run();
return 0;
}工具程序也复用同一个引擎接口,但拥有独立入口和输出职责。创建 tools/asset_tool.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 可以避免编译当前不需要的程序。
cmake -S . -B build
cmake --build build --target game
cmake --build build --target asset_tool
./build/game
./build/asset_tool预期输出
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 的传播规则,而不是直接添加全局搜索路径。
如果两个库必须互相链接,通常意味着职责划分不清。应提取双方共同需要的接口到更底层目标,或通过抽象接口反转依赖,而不是依赖链接器顺序掩盖循环关系。
本课总结
- 构建目标代表独立产物,应按引擎库、游戏程序和工具程序的职责拆分
- 目标之间通过显式链接形成单向依赖,避免全局配置和循环引用
- 公共头文件路径应随库目标传播,内部实现目录不应暴露给调用方
下一课预告
下一课将基于当前工程骨架加入统一的配置、日志或测试入口,使多个构建目标在保持独立的同时共享一致的开发规范。