【Unity 6】GitHub Desktopでチーム開発|WinForms経験者向け・2人で作るコイン収集ゲーム(6ステップ)

2026年11月19日

広告

Gitチーム開発シリーズ・Unity 6 実践編:シリーズ目次|WinFormsで2人開発|ブランチを体験する|Pull Requestを体験する

WinFormsで2人開発、ブランチ、Pull Requestを体験した人向けです。Gitの操作は既習として進めます。今回は同じ流れをUnityに持ち込み、Prefabで担当を分け、シーンは最後に1人が統合する方法を学びます。完成条件は、チーム全員のPCでPlayerが動き、Coinを3個集めるとCLEAR!が表示されることです。

この実習のルール:Prefabの分担とPRによる統合に集中するため、STEP 3・4では共有シーンを一時的な動作確認に使い、テスト用の変更だけを破棄します。シーンの正式な編集はSTEP 6で統合担当が行います。これは6ステップの学習用に単純化した進め方です。

実務で続けるときは:この6ステップを終えたら、担当別テストシーン・Prefab・PRで進める実務フローへ進んでください。共有シーンの変更を毎回破棄せず、担当ごとの確認とレビューを残す方法を説明します。

始める前の確認:2人でA・Bの担当を決め、GitHubアカウントとGitHub Desktopを使えることを確認します。Unity Hubに表示されるUnity 6のEditorバージョンを読み合わせ、2人で同じバージョンを使います。

用語の読み方を確認:Repository・Prefab・Pull requestなど、Unity・C#・Gitの読み方に迷ったときは、技術用語の読み方・発音ガイドも参照してください。

WinFormsでの経験をUnityに置き換える

WinFormsで経験したことUnityで行うこと
担当ごとにクラス・画面を分けるAさんはPlayer、BさんはCoinとスコアを、それぞれスクリプトとPrefabで作る
Designer生成ファイルを同時編集しないMainScene.unityを担当ブランチでは編集せず、最後にAさんが配置する
担当ブランチからPRを出して統合する同じ手順。AさんのPRを先にマージし、BさんはUpdate from main後にPRを完成させる

担当の約束:AさんはPlayerMovement.csとPlayer.prefab、BさんはCoin.cs・CoinCounter.cs・Coin.prefab・CoinCounter.prefabを担当します。BさんのCoinはPlayerタグで接触を判定します。AさんはSTEP 3でPlayer.prefabにPlayerタグを設定し、担当間の接点として共有します。MainScene.unityは2人チームでは統合時にAさんだけが編集します。

3人チームの場合

3人目のCさんは、レビューとシーン統合の担当です。CさんもBさんと同じ手順(STEP 2)で共有プロジェクトを開きます。MainScene.unityを編集するのはチームで1人だけ、という約束は同じで、STEP 6はAさんではなくCさんが行います。AさんとBさんがSTEP 3・4で作業している間、Cさんはレビューの準備をします。

考えてみよう(2人・3人共通):STEP 3・4のPRを出す前に、次の2点を予想してください。

  • PRを見るとき、どのファイルが入っていれば良いか(入っていてはいけないファイルは何か)
  • 2人のPRを統合する順番は、どちらが先でも良いか

答えは、STEP 5で確かめます。

STEP 1:Unityプロジェクトを共同作業用に準備する

  1. 2人とも同じUnity 6のEditorバージョンを使い、C#スクリプトを開けるようにします。入力にはUnity 6のInput Systemを使用します。Aさんは初回Commitの前に、Input Systemが使えることを確認します。使えない場合は、下の折りたたみを確認してください。
  2. Aさんは2DプロジェクトCoinCollectorTeamを作り、標準で用意されているAssets/ScenesフォルダーにMainScene.unityを保存します。UnityのProjectウィンドウでAssets/ScriptsとAssets/Prefabsを用意します。
  3. エクスプローラーで、Assets・Packages・ProjectSettingsが直下にあるUnityプロジェクトのフォルダーを開き、そのフォルダーごとGitHub Desktopのウィンドウへドラッグ&ドロップします。Assetsなど中のフォルダーではなく、プロジェクトのルートを渡します。「Gitリポジトリではない」と表示されたらcreate a repository hereを選び、Local pathがプロジェクトのフォルダー自体になっていることを確認します。Git IgnoreはWinForms実習の「Visual Studio」ではなく「Unity」にします。ドラッグ&ドロップがうまくいかない場合は、File > Add Local Repositoryからフォルダーを指定しても同じ画面に進めます。.metaはアセットと一緒に共有し、自動生成されるLibraryは含めません。

