이 페이지의 콘텐츠를 사용하려면 언리얼 엔진 P4 Perforce Depot에 대한 액세스가 포함된 에픽게임즈와의 맞춤형 라이선스 지원 계약이 필요합니다.
에픽게임즈는 외부에서 액세스할 수 있는 Perforce Depot를 통해 언리얼 엔진의 QA 승인 빌드 및 기타 특수 코드 드롭을 라이선시에게 제공합니다. 라이선시는 이렇게 Perforce Depot를 통해 엔진을 처음 얻을 수도 있고, 새 버전이 출시되고 라이선시가 적절하다고 판단하는 경우 새 버전으로 업데이트할 수도 있습니다. 이 문서에서는 에픽게임즈의 언리얼 엔진 디포에 연결하고 엔진 빌드에 동기화하기 위해 Perforce를 로컬에서 구성하는 단계를 설명합니다.
연결 정책
Perforce 계정에는 인증된 사용자 한 명만 로그인해야 한다는 점에 유의하세요. 여러 사용자가 동일한 계정에 로그인하는 것은 Perforce 이용약관을 위반하는 행위입니다.
에픽게임즈의 지침은 단일 사용자 또는 자동화를 통해 해당 계정을 사용하여 엔진 빌드를 로컬 Perforce Depot에 동기화하고, 귀사의 직원이 귀사에서 라이선스를 부여한 개별 Perforce 계정으로 액세스할 수 있도록 하는 것입니다.
아직 팀에 Perforce 라이선스가 없다면, 사용자 5명까지는 무료로 사용 가능하며, 라이선스 옵션을 확인해 보셔도 좋습니다.
에픽게임즈의 Perforce Depot에서 언리얼 엔진 빌드 또는 리비전을 다운로드하는 전체 프로세스는 Perforce로 언리얼 엔진 다운로드하기 페이지에서 자세히 확인할 수 있습니다.
설치 및 환경설정
P4V 구성하기
P4V 클라이언트는 현재 Perforce에서 제공하는 클라이언트입니다. 그래픽 인터페이스를 통해 버전이 지정된 파일에 액세스할 수 있으며 코드 변경 이력을 병합하고 시각화할 수 있는 툴도 포함되어 있습니다.
전체 P4V 인스톨러는 Perforce 다운로드 페이지에서 다운로드할 수 있습니다. P4V 설치 및 구성에 대한 지침은 Perforce의 P4V 문서를 참조하세요.
32비트 또는 64비트 등 사용 중인 운영 체제에 맞는 버전을 다운로드해야 합니다.
2017.2 이상 버전의 Perforce 클라이언트를 실행 중이어야 합니다.
문자 인코딩
유니코드 파일을 Perforce에서 텍스트로 저장하면, 로컬 줄 끝과 일치하도록 0xd가 추가되므로 유니코드 줄 끝 0x0a 0x00 0x0d 0x00은 0x0a 0x0d 0x00 0x0d 0x00으로 변환되어 파일이 깨집니다. 그러나 이렇게 변환되더라도, 로컬 버전은 변경되지 않으며 정상적으로 작동합니다. 이전 버전과 동기화했다가 다시 돌아가서 문제를 확인할 수 있습니다.
Perforce는 UTF-8을 유니코드로 정의합니다. 누군가 실수로 ASCII로 변환하지 않는다면 UTF-16이 이상적입니다. 병합을 놓치거나 여러 사용자가 동시에 체크아웃하지 않는다면 바이너리도 정상적으로 작동합니다.
언리얼 엔진은 유효한 파일인 경우 BOM이 포함된 ASCII 또는 UTF-16을 로드합니다.
언리얼 엔진 배포를 위한 Perforce 구성하기
해당 팀에는 에픽게임즈의 Perforce P4에서 사용하는 하나의 에픽 계정이 주어지며, 이 서버에서 언리얼 엔진 소스를 다운로드할 수 있습니다. 아래 안내에 따라 팀원과 빌드를 공유하는 프로세스를 구성하세요.
초기 구성 및 임포트하기
자신의(로컬) P4 서버를 생성합니다.
해당 서버에 임포트에 사용될 스트림의 디포를 생성합니다(예:
//UE5).에픽으로부터 임포트할 특정 릴리즈의 스트림을 생성합니다(예:
//UE5/Release-5.6.0).이 로컬 시스템에는 어떤 파일도 추가하지 마세요. 아래 별도의 단계에서 추가할 것입니다.
에픽게임즈 Perforce P4 서버에 워크스페이스를 생성하고(Perforce로 언리얼 엔진 다운로드하기 참조) 원하는 데이터를 동기화합니다.
워크스페이스 루트 폴더를 다음처럼 설정합니다.
c:\UE5\release-5.6동기화하는 대상인 최신 체인지리스트를 확인합니다(스트림을 선택한 상태로 P4V에서 히스토리 탭 확인).
P4V에서 자신의 Perforce P4 서버로의 새로운 연결을 생성합니다.
새로운 스트림을 위한 워크스페이스를 생성합니다(
//UE5/Release-5.6.0).워크스페이스의 루트를 에픽게임즈 Perforce P4 서버 워크스페이스와 같은 폴더로 설정합니다(예:
c:\UE\release-5.6).루트 폴더를 우클릭하고 추가 예약(Mark for Add)을 선택합니다.
보류 중인 체인지리스트 폴더로 가서 체인지리스트를 제출합니다.
설명에서 에픽게임즈 서버로부터 동기화한 특정 체인지리스트 번호를 확인합니다.
에픽게임즈에서 새 스냅샷 가져오기 및 임포트하기
기존에 생성한 워크스페이스를 사용하는 정규 프로세스입니다. 이는 위 단계를 수정한 하위 단계로, 이 워크플로에서는 워크스페이스를 전에 구성한 대로 두었다고 가정하고 진행합니다. 여기서는 최신 변경사항을 임포트하겠습니다.
에픽게임즈 Perforce P4 서버에 연결하기
전에 생성한 워크스페이스를 선택합니다.
최신 항목 가져오기(Get Latest)를 클릭하여 파일을 업데이트합니다.
동기화한 최신 체인지리스트를 확인합니다.
자신의 로컬 Perforce P4 서버에 연결합니다.
전에 생성한 워크스페이스를 선택합니다.
루트 폴더를 우클릭하고 오프라인 작업 조정(Reconcile offline work)을 선택합니다.
보류 중인 체인지리스트 폴더로 가서 체인지리스트를 제출합니다.
설명에서 에픽게임즈 서버로부터 동기화한 특정 체인지리스트 번호를 확인합니다.
지원
연결 문제
어떤 이유로든 Perforce Depot에 연결할 수 없는 경우, [email protected]으로 문의하거나 에픽 프로 서포트에 게시글을 작성해 주세요.