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

整理资源发布

整理资源发布

本课把已完成的游戏整理成可复制、可启动、可验证的发布目录。最终产物包含可执行文件、动态库与资源目录,并能在没有源码和开发工具的环境中独立运行。

学习目标

  • 规划稳定的发布目录和资源相对路径
  • 使用 CMake 安装规则收集程序、依赖与资源
  • 在干净环境中验证缺失文件和启动问题

设计发布目录

发布目录应只包含运行时需要的内容,不应混入源码、对象文件、编辑器配置和调试缓存。一个常见结构如下:

text
release/
├── bin/
│   └── tiny_game
├── lib/
│   └── <runtime-libraries>
├── assets/
│   ├── audio/
│   ├── fonts/
│   ├── textures/
│   └── levels/
└── README.txt

程序读取资源时应以可执行文件所在目录或明确的资源根目录为基准,避免依赖开发机工作目录。发布后出现“程序能启动但贴图、字体或音乐缺失”,通常就是相对路径仍指向源码目录。

从构建产物到独立发布目录的整理流程

编写安装规则

下面是接入现有 CMakeLists.txt 的片段示例,依赖项目已经存在名为 tiny_game 的可执行目标,并且资源位于项目根目录的 assets。Windows 动态库通常放入 bin,Linux 动态库通常放入 lib。

cmake
include(GNUInstallDirs)

install(
    TARGETS tiny_game
    RUNTIME DESTINATION bin
    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
)

install(
    DIRECTORY "${CMAKE_SOURCE_DIR}/assets/"
    DESTINATION assets
)

install(
    FILES "${CMAKE_SOURCE_DIR}/README.txt"
    DESTINATION .
)

这段配置不会改变开发目录,而是在执行安装命令时把目标文件复制到指定前缀。验证时重点检查 bin、assets 和说明文件是否同时出现;第三方动态库若未被目标安装规则覆盖,需要额外复制或使用平台部署工具收集。

生成发布目录

在项目根目录执行以下命令。<PATH> 替换为实际工程路径;不同生成器的可执行文件位置可能不同。

bash
cmake -S <PATH> -B <PATH>/build-release -DCMAKE_BUILD_TYPE=Release
cmake --build <PATH>/build-release --config Release
cmake --install <PATH>/build-release --prefix <PATH>/release

预期结果:

text
-- Build files have been written to: <PATH>/build-release
[100%] Built target tiny_game
-- Installing: <PATH>/release/bin/tiny_game
-- Installing: <PATH>/release/assets/...
-- Installing: <PATH>/release/README.txt

CMake 和生成器版本不同,日志细节可能变化,但最后必须得到 <PATH>/release,并包含可执行文件与完整资源目录。

补齐运行依赖

Linux 可用 ldd 检查动态库,Windows 可使用系统自带的加载错误信息或专门依赖检查工具。以下命令用于确认 Linux 可执行文件是否仍引用缺失库:

bash
ldd <PATH>/release/bin/tiny_game

预期输出应全部指向有效路径,不应出现 not found:

text
libstdc++.so.6 => /<SYSTEM_PATH>/libstdc++.so.6
libm.so.6 => /<SYSTEM_PATH>/libm.so.6
libc.so.6 => /<SYSTEM_PATH>/libc.so.6

系统路径会因发行版和架构不同而变化。只应随包分发许可允许且目标机器缺少的运行库,不要复制操作系统核心库。

在干净环境验收

把整个 release 目录复制到另一台机器或临时测试环境,不要从构建目录启动。进入发布目录后运行程序,依次验证窗口创建、关卡加载、字体显示、音效、背景音乐、存档路径和退出流程。

若程序无法启动,先检查动态库;能够启动但资源缺失,则检查资源是否复制完整、文件名大小写和相对路径;只在开发机正常,则检查是否意外读取了源码目录、环境变量或用户缓存。验收通过后再压缩整个发布目录,而不是只压缩可执行文件。

本课总结

  • 发布目录只保留运行所需的程序、依赖、资源和说明文件
  • CMake 安装规则可以稳定复现资源收集过程,减少手工遗漏
  • 真正的发布验收必须在脱离源码和开发环境的干净机器上完成

下一课预告

下一课将基于完整发布产物进行最终检查,并处理版本标识、平台打包与交付说明。

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

目录与阅读设置

阅读设置

17

记录一个想法

整理资源发布

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

登录哪都通