Skip to content

Commit

Permalink
Merge pull request #36 from VeyronSakai/update-readme
Browse files Browse the repository at this point in the history
Update DRAFT_README.md
  • Loading branch information
VeyronSakai authored Apr 27, 2024
2 parents c8c83d3 + d96e92f commit 179e3fe
Show file tree
Hide file tree
Showing 2 changed files with 81 additions and 2 deletions.
80 changes: 80 additions & 0 deletions .github/DRAFT_README.md
Original file line number Diff line number Diff line change
@@ -1 +1,81 @@
# GhaUnityBuildReporter

GhaUnityBuildReporter is a Unity package that automatically reflects [build report](https://docs.unity3d.com/ScriptReference/Build.Reporting.BuildReport.html) in GitHub Job Summary when building with Unity on GitHub Actions.

<img width="400" alt="top" src="https://github.com/VeyronSakai/GhaUnityBuildReporter/assets/43900255/ce50ca9a-928d-458a-8350-ff0630bdea0a">

This package is inspired by [Unity-Technologies/BuildReportInspector](https://github.com/Unity-Technologies/BuildReportInspector).

## Features

GhaUnityBuildReporter specifically reflects the following information in the Job Summary.

- Basic Info
- Build Steps
- Output Files
- Included Modules

> [!NOTE]
> Items with no information to display are hidden. For example, if the Scripting Backend is Mono instead of IL2CPP, Included Modules will be hidden.
### Basic Info

The basic information about the build.

| Item | Description |
| --- | --- |
| Platform | The platform that the build was created for. |
| Total Time | The total time taken by the build process. |
| Total Size | The total size of the build output. |
| Build Result | The outcome of the build. |
| Total Errors | The total number of errors and exceptions recorded during the build process. |
| Total Warnings | The total number of warnings recorded during the build process. |

<img width="200" alt="basic-info" src="https://github.com/VeyronSakai/GhaUnityBuildReporter/assets/43900255/c2822a2b-77dd-4ba1-9512-065613e67907">

### Build Steps

All build steps and the duration of each step and the messages output within the step.

<img width="400" alt="build-steps" src="https://github.com/VeyronSakai/GhaUnityBuildReporter/assets/43900255/1feddaa6-a9c0-4f0d-9a1f-46558d5ec944">

Each emoji corresponds to the following [LogType](https://docs.unity3d.com/ScriptReference/LogType.html).

| Emoji | LogType |
| --- | --- |
| :x: | Error |
| :no_entry_sign: | Assert |
| :warning: | Warning |
| :information_source: | Log |
| :boom: | Exception |
| :question: | Unknown |

### Output Files

List of file paths output during the build and their sizes.

<img width="600" alt="output-files" src="https://github.com/VeyronSakai/GhaUnityBuildReporter/assets/43900255/20bd078a-8608-4efd-a665-19635ffe7b10">

### Included Modules

Information about the native engine modules included in the build and why they were included.

<img width="300" alt="include-modules" src="https://github.com/VeyronSakai/GhaUnityBuildReporter/assets/43900255/af5fffda-d336-4653-a449-c8035383c179">

## Setup

Basically, the setup is completed by simply adding GhaUnityBuildReporter to the Unity project by following the steps below;

1. Open the Package Manager in the UnityEditor.
2. Select the + button in the upper left corner.
3. Select Add package from git URL.
4. Enter https://github.com/VeyronSakai/GhaUnityBuildReporter.git?path=Assets/GhaUnityBuildReporter and Select Add button.

The Workflow file of GitHub Actions basically does not need to be changed.

> [!WARNING]
> If you are using Docker to build Unity, you need to copy the files at $GITHUB_STEP_SUMMARY in the docker container to the same path on the host machine after building with Unity.
## License

This software is released under the MIT License. Please see the LICENSE file for details.
3 changes: 1 addition & 2 deletions Assets/GhaUnityBuildReporter/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,7 @@
"name": "com.veyron-sakai.gha-unity-build-reporter",
"displayName": "GhaUnityBuildReporter",
"version": "0.1.2",
"unity": "2022.3",
"description": "Automatically posts the build report to GitHub's Job Summaries upon completion of a Unity Build using GitHub Actions.",
"description": "Automatically reflects build report in GitHub Job Summary when building with Unity on GitHub Actions.",
"author": {
"name": "Yuki Sakai"
}
Expand Down

0 comments on commit 179e3fe

Please sign in to comment.