Build Reports
Every run writes a JSON report to the config workspace:
{workspace}/{buildConfigName}_Build{buildNumber}.json
The file is a serialized BuildAssistantReport. Field names below match the JSON keys.
| Name | Type | Notes |
|---|---|---|
| config | string | Unity asset name of the config (config.name). This is not buildConfigName. |
| buildNumber | string | Config build number, or -buildNumberOverride from the command line. |
| defines | string[] | Scripting defines from the platform on the config. |
| result | BuildAssistantResult | Overall Unity compile result only: Success or Failed. Written as a string. |
| artifacts | Dictionary<string, string> | Paths registered during the run, such as a zip from BA_ZipFiles. |
| Duration | TimeSpan | EndedAt - StartedAt. |
| StartedAt | DateTime | When the run started. |
| EndedAt | DateTime | When the run finished. |
| buildTarget | BuildTarget | Platform target. Written as a string. |
| buildTargetGroup | BuildTargetGroup | Platform target group. Written as a string. |
| mainBuildError | string | Present in the report. Not written by the current plugin, so it stays empty. |
| warnings | List<string> | Warnings from the Unity BuildPipeline.BuildPlayer report. Action warnings are not included. |
| errors | List<string> | Errors from the Unity BuildPipeline.BuildPlayer report. Action failures are not included. |
| preBuildResults | List<BuildActionResult> | One entry per enabled pre-build action. |
| postBuildResults | List<BuildActionResult> | One entry per enabled post-build action. Success and fail lists are the ones that actually ran. |
BuildAssistantResult values are Success, Warning, Failed, and Skipped. The overall result field only uses Success or Failed.
Action results
Each item in preBuildResults and postBuildResults is a BuildActionResult:
| Name | Type | Notes |
|---|---|---|
| description | string | Action title from GetMetadata(). |
| result | BuildAssistantResult | Success, Warning, Failed, or Skipped. Written as a string. |
| message | string | Optional text from SuccessWithMessage / FailedWithMessage. Empty for the plain results. |
An action that is not allowed to run (When to run / required batch flag) is stored as Skipped.