メインコンテンツまでスキップ

BitriseのUnity

Bitriseは、当社のbuild machines上でUnityソフトウェアを使用するための完全なサポートを提供します。便利なライセンス管理、最大40GBのディスク容量、そしてiOS版とAndroid版の両方のUnityプロジェクトを簡単に作成できるモバイル向けビルド環境が含まれます。

BitriseでUnityアプリをビルドできるようにするには、次の作業が必要です。

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ソフトウェアを実行する際の標準的な方法であり、数分で完了します。

Xcodeスタック

Unityビルドの実行には、必ずXcodeスタックを使用してください。このページの手順は、当社のXcodeスタックにUnityをインストールする場合に有効です。

  1. ダウンロードしたいUnityソフトウェアのバージョンを、Unityダウンロードアーカイブで確認します。

  2. 必要なバージョンのUnity Editorを見つけて、ダウンロードリンクをコピーします。

    リンクは次のような形式になります: https://download.unity3d.com/download_unity/b16b3b16c7a0/MacEditorInstallerArm64/Unity.pkg.

  3. 2つのプラットフォームサポートパッケージ(iOSとAndroid)のダウンロードリンクも必要です。これらはLTS Releasesページで確認できます。

  4. Workflowの先頭に Script Stepを追加します。

  5. Content入力に、必要なUnityパッケージをダウンロードするcurlコマンドを追加します。例:

    #workaround for .NET issue https://github.com/dotnet/runtime/issues/64103
    export COMPlus_ReadyToRun=0
    envman add --key COMPlus_ReadyToRun --value 0

    #download unity pkg for Apple Silicon
    curl -o ./unity.pkg http://download.unity3d.com/download_unity/8af3c3e441b1/MacEditorInstallerArm64/Unity-2021.3.12f1.pkg

    #download android support platform
    curl -o ./android.pkg http://download.unity3d.com/download_unity/8af3c3e441b1/MacEditorTargetInstaller/UnitySetup-Android-Support-for-Editor-2021.3.12f1.pkg

    #download iOS support platform
    curl -o ./ios.pkg http://download.unity3d.com/download_unity/8af3c3e441b1/MacEditorTargetInstaller/UnitySetup-iOS-Support-for-Editor-2021.3.12f1.pkg

    ダウンロードリンクを、必要なバージョンのリンクに置き換えてください。

  6. 必要に応じて、Rosettaに対応したAppleシリコン向けのUnityソフトウェアバージョンをインストールすることもできます。

    #download unity pkg for Apple Silicon with Rosetta support
    curl -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​

  1. BitriseにLog inし、左側のナビゲーションバーにカーソルを合わせます。

  2. Workspaceメニューで、正しいworkspaceが選択されていることを確認します。

  3. Settingsを選択します。

  4. 左側で Integrations を選択します。

  5. License pool カードをクリックします。

  6. Add license pool をクリックします。

    license_pools.png

  7. 各項目を入力します。

    次の項目を設定する必要があります:

    • 名前: Workflow Editorでプールを見つけるために使用します。
    • 環境変数キー: ビルドスクリプトでライセンスを使用する方法です。
    • license keysそのもの。ライセンスキーには、スペースやアンダースコア以外の特殊文字を含めることはできません。
  8. Save をクリックします。

  9. 必要なアプリのWorkflow Editorを開き、Licenses タブに移動します。

  10. ライセンスプールが必要なWorkflowごとに選択します。

    license-wfe.png

UnityライセンスをアクティベートするClick to copy link​

ビルドを実行する際は、まずUnityライセンスをアクティベートする必要があります。これにはUnityのメールアドレスとパスワードの入力が必要です。これらの保存にはSecretsの使用をおすすめします。

ライセンスを非アクティブ化する

ビルドが完了したら、再利用できるようにUnityライセンスを非アクティブ化することを強くおすすめします:

/Applications/Unity/Unity.app/Contents/MacOS/Unity -quit -batchmode -logFile -returnlicense
  1. メールアドレスとパスワードを保存するために、2つのSecretsを作成します。次のキーを使用することをおすすめします:

    • UNITY_EMAIL: 値としてメールアドレスを設定します。
    • UNITY_PW: 値としてUnityパスワードを設定します。
  2. Workflow内の、UnityソフトウェアをインストールするStepの後に配置した Script Stepに、次のコードを追加します:

    /Applications/Unity/Unity.app/Contents/MacOS/Unity -quit -batchmode -serial "$UNITY_SERIAL" -username "$UNITY_EMAIL" -password "$UNITY_PW" -logfile
    Utility Workflowを使用する

    ベストプラクティスとして、このStepを含むutility Workflowを作成し、Unityが必要な各Workflowの前に実行するようにします。

Unityソフトウェアを使用してビルドを実行するClick to copy link​

設定が完了すると、BitriseでUnityソフトウェアを使用してビルドを実行できます。同じWorkflow内であっても、アプリのAndroid版とiOS版の両方をビルドできます。

BitriseでUnityソフトウェアを使用してビルドを実行するには:

  1. BitriseにUnityライセンスプールを追加する。

  2. ビルド内でUnityライセンスをアクティベートする。

  3. 仮想マシンにUnityをダウンロードしてインストールする。

  4. アプリの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
  5. アプリの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
  6. XcodeプロジェクトからIPAを作成してエクスポートする。

  7. 完了したら、ライセンスを非アクティブ化します:

    /Applications/Unity/Unity.app/Contents/MacOS/Unity -quit -batchmode -logFile -returnlicense