From c0ffa39ec2e33074013680bbc0d4ccf4c4a2612c Mon Sep 17 00:00:00 2001 From: John Soros <97020587+js-9@users.noreply.github.com> Date: Tue, 21 Oct 2025 12:51:59 +0200 Subject: [PATCH 1/4] document incremental build cache in builder docs --- docs/03-github/04-builder.mdx | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/03-github/04-builder.mdx b/docs/03-github/04-builder.mdx index 85efb118..582ecb2c 100644 --- a/docs/03-github/04-builder.mdx +++ b/docs/03-github/04-builder.mdx @@ -109,6 +109,7 @@ Builds can now be downloaded as Artifacts in the Actions tab. ## Caching +### Library cache In order to make builds run faster, you can cache Library files from previous builds. To do so simply add Github Actions official [cache action](https://github.com/marketplace/actions/cache) before any unity steps. @@ -127,6 +128,23 @@ Example: This simple addition could speed up your build by more than 50%. +### Incremental build cache +To further speedup consequent builds, you may want to cache the incremental build cache directory. + +Example: + +```yaml +- uses: actions/cache@v3 + with: + path: $HOME/work/_temp/_github_home/.cache/unity3d/bee + key: IncrementalBuildCache-MyProjectName-TargetPlatform + restore-keys: | + IncrementalBuildCache-MyProjectName- + IncrementalBuildCache- +``` + +On a windows runner (e.g. if building for il2cpp) this path is different, but the incremental build cache is automatically saved with the Library folder. + ## Configuration options Below options can be specified under `with:` for the `unity-builder` action. From 8b2a548e54b95985c9e0cbe8d35502372d1ab625 Mon Sep 17 00:00:00 2001 From: John Soros <97020587+js-9@users.noreply.github.com> Date: Tue, 21 Oct 2025 12:57:47 +0200 Subject: [PATCH 2/4] AI caught mistake --- docs/03-github/04-builder.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/03-github/04-builder.mdx b/docs/03-github/04-builder.mdx index 582ecb2c..4775d25f 100644 --- a/docs/03-github/04-builder.mdx +++ b/docs/03-github/04-builder.mdx @@ -136,7 +136,7 @@ Example: ```yaml - uses: actions/cache@v3 with: - path: $HOME/work/_temp/_github_home/.cache/unity3d/bee + path: ~/work/_temp/_github_home/.cache/unity3d/bee key: IncrementalBuildCache-MyProjectName-TargetPlatform restore-keys: | IncrementalBuildCache-MyProjectName- From 3a0e9f56f3c4eecd9eafb7eda28a3874a27fd1b5 Mon Sep 17 00:00:00 2001 From: John Soros Date: Sat, 6 Dec 2025 01:50:32 -0600 Subject: [PATCH 3/4] reformat with prettier --- docs/03-github/03-test-runner.mdx | 19 +++++++++++++++++++ docs/03-github/04-builder.mdx | 7 +++++-- 2 files changed, 24 insertions(+), 2 deletions(-) diff --git a/docs/03-github/03-test-runner.mdx b/docs/03-github/03-test-runner.mdx index 021776aa..d1a9b2d4 100644 --- a/docs/03-github/03-test-runner.mdx +++ b/docs/03-github/03-test-runner.mdx @@ -300,6 +300,25 @@ This simple addition could speed up your test runs by more than 50%. Note that caching in this manner only applies to testing Unity **Projects**, not Unity **Packages** (see [Caveats](#caveats)). +### Incremental build cache + +To further speed up consequent builds, you may want to cache the incremental build cache directory. + +Example: + +```yaml +- uses: actions/cache@v3 + with: + path: ~/work/_temp/_github_home/.cache/unity3d/bee + key: IncrementalBuildCache-MyProjectName-TargetPlatform + restore-keys: | + IncrementalBuildCache-MyProjectName- + IncrementalBuildCache- +``` + +On a Windows runner (e.g. if building for il2cpp) this path is different, but the incremental build +cache is automatically saved with the Library folder. + ## Configuration options Below options can be specified under `with:` for the `unity-test-runner` action. diff --git a/docs/03-github/04-builder.mdx b/docs/03-github/04-builder.mdx index 4775d25f..1de1e59c 100644 --- a/docs/03-github/04-builder.mdx +++ b/docs/03-github/04-builder.mdx @@ -110,6 +110,7 @@ Builds can now be downloaded as Artifacts in the Actions tab. ## Caching ### Library cache + In order to make builds run faster, you can cache Library files from previous builds. To do so simply add Github Actions official [cache action](https://github.com/marketplace/actions/cache) before any unity steps. @@ -129,7 +130,8 @@ Example: This simple addition could speed up your build by more than 50%. ### Incremental build cache -To further speedup consequent builds, you may want to cache the incremental build cache directory. + +To further speed up consequent builds, you may want to cache the incremental build cache directory. Example: @@ -143,7 +145,8 @@ Example: IncrementalBuildCache- ``` -On a windows runner (e.g. if building for il2cpp) this path is different, but the incremental build cache is automatically saved with the Library folder. +On a Windows runner (e.g. if building for il2cpp) this path is different, but the incremental build +cache is automatically saved with the Library folder. ## Configuration options From 9accdde5e0f5f40af7ec53173e2e0422228cfa11 Mon Sep 17 00:00:00 2001 From: John Soros Date: Sat, 6 Dec 2025 01:56:41 -0600 Subject: [PATCH 4/4] capitalize IL2CPP --- docs/03-github/03-test-runner.mdx | 2 +- docs/03-github/04-builder.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/03-github/03-test-runner.mdx b/docs/03-github/03-test-runner.mdx index d1a9b2d4..5a381ade 100644 --- a/docs/03-github/03-test-runner.mdx +++ b/docs/03-github/03-test-runner.mdx @@ -316,7 +316,7 @@ Example: IncrementalBuildCache- ``` -On a Windows runner (e.g. if building for il2cpp) this path is different, but the incremental build +On a Windows runner (e.g. if building for IL2CPP) this path is different, but the incremental build cache is automatically saved with the Library folder. ## Configuration options diff --git a/docs/03-github/04-builder.mdx b/docs/03-github/04-builder.mdx index 1de1e59c..f37664e2 100644 --- a/docs/03-github/04-builder.mdx +++ b/docs/03-github/04-builder.mdx @@ -145,7 +145,7 @@ Example: IncrementalBuildCache- ``` -On a Windows runner (e.g. if building for il2cpp) this path is different, but the incremental build +On a Windows runner (e.g. if building for IL2CPP) this path is different, but the incremental build cache is automatically saved with the Library folder. ## Configuration options