文档

Unity 引擎

Unity 引擎

Unity Editor 命令行参数参考

从命令线启动 Unity Editor 版本When可以使用的Arguments列表。
阅读时间33 分钟最后更新于 6 天前

您可以使用其他命令行参数启动 Unity Editor 和 Player,从而Control启动行为、配置Settings或自动化工作流程。
要使用这些Arguments,请在Terminal或命令提示符符启动When将它们附加到 Unity 可执行文件路径。例如:
unity.exe -batchmode -quit -executeMethod MyClass.MyMethod
。
有关更多信息,请参阅从命令行界面运行 Unity。

配置Arguments

您可以运行 Unity Editor 并使用 ON 的其他命令和信息构建 Unity Applications 版本。Page面列出了可使用于启动和配置 Unity Editor 和 Unity Player 实例的命令行参数。

命令

描述

-createProject <pathname>
在给定路径处创建一个Empty Project。
-cloneFromTemplate <template-path>
将
-cloneFromTemplate
与
-createProject
结合使用,使用
-cloneFromTemplate
指定的模板存档或目录,在
-createProject
指定的路径上新建 Project。

示例(Windows):
-createProject "C:\Projects\MyProject" -cloneFromTemplate "C:\Path\To\Templates\com.unity.template.urp-blank-17.1.0.tgz"

示例 (macOS):
-createProject "/Users/username/Projects/MyProject" -cloneFromTemplate "/Users/username/Library/Application Support/UnityHub/Templates/com.unity.template.urp-blank-17.1.0.tgz"

示例 (Linux):
-createProject "/home/username/Projects/MyProject" -cloneFromTemplate "/home/username/.config/UnityHub/Templates/com.unity.template.urp-blank-17.1.0.tgz"
-consistencyCheck
ON Editor 启动时执行导入器一致性检查。默认情况下 Unity 执行
local
检查,强制在本地重新导入 All Assets。它还会检查导入是否与上次导入不同。

**注意:**一致性检查模式会禁用对 Unity Accelerator 的上传,旨在测试导入器输出是否具有确定性。如需了解更多信息,请参阅
-consistencyCheckSourceMode
的描述。
-consistencyCheckSourceMode string
设置 Unity 比较资源导入When检查的音频源。请从以下值中进行选择:
  • local
    :强制在本地Reimport导入AllAssets,并检查导入是否与上次导入不同。
  • cacheserver
    :如果已启用 Unity Accelerator,此选项将从缓存服务器获取资源元数据,并比较结果是否在本地 Match ON 缓存服务器。此选项仅重新导入缓存服务器器ON存在的Assets。如果一致性检查成功,则会保留原始导入result,并且不需要Upload,因为result是一致的并且已经缓存。如果检查失败,则会记录Editor器日志message,详细说明哪些导入failed。为了防止缓存缓存,不会上传不一致的result。
有关更多信息,请参阅 Check the consistency of an importer(检查导入器的一致性)。
-disable-assembly-updater <assembly1 assembly2>
指定一个以Space分隔的程序程序集称列表作为 Unity ONAutomatic更新时忽略的Parameters。

以Space分隔的程序集称列表是可选的:通道不带Any程序集名称的命令选项项以忽略All程序集,如示例 1 所示。

示例 1
unity.exe -disable-assembly-updater


示例 2
unity.exe -disable-assembly-updater A1.dll subfolder/A2.dll


示例 2 有两个程序集名称,一个具有路径名。示例 2 会忽略
A1.dll
(无论它存储在哪个 Folder 中),并且仅当它存储在
subfolder
Folder 下时才忽略
A2.dll
:

如果在
-disable-assembly-updater
命令行参数中列出程序集(或者如果未指定程序集),Unity 会将以下 message 记录到 Editor.log:

[Assembly Updater] warning: Ignoring assembly [assembly_path] as requested by command line parameter.”).


使用此选项可避免导入程序集时不必要的 API Updater 开销。

如果要导入访问不需要更新的 Unity API 的程序集,此参数很有用。When导入无法访问Any Unity API 的程序集时(例如,如果您在 Unity 外部构建了部分或All音频源代码,并希望将生成的程序集导入 Unity Project),此功能也很有用。

