ソースからビルド
このページは自動翻訳されており、誤りが含まれる場合があります。誤りを見つけた場合は「このページを編集」リンクからご協力ください。
エンジン自体に取り組みたいコントリビューターと開発者向け。
必要条件
| ツール | バージョン | 備考 |
|---|---|---|
| Zig | 0.16.0 必須 | 0.15 以前はサポート対象外 |
| Git | 任意 | |
| Git LFS | 任意 | examples/ 内のバイナリアセットに必要 |
クローンとビルド
git lfs install # マシンごとに 1 回
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
ビルトインコンポーネントの追加
engine/components/MyComponent.zigを作成：pub const MyComponent = struct { value: f32 = 1.0, };engine/components/root.zigに登録。engine/scene/Component.zigのComponent共用体にタグを追加。BuiltinEntry.zigとscanner.zig（populateBuiltins）を更新。
テストの実行
zig build test
テストは Zig のビルトイン test ブロックを使用してソースファイル内にインラインで配置されます。
プラットフォームサポートとクロスコンパイル
Studio と CLI は Linux、Windows、macOS でビルドおよび実行できます。Studio は SDL3-GPU を使用し、（SPIRV 3D ビューポートに必要な）Vulkan デバイスを優先しますが、Vulkan が利用できない場合はプラットフォームのデフォルト（Windows では D3D12、macOS では Metal）にフォールバックします——その場合でもエディターUIは完全に動作し、3D シーンビューポートのみが*「利用不可」*と表示されます。
Zig は、Windows ツールチェーンなしで Linux から Studio 全体をクロスコンパイルできます（SDL3、dvui、freetype はすべてソースからビルドされます）：
zig build -Dtarget=x86_64-windows-gnu -Dno-test
生成される turian-studio.exe は自己完結型（SDL3 は静的リンク）で、Wine 上でスモークテストできます。