確認:GitHub Desktopでリポジトリのフォルダーを開き、その直下にAssets、Packages、ProjectSettings、.gitignoreがあることを確認します。プロジェクトが入れ子になっていたらPublishせず、フォルダーの指定を見直してください。

Unityは、アセットやフォルダーを管理するための.metaファイルを自動生成・管理します。自分で作成・編集する必要はありません。Gitでは、再生成できるLibraryは共有せず、.metaは対応するアセットと一緒に共有します。

もう少し詳しく:なぜLibraryは除外して、.metaは残すの?

Unityは、アセットを読み込んで変換したデータなどをLibraryにキャッシュします。ほかのメンバーのPCでも必要に応じて再生成できるため、通常Gitでは共有しません。

一方、.metaには、アセットを識別するGUIDやインポート設定が保存されます。UnityはこのGUIDを使ってPrefabやスクリプトなどの参照先を識別するため、対応する.metaが失われて別のGUIDに変わると、参照切れの原因になります。フォルダーにも.metaが作られます。

ファイル・フォルダー役割Gitで共有
Library再生成できるキャッシュしない
.metaGUID・インポート設定などする
.unity・.cs・.prefabシーン・コード・Prefabの本体する

Unityは.metaを自動管理しますが、Gitのコミットに含まれるかどうかは自分で確認しましょう。通常、.metaは手動編集しません。

CommitからPublishまでの確認:GitHub DesktopのChangesで、Libraryが含まれていないことと、Assets/Scenes/MainScene.unityおよびMainScene.unity.meta、フォルダー用のAssets/Scripts.metaとAssets/Prefabs.metaなど、今回作成したアセットと対応する.metaが揃っていることを確認します。必要なファイルをCommitし、Historyでコミット済みの内容を確認してからPublishします。Changesに必要なファイルが残っていたら、確認してCommitしてから進みます。すべてのCommitに毎回同じファイルが入る必要はありません。

参考:Clone直後にも空フォルダーを表示したい場合(.gitkeep)

Gitは空のフォルダー自体を共有しません。Assets/Scripts.metaとAssets/Prefabs.metaをCommitしていれば、BさんがCloneした直後はフォルダーがなくても、Unityでプロジェクトを開いたときに再作成されます。空フォルダーが作られただけではGitHub DesktopのChangesには表示されません。Unityで開く前からフォルダーを存在させたい場合にだけ、各フォルダーへ.gitkeepという空のファイルを置きます。

Windowsでの作り方:

  1. エクスプローラーで、Unityプロジェクトのフォルダー(Assetsが見える場所)を開きます。
  2. 上のアドレスバーをクリックしてpowershellと入力し、Enterを押します。
  3. 次の1行を貼り付けてEnterを押します。
    New-Item -ItemType File Assets\Scripts\.gitkeep, Assets\Prefabs\.gitkeep
  4. 2つのファイルが作られた表示が出れば完了です。

Unityは.で始まるファイルを無視するので、.gitkeepに.metaは作られません。UnityのProjectウィンドウにも表示されません。使用する場合は、Commit前にGitHub DesktopのChangesで.gitkeepを確認し、Commitに含めます。

GitHub Desktopでリポジトリを作る操作を確認する

GitHub Desktopの「新しいリポジトリ」では、Local pathに指定した場所の内側にリポジトリ名のフォルダーが作られます。既存のUnityプロジェクトを使うこの実習では、作成後のリポジトリの直下にAssetsがあることを必ず確認してください。Initial commitがあってもUnityプロジェクトのファイルまで含まれるとは限りません。Changesに残っているファイルは内容を確認してCommitしてからPublishします。GitHub公式のリポジトリ作成手順も参照してください。

Input Systemが使えない場合