注意:
  • 如果禁用Any需要更新的程序程序集的更新,可能会在编译时间、运行时时或两者同时出现难以轨道的错误。
  • 此参数仅禁用 API Updater 的 AssemblyUpdater 组件。API Updater 的 ScriptUpdater 组件仍然针对项目中的代码(包括包)运行,除非在没有
    -accept-apiupdate
    参数的批次模式下运行 Editor。有关更多信息,请参阅批次模式 Arguments。
-disable-gpu-skinning
在启动时禁用图形处理单元 GPU 蒙皮。
-executeMethod <ClassName.MethodName>
或
-executeMethod <NamespaceName.ClassName.MethodName>
Unity 打Project以及可选Asset Server更新完成后,立即执行Static方法。您可以使用它执行 Continuous 集成、执行单元测试、进行构建或准备数据等任务。如果提供了
-activeBuildProfile
,Unity 会在运行
-executeMethod
之前使用配置文件的脚本定义来编译脚本。

要从命令行进程返回报错,请抛出异常导致 Unity 使用返回代码 1 退出,或使用非零返回代码调用
EditorApplication.Exit
。

要通道参数,请将它们添加到命令行并使用
System.Environment.GetCommandLineArgs
在函数中检索它们。要使用
-executeMethod
,必须将包含脚本放在 Editor Folder 文件夹中。执行的方法必须定义为 Static。
-exportPackage <exportAssetPath1 exportAssetPath2 ExportAssetPath3 exportFileName>
导出给定路径(或给定路径设置)的包。在此示例中,
exportAssetPath
是要从 Unity Project 导出的文件夹(相对于 Unity Project 根),
exportFileName
是 Package Name。此选项一时间仅导出整个文件夹。普通需要将此命令与
-projectPath
参数一起使用。
-importPackage <pathname>
导入给定的资源包。Unity 不显示Any导入对话框。
-job-worker-count <N>
指定 Unity JobQueue 任务工数量的最大线程数量。
-gc-helper-count <N>
指定资源垃圾回收器 helper 线程的数量。默值是可用的核心数量。
-logFile <pathname>
指定 Unity 将 Editor 日志文件写入的文件路径位置。ON 日志文件默认位置的更多信息,请参阅日志文件参考。要输出到控制台,请为路径 Name 指定
-
。ON Windows 可以使用
-logFile
将输出直接指向
stdout
,默认情况下不是控制台。如果路径包含空格,请用双引号将其换行。即使路径不包含空格,某些命令线面也可能需要引用路径。

示例(Windows):
"C:\Program Files\Unity\Hub\Editor\<Version>\Editor\Unity.exe" -projectPath "C:\Projects\MyGame" -logFile "C:\Logs\Editor.log"

示例 (macOS):
"/Applications/Unity/Hub/Editor/<Version>/Unity.app/Contents/MacOS/Unity" -projectPath "/Users/me/Projects/MyGame" -logFile "/Users/me/Logs/Editor.log"

示例 (Linux):
"/opt/Unity/Hub/Editor/<Version>/Editor/Unity" -projectPath "/home/me/Projects/MyGame" -logFile "/home/me/logs/Editor.log"


要指定 UPM 背景应用程序的日志文件的位置,请参阅描述以
-upmLogFile
。
-noUpm
禁用 Unity 包管理器。
-openfile <path>
从Scene或包文件的路径OpenProject。或者,也可以使用
-projectPath
参数
-password <password>
在激活 Unity Editor 期间,在日志表单中进入密码。
-projectPath <pathname>
在给定路径处OpenProject,该路径可以是绝对路径,也可以是相对于当前工作目录的路径。如果路径名包含空格,请用引号将其括起来。
-quit
在Other命令执行完毕后退出 Unity Editor。这样可以隐藏一些报错消息,但它们仍然显示在 Editor 的日志文件中。
-quit
参数具有以下限制:
  • 如果 Editor 连接到 Accelerator 缓存服务器,则需要额外的参数
    -cacheServerWaitForUploadCompletion
    以防止 Unity 在未完成的缓存上传之前退出。
  • 如果 Editor 正在使用
    -runTests
    参数运行测试,则
    -quit
    会使 Editor 在 In-Progress 测试有机会完成之前立即退出。
  • 如果 Editor 正在运行异步代码,则
    -quit
    可能导致应用程序挂起并失去响应。
