【Unity 6】GitHubを使ったUnityアプリのリリース版作成|ビルド・ZIP・タグ・Releases
完成したUnityのゲームを、ほかの人が遊べる形にして、GitHubで配る手順です。ビルド → ZIP → タグ → Releases の順に進めます。4人実践の3日目から来た人も、この記事の順に進めれば完成します。

この記事で作るもの
GitHubの「リリース」は、次の3つを1つにまとめて、版ごとに残す仕組みです。
| 何を | 役割 | どこにあるか |
|---|---|---|
| ソースコード | ゲームの元になるファイル | Gitのコミット |
| タグ | その版に付ける名前(例:v1.0.0) | Gitのタグ |
| ZIP(ビルドしたファイル) | 遊ぶ人に配るファイル | GitHubのReleasesに添付 |
始める前の準備
- ビルドに使う変更が、すべてmainにCommit・Pushされています。GitHub DesktopのChangesが空であることを確認します。チームで作ったゲームは、全員が最新のmainをPullします。
- Unityでプロジェクトを開き、Consoleにエラーがないことを確認します。
- プロジェクトの.gitignoreに、Buildフォルダーの除外が入っていることを確認します。Unity用の.gitignoreを選んでリポジトリを作っていれば、
/[Bb]uild/と/[Bb]uilds/の行が入っています。
STEP 1:Build Profilesでビルドする
メニューから開く
Unityのメニューから File > Build Profiles を選びます(ショートカットは Ctrl+Shift+B です)。

ビルド画面を確認する
左の一覧でプラットフォーム(Windowsの場合は Windows)を選びます。Scene List に、ゲームで使うシーン(4人実践ならMainScene)が入っていて、チェックが付いていることを確認します。

Buildボタンを押して、出力先を選ぶ
Build を押すと、フォルダーを選ぶ画面が出ます。Unityプロジェクトのフォルダーの直下に、Build フォルダーを新しく作って選びます。(Builds でも構いません。)

Buildフォルダーは、.gitignoreに書かれているので、Gitの管理から外れます。ビルドしたファイルを、誤ってコミットしないための決まりです。Macでビルドするときも、同じように Build フォルダーを選びます(出力は .app になります)。
確認:ビルドが終わったら、GitHub Desktopを開きます。ChangesにBuildフォルダーの中のファイルが出ていなければ、Gitの管理から外れています。
考えてみよう:ビルドしたファイルを、Gitのコミットに入れないのはなぜでしょう。
答えを見る
ビルドしたファイルは、ソースコードからいつでも作り直せます。サイズも大きいので、Gitのコミットではなく、Releasesで配ります。Unity用の.gitignoreにBuildフォルダーの除外が入っているのは、そのためです。
STEP 2:ビルドしたゲームを実行して確認する
Buildフォルダーの中の実行ファイル(Windowsは .exe)をダブルクリックして、起動します。移動、Coinの取得、クリア、Restartなど、エディターで動いていた操作が同じように動くことを確認します。
ゲームの閉じ方:ビルドしたゲームは、設定によっては全画面で起動し、×ボタンがありません。閉じるときは、Windowsは Alt+F4、Macは Cmd+Q を押します。Escapeキーなどで終了させたい場合は、次の記事を参考に、終了処理を組み込みます(任意です)。
STEP 3:ビルドしたファイルをZIPにまとめる
遊ぶ人に配るため、Buildフォルダーの中身をZIPにまとめます。.exe だけでは動きません。_Data フォルダーや UnityPlayer.dll など、Buildフォルダーの中のすべてが必要です。
圧縮する
エクスプローラーでBuildフォルダーを選び(ファイル単体ではありません)、右クリックして圧縮します。Windows 11では「ZIP ファイルに圧縮する」、Windows 10では「送る」→「圧縮(zip 形式)フォルダー」を選びます(下の画像はWindows 10の画面です)。Buildフォルダーの中身をすべて選んで圧縮しても構いません。

ZIPの名前は、バージョン付きにします(例:CoinCollector-v1.0.0-win.zip)。Releasesに複数の版が並んでも、見分けられます。Macは、Finderで右クリックして圧縮します。
ZIPをBuildフォルダーに置く
ZIPは、Buildフォルダーの中に置きます。Buildフォルダーは.gitignoreで除外されるので、GitHub DesktopのChangesには出ません。下の画像のZIPの名前は Build.zip ですが、実際には上で決めたバージョン付きの名前にします。

