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
- 生成 Arguments
- Unity Accelerator 缓存服务器 Arguments
- 调试 Arguments
- 图形 API Arguments
- 许可证Arguments
- 金属Arguments(仅限macOS)
- 性能分析器参数
- Unity Editor 特殊命令行参数
- Unity Hub 特殊命令行参数
- 其他资源
配置Arguments
您可以运行 Unity Editor 并使用 ON 的其他命令和信息构建 Unity Applications 版本。Page面列出了可使用于启动和配置 Unity Editor 和 Unity Player 实例的命令行参数。
命令 | 描述 |
|---|---|
| 在给定路径处创建一个Empty Project。 |
| 将 示例(Windows): 示例 (macOS): 示例 (Linux): |
| ON Editor 启动时执行导入器一致性检查。默认情况下 Unity 执行**注意:**一致性检查模式会禁用对 Unity Accelerator 的上传,旨在测试导入器输出是否具有确定性。如需了解更多信息,请参阅 |
| 设置 Unity 比较资源导入When检查的音频源。请从以下值中进行选择:
|
| 指定一个以Space分隔的程序程序集称列表作为 Unity ONAutomatic更新时忽略的Parameters。 以Space分隔的程序集称列表是可选的:通道不带Any程序集名称的命令选项项以忽略All程序集,如示例 1 所示。 示例 1 示例 2 示例 2 有两个程序集名称,一个具有路径名。示例 2 会忽略 如果在 使用此选项可避免导入程序集时不必要的 API Updater 开销。 如果要导入访问不需要更新的 Unity API 的程序集,此参数很有用。When导入无法访问Any Unity API 的程序集时(例如,如果您在 Unity 外部构建了部分或All音频源代码,并希望将生成的程序集导入 Unity Project),此功能也很有用。 注意:
|
| 在启动时禁用图形处理单元 GPU 蒙皮。 |
| Unity 打Project以及可选Asset Server更新完成后,立即执行Static方法。您可以使用它执行 Continuous 集成、执行单元测试、进行构建或准备数据等任务。如果提供了要从命令行进程返回报错,请抛出异常导致 Unity 使用返回代码 1 退出,或使用非零返回代码调用 要通道参数,请将它们添加到命令行并使用 |
| 导出给定路径(或给定路径设置)的包。在此示例中, |
| 导入给定的资源包。Unity 不显示Any导入对话框。 |
| 指定 Unity JobQueue 任务工数量的最大线程数量。 |
| 指定资源垃圾回收器 helper 线程的数量。默值是可用的核心数量。 |
| 指定 Unity 将 Editor 日志文件写入的文件路径位置。ON 日志文件默认位置的更多信息,请参阅日志文件参考。要输出到控制台,请为路径 Name 指定示例(Windows): 示例 (macOS): 示例 (Linux): 要指定 UPM 背景应用程序的日志文件的位置,请参阅描述以 |
| 禁用 Unity 包管理器。 |
| 从Scene或包文件的路径OpenProject。或者,也可以使用 |
| 在激活 Unity Editor 期间,在日志表单中进入密码。 |
| 在给定路径处OpenProject,该路径可以是绝对路径,也可以是相对于当前工作目录的路径。如果路径名包含空格,请用引号将其括起来。 |
| 在Other命令执行完毕后退出 Unity Editor。这样可以隐藏一些报错消息,但它们仍然显示在 Editor 的日志文件中。
|
| 当您使用 |
| 启用释放代码优化模式,覆盖会话的当前默认代码优化模式。 |
| 仅限 Android | 在导入纹理或版本Project之前,将默认纹理压缩设置为所需的Format。这是为了不必使用所需的 Format 再次导入纹理。可用格式为 dxt、PVRTC、ATC 等 ETC2 和 ASTC。已启用纹理压缩定向时,忽略此参数。 **注意:**PVRTC Format 已弃用。使用 ASTC 或 ETC Format式。 |
| 覆盖 Unity 在导入AssetsWhen应用的最大纹理大小(以像素为单位)。此设置会影响 Project 中的所有 Textures,并覆盖 Texture Import Settings 中为各个 Textures Configured 的任何 Max Size。该值是一个整数,表示纹理的高度或宽度(以较长者为准)的最大 Limit。调整宽WhenWhen。例如,如果纹理为 2048x1024 像素,但 |
| 覆盖 Unity 导入AssetsWhen使用的纹理压缩Settings。在本地Development期间,这对于速度纹理导入或生成目标切换特别有用。有关细节,请参阅 |
| 阻止 Unity 显示桌面版本,台式机,崩溃When显示的对话框。When希望在自动化构建或测试中运行播放Player时,此参数很有用,因为这种情况下不希望对话框提示阻碍自动化。 |
| 指定 Unity 为独立于 Editor 运行的 UPM 背景应用程序程序编写日志文件的路径和文件Name。您可以在同一命令中指定 |
| 在 Unity Editor 激活期间,在日志表单中进入用户名。 |
| 设置版本控制模式。可用模式有 注意:包含空格的 |
| 设置此会话的版本控制模式。可用模式有 注意:包含空格的 |
| 在命令线打印 Unity Editor 的版本数量,而不启动 Editor。 |
| 以当前时间戳和线程 ID 作为每个 Editor.log message 的前缀。 |
批次模式 Arguments
使用以下Arguments可配置 Unity 的批次处理模式。批次模式使 Unity 能够在没有用户输入的情况下运行预定义任务,这使得批次模式对于测试等自动化任务非常有用。
命令 | 描述 |
|---|---|
| 使用此命令行选项可在以批次模式启动 Unity 时运行 API Updater。 示例: 如果在批次模式下启动 Unity When忽略此命令线参数,则 API Updater 不会运行。这可能会导致编译器错误。 |
| 以批处理模式运行 Unity。在批处理模式下,Unity 运行命令行参数,无需人机交互。它还禁止需要人机交互的对话 Windows(例如保存场景窗口)。使用命令行参数When,始终以批次处理模式运行 Unity,因为它允许自动化运行而不会中断。 当脚本代码执行期间发生异常、Asset Server 更新失败或其他操作失败时,Unity 会立即退出并返回代码 1。 在批次模式下,Unity 将其日志输出的最低版本发送到控制台。但是,日志文件仍然包含完整的日志信息。在 Editor 打开同一项目时,无法以批次模式打开项目;一次只能运行 Unity 的单一实例。 要检查 Editor 还是桌面版本,台式机,请使用 Application.isBatchMode 运算符。 如果 When using |
| 使用此参数When,即使存在编译错误,Unity 也会继续Start应用程序程序。 |
| 在批次模式下运行When,Unity 不会Initialize图形设备。然后,您可以ON没有 GPU 的机器上运行自动化工作流程。自动工作流程仅在窗口获得焦点时才有效,否则无法发送模拟输入命令 **注意:**输出日志在此模式OFF关闭。要启用输出日志的创建,请使用命令 |
生成 Arguments
使用以下Arguments可从命令线各种平台版本播放玩家。有关从命令行构建玩家的更多信息,请参阅从命令行创建版本。
命令 | 描述 |
|---|---|
| 将保存在给定路径处的生成配置文件设置为 Active 生成配置文件(例如,注意:
|
| 从 |
| 生成 64 位独立平台 Linux Player(例如 |
| 生成 64 位 Linux 无头模拟 Player(例如 |
| 生成 64 位独立平台 macOS Player(例如 |
| 选择要在其中启动 Editor 的活动生成目标。可用的选项取决ON您在 Editor 中已启用了哪些版本目标。这些选项对应于 API 枚举
|
| 生成 32 位独立平台 Windows Player(例如 |
| 生成 64 位独立平台 Windows Player(例如 |
| 在加载中Project之前,为独立平台平台选择一个Active的版本目标:
|
Unity Accelerator 缓存服务器 Arguments
使用以下 Arguments 可配置 Unity 对 Unity Accelerator 缓存服务器的使用。这些Arguments会重载 Editor 偏好 中存储的Any相应配置。
命令 | 描述 |
|---|---|
| 启用 Unity Accelerator。还必须使用 |
| 指定 Unity Accelerator 实例的终端地址。 示例: 默认端口为 |
| 设置 Unity Accelerator 实例的命名空间前缀。使用此参数以及命名空间空间Name可对缓存服务器ON的数据进行分区,例如,隔离不同Projects Unity 版本的缓存数据。 示例: 包含空格的前缀必须用双引号 ( 提供的Name用作缓存中最多 3 个Namespaces空间的前缀,这些命名空间按类型数瑕疵数据和着色器缓存数据。 |
| 启用或禁用从 Unity Accelerator 实例下载。 |
| 启用或禁用上传到 Unity Accelerator 实例。 示例: |
| 指定 Unity 在加载中Project等待连接到 Unity Accelerator 实例的时间(以毫秒为单位),然后开始初始ProjectRefresh。 示例: |
| 阻止 Unity 关闭,直到任Any处理的 Unity Accelerator 上传完成。当 Unity Accelerator 与命令行参数 |
| 设置各个缓存服务器DownloadBatches中的瑕疵数量。Download Batches 是一种优化,用于将单个下载分组为更大的 Batches,从而减少 Download 操作的数量。 示例: - 默认值为 1。 |
| 当 Unity 开始将新建导入上传到 Unity Accelerator 实例时,上传以前未上传的任何现有导入。以前上传的导入不会重新上传。 |
| UploadAny现有导入,包括 Unity 开始将新建Upload传到 Unity Accelerator 实例When资源数据库已知但尚未上传的All先前修订版本。导入以前上传的修订版本,不会重新上传。 |
| 在 Unity 开始将新建导入上传到缓存服务器时,上传以前未上传的任何现有着色器缓存导入。以前上传的着色器导入不会重新上传。 |
调试 Arguments
命令 | 描述 |
|---|---|
| 禁用调试器监听套接字。 |
| Unity 仅启动一个着色器编译器实例,并将其超时强制为一小时。可用于调试着色器编译器问题。 |
| 启用调试代码优化模式,覆盖会话的当前默认代码优化模式。 |
| 启用 Code Coverage 并允许访问 Coverage API。 |
| 启用 DX12 验证图层。这对于处理 ON XR 插件或原生插件很有用。 |
| 启用基于 DX12 GPU 的验证。这对于处理 ON XR 插件或原生插件很有用。 |
| 启用 Vulkan 验证图层。这对于处理 ON XR 插件或原生插件很有用。 |
| 允许 Detailed 调试。All Settings 允许选定 None、Script Only 和 Full(例如, |
| 在关闭Editor器When将Detailed的内存和性能Reports添加到 Unity Editor 主要日志文件中。 |
| 使 Editor 在启动之前等待Managed调试器附加。生成一个对话框,其中显示 Editor 的进程 ID。ON Managed 调试的更多信息,请参阅在 Unity 中调试 C# 代码。 |
| 使 Editor 在启动之前等待附加原生调试器。生成一个对话框,其中显示 Editor 的进程 ID。 |
图形 API Arguments
使用以下Arguments可力 Unity Editor 使用指定的的图形 API。
命令 | 描述 |
|---|---|
| 将其与 |
| make Editor 使用 Direct3D 11 进行渲染。普通的图形 API 依赖于 Player Settings(通常默认为 D3D11)。 |
| make Editor 使用 Direct3D 12 进行渲染。普通的图形 API 取决于 ON Player Settings。 |
| 通过向 Editor 传递特定 GPU 设备的索引,使 Editor 使用该设备。例如,使用此属性可力 Editor 使用集成的 GPU 而不是专用的 GPU。GPU 索索引和物理 GPU 之间的Mapping取决于System枚举 GPU 的Order。此枚举通常由正在使用的 GPU 驱动程序或底层框架(例如金属、Direct3D 或 Vulkan)执行 Done。普通,索引 |
| make Editor 使用 OpenGL 3/4 核心配置配置文件进行渲染。Editor 会尝试使用可用的最佳 OpenGL 版本以及 OpenGL 驱动程序程序公开的All OpenGL 扩展。如果平台不受支持,则 Editor 使用 Direct3D。 |
| 与 类似 |
| make Editor 使用 OpenGL for 嵌入式 系统 进行渲染。Editor 会尝试使用可用的最佳 OpenGL ES 版本以及 OpenGL 驱动程序程序公开的All OpenGL ES 扩展。 |
| 与 |
| make Editor 使用Legacy OpenGL 结束。 |
| make Editor 使用 Vulkan 进行渲染。普通的图形 API 取决于 ON Player Settings。 |
许可证 Arguments
使用以下Arguments可以处理 Unity 许可证或使用不同的许可证选项运行 Unity Editor。
命令 | 描述 |
|---|---|
| 手动激活 Unity 许可证的三步骤过程的第一步。有关更多信息,请参阅用户手册许可证激活。 |
| 手动激活 Unity 许可证的三步骤过程中的步骤三。有关更多信息,请参阅用户手册许可证激活。 |
| 返回当前Active的基于序列或命名的用户许可证证。不要使用 |
| 激活付费 Unity 许可证。包含 **注意:**使用 |
金属 Arguments(仅限 MacOS)
使用以下 Arguments 可配置 Unity 对 Apple Devices 使用金属图形 API。
命令 | 详细信息 |
|---|---|
| 如果使用 金属,make Editor 使用低功耗设备。 |
| make Editor 使用 金属 作为图形PI(仅限 macOS)。 |
| 启用从 Editor 内部获取金属捕获的功能。 |
性能分析器 Arguments
使用以下 Arguments 可配置 Unity 对性能分析器的使用。
命令 | 描述 |
|---|---|
| 为 CPU 性能分析器启用深度性能分析选项。 |
| 对 Player 或 Editor 的 Start 进行配置文件。将此参数与 Player 一起使用时,其特效与在生成配置文件中已启用 Autoconnect Profiler 选项的情况下构建 Player 的效果相同。 将此参数与 Editor 一起使用时,Editor 启动时会在性能分析器窗口中开始收集和显示性能分析器信息。 |
| 此参数设置 Unity Profiler 在启动时将配置文件数据流到 .原始文件。它适用于玩家和 Editor。 |
| 此参数设置启动时串流到 .原始文件时性能分析器应在配置文件中捕获的帧数。仅适用于 ON 玩家。 |
| 默认情况下,Unity Profiler 的 |
Unity Editor 特殊命令行参数
仅在特殊情况下或 Unity 支持部门指示When才使用。
命令 | 描述 |
|---|---|
| WhenAssets由更新、不兼容的 Unity 版本制作,并且要降级才能与当前 Unity 版本配合使用,请使使用此选项。 Enable此属性When,如果尝试Open需要此属性的Project,Unity 会显示一个对话框,要求确认此降级。 注意:此过程不受支持且风险很高,只能用作最后的手段。 |
| 设置全局光照 (GI) 缓存文件夹的自定义位置。值必须是绝对路径,如果包含Any空格,则必须将其包含在引号中。如果设置了 |
| 此过程会删除 |
Unity Hub 特殊命令行参数
仅在特殊情况下或 Unity 支持部门指示When才使用。这些Arguments默认情况下情况下不使用 Unity Hub Unity Editor 版本中使用。
命令 | 描述 |
|---|---|
| 启动与 Hub 集成的 Unity Editor。 |
| 启用 Unity Editor 和 Unity Hub 之间的通信和交互。 |
| 指定 Unity Hub 会话的唯一标识符。 |
在 Unity Editor 的All受支持版本中,这些Arguments都已默认情况下设置。