-quitTimeout
当您使用
-quit
参数时,Editor 会等待待处理的异步任务以默认超时 300 秒完成。使用此参数可以设置不同的超时(以秒为单位)。
-releaseCodeOptimization
启用释放代码优化模式,覆盖会话的当前默认代码优化模式。
仅限 Android在导入纹理或版本Project之前,将默认纹理压缩设置为所需的Format。这是为了不必使用所需的 Format 再次导入纹理。可用格式为 dxt、PVRTC、ATC 等 ETC2 和 ASTC。已启用纹理压缩定向时,忽略此参数。
**注意:**PVRTC Format 已弃用。使用 ASTC 或 ETC Format式。
-overrideMaxTextureSize
覆盖 Unity 在导入AssetsWhen应用的最大纹理大小(以像素为单位)。此设置会影响 Project 中的所有 Textures,并覆盖 Texture Import Settings 中为各个 Textures Configured 的任何 Max Size。该值是一个整数,表示纹理的高度或宽度(以较长者为准)的最大 Limit。调整宽WhenWhen。例如,如果纹理为 2048x1024 像素,但
-overrideMaxTextureSize
设置为 512,Unity 会导入大小为 512x256 像素的纹理。有关更多详细信息,请参阅
EditorUserBuildSettings.overrideMaxTextureSize
。
-overrideTextureCompression
覆盖 Unity 导入AssetsWhen使用的纹理压缩Settings。在本地Development期间,这对于速度纹理导入或生成目标切换特别有用。有关细节,请参阅
EditorUserBuildSettings.overrideTextureCompression
。
-silent-crashes
阻止 Unity 显示桌面版本,台式机,崩溃When显示的对话框。When希望在自动化构建或测试中运行播放Player时,此参数很有用,因为这种情况下不希望对话框提示阻碍自动化。
-upmLogFile <pathname>
指定 Unity 为独立于 Editor 运行的 UPM 背景应用程序程序编写日志文件的路径和文件Name。您可以在同一命令中指定
-upmLogFile
和
-logFile
。如果同时包含这两个 Arguments,则可以为两个日志文件指定独立路径。
-username <username>
在 Unity Editor 激活期间,在日志表单中进入用户名。
-vcsMode <mode>
设置版本控制模式。可用模式有
"Visible Meta Files"
、
"Hidden Meta Files"
、
Perforce
和
PlasticSCM
。您可以使用其他标志来填写给定版本控制模式的配置字段。这些标志基于 Provider.GetActiveConfigFields 方法。例如,可以使用
-vcPerforceUsername
、
-vcPerforcePassword
、
-vcPerforceWorkspace
和
-vcPerforceServer
来设置 Perforce 用户名、工作空间和 Server 字段。

