feat: introduce v3 (#407)

* chore: upgrade docusaurus / fix deprecations

* chore: upgrade docusaurus / fix deprecations

* feat: introduce v3

* chore: upgrade node in ci

* Reconcile v2 and v3 docs with latest unity builder changes. Remove parameters not available in v2 from v2 docs.

* Remove parameters and outputs from v2.2.0-pre

* Update version tags to align with new version

* chore: upgrade docusaurus tsconfig

* chore: import/order

* fix: unresolved import

* chore: versions as client-side block

* fix: firebase resolution

---------

Co-authored-by: Andrew Kahr <[email protected]>
Co-authored-by: Gabriel Le Breton <[email protected]>

Author: 3 people

.github/workflows/checks.yml

@@ -12,7 +12,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-node@v3
         with:
-          node-version: '16'
+          node-version: 18
       - uses: c-hive/gha-yarn-cache@v2
       - run: yarn
       - run: yarn verify:formatting
@@ -23,7 +23,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-node@v3
         with:
-          node-version: '16'
+          node-version: 18
       - uses: c-hive/gha-yarn-cache@v2
       - run: yarn
       - run: yarn verify:code-styles
@@ -34,7 +34,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-node@v3
         with:
-          node-version: '16'
+          node-version: 18
       - uses: c-hive/gha-yarn-cache@v2
       - run: yarn
       - run: yarn typecheck
@@ -45,7 +45,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-node@v3
         with:
-          node-version: '16'
+          node-version: 18
       - uses: c-hive/gha-yarn-cache@v2
       - run: yarn
       - run: yarn test --coverage

.github/workflows/search-trigger.yml

@@ -6,7 +6,7 @@ jobs:
     name: Update search index
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
       - uses: darrenjennings/algolia-docsearch-action@da2ed379c147b356d60dbfec68bdcfacb2791a98
         with:
           algolia_application_id: 'E57FOT37U9'

.idea/prettier.xml

@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="PrettierConfiguration">
+    <option name="myConfigurationMode" value="AUTOMATIC" />
     <option name="myRunOnSave" value="true" />
     <option name="myRunOnReformat" value="true" />
   </component>

docs/03-github/01-getting-started.mdx

@@ -98,7 +98,7 @@ jobs:
 
       # Build
       - name: Build project
-        uses: game-ci/unity-builder@v2
+        uses: game-ci/unity-builder@v3
         env:
           UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
           UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
@@ -168,7 +168,7 @@ jobs:
 
       # Build
       - name: Build project
-        uses: game-ci/unity-builder@v2
+        uses: game-ci/unity-builder@v3
         env:
           UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
           UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
@@ -248,7 +248,7 @@ jobs:
           path: ${{ steps.testRunner.outputs.artifactsPath }}
       - if: matrix.targetPlatform == 'Android'
         uses: jlumbroso/[email protected]
-      - uses: game-ci/unity-builder@v2
+      - uses: game-ci/unity-builder@v3
         env:
           UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
           UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
@@ -295,7 +295,7 @@ jobs:
             Library-${{ matrix.projectPath }}-${{ matrix.targetPlatform }}-
             Library-${{ matrix.projectPath }}-
             Library-
-      - uses: game-ci/unity-builder@v2
+      - uses: game-ci/unity-builder@v3
         env:
           UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
           UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
@@ -341,7 +341,7 @@ jobs:
             Library-${{ matrix.projectPath }}-
             Library-
 
-      - uses: game-ci/unity-builder@v2
+      - uses: game-ci/unity-builder@v3
         env:
           UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
           UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}

docs/03-github/02-activation.mdx

@@ -105,7 +105,7 @@ floating license will be acquired before the build, and returned after.
 Example of use:
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   with:
     targetPlatform: WebGL
     unityLicensingServer: [url to your license server]

docs/03-github/04-builder.mdx

@@ -40,7 +40,7 @@ secret.
 Then, define the build step as follows:
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   env:
     UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
     UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
@@ -60,7 +60,7 @@ Make sure you have set up these variables in the activation step:
 Then, define the build step as follows:
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   env:
     UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
     UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
@@ -77,7 +77,7 @@ If you host your own Unity license server internally you can provide its url usi
 Example of use:
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   with:
     targetPlatform: WebGL
     unityLicensingServer: [url to your license server]
