0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

MacOS上でUnityプロジェクトをGithub管理するための流れ

0
Posted at

だいぶややこしかったため、見返せるようまとめてみた。
初稿のため読みずらい部分や気になる部分がある場合は教えていただけると幸いです。

前提条件

macOS Sonoma 14.1 (Apple M2)
git 2.44.0
Githubアカウント、Unity関連は導入済みとします。

参考資料

手順概要

  1. Unityでプロジェクトを作成
  2. gitignoreなどをプロジェクトに追加
  3. ローカルリポジトリを作成
  4. リモートリポジトリを作成
  5. SSHの生成と登録
  6. リモートリポジトリにローカルリポジトリを連携

1. Unityでプロジェクト作成

Unity Hubの右上にある"New project"からプロジェクトを制作
image.png

"Create project"でプロジェクトを作成
image.png

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

2. gitignoreなどをプロジェクトに追加

作成したUnityプロジェクトに以下のファイルを追加する

  • gitignore
  • ライセンス(任意)
  • README(任意)

それぞれのファイルについて

Unityでは本筋のプロジェクト以外のファイルが多数存在する。
(ライブラリとかダウンロードしたけど使わない他のアセットとか)
それらをgitにあげようとすると、誰かがクローンするときに莫大な容量と長いダウンロード時間を必要としてしまう。というかそもそもデカすぎるファイルはgithubにあげられない。そのため、gitで管理しないファイルを選ぶgitignoreが必要になる

そして、ライセンスは必要なら入れる程度でいいと思う。
これは、「GitHub上に挙げたコードをダウンロードして配布したり、改変したりしてもいいよ!」ということを示すものっぽい
特に、複数人での開発や、不特定多数に向けて配布してもいいツールとかは入れとかないと著作権関連でめちゃ面倒になるっぽい
※ライセンスの内容をしっかり読んでるわけでもないので、必要な人はしっかり調べてね

READMEは作ったコードがどんなものなのか、概要や使い方などを伝えるファイル。
ここも必要であれば(基本書いた方がいいと思うけど)
GitHub上で後からでも作れるので、ここで入れるかは任意

手順

  1. gitignore、ライセンス、READMEを作成する
    (今回はGitHub上で上記のファイルをまとめたテンプレートを作成する)
  2. gitignoreにダウンロードアセット用ディレクトリのパスを追加
  3. Unityプロジェクトにファイルを追加

GitHubマイページ → "Repositories" → "New" を押す
必要な情報と追加ファイルを選択
リポジトリ名は先程作成したプロジェクトの名前以外ならなんでもOK
(Unity-<ライセンス名>-Templateとでも入れとけばOK)
image.png

gitignoreを開いて編集
image.png
image.png
以下のコードを追加してDownloadフォルダ以下を無視

.gitignore
/[Aa]ssets/Downloads/

作成したテンプレートをダウンロードする
image.png

Unity Hubに戻って、プロジェクト横の3点リーダーから"Reveal in Finder"を押す
image.png

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

image.png

3. リモートリポジトリを作成

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

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」を選択
image.png
右上の「New SSH Key」を選択し、コピーした公開鍵を入力
「Add SSH key」で保存
image.png

6. リモートリポジトリにローカルリポジトリを連携

GitHub上のリポジトリからSSHをコピーする
image.png
以下のコマンドを入力してリモートリポジトリと連携

ターミナル
git remote add origin <コピーしたSSH>
git branch -M main
git push -u origin main

ページを更新して以下のようにファイルが表示されれば成功
image.png

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?