Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sttz/install-unity
Script to install Unity 3D versions from the command line on macOS
https://github.com/sttz/install-unity
automation install-script macos unity3d
Last synced: 3 months ago
JSON representation
Script to install Unity 3D versions from the command line on macOS
- Host: GitHub
- URL: https://github.com/sttz/install-unity
- Owner: sttz
- License: mit
- Created: 2015-12-18T14:15:18.000Z (almost 9 years ago)
- Default Branch: next
- Last Pushed: 2024-05-22T14:00:46.000Z (6 months ago)
- Last Synced: 2024-05-22T15:27:59.307Z (6 months ago)
- Topics: automation, install-script, macos, unity3d
- Language: C#
- Homepage:
- Size: 438 KB
- Stars: 129
- Watchers: 14
- Forks: 25
- Open Issues: 4
-
Metadata Files:
- Readme: Readme.md
- Changelog: Changelog.md
- License: LICENSE
Awesome Lists containing this project
README
# install-unity
A command-line utility to install any recent version of Unity.
Currently only supports macOS (Intel & Apple Silicon) but support for Windows/Linux is possible, PRs welcome.
## Table of Contents
* [Introduction](#introduction)
* [Versions](#versions)
* [Packages](#packages)
* [Offline Install](#offline-install)
* [Run](#run)
* [Create](#create)
* [CLI Help](#cli-help)
* [Changelog](#changelog)# Introduction
[Download the latest release here](https://github.com/sttz/install-unity/releases). install-unity is a self-contained executable and has no dependencies.
Or you can install via [Homebrew](https://brew.sh) using [sttz/homebrew-tap](https://github.com/sttz/homebrew-tap), see the tap readme for instructions.
Installing the latest release version of Unity is as simple as:
install-unity install f
## Versions
Most commands take a version as input, either to select the version to install or to filter the output.
You can be as specific as you like, `2018.2.2f1`, `2018.2.2`, `2018.2`, `2018`, `f` or `2018.3b` are all valid version inputs.
`install-unity` will scan for the available regular releases as well as the latest betas and alphas.
install-unity list
install-unity list a
install-unity list 2019.1Will show the available versions and the argument acts as a filter. Without an argument, only regular releases are loaded and displayed. Add an argument including `b` or `a` to load and display either beta or both beta and alpha versions as well.
In case install-unity fails to discover a release, it's also possible to pass a release notes or unity hub url instead of a version to `details` and `install`:
install-unity details https://unity3d.com/unity/whats-new/unity-2018.3.0
install-unity install unityhub://2018.3.0f2/6e9a27477296
## PackagesThe command above will install the default packages as specified by Unity.
install-unity details 2018.2
Will show the available packages for a given version. You can then select the packages you want to install with the `-p` or `--packages` option. The option can either be repeated or the names separated by space or comma:
install-unity install 2018.2 --packages Unity,Documentation
install-unity install f -p Unity Linux iOS Android
install-unity install 2018.3b -p Unity -p Android -p Linux## Apple Silicon
By default, `install-unity` will download and install the Unity editor matching the current platform.
Use `--platform macOSIntel` to download and install the Intel editor on Apple Silicon.
Use `--platform macOSArm` on Intel to download the Apple Silicon editor.
## Offline Install
install-unity can be used in a two-step process, first downloading the packages and then later installing them without needing an internet connection.
install-unity install 2018.2 --packages all --data-path "~/Desktop/2018.2" --download
Will download all available packages to `~/Desktop/Downloads` together with the necessary package metadata.
install-unity install 2018.2 --pacakages all --data-path "~/Destop/2018.2" --install
Will install those packages at a later time. Simply copy the folder together with the `install-unity` binary to another computer to do an offline installation there.
You can download and install only a subset of the available packages.
## Run
To select a Unity version from all the installed ones, use the run command.
install-unity run f
Will open the latest version of Unity installed.
You can also use the path to a Unity project and install-unity will open it with the corresponding Unity version.
install-unity run ~/Desktop/my-project
It will only open with the exact version of Unity the project is set to. You can optionally allow it to be opened with a newer patch, minor or any version:
install-unity run --allow-newer patch ~/Desktop/my-project
You can pass [command line arguments](https://docs.unity3d.com/Manual/CommandLineArguments.html) along to Unity, e.g. to create a build from the command line (note the `--` to separate install-unity options from the ones passed on the Unity).
install-unity run ~/Desktop/my-project -- -quit -batchmode -buildOSX64Player ~/Desktop/my-build
By default, Unity is started as a separate process and install-unity will exit after Unity has been launched. To wait for Unity to quit and forward Unity's log output through install-unity, use the `--child` option:
install-unity run ~/Desktop/my-project --child -v -- -quit -batchmode -buildOSX64Player ~/Desktop/my-build
## Create
To start a basic Unity project, use the create command. The version pattern will select an installed Unity version and create a new project using it.
install-unity create 2020.1 ~/Desktop/my-project
The project will use Unity's default setup, including packages. Alternatively, you can create a minimal project that will start with an empty ´Packages/manifest.json`:
install-unity create --type minimal 2020.1 ~/Desktop/my-project
## CLI Help
````
install-unity v2.12.1USAGE: install-unity [--help] [--version] [--verbose...] [--yes] [--update]
[--clear-cache] [--data-path ]
[--opt =...]GLOBAL OPTIONS:
-h, --help Show this help
--version Print the version of this program
-v, --verbose Increase verbosity of output, can be repeated
-y, --yes Don't prompt for confirmation (use with care)
-u, --update Force an update of the versions cache
--clear-cache Clear the versions cache before running any commands
--data-path Store all data at the given path, also don't delete
packages after install
--opt = Set additional options. Use '--opt list' to show all
options and their default value and '--opt save' to create an
editable JSON config file.ACTIONS:
---- INSTALL (default):
Download and install a version of UnityUSAGE: install-unity [options] [install] [--packages ...]
[--download] [--install] [--upgrade]
[--platform none|mac_os|linux|windows|all]
[--arch none|x86_64|arm64|all] [--redownload] [--yolo]
[]OPTIONS:
Pattern to match Unity version or release notes / unity hub
url
-p, --packages Select packages to download and install ('all'
selects all available, '~NAME' matches substrings)
--download Only download the packages (requires '--data-path')
--install Install previously downloaded packages (requires
'--data-path')
--upgrade Replace existing matching Unity installation after successful
install
--platform none|mac_os|linux|windows|all Platform to download the
packages for (only valid with '--download', default = current
platform)
--arch none|x86_64|arm64|all Architecture to download the packages for
(default = current architecture)
--redownload Force redownloading all files
--yolo Skip size and hash checks of downloaded files---- LIST:
Get an overview of available or installed Unity versionsUSAGE: install-unity [options] list [--installed]
[--platform none|mac_os|linux|windows|all]
[--arch none|x86_64|arm64|all] []OPTIONS:
Pattern to match Unity version
-i, --installed List installed versions of Unity
--platform none|mac_os|linux|windows|all Platform to list the versions
for (default = current platform)
--arch none|x86_64|arm64|all Architecture to list the versions for
(default = current architecture)---- DETAILS:
Show version information and all its available packagesUSAGE: install-unity [options] details
[--platform none|mac_os|linux|windows|all]
[--arch none|x86_64|arm64|all] []OPTIONS:
Pattern to match Unity version or release notes / unity hub
url
--platform none|mac_os|linux|windows|all Platform to show the details for
(default = current platform)
--arch none|x86_64|arm64|all Architecture to show the details for
(default = current architecture)---- UNINSTALL:
Remove a previously installed version of UnityUSAGE: install-unity [options] uninstall []
OPTIONS:
Pattern to match Unity version or path to installation root---- RUN:
Execute a version of Unity or a Unity project, matching it to its Unity
versionUSAGE: install-unity [options] run [--child]
[--allow-newer none|hash|build|patch|minor|all]
[--upgrade ]
[...]OPTIONS:
Pattern to match Unity version or path to a Unity project
Arguments to launch Unity with (put a -- first to avoid
Unity options being parsed as install-unity options)
-c, --child Run Unity as a child process and forward its log output (only
errors, use -v to see the full log)
-a, --allow-newer none|hash|build|patch|minor|all Allow newer versions of
Unity to open a project
--upgrade Run the project with the highest installed Unity
version matching the pattern---- CREATE:
Create a new empty Unity projectUSAGE: install-unity [options] create [--type ] [--open]
OPTIONS:
Pattern to match the Unity version to create the project with
Path to the new Unity project
--type Type of project to create (basic = standard
project, minimal = no packages/modules)
-o, --open Open the new project in the editor
````# Legacy
The old Python version of install-unity can be found in the [legacy](https://github.com/sttz/install-unity/tree/next) branch.