@@ -152,7 +152,7 @@ _**required:** `false`_ _**default:** `auto`_
 Specific docker image that should be used for building the project.
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   with:
     customImage: 'unityci/editor:2020.1.14f1-base-0'
 ```
@@ -192,7 +192,7 @@ There are two conditions for a custom buildMethod:
 Example:
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   with:
     buildMethod: EditorNamespace.BuilderClassName.StaticBuildMethod
 ```
@@ -202,7 +202,7 @@ To get started with a modified version of the default Unity Builder build script
 `Assets/Editor/UnityBuilderAction` directory and reference it:
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   with:
     buildMethod: UnityBuilderAction.BuildScript.Build
 ```
@@ -220,7 +220,7 @@ Parameters must start with a hyphen (`-`) and may be followed by a value (withou
 Parameters without a value will be considered booleans (with a value of true).
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   with:
     customParameters: -profile SomeProfile -someBoolean -someValue exampleValue
 ```
@@ -238,7 +238,7 @@ _**required:** `false`_ _**default:** `""`_
 Configure a specific versioning strategy
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   with:
     versioning: Semantic
 ```
@@ -298,7 +298,7 @@ Set this flag to `androidPackage` to build an apk, `androidAppBundle` for an aab
 `androidStudioProject` to build an Android Studio Project.
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   with:
     androidExportType: 'androidAppBundle'
     androidKeystoreName: user.keystore
@@ -308,33 +308,12 @@ Set this flag to `androidPackage` to build an apk, `androidAppBundle` for an aab
     androidKeyaliasPass: ${{ secrets.ANDROID_KEYALIAS_PASS }}
 ```
 
