Files
Mitchell Wilson 3f8c52a80a Copying //UE4/Dev-Documentation to Samples-Main (//UE4/Samples-Main)
#rb none

[CL 6955335 by Mitchell Wilson in Main branch]
2019-06-12 12:19:04 -04:00

68 lines
4.6 KiB
Plaintext

INTSourceChangelist:3372845
Availability:Public
Title:アンリアル ビルド システムの設定
Crumbs:
Description:エンジンとゲーム プロジェクトをコンパイルするアンリアル・エンジンのカスタムビルドシステム
version:4.15
parent:Programming
tags:Programming
tags:Unreal Build System
type:overview
topic-image:Engine/build_topic.png
[TOC (start:1 end:3)]
[REGION:fullwidth]
![Unreal Build System](build.png)
[/REGION]
**アンリアル ビルドシステム** とは、アンリアル エンジン 4 (UE4) のビルド プロセス自動化ツールのコレクションです。ハイレベルでは、UnrealBuildTool と UnrealHeaderTool はアンリアル ビルド システムをサポートします。
このガイドは、UE4 のモジュラー アーキテクチャに関する簡単な考察も交えながら、UnrealBuildTool と UnrealHeaderTool の概要を説明します。ビルド ツールのこのコレクションを使用したい方のために、
プロジェクト用にアンリアル ビルド システムを分かりやすくセットアップ / 設定できる操作ガイドが含まれています。終盤には、Include-What-You-Use (IWYU) 依存モデルと BuildGraph スクリプティング システムをさらに学習したい上級ユーザー向けのガイドがあります。
[REGION:note]
Mac OS X で UnrealBuildTool や UnrealAutomationTool をデバッグする場合は、以下を必ずインストールしてください。[MonoDevelop 4.2.2](http://monodevelop.com/Download) および [Mono 3.2.7](http://www.go-mono.com/mono-downloads/download.html)
[/REGION]
## UnrealBuildTool
UnrealBuildTool (UBT) は、様々なビルド コンフィギュレーションの UE4 ソース コードのビルド プロセスを管理するカスタム ツールです。ユーザー設定可能な様々なビルド オプションについては、
`BuildConfiguration.cs` で確認してください。
## UnrealHeaderTool
**UnrealHeaderTool** (UHT) は、UObject システムをサポートするカスタムのパースおよびコード生成のツールです。コードのコンパイルは以下の 2 つのフェーズで行われます。
1. UHT が呼び出されると、Unreal 関連のクラスのメタデータの C++ ヘッダーをパースし、様々な UObject 関連の機能を実装するためのカスタム コードを生成します。
1. 結果をコンパイルするために通常の C++ コンパイラが呼び出されます。
コンパイル時に、いずれかのツールがエラーを排出するため、注意深く見るようにしてください。
## モジュール アーキテクチャ
UE4 は多くのモジュールに分かれています。各モジュールには、`.build.cs` ファイルがあり、モジュールの従属関係、追加のライブラリ、インクルード パスなどを定義するためのオプションなど、ビルド方法を制御します。デフォルトで、こうしたモジュールはダイナミック リンクライブラリ (DLL) にコンパイルされ、単一の実行可能ファイルによってロードされます。`BuildConfiguration.cs` ファイルでモノリシック (単一) 実行ファイルをビルドするように選択できます。
## アンリアル ビルド システムの使用方法
アンリアル ビルド システムを使用する前に、ビルド プロセスは、Visual Studio の `.sln` や `.vcproj` ファイルなどの開発環境のプロジェクト ファイルとは独立して実行されるということを理解することが重要です。しかし、こうしたファイルは編集目的には役立ちます。
そのため、プロジェクトのディレクトリ ツリーの内容に基づき、こうしたファイルを動的に生成するためのツールがあります。このツールは `[Root UE4]` ディレクトリにある `GenerateProject.bat` ファイルで実行することができます。
[REGION:tip]
`GenerateProject.bat` を時々実行すると、ディスクからファイルが追加 (または削除) され、コード エディタが常に最新の状態になります。
[/REGION]
### セットアップ
%Programming/UnrealBuildSystem/ProjectFileGenerator:topic%
%Programming/Development/BuildingUnrealEngine:topic%
### コンフィギュレーション
%Programming/UnrealBuildSystem/Configuration:topic%
%Programming/UnrealBuildSystem/TargetFiles:topic%
## 高度なトピック
%Programming/UnrealBuildSystem/IWYUReferenceGuide:topic%
%Programming/BuildTools/AutomationTool/BuildGraph:topic%