まずGameビューにフォーカスがあるか確認します。using UnityEngine.InputSystem;でエラーが出る場合は、Package ManagerでInput Systemが導入されているか確認してください。Edit > Project Settings > Player > Active Input HandlingがInput System Package (New)またはBothになっていることも確認し、必要に応じて変更します。導入や設定の変更後に求められたら、Unity Editorを再起動します。これらの確認と変更は、Aさんが初回Commitの前に済ませてください。

STEP 2:Bさんが共有プロジェクトを開く

  1. Aさんはリポジトリを作成したら、Publish repositoryでGitHubに共有し、BさんをCollaboratorに招待します。
  2. Bさんは招待を承認し、GitHub Desktopで対象リポジトリをCloneします。
  3. BさんはUnity HubにClone先を既存プロジェクトとして追加し、Aさんと同じEditorで開きます。新しいUnityプロジェクトをClone先に作成しません。

確認:BさんのClone先にもAssets/Scenes/MainScene.unityとMainScene.unity.metaがあり、2人とも同じMainSceneを開けます。ここまではWinFormsの「Aさんが作成・共有、BさんがClone」と同じ流れです。

STEP 3・4の分担とSTEP 6の統合:担当ブランチにはMainScene.unityを含めず、Prefabを統合してからAさんがシーンを組み立てます。

なぜ動作確認したMainSceneを元に戻すの? この実習には、GitHub Desktopで「チームに共有する変更」と「動作確認だけに使った変更」を選び分ける練習も含まれています。STEP 3・4で共有したい成果物は、作成したPrefabとスクリプト、および対応する.metaファイルです。確認のために一時配置したGameObjectは、まだ正式なシーン構成ではありません。そのためMainScene.unityのテスト用変更だけを元に戻します。MainSceneそのものを削除するわけではなく、Prefabやスクリプトも削除しません。

実際の開発では、担当別テストシーン・Prefab・PRで進める実務フローのように、担当ごとのテストシーンを作って保存・共有する方法もあります。この6ステップではまず「必要なファイルだけをCommitする」ことを練習し、次の記事でテスト環境を残す方法へ進みます。

STEP 3・4でシーンをCommitに含めない方法:

  1. 各自のPCのMainScene.unityにテスト用オブジェクトを配置し、シーンを保存してPlayで動作確認します。確認後はPlayを止めます。
  2. GitHub DesktopのChangesでMainScene.unityの差分を確認します。テスト以外の変更が混ざっていたら破棄せず、シーンの統合担当と確認してください。
  3. HierarchyのMainScene名に*がなく、差分がテスト用の変更だけなら、GitHub DesktopでMainScene.unityだけをDiscard Changesで元に戻します。Discard All Changesは使いません。UnityにシーンのReload確認が出たら、Reloadを選びます。
  4. Commit・Pull・ブランチ切り替えの前に、MainScene.unityがChangesに残っていないことを確認します。STEP 5でPRを作ったら、Files changedにも含まれないことを確認します。

補足:Hierarchyのシーン名の横の*は、変更が未保存であることを示します。*がある場合は、Reloadで未保存の変更も失われるため、破棄せず内容を確認してください。Reload確認が出なければ、別のシーンを開いてからMainSceneを開き直します。この破棄手順は実習のSTEP 3・4だけで使い、STEP 6の正式なシーン編集には適用しません。

Gitを操作するときのUnity:ブランチ切り替え、Pull、Merge、Update from mainの間は、Unityを閉じます。Gitの操作が終わったらUnityを開き直し、Consoleにエラーがないことを確認します。

STEP 3:AさんがPlayerのPrefabを作る

Aさんは最新のmainからfeature/player-movementを作ります。Bさんはfeature/coin-collectionを作ります。作業前にGitHub Desktopの現在のブランチを確認してください。

  1. Aさんは青い四角のPlayerを作り、Rigidbody 2D(Gravity Scale = 0、Freeze Rotation Z = ON)とBox Collider 2D(Is Trigger = OFF)を追加します。Inspector上部のTagからPlayerを選びます。
    Playerの作り方
    1. Hierarchyで右クリックし、2D Object > Sprites > Squareを選びます。
    2. 名前をPlayerに変えます。
    3. InspectorのSprite RendererにあるColorをクリックし、青を選びます。
  2. PlayerMovement.csを作り、次のコードを入力してPlayerにアタッチします。
