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/2] 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/2] 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-