BitriseのUnity
Bitriseは、当社のbuild machines上でUnityソフトウェアを使用するための完全なサポートを提供します。便利なライセンス管理、最大40GBのディスク容量、そしてiOS版とAndroid版の両方のUnityプロジェクトを簡単に作成できるモバイル向けビルド環境が含まれます。
BitriseでUnityアプリをビルドできるようにするには、次の作業が必要です。
- Bitriseアプリとしてプロジェクトを追 加する。
- ビルドを実行する仮想マシンにUnityをダウンロードしてインストールする。
- Bitriseにライセンスを追加し、ビルド中にアクティベートする。
- プロジェクトをビルドする。
UnityプロジェクトをBitriseアプリとして追加するClick to copy link
Unityプロジェクトを新しいアプリとして追加します。プロジェクトスキャナーはUnityソフトウェアをサポートしていないため、プロジェクトをUnityプロジェクトとして検出しません。そのため自動設定をスキップし、プロジェクトをOtherとして登録できます。
Xcodeのスタックの使用をおすすめします。こちらには重要なAndroidツールも含まれています。当社のXcodeスタックでは、UnityアプリのiOS版とAndroid版の両方をビルドできます。
BitriseにUnityソフトウェアをダウンロードしてインストールするClick to copy link
BitriseでUnityプロジェクトをビルドできるようにするには、ビルド開始時に仮想マシンへUnityソフトウェアをインストールする必要があります。これはクラウドでUnityソフトウェアを実行する際の標準的な方法であり、数分で完了します。
Unityビルドの実行には、必ずXcodeスタックを使用してください。このページの手順は、当社のXcodeスタックにUnityをインストールする場合に有効です。
-
ダウンロードしたいUnityソフトウェアのバージョンを、Unityダウンロードアーカイブで確認します。
-
必要なバージョンのUnity Editorを見つけて、ダウンロ ードリンクをコピーします。
リンクは次のような形式になります: https://download.unity3d.com/download_unity/b16b3b16c7a0/MacEditorInstallerArm64/Unity.pkg.
-
2つのプラットフォームサポートパッケージ(iOSとAndroid)のダウンロードリンクも必要です。これらはLTS Releasesページで確認できます。
-
Content入力に、必要なUnityパッケージをダウンロードするcurlコマンドを追加します。例:
#workaround for .NET issue https://github.com/dotnet/runtime/issues/64103export COMPlus_ReadyToRun=0envman add --key COMPlus_ReadyToRun --value 0#download unity pkg for Apple Siliconcurl -o ./unity.pkg http://download.unity3d.com/download_unity/8af3c3e441b1/MacEditorInstallerArm64/Unity-2021.3.12f1.pkg#download android support platformcurl -o ./android.pkg http://download.unity3d.com/download_unity/8af3c3e441b1/MacEditorTargetInstaller/UnitySetup-Android-Support-for-Editor-2021.3.12f1.pkg#download iOS support platformcurl -o ./ios.pkg http://download.unity3d.com/download_unity/8af3c3e441b1/MacEditorTargetInstaller/UnitySetup-iOS-Support-for-Editor-2021.3.12f1.pkgダウンロードリンクを、必要なバージョンのリンクに置き換えてください。
-
必要に応じて、Rosettaに対応したAppleシリコン向けのUnityソフトウェアバージョンをインストールすることもできます。
#download unity pkg for Apple Silicon with Rosetta supportcurl -o ./unity.pkg http://download.unity3d.com/download_unity/8af3c3e441b1/MacEditorInstaller/Unity-2021.3.12f1.pkg
成功すると、/Applications/Unity/Unity.app/Contents/MacOS/UnityにUnityソフトウェアが見つかるはずです。
BitriseでUnityライセンスを設定するClick to copy link
Unityのポリシーに従い、コマンドラインをサポートしているのは有料プランのみです。そのため、UnityプロジェクトをビルドするにはBitriseにUnityライセンスプールを追加する必要があります。build machinesがWorkflowのライセンスを見つけますが、Unityのメールアドレスとパスワードを入力してアクティベートする必要があります。
複数のビルドを同時に実行するには、ビルドごとに個別のlicense keysが必要です。たとえば、Unityアプリのビルドを3つ同時に実行したい場合、少なくとも3つの個別のUnityライセンスが必要です。
Unityライセンスプールを追加するClick to copy link
-
BitriseにLog inし、左側のナビゲーションバーにカーソルを合わせます。
-
Workspaceメニューで、正しいworkspaceが選択されていることを確認します。
-
Settingsを選択します。
-
左側で Integrations を選択します。
-
License pool カードをクリックします。
-
Add license pool をクリックします。