using UnityEngine;
using UnityEngine.InputSystem;

[RequireComponent(typeof(Rigidbody2D))]
public class PlayerMovement : MonoBehaviour
{
    [SerializeField] private float moveSpeed = 4f;

    private Rigidbody2D rb;
    private Vector2 moveInput;

    private void Awake()
    {
        rb = GetComponent<Rigidbody2D>();
    }

    private void Update()
    {
        Keyboard keyboard = Keyboard.current;
        if (keyboard == null)
        {
            moveInput = Vector2.zero;
            return;
        }

        float x = 0f;
        float y = 0f;

        if (keyboard.aKey.isPressed || keyboard.leftArrowKey.isPressed) x -= 1f;
        if (keyboard.dKey.isPressed || keyboard.rightArrowKey.isPressed) x += 1f;
        if (keyboard.sKey.isPressed || keyboard.downArrowKey.isPressed) y -= 1f;
        if (keyboard.wKey.isPressed || keyboard.upArrowKey.isPressed) y += 1f;

        moveInput = new Vector2(x, y).normalized;
    }

    private void FixedUpdate()
    {
        rb.linearVelocity = moveInput * moveSpeed;
    }
}
  1. HierarchyのPlayerをProjectウィンドウのAssets/Prefabsフォルダーへドラッグし、Player.prefabを作ります。PlayerはHierarchyにも残ります。
  2. Hierarchyに残っているPlayerを使ってシーンを保存し、PlayでWASDまたは矢印キーによって上下左右に動くことを確かめます。Playを止めたら、上記の手順でMainScene.unityのテスト用変更を破棄します。Playerタグは、STEP 4で作るCoinとの接触判定に使います。
  3. ChangesにPlayerMovement.csとPlayer.prefabおよび対応する.metaだけがあることを確認し、Commit・Pushします。

Unityでの要点:動作確認にはシーンを使いますが、担当間で渡す成果物はPrefabとスクリプトです。シーンの最終配置はSTEP 6で行います。

補足:UpdateとFixedUpdate

このコードはUpdateで入力を読み、FixedUpdateでRigidbody 2DのlinearVelocityを更新します。

STEP 4:BさんがCoinとスコアのPrefabを作る

Bさんはfeature/coin-collectionだけで作業します。Aさんのスクリプトはまだ自分のブランチにないため、接触判定にはUnity標準のPlayerタグを使います。Playerは最初からあるタグなので、新規登録は不要です。

Coin.cs

using UnityEngine;

public class Coin : MonoBehaviour
{
    private bool collected;

    private void OnTriggerEnter2D(Collider2D other)
    {
        if (collected || !other.CompareTag("Player")) return;

        collected = true;
        CoinCounter.AddCoin();
        Destroy(gameObject);
    }
}

CoinCounter.cs

using UnityEngine;

public class CoinCounter : MonoBehaviour
{
    private const int Goal = 3;
    private static int count;

    private void Awake()
    {
        count = 0;
    }

    public static void AddCoin()
    {
        count++;
    }

    private void OnGUI()
    {
        GUI.Label(new Rect(20, 20, 260, 40), $"Coins: {count} / {Goal}");
        if (count >= Goal)
        {
            GUI.Label(new Rect(20, 60, 260, 40), "CLEAR!");
        }
    }
}

