当前位置：首页 > news >正文

Rizz构建系统：CMake配置与多平台编译的完整指南

news 2026/6/21 0:03:54

Rizz构建系统：CMake配置与多平台编译的完整指南

【免费下载链接】rizzSmall C game development framework项目地址: https://gitcode.com/gh_mirrors/ri/rizz

Rizz是一个轻量级的C语言游戏开发框架，专注于为开发者提供简单高效的跨平台构建解决方案。作为一个小型但功能强大的游戏开发框架，Rizz的CMake构建系统经过精心设计，支持Windows、Linux、macOS、Android、iOS和Raspberry Pi等多个平台，让开发者能够轻松实现一次编写、到处编译的目标。

📦 快速入门：Rizz构建系统概述

Rizz的构建系统基于CMake，提供了灵活而强大的配置选项。框架支持两种主要构建模式：Host模式和Bundle模式，分别针对开发和生产环境优化。

Rizz构建系统架构图展示了完整的编译流程

核心构建概念

Host模式：开发环境首选，支持热重载和插件动态加载
Bundle模式：生产环境打包，生成单一可执行文件
插件系统：模块化设计，按需编译和加载
跨平台支持：统一的CMake配置，多平台适配

🛠️ CMake配置详解

基本配置选项

Rizz的CMake配置位于项目根目录的CMakeLists.txt文件中，提供了丰富的构建选项：

# 主要构建选项 option(BUNDLE "Bundle all plugins and game together" OFF) option(BUILD_TOOLS "Build tools and editors" ON) option(BUILD_EXAMPLES "Build example projects" ON) option(ENABLE_HOT_LOADING "Enable hot-loading" ON)

多平台编译设置

Rizz的CMake配置自动检测目标平台并应用相应的编译设置：

# 平台特定配置 if (MSVC) # Windows编译设置 option(MSVC_STATIC_RUNTIME "Link with MSVC static runtime" OFF) option(MSVC_MULTITHREADED_COMPILE "Multi-threaded compilation" ON) elseif (APPLE) # macOS/iOS配置 set(MACOSX_BUNDLE_ROOT_DIR ${CMAKE_CURRENT_SOURCE_DIR}) endif()

Rizz插件系统架构图展示了模块化的设计理念

🚀 构建模式选择：Host vs Bundle

Host模式（开发环境）

Host模式是Rizz推荐的开发环境配置，具有以下特点：

动态插件加载：插件和游戏代码作为动态库加载
热重载支持：代码和资源修改后无需重新编译
快速迭代：缩短开发调试周期
轻量级部署：只编译必要的组件

配置命令示例：

cmake -B build -DBUNDLE=0 -DBUILD_EXAMPLES=1

Bundle模式（生产环境）

Bundle模式适用于发布版本，将所有组件静态链接到单一可执行文件：

单一可执行文件：便于分发和部署
优化性能：消除动态加载开销
减少依赖：无需外部库文件
跨平台打包：支持各平台原生打包

配置命令示例：

cmake -B build -DBUNDLE=1 -DBUNDLE_TARGET=01-hello -DBUNDLE_PLUGINS="imgui;2dtools"

Host模式架构图展示了动态加载的工作流程

📱 多平台编译实战

Windows平台编译

Windows平台支持Visual Studio和Clang-Cl编译器：

# 使用Visual Studio生成解决方案 cmake -B build -G "Visual Studio 16 2019" # 使用Ninja构建 cmake -B build -G "Ninja"

Linux平台编译

Linux平台需要安装必要的开发库：

# 安装依赖 sudo apt-get install libx11-dev libxrandr-dev libxi-dev libasound2-dev libglew-dev # 配置和构建 cmake -B build -DCMAKE_BUILD_TYPE=Release cmake --build build --parallel

macOS平台编译

macOS平台支持Xcode和命令行工具：

# 使用Xcode生成项目 cmake -B build -G "Xcode" # 或使用命令行构建 cmake -B build -DCMAKE_BUILD_TYPE=Release make -C build -j8

移动平台支持

Rizz为移动平台提供了专门的构建脚本：

Android：scripts/build-tools/android.py
iOS：scripts/build-tools/ios.py

多线程绘图架构展示了Rizz的高性能渲染能力

🔧 高级配置技巧

编译器优化设置

Rizz提供了丰富的编译器优化选项：

# 编译器警告设置 if (MSVC) target_compile_options(${native_project} PRIVATE /WX /W4) else() target_compile_options(${native_project} PRIVATE -Wextra -Wshadow -Wunreachable-code -Wstrict-aliasing -Werror) endif()

着色器编译集成

Rizz集成了GLSL跨平台着色器编译器：

# 着色器编译配置 include(glslcc) glslcc_target_compile_shaders_sgs(${proj_name} "${shaders}")

插件系统配置

插件系统是Rizz的核心特性，CMake配置支持灵活的插件管理：

# 插件列表配置 set(native_projects sx rizz imgui 2dtools 3dtools astar utility sound input collision basisut)

系统架构图展示了Rizz各组件之间的关系

📊 构建性能优化

并行编译配置

# 多线程编译加速 if (MSVC_MULTITHREADED_COMPILE AND NOT CMAKE_MAKE_PROGRAM MATCHES "ninja.exe") add_compile_options(/MP) # 多处理器编译 endif()

静态运行时链接

# Windows静态运行时配置 if (MSVC_STATIC_RUNTIME) set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /MT") set(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /MT") endif()

Clang编译性能分析

# Clang编译时间分析 if (CLANG_ENABLE_PROFILER) set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS_RELEASE} -ftime-trace") set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS_RELEASE} -ftime-trace") endif()

🎯 示例项目构建

Rizz包含丰富的示例项目，涵盖从基础到高级的各种功能：

# 构建所有示例 cmake -B build -DBUILD_EXAMPLES=1 cmake --build build --target 01-hello 02-quad 03-drawsprite # 运行示例 ./build/bin/rizz --run 01-hello.dll # Windows ./build/bin/rizz --run ./01-hello.so # Linux

Rizz示例项目展示了框架的强大功能

🔍 调试与优化

调试配置

# 调试符号配置 target_compile_definitions(${native_project} PUBLIC "$<$<OR:$<CONFIG:Debug>,$<CONFIG:RelWithDebInfo>>:RIZZ_DEV_BUILD>")

性能分析器

# 性能分析器配置 if (${CMAKE_BUILD_TYPE} MATCHES "Release") option(ENABLE_PROFILER "Enable profiler" OFF) else () option(ENABLE_PROFILER "Enable profiler" ON) endif()