使用命令行从Unity Hub中运行
Unity Hub拥有命令行界面,允许您在无头模式下访问一些Hub功能。注意,此功能仍在预览(实验)阶段。
在您可以使用这些命令之前,请下载并安装Hub.
全局标志
标志: --errors
截至 Hub 3.7.0-beta.1
- 一些错误默认情况下在控制台输出中是隐藏的。
- 在命令中使用 --errors标志将那些错误返回到输出。
显示帮助
从您的终端,导航到Hub应用可执行文件的位置,并运行命令 -- --headless help 或 -- --headless h(注意Linux系统的 -- 与其它操作系统的 -- --)。
帮助命令允许您访问可用CLI命令列表以及不同的标志和参数类型。
示例
macOS
/Applications/Unity\ Hub.app/Contents/MacOS/Unity\ Hub -- --headless help
Windows
C:\Program Files\Unity Hub> "Unity Hub.exe" -- --headless help
Linux
~/Applications/Unity\ Hub.AppImage --headless help
管理编辑器
要显示您的机器上可用的发布版本和已安装编辑器的综合列表,请使用 editors(别名: e)命令。
要缩小列表的范围,指定以下选项之一
| 选项 | 别名 | 描述 | 
| --all | -a | 显示您的机器上可用的发布版本和已安装的编辑器。 | 
| --releases | -r | 显示可用的发布版本。 | 
| --installed | -i | 显示您的机器上已安装的编辑器。 | 
示例
macOS
/Applications/Unity\ Hub.app/Contents/MacOS/Unity\ Hub -- --headless editors -r
Windows
C:\Program Files\Unity Hub> "Unity Hub.exe" -- --headless editors -r
Linux
~/Applications/Unity\ Hub.AppImage --headless editors -r
设置/获取安装路径
要设置或获取您的机器上安装Unity编辑器的路径,请使用 install-path 命令(别名: ip)。
此 install-path 命令支持以下选项
| 选项 | 别名 | 描述 | 
| --set | -s | 设置您的安装路径为指定的路径。 | 
| --get | -g | 显示您的当前安装路径。 | 
注意:如果您没有选择选项,默认为 get 命令。
示例
macOS
/Applications/Unity\ Hub.app/Contents/MacOS/Unity\ Hub -- --headless install-path
-s /Applications/Unity/Hub/Editor/
Windows
C:\Program Files\Unity Hub>"Unity Hub.exe" -- --headless install-path
-s /Applications/Unity/Hub/Editor/
Linux
~/Applications/Unity\ Hub.AppImage --headless install-path
-s /Applications/Unity/Hub/Editor/
安装Unity编辑器
要从发布列表或存档安装新编辑器,请使用 install 命令(别名: i)。
此 install 命令支持以下选项
| 选项 | 别名 | 必需? | 用法 | 描述 | 
|---|---|---|---|---|
| --version | -v | 是 | -v 2022.1.1f1 | 要安装的编辑器版本。 | 
| --changeset | -c | 否 | -c 9b001d489a54 | 如果版本不在发布列表中,这是Unity编辑器的更改集。如果版本不在发布列表中,可能需要此信息:运行 editors -r检查。 | 
| --module | -m | 否 | -m android或-m appletv webgl | 模块ID。接受多个模块ID。有关更多信息,请参阅 install-modules命令。 | 
| --childModules | --cm | 否 | --cm | 此参数将自动选择下载所有子模块,例如, android模块将下载所有子模块。 | 
| --architecture | -a | 否 | -a arm64用于Apple Silicon或-a x86_64用于Intel | macOS仅限:使用此参数以显式选择Apple Silicon或Intel版本的Unity编辑器。默认为Intel, x86_64。 | 
示例
macOS
/Applications/Unity\ Hub.app/Contents/MacOS/Unity\ Hub -- --headless install --version 2019.1.11f1 --changeset 9b001d489a54
Windows
C:\Program Files\Unity Hub>"Unity Hub.exe" -- --headless install --version 2019.1.11f1 --changeset 9b001d489a54
Linux
~/Applications/Unity\ Hub.AppImage --headless install --version 2019.1.11f1 --changeset 9b001d489a54
安装模块
要将模块下载并安装到已安装的编辑器中,请使用 install-modules 命令(别名: im)。
此 install-modules 命令支持以下选项
| 选项 | 别名 | 必需? | 用法 | 描述 | 
|---|---|---|---|---|
| --version | -v | 是 | -v 2022.1.1f1 | 指定添加模块的已安装编辑器的版本。 | 
| --module | -m | 是 | -m android或-m appletv webgl | 指定模块ID。您一次可以添加多个模块。 | 
| --childModules | --cm | 否 | --cm | 此参数将自动选择下载所有子模块。例如, android模块将下载所有子模块。 | 
有关可用的模块,请参阅下表。
注意:并非所有模块都适用于编辑器的每个版本或每个操作系统。
可用模块
| 模块 | 值 | 
| 文档 | 文档 | 
| Android 构建支持 | android | 
| Android SDK 及 NDK 工具 | android-sdk-ndk-tools | 
| OpenJDK | android-open-jdk | 
| iOS 构建支持 | ios | 
| tvOS 构建支持 | appletv | 
| Linux 构建支持(Mono) | linux-mono | 
| Linux 构建支持(IL2CPP) | linux-il2cpp | 
| WebGL 构建支持 | webgl | 
| Windows 构建支持 | windows | 
| Vuforia 增强现实支持 | vuforia-ar | 
| 语言包 | language-ja, language-ko, language-zh-cn, language-zh-hant, language-zh-hans | 
| Windows 构建支持(Mono) | windows-mono | 
| Lumin OS(Magic Leap)构建支持 | lumin | 
| Microsoft Visual Studio Community 2017/2019 | visualstudio | 
| Visual Studio for Mac | visualstudio | 
| Mac 构建支持(Mono) | mac-mono | 
| Mac 构建支持(IL2CPP) | mac-il2cpp | 
| 通用 Windows 平台构建支持 | universal-windows-platform | 
| UWP 构建支持(IL2CPP) | uwp-il2cpp | 
| UWP 构建支持 (.NET) | uwp-.net | 
示例
macOS
/Applications/Unity\ Hub.app/Contents/MacOS/Unity\ Hub -- --headless install-modules --version 2019.1.11f1 -m ios android
Windows
C:\Program Files\Unity Hub>"Unity Hub.exe" -- --headless install-modules --version 2019.1.11f1 -m ios android
Linux
~/Applications/Unity\ Hub.AppImage --headless install-modules --version 2019.1.11f1 -m ios android