collectedは接触処理が重複してもCoinを2回数えないための印です。2Dのトリガー通知には、接触するColliderの少なくとも片方にRigidbody 2Dが必要です。STEP 4の確認では代役のTestPlayer側に付けます。STEP 6で使うPlayer.prefabにはSTEP 3で付けています。

  1. 黄色い丸のCoinを作り、Circle Collider 2DのIs TriggerをONにしてCoin.csをアタッチします。Assets/Prefabs/Coin.prefabに保存します。
    Coinの作り方
    1. Hierarchyで右クリックし、2D Object > Sprites > Circleを選びます。
    2. 名前をCoinに変えます。
    3. Sprite RendererのColorで黄色を選びます。
    4. Playerと区別しやすいよう、TransformのScaleを0.5にします。
    5. Add ComponentからCircle Collider 2Dを追加します。
  2. Hierarchyで右クリックしてCreate Emptyを選び、作った空のGameObjectをCoinCounterと名付けます。CoinCounter.csを付け、ProjectウィンドウのAssets/PrefabsへドラッグしてCoinCounter.prefabを作ります。
  3. Prefabを作った後もHierarchyに残っているCoinとCoinCounterを使います。BさんのブランチにはAさんのPlayerがまだないため、接触確認用の代役TestPlayerをこのシーンだけに作ります。シーンを保存してPlayし、TestPlayerがCoinに触れたときにCoinが消えてカウントが増えるか確認します。TestPlayerはPrefabにしません。
    TestPlayerの作り方と接触確認
    1. Hierarchyで2D Object > Sprites > Squareを選び、名前をTestPlayerにします。
    2. Rigidbody 2D(Body Type = Dynamic、Gravity Scale = 1)とBox Collider 2Dを付けます。
    3. Inspector上部のTagからPlayerを選び、Coinの真上に配置します。Playすると重力で落ち、Coinに接触します。
  4. Playを止めたら、上記の手順でMainScene.unityのテスト用変更を破棄します。シーンがChangesに残っていないことを確認し、2本のスクリプト・2つのPrefab・対応する.metaをCommit・Pushします。

確認:両者の担当PRにMainScene.unityの変更が含まれません。

補足:簡易スコア表示

OnGUIはこの実習の簡易表示です。staticのAddCoin()をCoinから呼びます。最終シーンにCoinCounterは1個だけ配置します。

STEP 5:PRを順番に統合する

PR作成・レビュー・マージはWinFormsで学習した手順を使います。操作を確認したい場合はPull Requestを体験する(Gitチーム開発)を参照してください。 レビュー結果の意味や修正依頼後の対応は、Approve・Request changes・Dismiss review・Closeの違いで確認できます。今回は先にAさん、次にBさんの順で統合します。

Unity上の確認:STEP 3・4では、PRを出す前に、各自が自分のPCでPlayして動作を確認します。PRのレビューでは、Files changedで担当ファイルと.metaが揃い、MainScene.unityが含まれないことの確認が中心です。相手のブランチに切り替えてUnityで確認する方法は、実務フロー編で説明します。STEP 6の統合後には、全員のPCで最新のmainをPullし、同じゲームが動くことを確認します。

  1. 2人とも担当ブランチをPushし、base = main、compare = 自分のfeature/...でPRを作ります。変更ファイルと動作確認結果を書き、PR画面右側のReviewersで相手にレビューを依頼します。依頼された人はFiles changedで担当のスクリプト・Prefab・対応する.metaを確認し、MainScene.unityが含まれないことを確かめます。その後、Review changesから、問題なければApprove、修正が必要ならRequest changesを選び、Submit reviewで提出します。
  2. AさんのPRにBさんのApproveが付いたことを確認し、mainへマージします。
  3. BさんはUnityを閉じ、GitHub Desktopでmainに切り替え、Fetch origin → Pull originを行います。自分のfeature/coin-collectionへ戻り、Branch > Update from mainを実行します。Unityを開き直して、AさんのPlayer.prefabがProjectウィンドウにあり、Consoleにエラーがないことを確認します。変更が入ったらPushし、PRのFiles changedにBさんの担当ファイルだけが出ることを再確認します。
  4. BさんのPRをAさんが再確認し、Approveを提出してからマージします。2人ともmainをPullします。

Bさんが最新のmainを取り込む順序

確認:Bさんの作業ブランチにAさんのPlayerが入り、最終的なmainにはPlayer・Coin・CoinCounterのPrefabが揃っています。mainをPullしただけでは、Bさんの作業ブランチは更新されません。Update from mainは、最新のmainの変更を、現在作業しているブランチへ取り込む操作です。これにより、Aさんが追加したPlayerなどの変更をBさんの作業ブランチにも反映できます。

