기술 자료

Unity 엔진

Unity 엔진

Unity 에디터 커맨드 라인 인자 참조

커맨드 라인 Unity 에디터 버전을 실행할 때 사용할 수 있는 인자 리스트입니다.
읽는 시간 17분최근 업데이트: 9일 전

추가 커맨드 라인 인자 Unity 에디터 플레이어를 실행하여 시작 동작을 제어하거나 설정을 구성하거나 워크플로를 자동화할 수 있습니다.
이러한 인자를 사용하려면 터미널 또는 명령 프롬프트에서 실행할 때 Unity 실행 파일 경로에 추가하십시오. 예:
unity.exe -batchmode -quit -executeMethod MyClass.MyMethod
자세한 내용은 커맨드 라인 인터페이스에서 Unity 실행을 참고하십시오.

구성 인자

시작 시 추가 커맨드와 정보를 사용하여 Unity 에디터 실행하고 Unity 애플리케이션을 빌드할 수 있습니다. 이 페이지에는 Unity 에디터 및 Unity 플레이어 인스턴스를 실행하고 설정하는 데 사용할 수 있는 커맨드 라인 인자 나열되어 있습니다.

명령

설명

-createProject <pathname>
주어진 경로에 빈 프로젝트를 만듭니다.
-cloneFromTemplate <template-path>
-cloneFromTemplate
를
-createProject
와 함께 사용하여
-createProject
에서 지정한 경로에 새 프로젝트를 만들고,
-cloneFromTemplate
에서 지정한 템플릿 아카이브 또는 디렉토리를 사용합니다.