配る前に確認する
ZIPを別の場所に展開して、起動して動くことを確認します。可能なら、別のPCで行います。Windowsでは、ZIPのまま実行せず、必ず展開してから起動します。ZIPの中から直接起動すると、同じフォルダーにある必要なファイルを読み込めず、起動に失敗することがあるためです。
STEP 4:確認済みのコミットにタグを付ける
タグは、「この版」という名前を、特定のコミットに付けるものです。バージョンをタグ名にします(例:v1.0.0)。
ビルドに使ったコミットにタグを付けます。最新のコミットではありません。ソースコード・タグ・ZIPを、同じ状態にそろえるためです。
- GitHub Desktopの
Historyを開き、ビルドに使ったコミットを右クリックして、Create Tag...を選びます。 Nameにバージョン(例:v1.0.0)を入力して、Create Tagを押します。- タグをGitHubへ送ります。GitHub Desktopは、タグを関連するコミットと一緒に送ります。タグの名前の横に上向きの矢印が付いている間は、まだGitHubへ送られていません。画面上部に
Push originが出ているときは、押します。


確認:ブラウザでGitHubのリポジトリを開き、tagsに v1.0.0 が出ていることを確認します。
STEP 5:GitHub ReleasesでZIPを配る
Releasesは、版ごとにZIPなどのファイルを添付して配る場所です。過去の版も残るので、いつでも取得できます。
- ブラウザでGitHubのリポジトリを開き、右側の
Releasesを開き、一覧上部のDraft a new releaseを選びます。右側にCreate a new releaseが表示されていれば、そこからも開けます。 Select tagで、作成したタグ(v1.0.0)を選びます。Release titleに、リリース名を入力します(例:v1.0.0 初回リリース)。- 説明欄に、変更内容や遊び方を書きます。リリースノートの自動生成も使えます(下の記事)。
- 作成したZIPを、説明欄の下にある配布ファイルの添付枠にドラッグ&ドロップします。
Publish releaseを押します。


枠で囲んだ欄には、次のように入力します。
| 欄 | 入力例 | 補足 |
|---|---|---|
| Tag | v1.0.0 | STEP 4で作ったタグを選びます。ここで新しく打ち込む必要はありません |
| Target | main | 初期値のままで構いません |
| Release title | v1.0.0 初回リリース | 何の版かひと目でわかる名前にします |
| 説明欄 | コインを集めるゲームの初回版です。矢印キーで移動します。 | 遊び方や変更点を短く書きます |
| 配布用ZIP | CoinCollector-v1.0.0-win.zip | 説明欄の下にある添付欄へドラッグ&ドロップします |
STEP 6:公開されたリリースをダウンロードして確認する
リリースのページを開き、Assets に並ぶファイルを見ます。
- 自分で添付したZIP(例:
CoinCollector-v1.0.0-win.zip):遊ぶためのファイルです。 Source code(zip / tar.gz):GitHubが自動で付けるソースコードです。遊ぶためのファイルではありません。

自分で添付したZIPをダウンロードして、展開し、起動します。クリアまで動けば完成です。ほかの開発者が公開しているアプリも、このようにReleasesでバージョンごとに配られています。
ダウンロードした .exe を起動すると、「WindowsによってPCが保護されました」と表示されることがあります。自分で作ったゲームであれば、「詳細情報」を押して「実行」を選びます。
考えてみよう:Source code をダウンロードしても、ゲームを遊べないのはなぜでしょう。
答えを見る
Source codeは、Unityで開いてビルドするための元のファイルだからです。実行ファイルは含まれていません。
困ったときの確認
| 症状 | 最初に確認すること |
|---|---|
| ChangesにBuildフォルダーの中のファイルが出る | .gitignoreに /[Bb]uild/ の行があるか、Buildフォルダーがプロジェクトの直下にあるか |
| ZIPを開いても、ゲームが起動しない | ZIPを展開して起動したか。.exe だけをZIPにしていないか |
| ゲームを閉じられない | Windowsは Alt+F4、Macは Cmd+Q |
Releasesの Select tag に、タグが出ない | GitHub Desktopのタグの名前の横に、上向きの矢印が残っていないか(残っていれば、まだGitHubへ送られていません)。GitHubのtagsの一覧にも、タグがあるか |
| リリースの作成ボタンが見つからない | 右側の Releases を開き、一覧上部の Draft a new release を探します。表示されない場合は、ログインとリポジトリへの書き込み権限を確認します。 |
参考
インストーラー付きでリリースする場合
Windowsアプリとして、インストーラーを使ってインストールしてもらう方が喜ばれることがありますね
ファイルを2つGitHubにアップすることもできます












ディスカッション
コメント一覧
まだ、コメントがありません