-
各項目を入力します。
次の項目を設定する必要があります:
- 名前: Workflow Editorでプールを見つけるために使用します。
- 環境変数キー: ビルドスクリプトでライセンスを使用する方法です。
- license keysそのもの。ライセンスキーには、スペースやアンダースコア以外の特殊文字を含めることはできません。
-
Save をクリックします。
-
必要なアプリのWorkflow Editorを開き、Licenses タブに移動します。
-
ライセンスプールが必要なWorkflowごとに選択します。

UnityライセンスをアクティベートするClick to copy link
ビルドを実行する際は、まずUnityライセンスをアクティベートする必要があります。これにはUnityのメールアドレスとパスワードの入力が必要です。これらの保存にはSecretsの使用をおすすめします。
ビルドが完了したら、再利用できるようにUnityライセンスを非アクティブ化することを強くおすすめします:
/Applications/Unity/Unity.app/Contents/MacOS/Unity -quit -batchmode -logFile -returnlicense
-
メールアドレスとパスワードを保存するために、2つのSecretsを作成します。次のキーを使用することをおすすめします:
- UNITY_EMAIL: 値としてメールアドレスを設定します。
- UNITY_PW: 値としてUnityパスワードを設定します。
-
Workflow内の、UnityソフトウェアをインストールするStepの後に配置した Script Stepに、次のコードを追加します:
/Applications/Unity/Unity.app/Contents/MacOS/Unity -quit -batchmode -serial "$UNITY_SERIAL" -username "$UNITY_EMAIL" -password "$UNITY_PW" -logfileUtility Workflowを使用するベストプラクティスとして、このStepを含むutility Workflowを作成し、Unityが必要な各Workflowの前に実行するようにします。
Unityソフトウェアを使用してビルドを実行するClick to copy link
設定が完了すると、BitriseでUnityソフトウェアを使用してビルドを実行できます。同じWorkflow内であっても、アプリのAndroid版とiOS版の両方をビルドできます。
BitriseでUnityソフトウェアを使用してビルドを実行するには:
-
アプリのAndroid版をビルドするには、Script Stepを追加し、Content入力に次の内容を追加します:
/Applications/Unity/Unity.app/Contents/MacOS/Unity -nographics -quit -batchmode -logFile -projectPath "$BITRISE_SOURCE_DIR" -executeMethod BitriseUnity.Build -androidSdkPath "$ANDROID_HOME" -buildOutput "$BITRISE_DEPLOY_DIR/mygame.apk" -buildPlatform android -
アプリのiOS版用にXcodeプロジェクトを作成するには、Script Stepに次の内容を追加します:
/Applications/Unity/Unity.app/Contents/MacOS/Unity -nographics -quit -batchmode -logFile -projectPath "$BITRISE_SOURCE_DIR" -executeMethod BitriseUnity.Build -buildOutput "$BITRISE_SOURCE_DIR/xcodebuild" -buildPlatform ios -
完了したら、ライセンスを非アクティブ化します:
/Applications/Unity/Unity.app/Contents/MacOS/Unity -quit -batchmode -logFile -returnlicense