Unreal Engine のソースコードをダウンロードする

ソースコードのブランチ

リポジトリにアクセスすると、UE のソースコードがいくつかのブランチで発行されていることが分かります。

名前に dev、staging、test が含まれているブランチは、通常、内部 Epic プロセス用であり、エンド ユーザーにはほとんど役立ちません。新しいリリースやホットフィックスが安定すると、他の短期間のブランチがポップアップすることがあります。

リリース ブランチ

リリース ブランチは、現在の公式リリースを反映します。弊社 QA チームが十分なテストを行っており、ここから Unreal Engine の学習やプロジェクト作成を開始すると良いと思います。弊社はリリースの安定性と信頼性を高めるために懸命に取り組んでおり、数か月ごとに新しいリリースの公開を目指しています。

メイン ブランチ

UE のアクティブな開発のほとんどは ue5-main ブランチで行われます。このブランチには、エンジンの最新リリースが反映されるため、バグがあったりコンパイルされていない場合があります。このブランチは、新機能のテストやロックステップ開発に積極的なデベロッパーが利用できるようにしています。

ローカルマシンで Perforce サーバーをセットアップする

Perforce サーバーを実行するには P4D と P4S の 2 つの方法があります。P4D はコマンドラインのインスタンスが実行中に実行します。そのため、スポットのメンテナンス タスクでのみ使用されます。 P4S は P4D とサービス ベースで同等です。バックグラウンドでサーバーを実行できるからです。このサービスは Perforce サーバー ツールのインストール時に通常インストールされ、開始します。

サービスが実行したら、P4Admin を使用してサーバーに接続できます。これがサーバーへの初めての接続である場合、最初の接続ダイアログでユーザーを作成することができます。

Perforce サーバーに接続情報を入力して OK を押します。P4Admin でサーバーに接続したら、新規のデポ、ユーザー、グループを非常に簡単に作成することができます。 P4V とアンリアル エディタを使用して、最初の接続ダイアログで入力した認証情報を使用してサーバーに接続します。

P4 タイプマップ

デポにファイルを追加する前に、P4 タイプマップ をセットアップし、Perforce がアンリアルのファイル タイプをどのように扱うかを認識させます。 タイプマップを設定すると、Perforce 内でファイルが読み出しのみなのか、書き出し可能なのかの設定に影響を及ぼします。しかし、これを行うには、 新規コマンド プロンプトを開き、いくつかの p4 環境変数をセットアップする必要があります。

	p4 set P4USER=your.username
	p4 set P4PORT=localhost:1666
Copy full snippet

上記の値を各自のユーザー名と接続アドレスに置き換えてください。 コマンド プロンプトに以下を入力してタイプマップを開きます。

	p4 -P YourPassword typemap
Copy full snippet

続いてテキスト ウィンドウが開きます。これがサーバーのタイプマップです。以下のタイプマップは過去に使用した例です。

	# Perforce File Type Mapping Specifications.
	#
	# TypeMap: a list of filetype mappings; one per line.
	# Each line has two elements:
	#
	# Filetype:The filetype to use on 'p4 add'.
	#
	# Path: File pattern which will use this filetype.
	#
	# See 'p4 help typemap' for more information.

	TypeMap:
					binary+w //depot/....exe
					binary+w //depot/....dll
					binary+w //depot/....lib
					binary+w //depot/....app
					binary+w //depot/....dylib
					binary+w //depot/....stub
					binary+w //depot/....ipa
					binary //depot/....bmp
					text //depot/....ini
					text //depot/....config
					text //depot/....cpp
					text //depot/....h
					text //depot/....c
					text //depot/....cs
					text //depot/....m
					text //depot/....mm
					text //depot/....py
					binary+l //depot/....uasset
					binary+l //depot/....umap
					binary+l //depot/....upk
					binary+l //depot/....udk
					binary+l //depot/....ubulk
Copy full snippet

編集したら、キーボード上で Ctrl+S を押して保存し、終了します。コマンド プロンプトに Typemap saved と表示されます。

ローカル ネットワーク上のサーバー

共同使用するためにサーバーをローカルのネットワーク上にセットアップすることができます。 これを行うには、サーバーに関する上記の手順に従い、サーバーの名前またはクライアントからの IP を使用して接続します。

クラウド プロバイダ

Perforce サーバーをオフサイトでホストし、リモートで共同作業するための様々なクラウド プロバイダがあります。 Perforce Hosting でオンラインで簡単に検索するといくつかの結果が得られます。各ホスティング プロバイダは異なりますが、最終的には接続に使用する 認証情報一式が提供されます。Perforce クラウド プロバイダへの接続に関する注記である以下の「アンリアル エディタから接続する」のセクションもご覧ください。

ローカルのワークスペースをセットアップする

Perforce の管理下にあるファイルで作業するには、ワークスペースをセットアップし、ローカル マシンでファイルを管理できるようにします。これは、P4V 経由で [View] ドロップダウンから [Workspaces] タブを開いて行うことができます。

新規ワークスペースを作成するには、ワークスペース ウィンドウで 右クリック して、[New Workspace] オプションを選択します。ワークスペースの名前とローカルマシンでファイルを入れたい場所、 Workspace Root を入力します。

