UnityプロジェクトでGitHub Actionsを用いたCI/CDパイプラインを構築するための詳細な手順
ステップ1:UnityプロジェクトをGitHubにプッシュ
Gitの初期化:
- プロジェクトフォルダでターミナル(またはコマンドプロンプト)を開き、
git initを実行してGitリポジトリを初期化します。
.gitignoreの設定:
- Unity用の
.gitignoreファイルを作成します。以下の内容を含めることを推奨します。/Library/ /Temp/ /Obj/ /Build/ /Builds/ /Logs/ /UserSettings/ - これは不要なファイルや大容量のファイルをリポジトリに含めないようにするためです。
リポジトリへのプッシュ:
- GitHub上で新しいリポジトリを作成します。
- ローカルリポジトリをリモートリポジトリに接続します。
bash git remote add origin https://github.com/あなたのユーザー名/リポジトリ名.git - 変更をコミットしてプッシュします。
bash git add . git commit -m "初回コミット" git push -u origin main
Unity 6 のテストとビルドを GitHub Actions で実行する
まずローカルで Test Runner を開き、Edit Mode と Play Mode のテストを実行しておきます。リポジトリには Assets、Packages、ProjectSettings、および Unity の .meta を含めます。この例は GitHub.com の Ubuntu ホストランナーを使用し、リポジトリ直下に Unity プロジェクトがある構成を想定します。
GitHub の Settings > Secrets and variables > Actions に、契約に合う GameCI のライセンス情報を登録します。下の YAML は Personal の例です。Personal では UNITY_LICENSE、UNITY_EMAIL、UNITY_PASSWORD を使います。シリアルを使用する契約では、GameCI の案内に沿って UNITY_SERIAL、UNITY_EMAIL、UNITY_PASSWORD を両 Action に渡します。ライセンスファイルの取得手順は契約別の案内に従ってください。 GameCI ライセンス認証
.github/workflows/unity-ci.yml に以下を保存します。Unity のバージョンは GameCI の自動判定で ProjectSettings/ProjectVersion.txt に合わせます。サブフォルダーにある場合は、両 Action に同じ projectPath を指定してください。
name: Unity CI
on:
workflow_dispatch:
push:
branches: [main]
pull_request:
branches: [main]
permissions:
contents: read
jobs:
test-and-build:
if: ${{ github.event_name != 'pull_request' || (github.event.pull_request.head.repo.full_name == github.repository && github.actor != 'dependabot[bot]') }}
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
with:
persist-credentials: false
- name: Run Edit Mode and Play Mode tests
uses: game-ci/unity-test-runner@v4
env:
UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
with:
testMode: All
artifactsPath: test-results
- name: Upload test results
if: ${{ !cancelled() }}
uses: actions/upload-artifact@v7
with:
name: unity-test-results
path: test-results
if-no-files-found: warn
- name: Build Windows Player
uses: game-ci/unity-builder@v4
env:
UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
with:
targetPlatform: StandaloneWindows64
- name: Upload Windows build
uses: actions/upload-artifact@v7
with:
name: windows-player
path: build/StandaloneWindows64
if-no-files-found: error
testMode: All は Edit Mode と Play Mode を実行します。ビルドした Player 上でのテストは、対応する環境で Standalone を指定して別途実行します。テストが失敗するとビルドはスキップされます。結果ファイルが生成されていれば、失敗した実行でも Artifacts から確認できます。fork 由来の PR や Dependabot の PR は、認証情報を渡すジョブの対象外です。同一リポジトリのブランチでこのジョブを動かす場合も、変更を加えられる人を信頼できる範囲に限ります。
初回は Actions タブから Run workflow で起動し、テスト結果と Windows Player の両方を確認します。配布する場合は、確認済みの成果物を GitHub Releases の下書きに添付します。ここまでの YAML が行うのは、テスト、ビルド、実行結果への成果物保存です。
GameCI Test Runner v4 · GameCI Builder v4 · GitHub checkout · GitHub upload-artifact · GitHub Actions のシークレット









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