最新の変更を Epic から取得して更新

Unreal Engine のソース コードのフォークを更新して、最新の修正と機能を取り入れる方法を説明します。

Windows
MacOS
Linux

ソースを利用する最大のメリットの 1 つは、Epic のチームが Unreal Engine に追加した最新の改善点と機能に常にアクセスできることです。Epic は、ソース コードに変更を加え、新しい公式リリースを公開するなかで、Unreal Engine の GitHub リポジトリ のさまざまなブランチを更新し続けています。新しい公式リリースの公開ごと、あるいは毎月、毎日といった間隔で、こうした変更を定期的に取得したいと思われるかもしれません。

このページでは、フォークのブランチを更新する 2 つのアプローチを紹介します。これらの方法を使うことで、Unreal Engine のメインのリポジトリで加えられた最新の変更を反映できます。

方法 1:upstream リモートを利用

この方法では、オリジナルの Epic Games の Unreal Engine リポジトリを、フォークのローカル コピーに新しいリモート リポジトリとして追加します。これは通常 upstream リモートと呼ばれます。upstream リモートの変更をローカルのブランチにプルします。それから、その変更を GitHub 上の自分のフォーク (通常 origin リモートと呼ぶ) にプッシュできます。

下で説明する、GitHub のプル リクエストを使用する方法 2 よりも初めはややこしいように思えるかもしれませんが、こちらの方法を使用することをお勧めします。この方法には 2 つメリットがあります。

  • upstream リモートは、一度設定すれば、フォークの同じローカル クローンを使い続けるかぎり再設定は不要です。プロジェクトに合わせて、必要に応じた頻度で、すばやく簡単に変更を取得できます。

  • フォークを更新するために GitHub でプル リクエストを使用すると、そのたびにブランチに新しいコミットを作成し、プロジェクトの履歴に新しいプル リクエストを作成することになります。これは通常は無害なことですが、それでも不要な登録は避けたほうがいいでしょう。

次に、Git のコマンドライン ツールを使って新しいリモート リポジトリを追加し、変更を取得する方法を説明します。グラフィカルな Git クライアントを使っていても、手順は概ね同じです。詳細はご利用のツールのドキュメントをご覧ください。

GitHub Desktop を使うと、フォークをクローンしたときに upstream リモートが自動的に作成されます。upstream ブランチの変更をローカルのブランチにマージして、それからその変更を origin リポジトリにプッシュするだけで済みます。

upstream リモートを設定する手順は次のとおりです。

  1. まだそうしていなければ、フォークを自分のコンピューターにクローンします。

  2. コマンド プロンプトを開き、リポジトリのあるフォルダに移動します。

  3. ベースとなる Epic Games のリポジトリを新しいリモート リポジトリ「upstream」として追加します。

    > git remote add upstream https://github.com/EpicGames/UnrealEngine

upstream リモートの変更をフォークに取得する手順は次のとおりです。

  1. 更新するブランチに切り替えます。例:

    > git checkout master
  2. upstream リモートの変更をローカルのブランチにプルします。

    > git fetch upstream
    > git merge upstream/master
  3. 変更を origin リモートにプッシュします。

    > git push origin master

方法 2:GitHub のプル リクエストを利用

  1. Web ブラウザで github.com にアクセスし、自分のリポジトリのホームページに移動します。
    通常は、https://github.com/<username>/UnrealEngine という形式になります。<username> には GitHub のユーザー名が入ります。

  2. Branch ウィジェットから、更新するブランチを選択します。
    Selecting the master branch

  3. [Compare] リンクをクリックします。
    Compare

  4. 通常、フォーク内のこのブランチに変更を加えていないと、Epic Games のリポジトリにはあなたのリポジトリにあるすべてのコミットがすでにある、ということがわかります。
    [switching the base] リンクをクリックすると、比較の向きが逆になり、エンジンのリポジトリに作成されたコミットのうち、あなたのフォークにはないものが表示されます。
    Switching the base

  5. 変更の一覧を確認します。表示されている日付が期待どおりであれば、 [Create Pull Request] をクリックします。
    Comparing changes between branches

  6. 簡単な説明の欄に、プル リクエストで更新するブランチを入力します。入力したら [Create pull request] をクリックします。
    Open a new pull request

  7. GitHub が新しいプル リクエストの [Conversation] タブを表示します。変更の一覧の下から、[Merge pull request] をクリックします。
    Merge pull request

  8. [Confirm merge] をクリックします。
    Confirm merge

マージが完了すると、GitHub でフォークのブランチが最新になります。それから Git のコマンドライン ツールまたはいずれかのグラフィカルな Git ツールを使用してそのブランチに切り替え、最新の変更をローカルのコンピューターにプルできます。

タグ
Select Skin
Light
Dark

新しい Unreal Engine 4 ドキュメントサイトへようこそ!

あなたの声を私たちに伝えるフィードバックシステムを含め、様々な新機能について開発をおこなっています。まだ広く使える状態にはなっていないので、準備ができるまでは、ドキュメントフィードバックフォーラムで、このページについて、もしくは遭遇した問題について教えていただけると助かります。

新しいシステムが稼働した際にお知らせします。

フィードバックを送信