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//UnrealEngine という形式になります。 には 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 ツールを使用してそのブランチに切り替え、最新の変更をローカルのコンピューターにプルできます。

Tags
Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback