Build Automation 障害のトラブルシューティング

Solve common issues with Build Automation failures.

読み終わるまでの所要時間 6 分

最終更新 1年前

ログにエラーがないか確認します。

Unity Build Automation (UBA) 障害をトラブルシューティングする最初のステップは、エラーログを確認することです。

UBA ログでは、可視性を高めるためにエラーメッセージが赤色でハイライトされ、警告が黄色でハイライトされます。また、UBA では警告とエラーメッセージをコンパクトログタブに収集して検索しやすくなっていますが、すべての障害がコンパクトログに記録されるわけではなく、ログ全体を確認するのに役立てます。複数のエラーログがあり、以前のビルドが成功した場合は、ログを比較して、成功した実行に存在する可能性のあるエラーをフィルターで除外できます。

クリーンビルドの実行

ライブラリまたはワークスペースフォルダーのいずれかをキャッシュする UBA ビルドは、問題が発生する可能性があります。ターゲットにキャッシュを強制的に無視させるには、ビルドのトリガー時に クリーンビルド オプションを使用します。

バッチモードのローカルでの実行

エディターでのプロジェクトのビルドは成功したものの、Unity Build Automation でのビルドに失敗する場合は、バッチモードを使用してビルドを生成したことが原因である可能性があります。エラーが再現するかどうかを調べるには、ローカルでバッチモードで実行してみます。

まず、

Library

フォルダーを削除するか、ソースコードを新しいフォルダーにチェックアウトする必要があります。これで、UBA がパッケージを再ダウンロードします。これで、すべてのビルドでソースコードをチェックアウトする UBA ビルドサーバーの動作をシミュレートします。

これが同じコマンドの Windows と macOS バージョンです。

注

ノート: これらのフラグのうちいくつかは必須ではありません。単体テストを実行しない場合は、

-testPlatform

、

-testResults

、

-runTests

などのフラグをスキップできます。

指定されたディレクトリは Unity エディターのデフォルトのインストールフォルダーです。ローカルマシンの正しいパスに従って調整します。

Windows CMD コンソール


"C:\Program Files\Unity\Hub\Editor\{UNITY_VERSION}\Editor\unity.exe" -batchMode -skipMissingProjectID -skipMissingUPID -buildTarget {BUILD_TARGET} -logFile C:\{SOME_PATH}\log.txt -projectPath C:\{PROJECT_PATH} -executeMethod {CLASS_AND_STATIC_METHOD_NAME_OF_BUILD_SCRIPT} -quit

macOS 端末


/Applications/Unity/Hub/Editor/{UNITY_VERSION}/Unity.app/Contents/MacOS/Unity -batchMode -skipMissingProjectID -skipMissingUPID -buildTarget {BUILD_TARGET} -logFile /Users/{SOME_PATH}/log.txt -projectPath /Users/{PROJECT_PATH} -executeMethod {CLASS_AND_STATIC_METHOD_NAME_OF_BUILD_SCRIPT} -quit

テストも実行する場合は、以下のタグを追加できます。

```
-runTests
```

-testPlatform {PLATFORM} // playmode or editmode

-testResults {FILE_PATH_AND_FILE_NAME}.xml

テンプレートビルドスクリプト

ビルドを実行する静的メソッドを含むビルドスクリプトをエディターフォルダー内に置きます。エディターフォルダーがない場合は、作成します。

以下に参照として、テンプレートビルドスクリプトを示します。


using UnityEditor;class MyEditorScript{  static void PerformBuild ()  {    BuildPlayerOptions buildPlayerOptions = new BuildPlayerOptions();    buildPlayerOptions.scenes = new[] {"Assets/Scenes/MyScene.unity", ...};    buildPlayerOptions.target = BuildTarget.iOS; // More details on BuildTarget doc    buildPlayerOptions.options = BuildOptions.None;    buildPlayerOptions.locationPathName = "iOSBuild";    BuildPipeline.BuildPlayer(buildPlayerOptions);  }}

よくある問題

全般:

プラットフォーム固有の問題:

ドキュメント

Development

User Acquisition

Monetization

産業

ドキュメント

Development

User Acquisition

Monetization

産業