【Godot4】Gitでのバージョン管理：実践編①　ローカルリポジトリでの基本操作

1. Godotプロジェクト作成：
Godotで、新規プロジェクト作成時に
［バージョン管理メタデータ］で[Git]を選択
し、作成します。

※この操作によって、新規プロジェクトファイル内にGodot用の［.gitignore］、［.gitattributes］ファイルが生成されます

2. リポジトリ作成：
Source treeを起動し、
新規タブ→［Create］で、
手順1.で作成したプロジェクトフォルダを指定
します。

※この操作で、指定したGodotプロジェクトフォルダ内に、新規リポジトリ(.gitフォルダ)の作成が行われます。（＝コマンド［git init］相当）

※[作成]をクリックすると、確認メッセージが出力されますが、［はい］で進んでしまってOKです。
(既存フォルダをGit管理対象とする際の確認です)

完了確認：
画像のような画面になっていればOKです。

「作業ツリーのファイル」にはGodotプロジェクトフォルダ内のファイルが表示されていることが確認できます。
（.gitignore で除外されているものを除く）

1. プロジェクトファイルの編集(変更の確認)：
まずはGodotプロジェクトフォルダ内のファイルに対して、何らかの変更を行います。
→新規ファイルが追加されたり、既存のファイルに変更が発生すると、Gitはその変更を検知します。
(読み込まれていないときはF5で更新できます)

Source treeでは、この内容を
［ファイルステータス］
→［作業ツリーのファイル］から確認できます。(変更がない場合は非表示となります)

2. ステージング (git add)：
［すべて/選択を インデックスに追加］から、変更内容をステージします。
→ファイルが［indexにステージしたファイル］
　へ移動したことを確認できます

※ステージングとは、
次に行うコミット(変更の反映)の準備として、「反映する対象を選別する」作業のイメージです。＝インデックスに追加するとも言います

3. コミット (git commit)：
ファイルステータス下部にあるテキストボックスにコミットメッセージ※を入力し、
右下のボタンからコミットを実行します。

※例は初回コミットのため、コミットメッセージは「初期化(initialize)」の略で「init」としています。

完了確認：
コミットが完了すると、自動的に［History］タブへ表示が移動します。
ここで、これまでに行ったコミットの内容が確認できます。

※画像は初回コミットのため、一つだ表示されています。

今回は説明用に以下の画像のようなコミット履歴を用意しました。
→最新バージョンのファイル内は、
「レベル01シーン」、「レベル02EXシーン」が存在する状態です

チェックアウト：
Source treeでは、対象コミットをダブルクリックすることでチェックアウトができます。
(現在地点の前後どちらでもOKです。)

→今回はレベル01を追加した時点に戻ります

確認メッセージが出力されますが、
今回は［OK］で進んでしまって問題ありません

※こちらの確認メッセージの意味と”HEAD”についてはブランチ作成について触れるときに合わせて説明いたします

チェックアウトが完了すると、
ファイルの状態が指定したコミット時点のものになっていることを確認できます。

新規ブランチの作成：
Source treeでは、上部メニュー［ブランチ］
→［新規ブランチ］からを作成できます。

サイドバーの［ブランチ］で、新規作成したブランチを確認できます。

作成時に［新規ブランチを作成してチェックアウト］が有効な場合、自動的に新規ブランチが現在の作業場所となります。

新規ブランチにチェックアウトした状態で、
Godotプロジェクトをを編集します。

→例では、シーン「level_01.tscn」を削除し、
「level_01_ex.tscn」へ更新しています

続けて、ステージング～コミットを行います。

コミットが完了すると、mainブランチとは別に、［sub_test01］ブランチのコミットとして分岐して反映されていることが確認できます。

→ここでの変更は、mainブランチへは影響しません

ブランチの移動：
作成済みのブランチ間を移動する際も「チェックアウト」を使用します。
→Source treeでは、移動したいブランチをダブルクリックでチェックアウトできます。

マージの実行：
①マージ先(main等)ブランチへチェックアウト
②マージしたいブランチを右クリック
③［現在のブランチに<ブランチ名>をマージ］をクリックして実行

確認メッセージが出力されるため、OKで進みます。

※ファストフォワードについては補足参照

これでマージの作業は完了です。
ファイルを見ると、サブブランチでの作業がメインブランチへ反映されていることを確認できます。

今回は例として画像のようなブランチを用意しました。

同一gdスクリプトファイル７行目にて、
　mainでは、　　　printt(“TEST01”)
　sub_test02では、printt(“TEST02”)
と、衝突が発生するようにコミットしています。

この状態でマージを行うと、衝突が発生し、画像のようなメッセージが表示されます。

衝突(コンフリクト)の解消：
衝突が発生したファイルをGodotで開くと、画像のように衝突した箇所と各ブランチの内容が表示されています。

→衝突を解消するにはこの部分を編集し、
　・どちらか一方の編集内容を採用
　・または、２つを統合した内容を新たに追記
といった対応を行います。

今回は例として、２つの内容を組み合わせた、
　printt(“TEST!&TEST02”)
という内容に変更しました。

この状態で、再度、コミットを行うことで、衝突が解消され、正常にマージコミットが作成されます。

※このときのコミットメッセージは、衝突発生時に自動的に生成されていますが、追記や変更も可能です。