-You should also set all the Android Keystore options (see below). Refer to (this
-section)[/docs/github/deployment/android#3-generate-an-upload-key-and-keystore] for keystore setup.
+You should also set all the Android Keystore options (see below). Refer to
+[this section](/docs/github/deployment/android#3-generate-an-upload-key-and-keystore) for keystore
+setup.
 
 _**required:** `false`_ _**default:** `androidPackage`_
 
-#### androidAppBundle
-
-**[Deprecated] Please use androidExportType instead.**
-
-Set this flag to `true` to build '.aab' instead of '.apk'.
-
-```yaml
-- uses: game-ci/unity-builder@v2
-  with:
-    androidAppBundle: true
-    androidKeystoreName: user.keystore
-    androidKeystoreBase64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}
-    androidKeystorePass: ${{ secrets.ANDROID_KEYSTORE_PASS }}
-    androidKeyaliasName: ${{ secrets.ANDROID_KEYALIAS_NAME }}
-    androidKeyaliasPass: ${{ secrets.ANDROID_KEYALIAS_PASS }}
-```
-
-You should also set all the Android Keystore options (see below). Refer to (this
-section)[/docs/github/deployment/android#3-generate-an-upload-key-and-keystore] for keystore setup.
-
-_**required:** `false`_ _**default:** `false`_
-
 #### androidKeystoreName
 
 Configure the android `keystoreName`. Must be provided if configuring the below keystore options.
@@ -417,7 +396,7 @@ _**required:** `false`_ _**default:** `""`_
 Allows the branch of the build to be dirty, and still generate the build.
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   with:
     allowDirtyBuild: true
 ```
@@ -447,6 +426,20 @@ ie `3.4.0`. An empty string represents the latest available version on homebrew.
 
 _**required:** `false`_ _**default:** `""`_
 
+#### dockerWorkspacePath
+
+Allows customizing the build path within the container in case there are hardcoded paths generated
+during the build. For example building an IOS XCode project on Linux and moving to a new path on
+MacOS occasionally leads to broken paths requiring this override to ensure the paths match.
+
+Paths should be of format `/path/to/build`, ie `/tmp/build`. On Windows, leave off the drive letter
+specification. For example `C:\build` becomes `/build`. There should be no trailing slash in the
+path and the path should be absolute. The path will automatically be created within the container if
+it does not exist. It is recommended to use a path that doesn't already exist within the container
+to avoid any conflicts.
+
+_**required:** `false`_ _**default:** `"/github/workspace"`_
+
 ## Outputs
 
 Below are outputs that can be accessed by using `${{ steps.myBuildStep.outputs.outputName }}`, where
@@ -458,7 +451,7 @@ Returns the version that was generated by Builder, following the strategy config
 `versioning`.
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   id: myBuildStep
 - run: echo 'Project Version: ${{ steps.myBuildStep.outputs.buildVersion }}'
 ```
@@ -468,7 +461,7 @@ Returns the version that was generated by Builder, following the strategy config
 Returns the version code that was generated by Builder for Android builds.
 
 ```yaml
-- uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v3
   id: myBuildStep
 - run: echo 'Android Version Code: ${{ steps.myBuildStep.outputs.androidVersionCode }}'
 ```
@@ -507,7 +500,7 @@ steps:
   - uses: webfactory/[email protected]
     with:
       ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}
-  - uses: game-ci/unity-builder@v2
+  - uses: game-ci/unity-builder@v3
     with:
       sshAgent: ${{ env.SSH_AUTH_SOCK }}
 ```
@@ -565,7 +558,7 @@ jobs:
           restore-keys: Library-
       - if: matrix.targetPlatform == 'Android'
         uses: jlumbroso/[email protected]
-      - uses: game-ci/unity-builder@v2
+      - uses: game-ci/unity-builder@v3
         env:
           UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
         with:

docs/03-github/06-deployment/android.mdx

@@ -172,7 +172,7 @@ jobs:
         with:
           path: Library
           key: Library-Android
-      - uses: game-ci/unity-builder@v2
+      - uses: game-ci/unity-builder@v3
         with:
           targetPlatform: Android
           androidAppBundle: true

docs/03-github/06-deployment/ios.mdx

@@ -436,7 +436,7 @@ jobs:
           path: Library
           key: Library-iOS
 
-      - uses: game-ci/unity-builder@v2
+      - uses: game-ci/unity-builder@v3
         with:
           targetPlatform: iOS
 

docs/03-github/06-deployment/steam.mdx

@@ -40,7 +40,7 @@ jobs:
           restore-keys: |
             Library-${{ matrix.targetPlatform }}-
             Library-
-      - uses: game-ci/unity-builder@v2
+      - uses: game-ci/unity-builder@v3
         id: build
         env:
           UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}

docs/09-troubleshooting/common-issues.mdx

@@ -92,11 +92,11 @@ here][unity-docker-versions].
 
 In this particular case, it is also important to look for the last part of the docker image which is
 the version for GameCI. `-0` means it is the latest `v0.x.x` version of the docker images. `v0.x.x`
-version is out of date as we moved to Version 1 as shown on
+and `v1.x.x` are out of date as we moved to Version 2 as shown on
 [github.com/game-ci/docker/releases](https://github.com/game-ci/docker/releases). We are not
-publishing images for `v0.x.x` anymore.
+publishing images for `v0.x.x` or `v1.x.x` anymore.
 
-The correct image should be `unityci/editor:2021.3.0f1-android-1`.
+The correct image should be `unityci/editor:2021.3.0f1-android-2`.
 
 You can also test this locally:
 
@@ -106,24 +106,24 @@ docker pull unityci/editor:2021.3.0f1-android-0
 # Error response from daemon: manifest for unityci/editor:2021.3.0f1-android-0 not found: manifest unknown: manifest unknown
 
 # right
-docker pull unityci/editor:2021.3.0f1-android-1
-# 2021.3.0f1-android-1: Pulling from unityci/editor
+docker pull unityci/editor:2021.3.0f1-android-2
+# 2021.3.0f1-android-2: Pulling from unityci/editor
 # [...]
 ```
 
 #### Github Actions
 
-You need to make sure you are using Github Actions v2, check for the version of your actions in your
+You need to make sure you are using Github Actions v3, check for the version of your actions in your
 `.github/workflows/*.yml` files.
 
 ```diff
-- uses: game-ci/unity-builder@v1
-+ uses: game-ci/unity-builder@v2
+- uses: game-ci/unity-builder@v2
++ uses: game-ci/unity-builder@v3
 ```
 
 #### Gitlab CI
 
-Set the `IMAGE_VERSION` to 1 in
+Set the `IMAGE_VERSION` to 2 in
 [`.gitlab-ci.yml`](https://gitlab.com/game-ci/unity3d-gitlab-ci-example/-/blob/main/.gitlab-ci.yml#L12)
 
 ### Scripts have compiler errors.