注意:包含空格的
<mode>
Arguments 必须用双引号 (") 括起来。
-vcsModeSession <mode>
设置此会话的版本控制模式。可用模式有
"Visible Meta Files"
、
"Hidden Meta Files"
、
Perforce
和
PlasticSCM
。您可以使用其他标志来填写给定版本控制模式的配置字段。这些标志基于 Provider.GetActiveConfigFields 方法。例如,可以使用
-vcPerforceUsername
、
-vcPerforcePassword
、
-vcPerforceWorkspace
和
-vcPerforceServer
来设置 Perforce 用户名、工作空间和 Server 字段。

注意:包含空格的
<mode>
Arguments 必须用双引号 (") 括起来。
-version
在命令线打印 Unity Editor 的版本数量,而不启动 Editor。
-timestamps
以当前时间戳和线程 ID 作为每个 Editor.log message 的前缀。

批次模式 Arguments

使用以下Arguments可配置 Unity 的批次处理模式。批次模式使 Unity 能够在没有用户输入的情况下运行预定义任务,这使得批次模式对于测试等自动化任务非常有用。
重要
除非与 Unity 另有单独的商业条款,否则以批次模式使用 Unity 将受 Unity 服务条款(包括适用的附加条款)的约束。有关更多信息,请参阅最新版本的 Unity 服务条款和其他条款,包括 Unity Editor 软件条款。

命令

描述

-accept-apiupdate
使用此命令行选项可在以批次模式启动 Unity 时运行 API Updater。

示例:
unity.exe -accept-apiupdate -batchmode [other params]


如果在批次模式下启动 Unity When忽略此命令线参数,则 API Updater 不会运行。这可能会导致编译器错误。
-batchmode
以批处理模式运行 Unity。在批处理模式下,Unity 运行命令行参数,无需人机交互。它还禁止需要人机交互的对话 Windows(例如保存场景窗口)。使用命令行参数When,始终以批次处理模式运行 Unity,因为它允许自动化运行而不会中断。

当脚本代码执行期间发生异常、Asset Server 更新失败或其他操作失败时,Unity 会立即退出并返回代码 1。

在批次模式下,Unity 将其日志输出的最低版本发送到控制台。但是,日志文件仍然包含完整的日志信息。在 Editor 打开同一项目时,无法以批次模式打开项目;一次只能运行 Unity 的单一实例。

要检查 Editor 还是桌面版本,台式机,请使用 Application.isBatchMode 运算符。

如果 When using
-batchmode
尚未导入 Project,则 Target 平台为默认平台。要强制不同的平台,请使用
-buildTarget
选项。
‑ignorecompilererrors
使用此参数When,即使存在编译错误,Unity 也会继续Start应用程序程序。
-nographics
在批次模式下运行When,Unity 不会Initialize图形设备。然后,您可以ON没有 GPU 的机器上运行自动化工作流程。自动工作流程仅在窗口获得焦点时才有效,否则无法发送模拟输入命令
-nographics
。 不允许烘焙 GI,因为 Enlighten Realtime Global Illumination 需要 GPU 进行 Meta Pass 渲染(请参阅 光照贴图和着色器页面的 Meta Pass 部分 以了解更多信息)。
**注意:**输出日志在此模式OFF关闭。要启用输出日志的创建,请使用命令
-logFile
指定文件位置。

生成 Arguments

使用以下Arguments可从命令线各种平台版本播放玩家。有关从命令行构建玩家的更多信息,请参阅从命令行创建版本。

命令

描述

-activeBuildProfile <pathname>
将保存在给定路径处的生成配置文件设置为 Active 生成配置文件(例如,
-activeBuildProfile "Assets/Settings/Build Profiles/WindowsDemo.asset"
)。

注意:
  • -activeBuildProfile <pathname>
    在编译前应用 Active 生成配置文件的生成数据部分中的自定义脚本定义。这些脚本定义会添加到当前的定义设置中,并且不会重载或删除 Project 中的现有脚本定义。
  • 版本版本配置文件资源的路径必须相对于Project的根文件Folder。
  • 与
    -executeMethod
    一起指定时,Unity 会应用配置文件的脚本定义并在调用该方法之前触发脚本编译。配置文件的定义将添加到当前 Project 定义中,并在后续
    -executeMethod
    执行期间生效。这样可以实现 CI/CD 工作流程,例如在单一批次会话中切换 Target 平台。
-build <pathName>
从
activeBuildProfile <pathname>
到指定 Target 路径生成 Player。对于某些平台,路径必须以 Target 平台指定的文件扩展名结束。例如,
-build path/to/your/build.exe
。ON哪些平台需要扩展的信息,请参阅平台版本路径参考。
-buildLinux64Player <pathname>
生成 64 位独立平台 Linux Player(例如
-buildLinux64Player path/to/your/build
)。
-buildLinuxHeadlessSimulation <pathname>
生成 64 位 Linux 无头模拟 Player(例如
-buildLinuxHeadlessSimulation path/to/your/build
)。
-buildOSXUniversalPlayer <pathname>
生成 64 位独立平台 macOS Player(例如
-buildOSXUniversalPlayer path/to/your/build.app
)。
-buildTarget <name>
选择要在其中启动 Editor 的活动生成目标。可用的选项取决ON您在 Editor 中已启用了哪些版本目标。这些选项对应于 API 枚举
BuildTarget
中的可用选项,如下所示:
  • android
  • cloudrendering
  • ios
  • linux64
  • osxuniversal
  • tvos
  • visionos
  • windowsstoreapps
  • webgl
  • win
  • win64
如果您是可访问封闭平台的开发者,可能还有其他可用的
-buildTarget
选项。有关细节,请参阅 Target 平台的文档。
-buildWindowsPlayer <pathname>
生成 32 位独立平台 Windows Player(例如
-buildWindowsPlayer path/to/your/build.exe
)。
-buildWindows64Player <pathname>
生成 64 位独立平台 Windows Player(例如
-buildWindows64Player path/to/your/build.exe
)。
-standaloneBuildSubtarget <name>
在加载中Project之前,为独立平台平台选择一个Active的版本目标:
  • 玩家
  • --server

Unity Accelerator 缓存服务器 Arguments

使用以下 Arguments 可配置 Unity 对 Unity Accelerator 缓存服务器的使用。这些Arguments会重载 Editor 偏好 中存储的Any相应配置。

命令

描述

-EnableCacheServer
启用 Unity Accelerator。还必须使用
-cacheServerEndpoint <host:port>
指定 Unity Accelerator 实例的地址。
-cacheServerEndpoint <host:port>
指定 Unity Accelerator 实例的终端地址。

示例:
-cacheServerEndpoint 127.0.0.1:10080

默认端口为
10080
,但在安装过程中可以更改。
-cacheServerNamespacePrefix <prefix>
设置 Unity Accelerator 实例的命名空间前缀。使用此参数以及命名空间空间Name可对缓存服务器ON的数据进行分区,例如,隔离不同Projects Unity 版本的缓存数据。

示例:
-cacheServerNamespacePrefix MyProject_Unity23LTS

包含空格的前缀必须用双引号 (
"
) 括起来。
提供的Name用作缓存中最多 3 个Namespaces空间的前缀,这些命名空间按类型数瑕疵数据和着色器缓存数据。
-cacheServerEnableDownload true

-cacheServerEnableDownload false
启用或禁用从 Unity Accelerator 实例下载。
-cacheServerEnableUpload true

-cacheServerEnableUpload false
启用或禁用上传到 Unity Accelerator 实例。

示例:
-cacheServerEnableUpload true
-cacheServerWaitForConnection <ms>
指定 Unity 在加载中Project等待连接到 Unity Accelerator 实例的时间(以毫秒为单位),然后开始初始ProjectRefresh。

示例:
-cacheServerWaitForConnection 5000
-cacheServerWaitForUploadCompletion
阻止 Unity 关闭,直到任Any处理的 Unity Accelerator 上传完成。当 Unity Accelerator 与命令行参数
-quit
结合使用时,建议这样做;命令行参数在其他脚本化命令执行完毕后关闭 Unity Editor。
-cacheServerDownloadBatchSize <batchSize>
设置各个缓存服务器DownloadBatches中的瑕疵数量。Download Batches 是一种优化,用于将单个下载分组为更大的 Batches,从而减少 Download 操作的数量。

示例:
-cacheServerDownloadBatchSize 256

- 默认值为 1。
-cacheServerUploadExistingImports
当 Unity 开始将新建导入上传到 Unity Accelerator 实例时,上传以前未上传的任何现有导入。以前上传的导入不会重新上传。
-cacheServerUploadAllRevisions
UploadAny现有导入,包括 Unity 开始将新建Upload传到 Unity Accelerator 实例When资源数据库已知但尚未上传的All先前修订版本。导入以前上传的修订版本,不会重新上传。
-cacheServerUploadExistingShaderCache
在 Unity 开始将新建导入上传到缓存服务器时,上传以前未上传的任何现有着色器缓存导入。以前上传的着色器导入不会重新上传。

调试 Arguments

命令

描述

-disableManagedDebugger
禁用调试器监听套接字。
-diag-debug-shader-compiler
Unity 仅启动一个着色器编译器实例,并将其超时强制为一小时。可用于调试着色器编译器问题。
-debugCodeOptimization
启用调试代码优化模式,覆盖会话的当前默认代码优化模式。
-enableCodeCoverage
启用 Code Coverage 并允许访问 Coverage API。
-force-d3d12-debug
启用 DX12 验证图层。这对于处理 ON XR 插件或原生插件很有用。
-force-d3d12-debug-gbv
启用基于 DX12 GPU 的验证。这对于处理 ON XR 插件或原生插件很有用。
-force-vulkan-layers
启用 Vulkan 验证图层。这对于处理 ON XR 插件或原生插件很有用。
-stackTraceLogType
允许 Detailed 调试。All Settings 允许选定 None、Script Only 和 Full(例如,
-stackTraceLogType Full
)。
-log-memory-performance-stats
在关闭Editor器When将Detailed的内存和性能Reports添加到 Unity Editor 主要日志文件中。
-wait-for-managed-debugger
使 Editor 在启动之前等待Managed调试器附加。生成一个对话框,其中显示 Editor 的进程 ID。ON Managed 调试的更多信息,请参阅在 Unity 中调试 C# 代码。
-wait-for-native-debugger
使 Editor 在启动之前等待附加原生调试器。生成一个对话框,其中显示 Editor 的进程 ID。

图形 API Arguments

使用以下Arguments可力 Unity Editor 使用指定的的图形 API。

命令

描述

-force-clamped
将其与
-force-glcoreXY
结合使用可防止 Unity 检查其他 OpenGL 扩展,从而允许在具有相同代码路径的平台之间运行。此方法有助于确定问题是否由平台指定。例如,驱动程序错误。
-force-d3d11
(仅限 Windows)
make Editor 使用 Direct3D 11 进行渲染。普通的图形 API 依赖于 Player Settings(通常默认为 D3D11)。
-force-d3d12
(仅限 Windows)
make Editor 使用 Direct3D 12 进行渲染。普通的图形 API 取决于 ON Player Settings。
-force-device-index
通过向 Editor 传递特定 GPU 设备的索引,使 Editor 使用该设备。例如,使用此属性可力 Editor 使用集成的 GPU 而不是专用的 GPU。GPU 索索引和物理 GPU 之间的Mapping取决于System枚举 GPU 的Order。此枚举通常由正在使用的 GPU 驱动程序或底层框架(例如金属、Direct3D 或 Vulkan)执行 Done。普通,索引
0
将是连接到主 Monitor 的 GPU。ON 桌面计算机通常是专用 GPU,而 ON 笔记本电脑通常是集成 GPU。因此,桌面计算机的专用显卡通常是 ON
-force-device-index=0
。
-force-glcore
make Editor 使用 OpenGL 3/4 核心配置配置文件进行渲染。Editor 会尝试使用可用的最佳 OpenGL 版本以及 OpenGL 驱动程序程序公开的All OpenGL 扩展。如果平台不受支持,则 Editor 使用 Direct3D。
-force-glcoreXY
与 类似
-force-glcore
,但需要指定的 OpenGL 上下文版本。XY 的接受值:32、33、40、41、42、43、44 或 45。如果平台不Support指定的版本的 OpenGL,Unity 将Fallback到支持的版本。
-force-gles
(仅限 Windows)
make Editor 使用 OpenGL for 嵌入式 系统 进行渲染。Editor 会尝试使用可用的最佳 OpenGL ES 版本以及 OpenGL 驱动程序程序公开的All OpenGL ES 扩展。
-force-glesXY
(仅限 Windows)
与
-force-gles
类似,但请求指定的 OpenGL ES 上下文版本。XY 的接受值:30, 31, 31aep 或 32。如果平台不Support OpenGL ES 的指定的版本,Unity 将Fallback到支持的版本。如果平台不Support OpenGL ES,Unity 将Fallback到另一个图形 API。
-force-opengl
make Editor 使用Legacy OpenGL 结束。
-force-vulkan
make Editor 使用 Vulkan 进行渲染。普通的图形 API 取决于 ON Player Settings。

许可证 Arguments

使用以下Arguments可以处理 Unity 许可证或使用不同的许可证选项运行 Unity Editor。

命令

描述

-createManualActivationFile
手动激活 Unity 许可证的三步骤过程的第一步。有关更多信息,请参阅用户手册许可证激活。
-manualLicenseFile <yourulffile>
手动激活 Unity 许可证的三步骤过程中的步骤三。有关更多信息,请参阅用户手册许可证激活。
-returnlicense
返回当前Active的基于序列或命名的用户许可证证。不要使用
-returnlicense
返回浮动许可证。有关更多信息,请参阅退回许可证。有关许可模式的更多信息,请参阅 Licensing Overview。
-serial <serial-key>
激活付费 Unity 许可证。包含
<serial-key>
值可激活基于序列号的许可证,或同时激活指定的用户许可证及其 serial Key。排除
<serial-key>
值以激活指定的用户许可证而不激活其 serial Key。有关更多信息,请参阅从命令行激活许可证。有关许可模式的更多信息,请参阅 Licensing Overview。

**注意:**使用
-serial
参数时,还必须使用
-batchmode
参数。指定
-quit
参数也是一种很好的做法。

金属 Arguments(仅限 MacOS)

使用以下 Arguments 可配置 Unity 对 Apple Devices 使用金属图形 API。

命令

详细信息

-force-low-power-device
(仅限 macOS)
如果使用 金属,make Editor 使用低功耗设备。
-force-metal
make Editor 使用 金属 作为图形PI(仅限 macOS)。
-enable-metal-capture
启用从 Editor 内部获取金属捕获的功能。

性能分析器 Arguments

使用以下 Arguments 可配置 Unity 对性能分析器的使用。

命令

描述

-deepprofiling
为 CPU 性能分析器启用深度性能分析选项。
-profiler-enable
对 Player 或 Editor 的 Start 进行配置文件。将此参数与 Player 一起使用时,其特效与在生成配置文件中已启用 Autoconnect Profiler 选项的情况下构建 Player 的效果相同。

将此参数与 Editor 一起使用时,Editor 启动时会在性能分析器窗口中开始收集和显示性能分析器信息。
-profiler-log-file <Path/To/Log/File.raw>
此参数设置 Unity Profiler 在启动时将配置文件数据流到 .原始文件。它适用于玩家和 Editor。
-profiler-capture-frame-count <NumberOfFrames>
此参数设置启动时串流到 .原始文件时性能分析器应在配置文件中捕获的帧数。仅适用于 ON 玩家。
-profiler-maxusedmemory
默认情况下,Unity Profiler 的
maxUsedMemory
对于玩家为 16MB,对于 Editor 为 256MB。您可以使用此参数在 Start 时将
maxUsedMemory
参数设置为自定义大小(例如,
-profiler-maxusedmemory 16777216
)。大小以字节为单位设置。

Unity Editor 特殊命令行参数

仅在特殊情况下或 Unity 支持部门指示When才使用。

命令

描述

-enableIncompatibleAssetDowngrade
WhenAssets由更新、不兼容的 Unity 版本制作,并且要降级才能与当前 Unity 版本配合使用,请使使用此选项。
Enable此属性When,如果尝试Open需要此属性的Project,Unity 会显示一个对话框,要求确认此降级。

注意:此过程不受支持且风险很高,只能用作最后的手段。
-giCustomCacheLocation
设置全局光照 (GI) 缓存文件夹的自定义位置。值必须是绝对路径,如果包含Any空格,则必须将其包含在引号中。如果设置了
-giCustomCacheLocation
,则对于当前 Editor 会话,其值覆盖先前在 GI Cache 偏好中定义的任何自定义缓存 Folder 位置。Editor 退出后,值不再存在。
-rebuildLibrary
此过程会删除
Library
Project 子目录,从而触发 All Assets 的完整 Reimport。When Unity 在Project初始化期间Reports数据库损坏报错时,请使使用此选项。

Unity Hub 特殊命令行参数

仅在特殊情况下或 Unity 支持部门指示When才使用。这些Arguments默认情况下情况下不使用 Unity Hub Unity Editor 版本中使用。

命令

描述

-useHub
启动与 Hub 集成的 Unity Editor。
-hubIPC
启用 Unity Editor 和 Unity Hub 之间的通信和交互。
-hubSessionId
指定 Unity Hub 会话的唯一标识符。
在 Unity Editor 的All受支持版本中,这些Arguments都已默认情况下设置。

其他资源