unity-cli@v1.2.1 (#21)

- Hotfix to install libssl 1.1.1 for 2021.x editors
- Added a new `uninstall-unity` command to uninstall unity editors by path or by version.
- Added a new `open-project` command to launch a Unity project directly from the CLI, automatically resolving the Unity version and editor path.
- Refactored command options for `run`, `list-project-templates`, and `create-project` to support both Unity version and editor path resolution, with clearer error handling if neither is specified
- Refactored command options for `run`, `list-project-templates`, and `create-project` to support both Unity version and editor path resolution, with clearer error handling if neither is specified

Author: StephenHodgson

.github/workflows/build-options.json

@@ -5,7 +5,9 @@
     "macos-latest"
   ],
   "unity-version": [
-    "2022.3.x",
+    "4.7.2",
+    "2021.x",
+    "2022.x",
     "6000.0.x",
     "6000.1.x",
     "6000.2.x"
@@ -23,5 +25,15 @@
       "os": "macos-latest",
       "build-target": "StandaloneOSX"
     }
+  ],
+  "exclude": [
+    {
+      "os": "ubuntu-latest",
+      "unity-version": "4.7.2"
+    },
+    {
+      "os": "macos-latest",
+      "unity-version": "4.7.2"
+    }
   ]
 }

.github/workflows/unity-build.yml

@@ -22,6 +22,8 @@ jobs:
     permissions:
       contents: read
     timeout-minutes: 30
+    env:
+      UNITY_PROJECT_PATH: '' # Set from create-project step
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
@@ -38,7 +40,6 @@ jobs:
         shell: bash
         run: |
           unity-cli hub-install --auto-update
-          unity-cli activate-license --license personal --email "${{ secrets.UNITY_USERNAME }}" --password "${{ secrets.UNITY_PASSWORD }}"
           unity-cli setup-unity --unity-version "${{ matrix.unity-version }}" --build-targets "${{ matrix.build-target }}" --json
       - name: verify UNITY_HUB_PATH and UNITY_EDITOR_PATH variables
         shell: bash
@@ -56,6 +57,10 @@ jobs:
             echo "Error: UNITY_EDITOR_PATH is not set"
             exit 1
           fi
+      - name: activate license
+        shell: bash
+        run: |
+          unity-cli activate-license --license personal --email "${{ secrets.UNITY_USERNAME }}" --password "${{ secrets.UNITY_PASSWORD }}"
       - name: create unity project
         shell: bash
         run: |
@@ -70,16 +75,26 @@ jobs:
           fi
       - name: Install OpenUPM and build pipeline package
         shell: bash
+        if: ${{ matrix.unity-version != '4.7.2' && matrix.unity-version != '5.6.7' }}
         run: |
           npm install -g openupm-cli
           cd "${UNITY_PROJECT_PATH}"
           openupm add com.utilities.buildpipeline
       - name: Build project
+        if: ${{ matrix.unity-version != '4.7.2' && matrix.unity-version != '5.6.7' }}
         shell: bash
         run: |
-          unity-cli run --unity-editor "${UNITY_EDITOR_PATH}" --unity-project "${UNITY_PROJECT_PATH}" --log-name Validate -quit -nographics -batchmode -executeMethod Utilities.Editor.BuildPipeline.UnityPlayerBuildTools.ValidateProject -importTMProEssentialsAsset
-          unity-cli run --unity-editor "${UNITY_EDITOR_PATH}" --unity-project "${UNITY_PROJECT_PATH}" --log-name Build -quit -nographics -batchmode -executeMethod Utilities.Editor.BuildPipeline.UnityPlayerBuildTools.StartCommandLineBuild -sceneList Assets/Scenes/SampleScene.unity
-      - name: Post Run
+          unity-cli run --log-name Validate -quit -nographics -batchmode -executeMethod Utilities.Editor.BuildPipeline.UnityPlayerBuildTools.ValidateProject -importTMProEssentialsAsset
+          unity-cli run --log-name Build -quit -nographics -batchmode -executeMethod Utilities.Editor.BuildPipeline.UnityPlayerBuildTools.StartCommandLineBuild -sceneList Assets/Scenes/SampleScene.unity
+      - name: Uninstall editor
+        shell: bash
+        run: |
+          if [ -z "${UNITY_EDITOR_PATH}" ]; then
+            echo "UNITY_EDITOR_PATH is not set, skipping uninstall"
+            exit 0
+          fi
+          unity-cli uninstall-unity --unity-editor "${UNITY_EDITOR_PATH}"
+      - name: Return license
         if: always()
         shell: bash
         run: |

README.md

@@ -28,16 +28,29 @@ unity-cli [command] [options]
 
 ### Common Commands
 
-- `unity-cli hub-install`: Install Unity Hub
-- `unity-cli hub-version`: Print Unity Hub version
-- `unity-cli hub-path`: Print Unity Hub executable path
-- `unity-cli hub [options] <args...>`: Run [Unity Hub command line arguments](https://docs.unity3d.com/hub/manual/HubCLI.html)
+#### Auth
+
+- `unity-cli license-version`: Print the Unity License Client version
 - `unity-cli activate-license [options]`: Activate a Unity license
 - `unity-cli return-license [options]`: Return a Unity license
-- `unity-cli license-version`: Print Unity License Client version
-- `unity-cli setup-unity [options]`: Find or install Unity Editor for a project/version
-- `unity-cli create-project [options]`: Create a new Unity project from a [template](https://docs.unity3d.com/hub/manual/Templates.html)
-- `unity-cli run [options] <args...>`: Run [Unity Editor Command Line Arguments](https://docs.unity3d.com/Manual/EditorCommandLineArguments.html)
+
+#### Unity Hub
+
+- `unity-cli hub-version`: Print the Unity Hub version
+- `unity-cli hub-install [options]`: Install or update the Unity Hub
+- `unity-cli hub-path`: Print the Unity Hub executable path
+- `unity-cli hub [options] <args...>`: Run Unity Hub command line arguments (passes args directly to the hub executable)
+
+#### Unity Editor
+
+- `unity-cli setup-unity [options]`: Find or install the Unity Editor for a project or specific version
+- `unity-cli uninstall-unity [options]`: Uninstall a Unity Editor version
+- `unity-cli list-project-templates [options]`: List available Unity project templates for an editor
+- `unity-cli create-project [options]`: Create a new Unity project from a template
+- `unity-cli open-project [options]`: Open a Unity project in the Unity Editor
+- `unity-cli run [options] <args...>`: Run Unity Editor command line arguments (passes args directly to the editor)
+
+Run `unity-cli --help` for a full list of commands and options.
 
 #### Install Unity Hub and Editor
 
@@ -60,8 +73,16 @@ unity-cli activate-license --email <your-email> --password <your-password> --ser
 unity-cli create-project --name "MyGame" --template com.unity.template.3d(-cross-platform)? --unity-editor <path-to-editor>
 ```
 
+#### Open a project from the command line
+
+> [!NOTE] If you run this command in the same directory as your Unity project, you can omit the `--unity-project`, `--unity-version`, and `--unity-editor` options.
+
+```bash
+unity-cli open-project
+```
+
 #### Build a Project
 
 ```bash
-unity-cli run --unity-editor <path-to-editor> --unity-project <path-to-project> -quit -batchmode -executeMethod StartCommandLineBuild
+unity-cli run --unity-project <path-to-project> -quit -batchmode -executeMethod StartCommandLineBuild
 ```

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@rage-against-the-pixel/unity-cli",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "A command line utility for the Unity Game Engine.",
   "author": "RageAgainstThePixel",
   "license": "MIT",