Unity 에디터 커맨드 라인 인자 참조
커맨드 라인 Unity 에디터 버전을 실행할 때 사용할 수 있는 인자 리스트입니다.
읽는 시간 17분최근 업데이트: 9일 전
추가 커맨드 라인 인자 Unity 에디터 플레이어를 실행하여 시작 동작을 제어하거나 설정을 구성하거나 워크플로를 자동화할 수 있습니다.
이러한 인자를 사용하려면 터미널 또는 명령 프롬프트에서 실행할 때 Unity 실행 파일 경로에 추가하십시오. 예:
unity.exe -batchmode -quit -executeMethod MyClass.MyMethod자세한 내용은 커맨드 라인 인터페이스에서 Unity 실행을 참고하십시오.
- 설정 인자
- 배치 모드 인자
- 빌드 인자
- Unity 액셀러레이터 캐시 서버 인자
- 디버깅 인자
- 그래픽스 API 인자
- 라이선스 인자
- Metal 인자(macOS 전용)
- 프로파일러 인자
- Unity 에디터 특수 커맨드 라인 인자
- Unity Hub 특수 커맨드 라인 인자
- 추가 리소스
구성 인자
시작 시 추가 커맨드와 정보를 사용하여 Unity 에디터 실행하고 Unity 애플리케이션을 빌드할 수 있습니다. 이 페이지에는 Unity 에디터 및 Unity 플레이어 인스턴스를 실행하고 설정하는 데 사용할 수 있는 커맨드 라인 인자 나열되어 있습니다.
명령 | 설명 |
|---|---|
| 주어진 경로에 빈 프로젝트를 만듭니다. |
| 예시(Windows): 예시(macOS): 예시(Linux): |
| 에디터 시작 시 임포터 일관성 검사를 수행합니다. 기본적으로 Unity는 모든 자산을 로컬로 다시 임포트해야 하는 참고: 정합성 검사 모드는 Unity Accelerator에 업로드를 비활성화하며 임포터 출력이 결정론적인지 테스트하는 데 사용됩니다. 자세한 내용은 |
| Unity 에셋 임포트를 비교할 때 확인할 소스를 설정합니다. 다음 값 중에서 선택할 수 있습니다.
|
| 자동 업데이트 시 Unity 무시할 수 있는 파라미터로 어셈블리 이름의 공백 구분 목록을 지정합니다. 스페이스로 구분된 어셈블리 이름 목록은 선택 사항입니다. 예제 1와 같이 어셈블리 이름 없이 커맨드 라인 옵션을 전달하여 모든 어셈블리를 무시합니다. 예제 1 예제 2 예제 2에는 두 개의 어셈블리 이름이 있으며 하나는 경로 이름입니다. 예제 2는 저장된 폴더에 관계없이 어셈블리를 어셈블리를 임포트할 때 불필요한 API 업데이터 오버헤드를 방지하려면 이 옵션을 사용합니다. 이 인자는 업데이트할 필요가 없는 Unity API 액세스하는 어셈블리를 임포트하려는 경우에 유용합니다. Unity API에 액세스하지 않는 어셈블리를 임포트하는 경우에도 유용합니다. 예를 들어 Unity 외부에서 소스 코드를 일부 또는 전부 빌드했으며 결과 어셈블리를 Unity 프로젝트 임포트하려는 경우도 마찬가지입니다. 참고:
|
| 시작 시 그래픽처리장치(GPU) 스키닝을 비활성화합니다. |
| Unity 프로젝트를 열고 옵션 에셋 서버 업데이트가 완료된 즉시 정적 메서드를 실행합니다. 연속적 통합, 유닛 테스트 수행, 빌드 생성, 데이터 준비 등의 작업에 사용할 수 있습니다. 커맨드 라인 프로세스에서 오류를 반환하려면 반환 코드 1로 Unity가 종료되는 예외를 발생시키거나 0이 아닌 반환 코드로 파라미터를 전달하려면 커맨드 라인에 추가하고 |
| 특정 경로 또는 특정 경로 세트로 패키지를 익스포트합니다. 이 예시에서 |
| 지정된 자산 패키지를 가져옵니다. Unity 임포트 다이얼로그를 표시하지 않습니다. |
| Unity JobQueue 잡 워커 수의 최대 스레드 수를 지정합니다. |
| 에셋 가비지 컬렉터 헬퍼 스레드의 수를 지정합니다. 기본값은 사용 가능한 코어 수입니다. |
| Unity 에디터 로그 파일을 작성할 파일 경로 위치를 지정합니다. 로그 파일의 기본 위치에 대한 자세한 내용은 로그 파일 레퍼런스를 참조하십시오. 콘솔로 출력하려면 경로 이름의 예시(Windows): 예시(macOS): 예시(Linux): UPM 백그라운드 애플리케이션의 로그 파일 위치를 지정하려면 |
| Unity 패키지 관리자를 비활성화합니다. |
| 씬 또는 패키지 파일의 경로에서 프로젝트를 엽니다. 또는 |
| Unity 에디터 활성화 중에 로그인 양식에 비밀번호를 입력합니다. |
| 주어진 경로에서 프로젝트를 엽니다. 이 경로는 현재 작업 디렉토리에 대해 절대적이거나 상대적일 수 있습니다. 경로 이름에 공백이 있는 경우 따옴표로 둘러싸십시오. |
| 다른 커맨드 실행이 완료된 후 Unity 에디터 종료합니다. 이렇게 하면 일부 오류 메시지가 숨겨지지만 에디터의 로그 파일에 계속 표시됩니다.
|
| |
| 릴리스 코드 최적화 모드를 활성화하여 세션의 현재 기본 코드 최적화 모드를 오버라이드합니다. |
| Android만 | 텍스처를 임포트하거나 프로젝트를 빌드하기 전에 기본 텍스처 압축을 원하는 포맷으로 설정합니다. 이렇게 하면 원하는 형식으로 텍스처를 다시 임포트할 필요가 없습니다. 사용 가능한 포맷은 dxt, PVRTC, atc 등등과 astc입니다. 텍스처 압축 타게팅이 활성화되면 이 인수는 무시됩니다. 참고: PVRTC 형식은 지원 중단 예정입니다. 대신 ASTC 또는 ETC 포맷을 사용합니다. |
| Unity 에셋을 임포트할 때 적용하는 최대 텍스처 크기(픽셀 단위)를 오버라이드합니다. 이 설정은 프로젝트의 모든 텍스처에 영향을 미치며, 텍스처 임포트 설정에서 개별 텍스처에 대해 구성된 모든 Max Size를 오버라이드합니다. 값은 텍스처의 높이나 너비에 대한 최대 한도를 나타내는 정수입니다(최장값). 크기 조절 시 종횡비는 항상 유지됩니다. 예를 들어 텍스처가 2048x1024 픽셀이지만 |
| Unity 에셋을 임포트할 때 사용하는 텍스처 압축 설정을 오버라이드합니다. 이는 텍스처 임포트 또는 빌드 타겟 전환 속도를 높이는 로컬 개발 중에 특히 유용합니다. 자세한 내용은 |
| 스탠드얼론 플레이어에서 크래시가 발생할 때 Unity 표시되는 다이얼로그를 방지합니다. 이 인자는 자동화된 빌드 또는 테스트에서 플레이어를 실행하려는 경우 유용합니다. 여기서 자동화를 방해하는 다이얼로그 프롬프트가 필요하지 않습니다. |
| Unity 에디터와 독립적으로 실행되는 UPM 배경 애플리케이션용 로그 파일을 작성하는 경로와 파일 이름을 지정합니다. 같은 명령에서 |
| Unity 에디터 활성화 중에 사용자 이름을 로그인 양식에 입력합니다. |
| Version Control 모드를 설정합니다. 사용 가능한 모드는 참고: 공백이 포함된 |
| 이 세션의 Version Control 모드를 설정합니다. 사용 가능한 모드는 참고: 공백이 포함된 |
| 에디터를 실행하지 않고 커맨드 라인 Unity 에디터 버전 번호를 출력합니다. |
| 모든 Editor.log 메시지를 현재 타임스탬프 및 스레드 ID로 접두사로 지정합니다. |
배치 모드 인자
다음 인자를 사용하여 Unity 배치 모드를 설정합니다. 배치 모드를 사용하면 Unity 사용자 입력 없이 사전 정의된 작업을 실행할 수 있으므로 배치 모드는 테스트와 같은 자동화된 작업에 유용합니다.
명령 | 설명 |
|---|---|
| Unity가 배치 모드에서 실행될 때 이 커맨드 라인 옵션을 사용하여 API 업데이터를 실행합니다. 예: 배치 모드에서 Unity 실행할 때 이 커맨드 라인 인자를 생략하면 API 업데이터가 실행되지 않습니다. 컴파일러 오류가 리드 수 있습니다. |
| Unity를 배치 모드 실행합니다. 배치 모드에서는 Unity가 사람의 상호 작용 없이 커맨드 라인 인자를 실행합니다. 또한 사람의 상호 작용이 필요한 대화창(예: 씬 저장 창)을 억제합니다. 커맨드 라인 인자 사용할 때는 항상 Unity 배치 모드로 실행해야 합니다. 이는 자동화를 중단 없이 실행할 수 있기 때문입니다. 스크립트 코드 실행 중에 예외가 발생하거나 에셋 서버 업데이트가 실패하거나 다른 작업이 실패하면 Unity는 즉시 코드 1을 반환하여 종료합니다. 배치 모드에서는 Unity 콘솔에 로그 출력의 최소 버전을 전송합니다. 그러나 로그 파일은 여전히 전체 로그 정보를 포함합니다. 에디터에 동일한 프로젝트가 열려 있는 동안 배치 모드에서 프로젝트를 열 수 없습니다. Unity 인스턴스는 한 번에 하나만 실행할 수 있습니다. 에디터 또는 스탠드얼론 플레이어가 배치 모드에서 실행 중인지 확인하려면 Application.isBatchMode 연산자를 사용하십시오. |
| 이 인자를 사용하면 컴파일 오류가 있더라도 Unity 계속해서 애플리케이션을 시작합니다. |
| 배치 모드에서 실행하면 Unity 그래픽스 기기를 초기화하지 않습니다. 그러면 GPU가 없는 머신에서 자동화된 워크플로를 실행할 수 있습니다. 자동화된 워크플로는 창에 포커스가 있는 경우에만 작동하며, 그렇지 않으면 시뮬레이션된 입력 커맨드를 참고: 출력 로그는 이 모드에서 꺼져 있습니다. 출력 로그 생성을 활성화하려면 커맨드 |
인자 빌드
다음 인자를 사용하여 커맨드 라인 다양한 플랫폼용 플레이어를 빌드합니다. 커맨드 라인에서 플레이어를 빌드하는 방법에 대한 자세한 내용은 커맨드 라인에서 빌드 만들기를 참조하십시오.
명령 | 설명 |
|---|---|
| 주어진 경로에 저장된 빌드 프로파일을 활성 빌드 프로파일로 설정합니다(예: 참고 사항
|
| |
| 64비트 스탠드얼론 Linux 플레이어를 빌드합니다(예: |
| 64비트 Linux 헤드리스 시뮬레이션 플레이어를 빌드합니다(예: |
| 64비트 스탠드얼론 macOS 플레이어를 빌드합니다(예: |
| 에디터를 실행할 활성 빌드 타겟을 선택합니다. 사용 가능한 옵션은 에디터에서 활성화한 빌드 타겟에 따라 다릅니다. 이러한 옵션은 API 열거
|
| 32비트 스탠드얼론 Windows 플레이어를 빌드합니다(예: |
| 64비트 스탠드얼론 Windows 플레이어를 빌드합니다(예: |
| 프로젝트를 로드하기 전에 스탠드얼론 플랫폼용 액티브 빌드 하위 타겟을 선택합니다.
|
Unity 액셀러레이터 캐시 서버 인자
다음 인자를 사용하여 Unity의 Unity Accelerator 캐시 서버 사용을 설정합니다. 이러한 인자는 에디터 환경 설정에 저장된 해당 구성을 오버라이드합니다.
명령 | 설명 |
|---|---|
| Unity Accelerator를 활성화합니다. 또한 |
| Unity 액셀러레이터 인스턴스의 엔드포인트 주소를 지정합니다. 예: 기본 포트는 |
| Unity 액셀러레이터 인스턴스의 네임스페이스 접두사를 설정합니다. 네임스페이스 이름과 함께 이 인자를 사용하여 캐시 서버 데이터를 분리합니다. 예를 들어 다른 프로젝트나 Unity 버전에 대한 캐시 데이터를 분리할 수 있습니다. 예: 공백을 포함하는 접두사는 더블 따옴표( 제공된 이름은 메타데이터, 아티팩트 데이터, 셰이더 캐시 데이터 등 타입별로 데이터를 구분하는 캐시에서 최대 3개의 네임스페이스 대한 접두사로 사용됩니다. |
| Unity 액셀러레이터 인스턴스에서 다운로드를 활성화하거나 비활성화합니다. |
| Unity 액셀러레이터 인스턴스에 업로드를 활성화하거나 비활성화합니다. 예: |
| 초기 프로젝트 새로고침을 시작하기 전에 Unity 프로젝트를 로드하는 동안 Unity 액셀러레이터 인스턴스에 대한 연결을 기다리는 시간을 밀리초 단위로 지정합니다. 예: |
| 보류 중인 Unity 액셀러레이터 업로드가 완료될 때까지 Unity 닫히지 않도록 합니다. Unity 액셀러레이터를 커맨드 라인 인자 |
| 개별 캐시 서버 다운로드 배치의 아티팩트 수를 설정합니다. 다운로드 배치는 개별 다운로드를 더 큰 배치로 그룹화하여 다운로드 작업의 수를 줄이는 데 사용되는 최적화입니다. 예: 기본값은 |
| Unity 새 임포트를 Unity 액셀러레이터 인스턴스에 업로드하기 시작하면 이전에 업로드되지 않은 기존 임포트를 업로드합니다. 이전에 업로드한 임포트는 다시 업로드되지 않습니다. |
| Unity 새 임포트를 Unity 액셀러레이터 인스턴스에 업로드하기 시작할 때 이전에 업로드되지 않은 에셋 데이터베이스에 알려진 모든 이전 리비전을 포함한 기존 임포트를 업로드합니다. 이전에 업로드된 임포트 리비전은 다시 업로드되지 않습니다. |
| Unity 캐시 서버 새 임포트를 업로드하기 시작하면 이전에 업로드되지 않은 기존 셰이더 캐시 임포트를 업로드합니다. 이전에 업로드한 셰이더 임포트는 다시 업로드되지 않습니다. |
인자 디버깅
명령 | 설명 |
|---|---|
| 디버거 리스닝 소켓을 비활성화합니다. |
| Unity는 셰이더 컴파일러의 인스턴스 하나만 실행하고 타임아웃을 1시간으로 설정합니다. 셰이더 컴파일러 문제 디버깅에 유용합니다. |
| 디버그 코드 최적화 모드를 활성화하여 세션의 현재 기본 코드 최적화 모드를 오버라이드합니다. |
| Code Coverage를 활성화하고 Coverage API에 대한 액세스를 허용합니다. |
| DX12 확인 레이어를 활성화합니다. 이는 XR 플러그인 또는 네이티브 플러그인 작업에 유용합니다. |
| DX12 GPU 기반 확인을 활성화합니다. 이는 XR 플러그인 또는 네이티브 플러그인 작업에 유용합니다. |
| Vulkan 확인 레이어를 활성화합니다. 이는 XR 플러그인 또는 네이티브 플러그인 작업에 유용합니다. |
| 자세한 디버깅을 허용합니다. 모든 설정에서 None, Script Only 및 Full을 선택할 수 있습니다(예: |
| 에디터를 닫을 때 메인 Unity 에디터 로그 파일에 자세한 메모리 및 성능 보고서를 추가합니다. |
| 실행하기 전에 에디터가 관리되는 디버거가 연결될 때까지 기다립니다. 에디터의 프로세스 ID를 표시하는 다이얼로그를 생성합니다. 관리형 디버깅에 대한 자세한 내용은 Unity에서 C# 코드 디버그를 참고하십시오. |
| 실행하기 전에 에디터가 네이티브 디버거가 연결될 때까지 기다립니다. 에디터의 프로세스 ID를 표시하는 다이얼로그를 생성합니다. |
그래픽스 API 인자
다음 인자를 사용하여 Unity 에디터 특정 그래픽스 API 사용하도록 합니다.
명령 | 설명 |
|---|---|
| 이를 |
| 렌더링 시 에디터가 Direct3D 11을 사용하도록 합니다. 일반적으로 그래픽스 API는 플레이어 설정에 따라 달라집니다(일반적으로 기본값은 D3D11). |
| 렌더링 시 에디터가 Direct3D 12를 사용하도록 만듭니다. 일반적으로 그래픽스 API는 플레이어 설정에 따라 달라집니다. |
| 에디터가 해당 GPU의 인덱스를 전달하여 특정 GPU 기기를 사용하도록 합니다. 예를 들어 에디터가 전용 GPU 대신 통합 GPU를 사용하도록 만들 때 사용합니다. GPU 인덱스와 물리적 GPU 간 매핑은 시스템에서 GPU가 열거되는 순서에 따라 결정됩니다. 일반적으로 이 열거는 사용 중인 GPU 드라이버 또는 기본 프레임워크(예: Metal, Direct3D 또는 Vulkan)에 의해 수행됩니다. 일반적으로 인덱스 |
| 렌더링 시 에디터가 OpenGL 3/4 코어 프로파일을 사용하도록 만듭니다. 에디터는 사용 가능한 최적의 OpenGL 버전과 OpenGL 드라이버에 의해 노출되는 모든 OpenGL 확장자를 사용하려고 시도합니다. 플랫폼이 지원되지 않는 경우 에디터는 Direct3D를 사용합니다. |
| 이와 유사하지만 |
| 렌더링 시 에디터가 OpenGL for Embedded Systems를 사용하도록 합니다. 에디터는 사용 가능한 최적의 OpenGL ES 버전과 OpenGL 드라이버에 의해 노출되는 모든 OpenGL ES 확장자를 사용하려고 시도합니다. |
| |
| 에디터가 레거시 OpenGL 백엔드를 사용하도록 만듭니다. |
| 에디터가 렌더링에 Vulkan을 사용하도록 만듭니다. 일반적으로 그래픽스 API는 플레이어 설정에 따라 달라집니다. |
라이선스 인자
다음 인자를 사용하여 Unity 라이선스 처리하거나 다른 라이선스 옵션으로 Unity 에디터 실행합니다.
명령 | 설명 |
|---|---|
| Unity 라이선스를 수동으로 활성화하는 세 단계 프로세스 중 하나입니다. 자세한 내용은 수동 라이선스 활성화를 참조하십시오. |
| Unity 라이선스를 수동으로 활성화하는 세 단계 프로세스의 세 번째 단계입니다. 자세한 내용은 수동 라이선스 활성화를 참조하십시오. |
| 현재 활성화된 시리얼 기반 또는 이름이 지정된 사용자 라이선스 반환합니다. 플로팅 라이선스를 반환하는 데 |
| 유료 Unity 라이선스 활성화합니다. 시리얼 기반 라이선스를 활성화하거나 이름이 지정된 사용자 라이선스와 시리얼 키를 동시에 활성화하려면 참고: |
Metal 인자(macOS 전용)
다음 인자를 사용하여 Unity의 Apple 기기용 Metal 그래픽스 API 사용을 설정합니다.
명령 | 세부 정보 |
|---|---|
| Metal을 사용하는 경우 에디터가 저전력 기기를 사용하도록 합니다. |
| 에디터가 Metal을 기본 그래픽스 API 사용하도록 합니다(macOS 전용). |
| 에디터 내에서 Metal 캡처를 가져오는 기능을 활성화합니다. |
프로파일러 인자
다음 인자를 사용하여 Unity의 프로파일러 사용을 설정합니다.
명령 | 설명 |
|---|---|
| CPU 프로파일러에 대해 세부 프로파일링 옵션을 활성화합니다. |
| 플레이어 또는 에디터의 시작을 프로파일링합니다. 이 인수를 플레이어와 함께 사용하면 빌드 프로파일에서 활성화된 자동 연결 프로파일러 옵션을 사용하여 플레이어를 빌드하는 것과 동일한 효과가 있습니다. 에디터에서 이 인자를 사용하면 에디터 시작 시 프로파일러 창 프로파일러 정보를 수집하고 표시합니다. |
| 이 인자는 시작 시 프로필 데이터를 .raw 파일로 스트리밍하도록 Unity 프로파일러를 설정합니다. 플레이어와 에디터 모두에서 작동합니다. |
| 이 인자는 시작 시 .raw 파일로 스트리밍할 때 프로파일러가 프로파일에서 캡처해야 하는 프레임 수를 설정합니다. 플레이어에서만 작동합니다 |
| 기본적으로 Unity 프로파일러의 |
Unity 에디터 특수 커맨드 라인 인자
특별한 상황이나 Unity 지원 부서의 지시를 받는 경우에만 사용하십시오.
명령 | 설명 |
|---|---|
| 최신 버전의 Unity에서 작동하도록 다운그레이드하려는 최신 버전의 Unity에서 만든 에셋이 있는 경우에 사용합니다. 이 설정을 활성화하면 Unity 필요한 프로젝트를 열려고 할 때 이 다운그레이드 확인을 요청하는 다이얼로그를 표시합니다. 참고: 이 절차는 지원되지 않으며 매우 위험하며, 최후의 수단으로만 사용해야 합니다. |
| 전역 조명(GI) 캐시 폴더의 커스텀 위치를 설정합니다. 값은 절대 경로여야 하며 공백이 포함된 경우 따옴표로 묶어야 합니다. |
| 이 절차는 모든 에셋의 전체 재임포트를 트리거하는 |
Unity Hub 특수 커맨드 라인 인자
특별한 상황이나 Unity 지원 부서의 지시를 받는 경우에만 사용하십시오. 이 인자는 Unity Hub 기본적으로 사용하지 않는 Unity 에디터 버전에서 사용됩니다.
명령 | 설명 |
|---|---|
| Unity 에디터 Hub 통합으로 실행합니다. |
| Unity 에디터 Unity Hub 간 커뮤니케이션 및 상호 작용을 활성화합니다. |
| Unity Hub 세션에 대한 고유 식별자를 지정합니다. |
지원되는 모든 Unity 에디터 버전에서는 기본적으로 이러한 인수가 설정되어 있습니다.