答え合わせ:STEP 3・4のPRに入るのは担当のスクリプトとPrefabと.metaで、MainScene.unityは含まれません。複数人が同じシーンを編集すると変更が重なるため、シーンの統合はSTEP 6で1人が担当します。AさんのPRを先にマージし、BさんはUpdate from mainで追いつきます。

STEP 6:Aさんがシーンを組み立て、2人で再現する

Aさんは最新のmainからfeature/integrate-sceneを作ります。この段階で初めてMainScene.unityを編集します。Bさんは同時にこのシーンを変更しません。

  1. Player.prefabをシーンに配置します。HierarchyでPlayerを選び、Inspector上部のTagがPlayerであることを確認します。タグはSTEP 3でPrefabに設定済みです。
  2. Coin.prefabを3個、CoinCounter.prefabを1個配置します。配置例はPlayerのPosition = (-3, 0, 0)、3個のCoinを(-1, 0, 0)・(1, 0, 0)・(3, 0, 0)です。Playerと3個のCoinがGameビューに見えるようMain Cameraを確認し、収まらなければカメラを調整します。CoinCounterはHierarchyに1個あればよく、空のGameObjectなので画面には表示されません。
  3. Playで移動と接触を試し、Coins: 1 / 3 → 2 / 3 → 3 / 3、最後にCLEAR!を確認します。
  4. Playを止めてシーンを保存し、Commit・Push・PR・相手のレビュー・マージを行います。
  5. ほかのメンバーも最新のmainをPullし、全員のPCで同じゲームが動くことを確認します。

完成条件:1台のPCで動くだけでは完了ではありません。チーム全員のPCでシーンと機能を再現できれば成功です。

メンバーが休んだ日の進め方

休む人がいても、作業は止めずに進められます。担当ごとにファイルが分かれているからです。

状況やること
相方が休み、自分の担当は進められる自分のブランチで作り、Pushまでします。PRも出します
レビュー相手がいない授業の締切などでレビューを待てない場合に限り、変更ファイルが担当分だけか自分で確認してからマージします。揃った日に、相手が中身を確認します
統合担当(Aさん、3人ならCさん)が休み別のメンバーがfeature/integrate-sceneを作ります。手順はSTEP 6と同じです
休んだ人が戻ったmainをPullし、作業中のブランチでUpdate from mainを実行します(STEP 5の手順3と同じです)

休んでいる間に、シーン(MainScene.unity)を複数人で同時に触らないことだけは守ります。

困ったときの確認

症状最初に確認すること
Bさんのプロジェクトが開けないClone先直下にAssets・Packages・ProjectSettingsがあるか、Editorバージョンが一致するか
Missing Scriptスクリプトと対応する.meta、Consoleのエラー
Playerが動かないGameビューのフォーカス、Input System設定
Coinに触れても反応しないCoinのIs Trigger、Playerタグ、PlayerのRigidbody 2D
ChangesにMainScene.unityが出ているSTEP 2の「シーンをCommitに含めない方法」を確認。テスト用の変更だけか差分を見て、担当のコード・Prefabは残します
相手の機能が見えない現在のブランチ、mainのPull、作業ブランチのUpdate from main

発展学習

競合解消は、まずWinFormsのシリーズで扱ったテキストファイルの演習を復習してください。UnityのMainScene.unityやPrefabでの競合解消は、今回の完成条件には含めません。次の練習では担当を交換し、AさんはCoinの目標を2個に、BさんはPlayerの移動速度を変更してみましょう。Coinを3個配置したまま、2個目でCLEAR!が出るか確認します。新しいブランチで別々のファイルを編集し、PRで変更内容を説明します。次の段階では、担当別のテストシーンを用意し、共有シーンの正式な編集と動作確認を分ける方法を、実務フロー編で学びましょう。

関連するソフトライム記事

公式資料

次の実践:実務フロー編 — 担当別テストシーン・Prefab・PRで進める実務フローへ進みます。そのあと、基本制作3日間・18限のUnity実践2(4人でUI・効果音・ビルドまで完成させる)で担当を広げてみましょう。Gitチーム開発シリーズの目次へ。

訪問数 198 回, 今日の訪問数 1回

広告