← Руководство

Запуск Unity из интерфейса командной строки

Unity Editor можно запустить из интерфейса командной строки операционной системы и передать аргументы, меняющие способ запуска. Через командную строку можно также выполнить при запуске конкретные методы из скриптов C# вашего проекта.

При запуске Unity Editor, разделителем для значения аргумента командной строки является один пробел. Например, чтобы установить режим окна на безграничный, используйте -window-mode borderless.

Полный список аргументов командной строки см. в Unity Editor ссылка на аргументы командной строки и Unity ссылка на аргументы командной строки игрока.

Запуск Unity из интерфейса командной строки

Чтобы запустить проект Unity из интерфейса командной строки, укажите путь к каталогу приложения Unity, а затем -projectPath и путь к каталогу для целевого проекта.

Важно: Если путь к проекту содержит пробелы, заключите его в кавычки. Например, "Unity Projects/My Game".

При запуске таким образом Редактор получает команды и информацию о запуске, что может быть полезно для тестовых пакетов, автоматических сборок и других производственных задач.

При возникновении каких-либо ошибок обращайтесь к файлам журнала Unity для получения дополнительной информации, которая может помочь диагностировать проблемы.

Предварительные условия

Установите Unity Editor в расположение по умолчанию через Unity Hub. Если редактор установлен в другом расположении, измените путь, чтобы отразить это. Дополнительные сведения о том, как найти путь к расположению редактора, см. в Установка и удаление версий редактора.

Запуск Unity на Linux

Введите следующую команду в Терминал, чтобы запустить Unity:

/home/<user>/Unity/Hub/Editor/<version>/Editor/Unity -projectPath <project path>

Запуск Unity на macOS

Введите следующую команду в Терминал, чтобы запустить Unity:

/Applications/Unity/Hub/Editor/<version>/Unity.app/Contents/MacOS/Unity -projectPath <project path>

Запуск Unity на Windows

Для запуска Unity в командной строке введите следующую команду:

"C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -projectPath "<project path>"

Чтобы предотвратить ошибки синтаксиса в Windows, убедитесь, что путь к каталогу не заканчивается одним обратным косой чертой. Используйте либо двойные обратные косой черты (\\), либо не используйте обратной косой черты, как показано ниже:

"C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -projectPath "C:\MyUnityProjects\MyProject"
"C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -createProject "C:\MyUnityProjects\MyProject\\"

Пример скрипта для выполнения методов при запуске

Вы можете использовать командную строку для выполнения определенных методов из скриптов C# вашего проекта при запуске Редактора. Следующие примеры демонстрируют скрипт C# и аргументы командной строки, используемые для выполнения методов из этого скрипта при запуске:

Пример скрипта C# в проекте:

using UnityEditor;
class MyEditorScript
{
     static void PerformBuild ()
     {
        BuildPlayerOptions buildPlayerOptions = new BuildPlayerOptions();
        buildPlayerOptions.scenes = new[] { "Assets/Scene1.unity", "Assets/Scene2.unity" };
        BuildPipeline.BuildPlayer(buildPlayerOptions);
     }
}

Следующая команда запускает Редактор в пакетном режиме, вызывает метод MyEditorScript.PerformBuild из предыдущего скрипта, а затем выходит по завершении. В пути Редактора замените <version> на версию Unity, которую вы хотите запустить, или замените путь полностью, если ваш путь Unity Editor не является путем по умолчанию.

Windows:

"C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -quit -batchmode -projectPath "C:\Users\UserName\Documents\MyProject" -executeMethod
MyEditorScript.PerformBuild

macOS:

/Applications/Unity/Hub/Editor/<version>/Unity.app/Contents/MacOS/Unity -quit -batchmode -projectPath ~/UnityProjects/MyProject -executeMethod
MyEditorScript.PerformBuild