だいぶややこしかったため、見返せるようまとめてみた。
初稿のため読みずらい部分や気になる部分がある場合は教えていただけると幸いです。
前提条件
macOS Sonoma 14.1 (Apple M2)
git 2.44.0
Githubアカウント、Unity関連は導入済みとします。
参考資料
- UnityをGitHubで共同開発するための快適な開発環境+Tips
https://qiita.com/ayakaintheclouds/items/c7022b393485db573bda - W3 School "Git and GitHub"
https://www.w3schools.com/git/git_remote_getstarted.asp?remote=github
「Git What is SSH?」 ~ 「GitHub Set Remote」 まで - SSH接続のやり方をめちゃくちゃ詳しく解説する for Mac
https://qiita.com/rihib/items/9b1f611619695cbf68a0 - GitHubが公開してるオープンソースガイドライン、まとめてみた。
https://zenn.dev/naoki/articles/6b2a63e08f2b02e524d9
手順概要
- Unityでプロジェクトを作成
- gitignoreなどをプロジェクトに追加
- ローカルリポジトリを作成
- リモートリポジトリを作成
- SSHの生成と登録
- リモートリポジトリにローカルリポジトリを連携
1. Unityでプロジェクト作成
Unity Hubの右上にある"New project"からプロジェクトを制作

プロジェクトが開いたら、下部の"Project"のAssetフォルダ内にDownloadsフォルダとProjectフォルダを作成。Downloadsフォルダにはダウンロードしたアセットフォルダを入れ、ProjectフォルダにDownloads以外の全てのファイルを入れる
(Downloads内には何も入ってなくてもOK)

2. gitignoreなどをプロジェクトに追加
作成したUnityプロジェクトに以下のファイルを追加する
- gitignore
- ライセンス(任意)
- README(任意)
それぞれのファイルについて
Unityでは本筋のプロジェクト以外のファイルが多数存在する。
(ライブラリとかダウンロードしたけど使わない他のアセットとか)
それらをgitにあげようとすると、誰かがクローンするときに莫大な容量と長いダウンロード時間を必要としてしまう。というかそもそもデカすぎるファイルはgithubにあげられない。そのため、gitで管理しないファイルを選ぶgitignoreが必要になる
そして、ライセンスは必要なら入れる程度でいいと思う。
これは、「GitHub上に挙げたコードをダウンロードして配布したり、改変したりしてもいいよ!」ということを示すものっぽい
特に、複数人での開発や、不特定多数に向けて配布してもいいツールとかは入れとかないと著作権関連でめちゃ面倒になるっぽい
※ライセンスの内容をしっかり読んでるわけでもないので、必要な人はしっかり調べてね
READMEは作ったコードがどんなものなのか、概要や使い方などを伝えるファイル。
ここも必要であれば(基本書いた方がいいと思うけど)
GitHub上で後からでも作れるので、ここで入れるかは任意
手順
- gitignore、ライセンス、READMEを作成する
(今回はGitHub上で上記のファイルをまとめたテンプレートを作成する) - gitignoreにダウンロードアセット用ディレクトリのパスを追加
- Unityプロジェクトにファイルを追加
GitHubマイページ → "Repositories" → "New" を押す
必要な情報と追加ファイルを選択
リポジトリ名は先程作成したプロジェクトの名前以外ならなんでもOK
(Unity-<ライセンス名>-Templateとでも入れとけばOK)

gitignoreを開いて編集


以下のコードを追加してDownloadフォルダ以下を無視
/[Aa]ssets/Downloads/
Unity Hubに戻って、プロジェクト横の3点リーダーから"Reveal in Finder"を押す

Finder上でプロジェクトのフォルダにダウンロードしたテンプレートを移動すれば完了!
.gitignoreファイルは隠しファイルなので、command+shift+.(ピリオド)で表示

3. リモートリポジトリを作成
GitHubを開き2と同じようにリポジトリを作成する。
今度はリポジトリ名にプロジェクトの名前を入力
(このために2で作成したリポジトリはプロジェクト名を避ける必要があったんですね)(RTA並感)

4. ローカルリポジトリを作成
2で作成したプロジェクトのフォルダを選択して右クリックで"フォルダに新規ターミナル"
ターミナルが開いたら以下を入力
git init
git add .
git commit -m "<好きなメッセージ>"
これでローカルリポジトリを作成完了!
5. 鍵の生成と登録
作成したローカルリポジトリをGitHub上のリモートリポジトリに繋げるにはSSH接続というのを行います。そのために、まずは暗号化の鍵を生成する必要があります。(すでに鍵の生成と登録を行なっている場合は6にスキップ)
鍵の生成はターミナルで行います。
以下のコマンドを入力
ssh-keygen -t ed25519 -C "<GitHubに登録しているメールアドレス>"
実行すると、鍵ファイルの名前と保存場所を聞かれるため、それを決める
(そのままEnterを押すと、カッコ内の位置と名前になる)
Generating public/private ed25519 key pair.
Enter file in which to save the key (/Users/<名前>/.ssh/id_ed25519):
パスフレーズを入力する(確認用に2回入力)
セキュリティ的に300文字くらいのランダム文字列を生成した方がいいらしい
パスフレーズはパスワードマネージャーで登録するなどで保存
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
以下のような表示が出れば生成完了
The key's randomart image is:
+--[ED25519 256]--+
| .. |
| ..o |
| =E |
| . o ooo . |
|. . + + S = o |
|...... + + O |
| . +.o .= * . |
| ooBo++o+ |
| .=+B=oo++. |
+----[SHA256]-----+
生成した鍵は以下のコマンドで確認できる
左側が秘密鍵で右側が公開鍵(publicの.pub)になる
ls ~/.ssh
<生成したファイル名> <生成したファイル名>.pub
生成した秘密鍵(.pubとついていない方)をSSHエージェントに登録
ssh-add ~/.ssh/<秘密鍵のファイル名>
先ほど設定したパスフレーズを入力してエージェントに登録
その後、公開鍵の方をコピーする
pbcopy < ~/.ssh/<公開鍵のファイル名>
コピーした公開鍵はGitHubに登録する
GitHubから右上のユーザーアイコンをクリックし、出てきたメニューバーから「Setting」、左側のメニューから「SSH and GPG keys」を選択

右上の「New SSH Key」を選択し、コピーした公開鍵を入力
「Add SSH key」で保存

6. リモートリポジトリにローカルリポジトリを連携
GitHub上のリポジトリからSSHをコピーする

以下のコマンドを入力してリモートリポジトリと連携
git remote add origin <コピーしたSSH>
git branch -M main
git push -u origin main



