ushell 기능은 언리얼 엔진 프로젝트에서 작업할 때 사용하는 명령줄 인터페이스입니다.
다음과 같은 다양한 기본 UE 작업 관련 명령이 있습니다.
- 코드 빌딩
- 데이터 쿠킹 및 스테이징
- 타이틀 실행
- 명령 실행
- 언리얼 인사이트(Unreal Insights)용 트레이스 실행
- 기타 등등
ushell은 다양한 탭 완성 기능을 지원하고, 자세한 인라인 문서를 포함하며, 영구적인 검색 가능 명령 히스토리를 보유하고 있습니다. 이 페이지에서는 ushell로 빠르게 시작하는 방법에 대한 정보를 제공합니다.
ushell 실행 방법
ushell을 시작하려면 엔진 설치 디렉터리(예: C:/EpicGames/UE_5.4)를 열고 다음 배치 파일을 실행합니다.
엔진 설치 디렉터리의 상대 경로
Engine/Extras/ushell/ushell.bat
ushell이 UE 5.4의 런처 빌드에는 없고, 소스 코드 빌드에는 있습니다. 이 문제는 UE 5.5에서 수정되었습니다.
모든 명령은 마침표 문자로 시작합니다. 예를 들어, .build 명령은 다양한 환경설정으로 프로젝트를 빌드합니다. 탭 완성 기능을 사용하면 명령어와 실행인자를 찾는 데 도움이 됩니다.
도움말 및 문서
.help 명령을 입력하면 사용할 수 있는 모든 명령의 목록을 볼 수 있으며, --help 실행인자를 지정하면 각 명령의 사용자 가이드를 볼 수 있습니다.
ushell 명령
.help
.build editor --help
더 자세한 문서는 ushell의 readme 파일에서 확인할 수 있습니다. 커스텀 명령으로 ushell 확장하기, ushell로 스크립팅하기, POSIX 기반 플랫폼에서 실행하기, 다른 셸과 통합하기 등의 주제를 확인할 수 있습니다. .help readme 명령을 사용하면 편리하게 파일을 확인할 수 있습니다.
예시 명령
다음은 ushell의 사용 사례를 이해하도록 돕기 위해 준비했습니다. 사용자가 사용할 수 있는 명령의 예시 목록이지만, 전체 명령을 수록하지는 않았습니다.
| 예시 명령 | 설명 |
|---|---|
.build editor |
활성 프로젝트를 위해 에디터를 빌드합니다. |
.build game win64 |
Win64 플랫폼용 활성 프로젝트의 게임 런타임을 빌드합니다. |
.build program UnreralInsights shipping |
출시 구성으로 언리얼 인사이트를 빌드합니다. |
.cook game win64 |
Win64 플랫폼용 게임 런타임의 데이터를 쿠킹합니다. |
.stage game mac |
로컬에서 빌드한 게임/클라이언트 실행 파일과 전에 쿠킹한 데이터를 Mac용으로 스테이징합니다. |
.run editor |
활성 프로젝트용 에디터를 실행합니다. |
.run game Win64 --trace -- -ExecCmds="TrySurfing" |
Win64 플랫폼용 활성 프로젝트를 위해 로컬에서 빌드한 바이너리를 실행합니다. 개발 호스트에 언리얼 인사이트 트레이스 세션을 전송하고 'TrySurfing' 명령을 실행합니다. |
.run program UnrealInsights shipping |
출시 구성으로 언리얼 인사이트를 실행합니다. |
.sln generate |
활성 프로젝트용 Visual Studio 솔루션을 생성합니다. |
.info |
현재 세션에 대한 정보를 표시합니다. |
.help 명령이나 --help 실행인자를 사용하면 위 명령들에 대한 보다 자세한 정보를 확인할 수 있습니다.
각 ushell 명령에는 명령 설명 문서, 명령 호출 방법에 대한 세부 정보, 사용 가능한 옵션을 설명해 주는 --help 실행인자를 사용할 수 있습니다.
탭 완성 및 명령 히스토리
Bash에서 명령을 편집하고 이전 명령(예: Readline)을 다시 불러오는 데 익숙한 사용자라면 ushell 프롬프트에도 익숙할 것입니다.
컨텍스트를 구분하는 광범위한 탭 완성 기능을 명령과 그 실행인자에 사용할 수 있습니다. Tab 키를 누르면 명령과 실행인자를 모두 확인할 수 있어 빠르고 편리하게 명령을 입력할 수 있습니다. 예시:
| 예시 입력 | 설명 |
|---|---|
.<tab><tab> |
사용할 수 있는 명령을 표시합니다. |
.b<tab> |
.build 를 완료합니다. |
.run <tab><tab> |
.run 의 첫 번째 실행인자 옵션을 표시합니다. |
.build editor --p<tab> |
--platform= 을 추가합니다. 탭을 더 누르면 플랫폼을 완성합니다. |
ushell은 이전에 실행한 명령의 히스토리를 유지하며, 이 히스토리는 세션이 바뀌어도 유지됩니다. 이전 명령은 몇 가지 방법으로 편리하게 다시 불러올 수 있습니다.
이전 명령을 접두사 단위로 거슬러 올라가려면 PgUp을 사용합니다.
| 예시 입력 | 설명 |
|---|---|
.bu<pgup> |
".bu"로 시작하는 명령을 역으로 이동합니다. |
| ` .run game xb |
Xbox에서 이전 실행을 반복작업합니다. |
Ctrl-R 을 누르면 증분 히스토리를 통해 더 철저하게 검색할 수 있습니다. Ctrl-R 을 누르면 검색 스트링을 입력하라는 메시지가 표시되고, 스트링을 입력하면 그와 일치하는 가장 최근 명령이 표시됩니다. Ctrl-R 을 다시 누를 때마다 검색 스트링과 일치하는 명령을 하나씩 거슬러 올라갑니다. Ctrl-S 를 누르면 거슬러 올라가지 않고 앞으로 이동합니다.