概要
Unityで作成したコードをGitHubでバージョン管理する手順を記載しています。
Unityは、EclipseやAndroid Studio、Visual Studioなどと違い、GitHubとの連携が最初から用意されているわけではないようで、下記のような方法を選択するようです。
- Github for Unity(https://unity.github.com/)
UnityのAssetとして、GitHub管理したいプロジェクトに追加する方式。 - Source Tree(https://www.sourcetreeapp.com/)
OS上のファイルをGit管理する。という扱いでUnityをGitHub管理する。 - GitHub Desktop(https://desktop.github.com/)
GitHub純正のGit管理アプリ。GitHub側に近いUIなので、ローカル上の管理は戸惑うかも。
前提環境
* macOS 12.2.1(Monterey)
* SourceTree
* Unity 2020.3.29f1(Personalライセンス)
* Github Free(https://github.co.jp/pricing.html )
やってみる
Unity Hubなどから新規で作成したプロジェクトをGitHubで管理するまでの流れで進めていきます。
個人的に多いのが2Dでのテンプレで作成しているので、下記のような感じの構成になります。
プロジェクト名は「Sample2D」としておきます。
.
├── Assets
│ └── Scenes
├── Library
│ ├── APIUpdater
│ ├── Artifacts
│ ├── PackageCache
│ ├── PackageManager
│ ├── ScriptAssemblies
│ ├── ShaderCache
│ ├── StateCache
│ └── TempArtifacts
├── Logs
├── Packages
├── ProjectSettings
├── UserSettings
└── obj
└── Debug
というわけで、上記のプロジェクトをGitHubへ登録します。
SourceTreeのインストールなど
前回(SourceTreeでGitHubを使う )で解説したので、そちらを一読してください。
GitHubにリポジトリを作成する
SourceTreeからGitHubにリポジトリを作成することはできないようです。
なので、先にGitHub側でリポジトリを作成します。
作成するのは、作成したUnityプロジェクトと同名(Sample2D)としておきます。
自分用のリポジトリなのでPrivateを選択します。
そして、.gitignoreを追加します。(重要)
ここで、Unity用の.gitignoreが標準で用意されているので、追加しておくと余計なファイルをGitHubに登録しないようになります。
はい。まずは、空っぽのリポジトリができました。
SourceTreeでローカルにクローンしてくる
SourceTreeを開いて、リモート側に作成したリポジトリを探します。
見つけたら、リポジトリの右側の「クローン」をクリックして、適当なところにクローンします。
一応書いておきますが、Unityプロジェクトが置かれているところには、すでに同名のフォルダがあるので別の場所にしましょう。
クローンすると、SourceTreeのローカル側に表示されます。
ローカルにクローンしたフォルダにコピーする
Unityプロジェクトをクローンしたフォルダにコピーします。
GitHubにプッシュする
正確には、ローカルのGitリポジトリにコミットして、リモートのGitHubにプッシュです。
UnityプロジェクトでGitHub管理にしたくないものの選別は、すでにUnity用の.gitignoreがあるので、気にせずコミットしてOKです。
下記のように、フォルダにコピーした時点で、コミット対象はこのくらい。と数が表示されている(今回は30ファイル)。
リポジトリをダブルクリックして開くとコミット対象のリストが確認できる
「保留中のファイル」のチェックをつけると、すべての対象にチェックがつくので、チェックをつけます。
コミットメッセージに適当に記載して、コミットボタンをおします。
この時点では、GitHubにはあがってません。まだローカルGitへコミットしただけです。
上記のように、プッシュに通知がきていると思います。
クリックすると、下記のように確認が表示されるので、一応確認してOKボタンをクリックします。
これで、GitHubにプッシュされたはずです。
GitHubで確認してみる
GitHub側で対象のリポジトリを見てみると、無事、Pushできていることが確認できました。
このあとの問題
自分はやらかしたので、一応書いておきますが、Unity Hub側で新しくクローンしてプッシュさせたフォルダに切り替えてください。
そうしないと、Git管理されていないほうを更新していって、でもSourceTreeにはコミット対象はない。と言われるアホなことをしでかします。
以上で、UnityをGitHub管理するまでの手順でした。