从源码构建

本页面为自动翻译，可能包含错误。如果发现问题，请通过“编辑此页面”链接帮助修正。

适用于想要在引擎本身上工作的贡献者和开发者。

系统要求

工具 版本 备注
Zig 必须为 0.16.0 不支持 0.15 及更早版本
Git 任意
Git LFS 任意 examples/ 中的二进制资源需要

克隆与构建

git lfs install            # 每台机器只需执行一次
git clone {{< param repo >}}.git
cd turian

zig build          # 编译 studio + CLI（Debug 模式）
zig build run      # 编译并启动 Turian Studio
zig build test     # 运行所有单元测试
zig build ci       # 测试 + ReleaseFast（与 CI 一致）

输出的二进制文件位于 zig-out/bin/：

  • turian-studio — GUI 编辑器
  • turian-cli — 无头 CLI

CLI 用法（从源码）

./zig-out/bin/turian-cli new-project ../my-game "My Game"
./zig-out/bin/turian-cli info        ../my-game
./zig-out/bin/turian-cli build       ../my-game

添加内置组件

  1. 创建 engine/components/MyComponent.zig： 
    pub const MyComponent = struct {
    value: f32 = 1.0,
};
  2. 在 engine/components/root.zig 中注册。
  3. 在 engine/scene/Component.zig 的 Component 联合体中添加标签。
  4. 更新 BuiltinEntry.zig 和 scanner.zig（populateBuiltins）。

运行测试

zig build test

测试使用 Zig 内置的 test 块内联存放在源文件中。

← 所有文档 编辑此页面