サーバーとワークスペースの用意ができたら、ファイルの追加を開始します。しばらくは、ファイルの追加は P4V を介してエディタ外で行う必要があります。他の誰かがいくつかのファイルをセットアップしたワークスペースが既にある場合、スキップして先に進むことができます。編集 新規プロジェクトを作成したら、C++ コードおよびブループリント エレメントを含むか否かを選択することができます。プロジェクトで C++ コードを使用している場合は、Source/ ディレクトリも表示されます。 最初にプロジェクトの以下のディレクトリだけを追加します。

緑 でハイライトされているフォルダやファイルはデポに追加します。黄色 のバイナリ フォルダはオプションです。チームがどのように共同作業するかに応じて変わります。これはチームの各メンバーがエディタ / ゲームを自分でコンパイルする場合は必須ではありませんが、 チームのメンバーのいずれかがデポからバージョンを取得してコンテンツを作成する場合は 最初の追加 (initial add) に含める必要があります。 上記のサーバーのタイプマップのセットアップは Perforce によって Read-Only に設定されなくともコーダーがそのバイナリをコンパイルできることを意味します。

Perforce にファイルを追加する

Perforce にファイルを追加するには以下の手順に従います。

1. ファイル / フォルダを Perforce に追加するには、最初に P4V でファイル / フォルダを選択し、右クリック し、[Mark For Add] オプションを選択します。

   

2. これでファイルがデフォルトの変更リストに追加されます。追加したすべてのファイルは Pending change lists タブで見ることができます。

   

3. 何かをサブミットするには最初に変更リスト上で 右クリック します。次に [Submit] を選択します。続いて、変更リストの簡単な説明を入力し、[Submit] ボタンをクリックします。

   

誰かが既に開始したプロジェクトで作業を開始する場合、 P4V を使用して Perforce から最新の変更ファイルを取得する必要があります。 これを行うには、 P4V のデポビューでプロジェクトを探し、取得したいプロジェクト上で 右クリック して [Get Latest Revision] を選択します。 これで上記の Workspace Root に対して指定した場所にすべてのファイルがダウンロードされます。

Unreal Editor から接続する

エディタから Perforce サーバーに接続することができます。これは ツールバー の [Source Control (ソース コントロール)] アイコンをクリックして行います。

開いたらソース コントロールのログイン ダイアログからプロバイダとして [Perforce] を選択し、ログインの認証情報を入力します。 ワークスペース (現在のプロジェクトが中に入っている) をセットアップ済みであったら 、ログインの認証情報は自動的に入力されます。

多くのクラウド プロバイダを含むサーバーをいくつか使用する場合、エディタからデポにアクセスするためにホストとパスワードを入力する必要があるかもしれません。これは Perforce のログイン ダイアログの下部で [advanced] 欄を開いて行うことができます。

ソース コードのダウンロード

Unreal Engine のソースコードをダウンロードするには、以下の手順に従います。

追加のターゲット プラットフォーム

• Android サポートは、Android NDK がインストールされている場合、セットアップ スクリプトによってダウンロードされます。詳細は「Android クイックスタート ガイド」を参照してください。

• iOS 開発には Mac が必要です。インストラクションは「iOS クイックスタート ガイド」を参照してください。

*コンソールや、Sony PlayStation、Microsoft Xbox、Nintendo Switch など、アクセス制限のあるその他のプラットフォームの開発の場合は、これらのサードパーティ ベンダーに登録済みのデベロッパー アカウントを持っている場合にのみ可能です。

プラットフォームによっては、追加のドキュメントやガイダンスが Unreal Developer Network サポートサイト サポート サイトで提供されている可能性や、そのプラットフォーム専用の Unreal Engine フォーラム セクションでダウンロード可能なアーカイブとして入手できる可能性があります。

これらのリソースにアクセスできない場合は、まず、デベロッパー アカウントをサードパーティ ベンダーに登録してください。その後、担当の Epic Games アカウント マネージャーに問い合わせます。または、担当マネージャーがいない場合は、Unreal Engine の コンソール開発リクエスト フォームに記入して提出します。Epic から正式な契約書へのデジタル署名を求める連絡があります。これが承認されると、そのプラットフォームのソース コード、バイナリ、追加指示にアクセスする方法の説明が提供されます。

ライセンス契約と貢献

GitHub 上の Unreal Engine へのアクセス、使用は、EULA (エンドユーザーライセンス契約書) によって規定されます。随時修正される、EULA の条件に従わない場合は、Unreal Engine へのアクセスや使用は許可されません。

GitHub の プル リクエスト を用いた Unreal Engine の開発に対する貢献を歓迎します。弊社の進行中の開発のほとんどは、Master ブランチにあります。そのため、そこからプル リクエストを行ってください (特に新機能の場合)。すべての新規コードは、Epic Games のコーディング規約 を順守するようにしてください。すべての貢献は、EULA (エンドユーザーライセンス契約書) の条件によって規定されます。

次のステップ

Unreal Engine のダウンロードとセットアップが終了しました。次は、ソースからエンジンをビルドする ステップに進みます。

補足説明

新しいソース ビルドから初めてエディタを起動すると、ロードに時間がかかる場合があります。 Unreal Engine は使用するプラットフォームのコンテンツを 派生データ キャッシュ に最適化します。これは 1 回だけ行われます。

Unreal Engine のコードのプライベートのフォークは、GitHub アカウントの許可に関連付いています。 サブスクライブの解除または GitHub のユーザー名を切り替える場合は、再度フォークし、ローカル コピーから変更をアップロードする必要があります。