예시(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
에디터 시작 시 임포터 일관성 검사를 수행합니다. 기본적으로 Unity는 모든 자산을 로컬로 다시 임포트해야 하는
local
검사를 수행합니다. 또한 임포트가 이전 임포트와 다른지 확인합니다.

참고: 정합성 검사 모드는 Unity Accelerator에 업로드를 비활성화하며 임포터 출력이 결정론적인지 테스트하는 데 사용됩니다. 자세한 내용은
-consistencyCheckSourceMode
에 대한 설명을 참고하십시오.
-consistencyCheckSourceMode string
Unity 에셋 임포트를 비교할 때 확인할 소스를 설정합니다. 다음 값 중에서 선택할 수 있습니다.
  • local
    : 로컬에서 모든 에셋을 강제로 다시 임포트하고 임포트가 이전 임포트와 다른지 확인합니다.
  • cacheserver
    : Unity Accelerator를 활성화한 경우 이 옵션은 캐시 서버에서 에셋 메타데이터를 가져오고 결과가 캐시 서버의 결과와 로컬에서 일치하는지 비교합니다. 이 옵션은 캐시 서버 존재하는 에셋만 다시 임포트합니다. 정합성 검사가 성공하면 원래 임포트 결과가 유지되고 결과가 정합적이고 이미 캐시되었기 때문에 업로드할 필요가 없습니다. 확인이 실패하면 어떤 임포트가 실패했는지에 대한 자세한 내용이 포함된 에디터 로그 메시지가 기록됩니다. 캐시 중독을 방지하기 위해 일관되지 않는 결과가 업로드되지 않습니다.
자세한 내용은 임포터의 일관성 검사를 참고하십시오.
-disable-assembly-updater <assembly1 assembly2>
자동 업데이트 시 Unity 무시할 수 있는 파라미터로 어셈블리 이름의 공백 구분 목록을 지정합니다.

스페이스로 구분된 어셈블리 이름 목록은 선택 사항입니다. 예제 1와 같이 어셈블리 이름 없이 커맨드 라인 옵션을 전달하여 모든 어셈블리를 무시합니다.

예제 1
unity.exe -disable-assembly-updater


예제 2
unity.exe -disable-assembly-updater A1.dll subfolder/A2.dll


예제 2에는 두 개의 어셈블리 이름이 있으며 하나는 경로 이름입니다. 예제 2는 저장된 폴더에 관계없이
A1.dll
를 무시하고
subfolder
폴더에 저장된 경우에만
A2.dll
를 무시합니다.

어셈블리를
-disable-assembly-updater
커맨드 라인 파라미터에 나열하거나 어셈블리를 지정하지 않으면 Unity는 다음 메시지를 Editor.log에 기록합니다.

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


어셈블리를 임포트할 때 불필요한 API 업데이터 오버헤드를 방지하려면 이 옵션을 사용합니다.

이 인자는 업데이트할 필요가 없는 Unity API 액세스하는 어셈블리를 임포트하려는 경우에 유용합니다. Unity API에 액세스하지 않는 어셈블리를 임포트하는 경우에도 유용합니다. 예를 들어 Unity 외부에서 소스 코드를 일부 또는 전부 빌드했으며 결과 어셈블리를 Unity 프로젝트 임포트하려는 경우도 마찬가지입니다.

참고:
  • 업데이트가 필요한 어셈블리의 업데이트를 비활성화하면 컴파일 시, 런타임 시 또는 둘 다 트래킹하기 어려운 오류가 발생할 수 있습니다.
  • 이 인수는 API 업데이터의 AssemblyUpdater 컴포넌트만 비활성화합니다. API 업데이터의 ScriptUpdater 컴포넌트는
    -accept-apiupdate
    인수 없이 배치 모드에서 에디터를 실행하지 않는 한 패키지를 포함하여 프로젝트의 코드에 대해 계속 실행됩니다. 자세한 내용은 배치 모드 인자를 참고하십시오.
-disable-gpu-skinning
시작 시 그래픽처리장치(GPU) 스키닝을 비활성화합니다.
-executeMethod <ClassName.MethodName>
또는
-executeMethod <NamespaceName.ClassName.MethodName>
Unity 프로젝트를 열고 옵션 에셋 서버 업데이트가 완료된 즉시 정적 메서드를 실행합니다. 연속적 통합, 유닛 테스트 수행, 빌드 생성, 데이터 준비 등의 작업에 사용할 수 있습니다.
-activeBuildProfile
가 제공된 경우, Unity는
-executeMethod
를 실행하기 전에 프로필의 스크립팅 정의를 사용하여 스크립트를 컴파일합니다.

커맨드 라인 프로세스에서 오류를 반환하려면 반환 코드 1로 Unity가 종료되는 예외를 발생시키거나 0이 아닌 반환 코드로
EditorApplication.Exit
를 호출합니다.

파라미터를 전달하려면 커맨드 라인에 추가하고
System.Environment.GetCommandLineArgs
를 사용하여 함수 내에서 가져옵니다.
-executeMethod
를 사용하려면 에디터 폴더에 둘러싸는 스크립트를 배치해야 합니다. 실행하는 메서드는 정적으로 정의되어야 합니다.
-exportPackage <exportAssetPath1 exportAssetPath2 ExportAssetPath3 exportFileName>
특정 경로 또는 특정 경로 세트로 패키지를 익스포트합니다. 이 예시에서
exportAssetPath
는 Unity 프로젝트에서 익스포트할 폴더(Unity 프로젝트 루트와 관련)이고
exportFileName
는 패키지 이름입니다. 이 옵션은 한 번에 전체 폴더만 익스포트합니다. 일반적으로 이 명령을
-projectPath
인수와 함께 사용해야 합니다.
-importPackage <pathname>
지정된 자산 패키지를 가져옵니다. Unity 임포트 다이얼로그를 표시하지 않습니다.
-job-worker-count <N>
Unity JobQueue 잡 워커 수의 최대 스레드 수를 지정합니다.
-gc-helper-count <N>
에셋 가비지 컬렉터 헬퍼 스레드의 수를 지정합니다. 기본값은 사용 가능한 코어 수입니다.
-logFile <pathname>
Unity 에디터 로그 파일을 작성할 파일 경로 위치를 지정합니다. 로그 파일의 기본 위치에 대한 자세한 내용은 로그 파일 레퍼런스를 참조하십시오. 콘솔로 출력하려면 경로 이름의
-
를 지정합니다. 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>
씬 또는 패키지 파일의 경로에서 프로젝트를 엽니다. 또는
-projectPath
인자를 사용할 수도 있습니다.
-password <password>
Unity 에디터 활성화 중에 로그인 양식에 비밀번호를 입력합니다.
-projectPath <pathname>
주어진 경로에서 프로젝트를 엽니다. 이 경로는 현재 작업 디렉토리에 대해 절대적이거나 상대적일 수 있습니다. 경로 이름에 공백이 있는 경우 따옴표로 둘러싸십시오.
-quit
다른 커맨드 실행이 완료된 후 Unity 에디터 종료합니다. 이렇게 하면 일부 오류 메시지가 숨겨지지만 에디터의 로그 파일에 계속 표시됩니다.
-quit
인수에는 다음과 같은 제한 사항이 있습니다.
  • 에디터가 액셀러레이터 캐시 서버에 연결된 경우 보류 중인 캐시 업로드가 완료되기 전에 Unity 종료를 방지하기 위해 추가 인수
    -cacheServerWaitForUploadCompletion
    가 필요합니다.
  • 에디터가
    -runTests
    인자를 사용하여 테스트를 실행 중인 경우,
    -quit
    는 진행 중인 테스트가 완료되기 전에 에디터가 즉시 종료합니다.
  • 에디터에서 비동기 코드를 실행 중인 경우,
    -quit
    로 인해 애플리케이션이 멈추고 응답하지 않습니다.
-quitTimeout
-quit
인자를 사용하면 에디터는 보류 중인 비동기 작업이 기본 시간 초과 300초로 완료될 때까지 기다립니다. 이 파라미터를 사용하여 초 단위로 다른 타임아웃을 설정합니다.
-releaseCodeOptimization
릴리스 코드 최적화 모드를 활성화하여 세션의 현재 기본 코드 최적화 모드를 오버라이드합니다.
Android만텍스처를 임포트하거나 프로젝트를 빌드하기 전에 기본 텍스처 압축을 원하는 포맷으로 설정합니다. 이렇게 하면 원하는 형식으로 텍스처를 다시 임포트할 필요가 없습니다. 사용 가능한 포맷은 dxt, PVRTC, atc 등등과 astc입니다. 텍스처 압축 타게팅이 활성화되면 이 인수는 무시됩니다.
참고: PVRTC 형식은 지원 중단 예정입니다. 대신 ASTC 또는 ETC 포맷을 사용합니다.
-overrideMaxTextureSize
Unity 에셋을 임포트할 때 적용하는 최대 텍스처 크기(픽셀 단위)를 오버라이드합니다. 이 설정은 프로젝트의 모든 텍스처에 영향을 미치며, 텍스처 임포트 설정에서 개별 텍스처에 대해 구성된 모든 Max Size를 오버라이드합니다. 값은 텍스처의 높이나 너비에 대한 최대 한도를 나타내는 정수입니다(최장값). 크기 조절 시 종횡비는 항상 유지됩니다. 예를 들어 텍스처가 2048x1024 픽셀이지만
-overrideMaxTextureSize
가 512로 설정된 경우 Unity는 텍스처 크기를 512x256 픽셀로 임포트합니다. 자세한 내용은
EditorUserBuildSettings.overrideMaxTextureSize
를 참조하십시오.
-overrideTextureCompression
Unity 에셋을 임포트할 때 사용하는 텍스처 압축 설정을 오버라이드합니다. 이는 텍스처 임포트 또는 빌드 타겟 전환 속도를 높이는 로컬 개발 중에 특히 유용합니다. 자세한 내용은
EditorUserBuildSettings.overrideTextureCompression
를 참조하십시오.
-silent-crashes
스탠드얼론 플레이어에서 크래시가 발생할 때 Unity 표시되는 다이얼로그를 방지합니다. 이 인자는 자동화된 빌드 또는 테스트에서 플레이어를 실행하려는 경우 유용합니다. 여기서 자동화를 방해하는 다이얼로그 프롬프트가 필요하지 않습니다.
-upmLogFile <pathname>
Unity 에디터와 독립적으로 실행되는 UPM 배경 애플리케이션용 로그 파일을 작성하는 경로와 파일 이름을 지정합니다. 같은 명령에서
-upmLogFile
및
-logFile
를 지정할 수 있습니다. 두 인자를 모두 포함하면 두 로그 파일에 대해 독립적인 경로를 지정할 수 있습니다.
-username <username>
Unity 에디터 활성화 중에 사용자 이름을 로그인 양식에 입력합니다.
-vcsMode <mode>
Version Control 모드를 설정합니다. 사용 가능한 모드는
"Visible Meta Files"
,
"Hidden Meta Files"
,
Perforce
및
PlasticSCM
입니다. 추가 플래그를 사용하여 주어진 Version Control 모드의 구성 필드를 작성할 수 있습니다. 이 플래그는 Provider.GetActiveConfigFields 메서드를 기반으로 합니다. 예를 들어
-vcPerforceUsername
,
-vcPerforcePassword
,
-vcPerforceWorkspace
및
-vcPerforceServer
를 사용하여 Perforce 사용자 이름, 작업 공간 및 서버 필드를 설정할 수 있습니다.

참고: 공백이 포함된
<mode>
인수는 더블따옴표()"로 래핑해야 합니다.
-vcsModeSession <mode>
이 세션의 Version Control 모드를 설정합니다. 사용 가능한 모드는
"Visible Meta Files"
,
"Hidden Meta Files"
,
Perforce
및
PlasticSCM
입니다. 추가 플래그를 사용하여 주어진 Version Control 모드의 구성 필드를 작성할 수 있습니다. 이 플래그는 Provider.GetActiveConfigFields 메서드를 기반으로 합니다. 예를 들어
-vcPerforceUsername
,
-vcPerforcePassword
,
-vcPerforceWorkspace
및
-vcPerforceServer
를 사용하여 Perforce 사용자 이름, 작업 공간 및 서버 필드를 설정할 수 있습니다.

참고: 공백이 포함된
<mode>
인수는 더블따옴표()"로 래핑해야 합니다.
-version
에디터를 실행하지 않고 커맨드 라인 Unity 에디터 버전 번호를 출력합니다.
-timestamps
모든 Editor.log 메시지를 현재 타임스탬프 및 스레드 ID로 접두사로 지정합니다.

배치 모드 인자

다음 인자를 사용하여 Unity 배치 모드를 설정합니다. 배치 모드를 사용하면 Unity 사용자 입력 없이 사전 정의된 작업을 실행할 수 있으므로 배치 모드는 테스트와 같은 자동화된 작업에 유용합니다.
중요
Unity 별도의 상업적 약관이 적용되지 않는 한, Unity 배치 모드로 사용하는 것은 해당하는 추가 약관을 포함하여 Unity 서비스 약관을 따릅니다. 자세한 내용은 Unity 서비스 약관의 최신 버전과 Unity 에디터 소프트웨어 약관을 포함한 추가 약관을 참조하십시오.

명령

설명

-accept-apiupdate
Unity가 배치 모드에서 실행될 때 이 커맨드 라인 옵션을 사용하여 API 업데이터를 실행합니다.

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


배치 모드에서 Unity 실행할 때 이 커맨드 라인 인자를 생략하면 API 업데이터가 실행되지 않습니다. 컴파일러 오류가 리드 수 있습니다.
-batchmode
Unity를 배치 모드 실행합니다. 배치 모드에서는 Unity가 사람의 상호 작용 없이 커맨드 라인 인자를 실행합니다. 또한 사람의 상호 작용이 필요한 대화창(예: 씬 저장 창)을 억제합니다. 커맨드 라인 인자 사용할 때는 항상 Unity 배치 모드로 실행해야 합니다. 이는 자동화를 중단 없이 실행할 수 있기 때문입니다.

스크립트 코드 실행 중에 예외가 발생하거나 에셋 서버 업데이트가 실패하거나 다른 작업이 실패하면 Unity는 즉시 코드 1을 반환하여 종료합니다.

배치 모드에서는 Unity 콘솔에 로그 출력의 최소 버전을 전송합니다. 그러나 로그 파일은 여전히 전체 로그 정보를 포함합니다. 에디터에 동일한 프로젝트가 열려 있는 동안 배치 모드에서 프로젝트를 열 수 없습니다. Unity 인스턴스는 한 번에 하나만 실행할 수 있습니다.

에디터 또는 스탠드얼론 플레이어가 배치 모드에서 실행 중인지 확인하려면 Application.isBatchMode 연산자를 사용하십시오.

-batchmode
를 사용할 때 프로젝트를 아직 임포트하지 않은 경우 타겟 플랫폼이 기본값입니다. 다른 플랫폼을 강제로 사용하려면
-buildTarget
옵션을 사용합니다.
‑ignorecompilererrors
이 인자를 사용하면 컴파일 오류가 있더라도 Unity 계속해서 애플리케이션을 시작합니다.
-nographics
배치 모드에서 실행하면 Unity 그래픽스 기기를 초기화하지 않습니다. 그러면 GPU가 없는 머신에서 자동화된 워크플로를 실행할 수 있습니다. 자동화된 워크플로는 창에 포커스가 있는 경우에만 작동하며, 그렇지 않으면 시뮬레이션된 입력 커맨드를
-nographics
전송할 수 없습니다. 인라이튼 실시간 전역 조명은 메타 패스 렌더링에 GPU가 필요하기 때문에 GI를 베이크할 수 없습니다(자세한 내용은 라이트매핑 및 셰이더 페이지의 메타 패스 섹션 참조).
참고: 출력 로그는 이 모드에서 꺼져 있습니다. 출력 로그 생성을 활성화하려면 커맨드
-logFile
를 사용하여 파일 위치를 지정합니다.

인자 빌드

다음 인자를 사용하여 커맨드 라인 다양한 플랫폼용 플레이어를 빌드합니다. 커맨드 라인에서 플레이어를 빌드하는 방법에 대한 자세한 내용은 커맨드 라인에서 빌드 만들기를 참조하십시오.

명령

설명

-activeBuildProfile <pathname>
주어진 경로에 저장된 빌드 프로파일을 활성 빌드 프로파일로 설정합니다(예:
-activeBuildProfile "Assets/Settings/Build Profiles/WindowsDemo.asset"
).

참고 사항
  • -activeBuildProfile <pathname>
    는 컴파일 전에 활성 빌드 프로파일의 빌드 데이터 섹션에 있는 커스텀 스크립팅 정의를 적용합니다. 이러한 스크립팅 정의는 현재 정의 세트에 추가되며, 프로젝트의 기존 스크립팅 정의를 오버라이드하거나 삭제하지 않습니다.
  • 빌드 프로파일 에셋의 경로는 프로젝트의 루트 폴더를 기준으로 해야 합니다.
  • -executeMethod
    와 함께 지정된 경우 Unity는 프로필의 스크립팅 정의를 적용하고 메서드를 호출하기 전에 스크립트 컴파일을 트리거합니다. 프로필의 정의는 현재 프로젝트 정의에 추가되며 이후의
    -executeMethod
    실행 중에 적용됩니다. 이는 단일 배치 세션에서 타겟 플랫폼 전환과 같은 CI/CD 워크플로를 활성화합니다.
-build <pathName>
activeBuildProfile <pathname>
에서 지정된 대상 경로로 플레이어를 빌드합니다. 일부 플랫폼의 경우 경로는 타겟 플랫폼에만 해당하는 파일 확장자로 끝나야 합니다. 예:
-build path/to/your/build.exe
확장 기능이 필요한 플랫폼에 대한 자세한 내용은 플랫폼 빌드 경로 참조를 참조하십시오.
-buildLinux64Player <pathname>
64비트 스탠드얼론 Linux 플레이어를 빌드합니다(예:
-buildLinux64Player path/to/your/build
).
-buildLinuxHeadlessSimulation <pathname>
64비트 Linux 헤드리스 시뮬레이션 플레이어를 빌드합니다(예:
-buildLinuxHeadlessSimulation path/to/your/build
).
-buildOSXUniversalPlayer <pathname>
64비트 스탠드얼론 macOS 플레이어를 빌드합니다(예:
-buildOSXUniversalPlayer path/to/your/build.app
).
-buildTarget <name>
에디터를 실행할 활성 빌드 타겟을 선택합니다. 사용 가능한 옵션은 에디터에서 활성화한 빌드 타겟에 따라 다릅니다. 이러한 옵션은 API 열거
BuildTarget
에서 사용 가능한 옵션에 해당합니다.
  • android
  • cloudrendering
  • ios
  • linux64
  • osxuniversal
  • tvos
  • visionos
  • windowsstoreapps
  • webgl
  • win
  • win64
닫힌 플랫폼에 액세스할 수 있는 개발자는 다른
-buildTarget
옵션을 사용할 수 있습니다. 자세한 내용은 타겟 플랫폼에 대한 기술 자료를 참고하십시오.
-buildWindowsPlayer <pathname>
32비트 스탠드얼론 Windows 플레이어를 빌드합니다(예:
-buildWindowsPlayer path/to/your/build.exe
).
-buildWindows64Player <pathname>
64비트 스탠드얼론 Windows 플레이어를 빌드합니다(예:
-buildWindows64Player path/to/your/build.exe
).
-standaloneBuildSubtarget <name>
프로젝트를 로드하기 전에 스탠드얼론 플랫폼용 액티브 빌드 하위 타겟을 선택합니다.
  • 플레이어
  • --server

Unity 액셀러레이터 캐시 서버 인자

다음 인자를 사용하여 Unity의 Unity Accelerator 캐시 서버 사용을 설정합니다. 이러한 인자는 에디터 환경 설정에 저장된 해당 구성을 오버라이드합니다.

명령

설명

-EnableCacheServer
Unity Accelerator를 활성화합니다. 또한
-cacheServerEndpoint <host:port>
를 사용하여 Unity 액셀러레이터 인스턴스의 주소를 지정해야 합니다.
-cacheServerEndpoint <host:port>
Unity 액셀러레이터 인스턴스의 엔드포인트 주소를 지정합니다.

예:
-cacheServerEndpoint 127.0.0.1:10080

기본 포트는
10080
이지만 설치 중에 변경할 수 있습니다.
-cacheServerNamespacePrefix <prefix>
Unity 액셀러레이터 인스턴스의 네임스페이스 접두사를 설정합니다. 네임스페이스 이름과 함께 이 인자를 사용하여 캐시 서버 데이터를 분리합니다. 예를 들어 다른 프로젝트나 Unity 버전에 대한 캐시 데이터를 분리할 수 있습니다.

예:
-cacheServerNamespacePrefix MyProject_Unity23LTS

공백을 포함하는 접두사는 더블 따옴표(
"
)로 묶어야 합니다.
제공된 이름은 메타데이터, 아티팩트 데이터, 셰이더 캐시 데이터 등 타입별로 데이터를 구분하는 캐시에서 최대 3개의 네임스페이스 대한 접두사로 사용됩니다.
-cacheServerEnableDownload true

-cacheServerEnableDownload false
Unity 액셀러레이터 인스턴스에서 다운로드를 활성화하거나 비활성화합니다.
-cacheServerEnableUpload true

-cacheServerEnableUpload false
Unity 액셀러레이터 인스턴스에 업로드를 활성화하거나 비활성화합니다.

예:
-cacheServerEnableUpload true
-cacheServerWaitForConnection <ms>
초기 프로젝트 새로고침을 시작하기 전에 Unity 프로젝트를 로드하는 동안 Unity 액셀러레이터 인스턴스에 대한 연결을 기다리는 시간을 밀리초 단위로 지정합니다.

예:
-cacheServerWaitForConnection 5000
-cacheServerWaitForUploadCompletion
보류 중인 Unity 액셀러레이터 업로드가 완료될 때까지 Unity 닫히지 않도록 합니다. Unity 액셀러레이터를 커맨드 라인 인자
-quit
와 함께 사용하는 경우, 다른 스크립팅된 명령이 실행을 마친 후 Unity 에디터를 닫는 것이 좋습니다.
-cacheServerDownloadBatchSize <batchSize>
개별 캐시 서버 다운로드 배치의 아티팩트 수를 설정합니다. 다운로드 배치는 개별 다운로드를 더 큰 배치로 그룹화하여 다운로드 작업의 수를 줄이는 데 사용되는 최적화입니다.

예:
-cacheServerDownloadBatchSize 256

기본값은
128
입니다.
-cacheServerUploadExistingImports
Unity 새 임포트를 Unity 액셀러레이터 인스턴스에 업로드하기 시작하면 이전에 업로드되지 않은 기존 임포트를 업로드합니다. 이전에 업로드한 임포트는 다시 업로드되지 않습니다.
-cacheServerUploadAllRevisions
Unity 새 임포트를 Unity 액셀러레이터 인스턴스에 업로드하기 시작할 때 이전에 업로드되지 않은 에셋 데이터베이스에 알려진 모든 이전 리비전을 포함한 기존 임포트를 업로드합니다. 이전에 업로드된 임포트 리비전은 다시 업로드되지 않습니다.
-cacheServerUploadExistingShaderCache
Unity 캐시 서버 새 임포트를 업로드하기 시작하면 이전에 업로드되지 않은 기존 셰이더 캐시 임포트를 업로드합니다. 이전에 업로드한 셰이더 임포트는 다시 업로드되지 않습니다.

인자 디버깅

명령

설명

-disableManagedDebugger
디버거 리스닝 소켓을 비활성화합니다.
-diag-debug-shader-compiler
Unity는 셰이더 컴파일러의 인스턴스 하나만 실행하고 타임아웃을 1시간으로 설정합니다. 셰이더 컴파일러 문제 디버깅에 유용합니다.
-debugCodeOptimization
디버그 코드 최적화 모드를 활성화하여 세션의 현재 기본 코드 최적화 모드를 오버라이드합니다.
-enableCodeCoverage
Code Coverage를 활성화하고 Coverage API에 대한 액세스를 허용합니다.
-force-d3d12-debug
DX12 확인 레이어를 활성화합니다. 이는 XR 플러그인 또는 네이티브 플러그인 작업에 유용합니다.
-force-d3d12-debug-gbv
DX12 GPU 기반 확인을 활성화합니다. 이는 XR 플러그인 또는 네이티브 플러그인 작업에 유용합니다.
-force-vulkan-layers
Vulkan 확인 레이어를 활성화합니다. 이는 XR 플러그인 또는 네이티브 플러그인 작업에 유용합니다.
-stackTraceLogType
자세한 디버깅을 허용합니다. 모든 설정에서 None, Script Only 및 Full을 선택할 수 있습니다(예:
-stackTraceLogType Full
).
-log-memory-performance-stats
에디터를 닫을 때 메인 Unity 에디터 로그 파일에 자세한 메모리 및 성능 보고서를 추가합니다.
-wait-for-managed-debugger
실행하기 전에 에디터가 관리되는 디버거가 연결될 때까지 기다립니다. 에디터의 프로세스 ID를 표시하는 다이얼로그를 생성합니다. 관리형 디버깅에 대한 자세한 내용은 Unity에서 C# 코드 디버그를 참고하십시오.
-wait-for-native-debugger
실행하기 전에 에디터가 네이티브 디버거가 연결될 때까지 기다립니다. 에디터의 프로세스 ID를 표시하는 다이얼로그를 생성합니다.

그래픽스 API 인자

다음 인자를 사용하여 Unity 에디터 특정 그래픽스 API 사용하도록 합니다.

명령

설명

-force-clamped
이를
-force-glcoreXY
와 함께 사용하여 Unity가 추가 OpenGL 확장 기능을 확인하지 않도록 하여 동일한 코드 경로를 가진 플랫폼 간에 실행할 수 있습니다. 이 접근 방식은 문제가 플랫폼별인지 확인하는 데 도움이 됩니다. 예를 들면 드라이버 버그입니다.
-force-d3d11
(Windows 전용)
렌더링 시 에디터가 Direct3D 11을 사용하도록 합니다. 일반적으로 그래픽스 API는 플레이어 설정에 따라 달라집니다(일반적으로 기본값은 D3D11).
-force-d3d12
(Windows 전용)
렌더링 시 에디터가 Direct3D 12를 사용하도록 만듭니다. 일반적으로 그래픽스 API는 플레이어 설정에 따라 달라집니다.
-force-device-index
에디터가 해당 GPU의 인덱스를 전달하여 특정 GPU 기기를 사용하도록 합니다. 예를 들어 에디터가 전용 GPU 대신 통합 GPU를 사용하도록 만들 때 사용합니다. GPU 인덱스와 물리적 GPU 간 매핑은 시스템에서 GPU가 열거되는 순서에 따라 결정됩니다. 일반적으로 이 열거는 사용 중인 GPU 드라이버 또는 기본 프레임워크(예: Metal, Direct3D 또는 Vulkan)에 의해 수행됩니다. 일반적으로 인덱스
0
는 기본 모니터에 연결된 GPU입니다. 데스크톱 컴퓨터에서는 보통 전용 GPU이고 노트북에서는 통합 GPU입니다. 따라서 데스크톱 컴퓨터에서
-force-device-index=0
는 일반적으로 전용 그래픽 카드입니다.
-force-glcore
렌더링 시 에디터가 OpenGL 3/4 코어 프로파일을 사용하도록 만듭니다. 에디터는 사용 가능한 최적의 OpenGL 버전과 OpenGL 드라이버에 의해 노출되는 모든 OpenGL 확장자를 사용하려고 시도합니다. 플랫폼이 지원되지 않는 경우 에디터는 Direct3D를 사용합니다.
-force-glcoreXY
이와 유사하지만
-force-glcore
특정 OpenGL 컨텍스트 버전을 요청합니다. XY에 허용되는 값: 32, 33, 40, 41, 42, 43, 44, 45 플랫폼이 특정 버전의 OpenGL을 지원하지 않는 경우 Unity 지원되는 버전으로 폴백합니다.
-force-gles
(Windows 전용)
렌더링 시 에디터가 OpenGL for Embedded Systems를 사용하도록 합니다. 에디터는 사용 가능한 최적의 OpenGL ES 버전과 OpenGL 드라이버에 의해 노출되는 모든 OpenGL ES 확장자를 사용하려고 시도합니다.
-force-glesXY
(Windows 전용)
-force-gles
와 유사하지만 특정 OpenGL ES 컨텍스트 버전을 요청합니다. XY에 허용되는 값: 30, 31, 31aep 또는 32입니다. 플랫폼이 특정 버전의 OpenGL ES를 지원하지 않는 경우 Unity 지원되는 버전으로 폴백합니다. 플랫폼이 OpenGL ES를 지원하지 않으면 Unity 다른 그래픽스 API 폴백합니다.
-force-opengl
에디터가 레거시 OpenGL 백엔드를 사용하도록 만듭니다.
-force-vulkan
에디터가 렌더링에 Vulkan을 사용하도록 만듭니다. 일반적으로 그래픽스 API는 플레이어 설정에 따라 달라집니다.

라이선스 인자

다음 인자를 사용하여 Unity 라이선스 처리하거나 다른 라이선스 옵션으로 Unity 에디터 실행합니다.

명령

설명

-createManualActivationFile
Unity 라이선스를 수동으로 활성화하는 세 단계 프로세스 중 하나입니다. 자세한 내용은 수동 라이선스 활성화를 참조하십시오.
-manualLicenseFile <yourulffile>
Unity 라이선스를 수동으로 활성화하는 세 단계 프로세스의 세 번째 단계입니다. 자세한 내용은 수동 라이선스 활성화를 참조하십시오.
-returnlicense
현재 활성화된 시리얼 기반 또는 이름이 지정된 사용자 라이선스 반환합니다. 플로팅 라이선스를 반환하는 데
-returnlicense
를 사용하지 마십시오. 자세한 내용은 라이선스 반환을 참고하십시오. 라이센싱 모델에 대한 자세한 내용은 라이센싱 개요를 참조하십시오.
-serial <serial-key>
유료 Unity 라이선스 활성화합니다. 시리얼 기반 라이선스를 활성화하거나 이름이 지정된 사용자 라이선스와 시리얼 키를 동시에 활성화하려면
<serial-key>
값을 포함합니다. 일련 키를 활성화하지 않고 명명된 사용자 라이선스를 활성화하려면
<serial-key>
값을 제외합니다. 자세한 내용은 커맨드 라인에서 라이선스 활성화를 참고하십시오. 라이센싱 모델에 대한 자세한 내용은 라이센싱 개요를 참조하십시오.

참고:
-serial
인수를 사용하는 경우에는
-batchmode
인수를 사용해야 합니다. 또한
-quit
인자를 지정하는 것이 좋습니다.

Metal 인자(macOS 전용)

다음 인자를 사용하여 Unity의 Apple 기기용 Metal 그래픽스 API 사용을 설정합니다.

명령

세부 정보

-force-low-power-device
(macOS 전용)
Metal을 사용하는 경우 에디터가 저전력 기기를 사용하도록 합니다.
-force-metal
에디터가 Metal을 기본 그래픽스 API 사용하도록 합니다(macOS 전용).
-enable-metal-capture
에디터 내에서 Metal 캡처를 가져오는 기능을 활성화합니다.

프로파일러 인자

다음 인자를 사용하여 Unity의 프로파일러 사용을 설정합니다.

명령

설명

-deepprofiling
CPU 프로파일러에 대해 세부 프로파일링 옵션을 활성화합니다.
-profiler-enable
플레이어 또는 에디터의 시작을 프로파일링합니다. 이 인수를 플레이어와 함께 사용하면 빌드 프로파일에서 활성화된 자동 연결 프로파일러 옵션을 사용하여 플레이어를 빌드하는 것과 동일한 효과가 있습니다.

에디터에서 이 인자를 사용하면 에디터 시작 시 프로파일러 창 프로파일러 정보를 수집하고 표시합니다.
-profiler-log-file <Path/To/Log/File.raw>
이 인자는 시작 시 프로필 데이터를 .raw 파일로 스트리밍하도록 Unity 프로파일러를 설정합니다. 플레이어와 에디터 모두에서 작동합니다.
-profiler-capture-frame-count <NumberOfFrames>
이 인자는 시작 시 .raw 파일로 스트리밍할 때 프로파일러가 프로파일에서 캡처해야 하는 프레임 수를 설정합니다. 플레이어에서만 작동합니다
-profiler-maxusedmemory
기본적으로 Unity 프로파일러의
maxUsedMemory
는 플레이어의 경우 16MB이고 에디터의 경우 256MB입니다. 이 인자를 사용하여 시작 시
maxUsedMemory
파라미터를 커스텀 크기로 설정할 수 있습니다(예:
-profiler-maxusedmemory 16777216
). 크기는 바이트 단위로 설정됩니다.

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

특별한 상황이나 Unity 지원 부서의 지시를 받는 경우에만 사용하십시오.

명령

설명

-enableIncompatibleAssetDowngrade
최신 버전의 Unity에서 작동하도록 다운그레이드하려는 최신 버전의 Unity에서 만든 에셋이 있는 경우에 사용합니다.
이 설정을 활성화하면 Unity 필요한 프로젝트를 열려고 할 때 이 다운그레이드 확인을 요청하는 다이얼로그를 표시합니다.

참고: 이 절차는 지원되지 않으며 매우 위험하며, 최후의 수단으로만 사용해야 합니다.
-giCustomCacheLocation
전역 조명(GI) 캐시 폴더의 커스텀 위치를 설정합니다. 값은 절대 경로여야 하며 공백이 포함된 경우 따옴표로 묶어야 합니다.
-giCustomCacheLocation
가 설정된 경우 현재 에디터 세션의 값은 이전에 GI 캐시 환경 설정에 정의된 사용자 지정 캐시 폴더 위치를 오버라이드합니다. 이 값은 에디터가 종료된 후에도 유지되지 않습니다.
-rebuildLibrary
이 절차는 모든 에셋의 전체 재임포트를 트리거하는
Library
프로젝트 하위 디렉토리를 삭제합니다. Unity 프로젝트 초기화 중에 데이터베이스 손상 오류를 리포트할 때 사용합니다.

Unity Hub 특수 커맨드 라인 인자

특별한 상황이나 Unity 지원 부서의 지시를 받는 경우에만 사용하십시오. 이 인자는 Unity Hub 기본적으로 사용하지 않는 Unity 에디터 버전에서 사용됩니다.

명령

설명

-useHub
Unity 에디터 Hub 통합으로 실행합니다.
-hubIPC
Unity 에디터 Unity Hub 간 커뮤니케이션 및 상호 작용을 활성화합니다.
-hubSessionId
Unity Hub 세션에 대한 고유 식별자를 지정합니다.
지원되는 모든 Unity 에디터 버전에서는 기본적으로 이러한 인수가 설정되어 있습니다.

추가 리소스