커맨드 라인 인자(Command line arguments)

Unity를 실행할 때 일반적으로 바탕 화면에서 아이콘을 더블클릭하여 시작하지만, 커맨드 라인(Mac OS 터미널 또는 Windows 커맨드 프롬프트)에서 실행할 수도 있습니다. 이렇게 시작하면 Unity가 시작할 때 커맨드와 정보를 받을 수 있어 테스트 스위트(test suite), 자동화 빌드 또는 기타 프로덕션 작업에 매우 유용합니다.

Mac OS의 경우, 다음을 터미널에 입력하여 Unity를 실행해야 합니다.

/Applications/Unity/Unity.app/Contents/MacOS/Unity

64비트 Windows에서 다음을 커맨드 프롬프트에 입력하여 Unity를 실행해야 합니다.

C:\\Program Files\\Unity\\Editor\\Unity.exe

32비트 Windows에서 다음을 커맨드 프롬프트에 입력하여 Unity를 실행해야 합니다.

C:\\Program Files (x86)\\Unity\\Editor\\Unity.exe

동일한 방법으로 스탠드얼론 Unity 게임을 실행해야 합니다.

Unity 자동 실행

Mac OS의 경우, 다음을 터미널에 입력하여 Unity를 자동으로 실행해야 합니다.

/Applications/Unity/Unity.app/Contents/MacOS/Unity -quit -batchmode -serial SB-XXXX-XXXX-XXXX-XXXX-XXXX -username 'JoeBloggs@example.com' -password 'MyPassw0rd'

참고: Jenkins 등의 지속적 통합(Continuous Integration, CI) 도구를 사용하여 커맨드 라인을 통해 활성화할 경우에는 -nographics 플래그를 추가하여 WindowServer 오류를 방지합니다.

64비트 Windows에서 다음을 커맨드 프롬프트에 입력하여 Unity를 자동으로 실행해야 합니다.

     "C:\Program Files\Unity\Editor\Unity.exe" -quit -batchmode -serial SB-XXXX-XXXX-XXXX-XXXX-XXXX -username "JoeBloggs@example.com" -password "MyPassw0rd"

32비트 Windows에서 다음을 커맨드 프롬프트에 입력하여 Unity를 자동으로 실행해야 합니다.

 "C:\Program Files (x86)\Unity\Editor\Unity.exe" -quit -batchmode -serial SB-XXXX-XXXX-XXXX-XXXX-XXXX -username "JoeBloggs@example.com" -password "MyPassw0rd"

옵션

위에서 언급한 대로, 에디터 및 빌드된 게임은 시작 시 추가 커맨드 및 정보를 선택적으로 받을 수 있습니다. 이 섹션에서는 사용 가능한 커맨드 라인 옵션을 설명합니다.

예제

C#:

using UnityEditor;
class MyEditorScript
{
     static void PerformBuild ()
     {
         string[] scenes = { "Assets/MyScene.unity" };
         BuildPipeline.BuildPlayer(scenes, ...);
     }
}

JavaScript:

static void PerformBuild ()
{
    string[] scenes = { "Assets/MyScene.unity" };
    BuildPipeline.BuildPlayer(scenes, ...);
}

다음 커맨드는 Unity를 배치 모드로 실행하고 MyEditorScript.PerformBuild 메서드를 실행한 다음 완료되면 종료합니다.

Windows:

C:\program files\Unity\Editor\Unity.exe -quit -batchmode -executeMethod MyEditorScript.PerformBuild

Mac OS:

/Applications/Unity/Unity.app/Contents/MacOS/Unity -quit -batchmode -executeMethod MyEditorScript.PerformBuild

다음 커맨드는 Unity를 배치 모드로 실행하고, 주어진 프로젝트 경로를 사용하여 에셋 서버에서 업데이트합니다. 에셋 서버에서 모든 에셋을 다운로드하고 임포트한 후 해당 메서드가 실행됩니다. 함수 실행이 완료된 후 Unity는 자동으로 종료됩니다.

/Applications/Unity/Unity.app/Contents/MacOS/Unity -batchmode -projectPath ~/UnityProjects/AutobuildProject -assetServerUpdate 192.168.1.1 MyGame AutobuildUser l33tpa33 -executeMethod MyEditorScript.PerformBuild -quit

Unity 에디터 특수 커맨드 라인 인자

다음은 특수 상황 또는 Unity 지원에서 지시하는 경우에만 사용해야 합니다.

Unity 스탠드얼론 플레이어 커맨드 라인 인자

Unity로 빌드한 스탠드얼론 플레이어 또한 몇몇 커맨드 라인 인자를 파악할 수 있습니다.

유니버설 Windows 플랫폼 커맨드 라인 인자

유니버설 Windows 앱은 디폴트로 커맨드 라인 인자를 허용하지 않기 때문에 인수를 전달하려면 MainPage.xaml.cs/cpp 또는 MainPage.cs/cpp에서 특수 함수를 호출해야 합니다. 예를 들어 다음과 같습니다.

appCallbacks.AddCommandLineArg("-nolog");

이 함수는 appCallbacks.Initialize*() 함수 이전에 호출해야 합니다.

• 2017–08–07 일부 편집 리뷰를 거쳐 페이지 수정됨
  
• Unity 2017.2에 “accept-apiupdate” 커맨드 라인 옵션 추가됨 NewIn20172