使用命令行从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