Source Control

언리얼 소스 컨트롤 선택 규칙

언리얼 프로젝트는 코드보다 에셋과 바이너리 파일 관리가 더 큰 병목이 될 수 있습니다. .uasset, .umap, 텍스처, 사운드의 크기와 잠금 필요성에 따라 Git, Git LFS, Perforce 선택을 분리합니다.

Sync작업 전 최신 리비전 받기
Checkout에셋 잠금 후 수정
검토맵·블루프린트 영향 확인
Submit빌드 가능한 단위로 반영
01

Git

C++ 코드, Config, 머티리얼 함수처럼 텍스트 변경이 많고 팀이 작을 때 시작 비용이 낮습니다.

02

Git LFS

.uasset, .umap, .fbx, .wav를 LFS와 lockable 속성으로 관리해 바이너리 충돌을 줄입니다.

03

Perforce

P4V 체크아웃, exclusive lock, stream 분기가 필요한 대규모 콘텐츠 제작에 적합합니다.

04

Branch

release, hotfix, feature, engine-upgrade 흐름을 나눠 에셋 마이그레이션 회귀를 줄입니다.

에셋 저장소 운영 규칙

  • DerivedDataCache, Saved, Intermediate는 무시하고 Content와 Config 변경만 의도적으로 올립니다.
  • 큰 바이너리 파일은 처음 가져오기 전에 .gitattributes와 LFS 추적 규칙을 먼저 확정합니다.
  • 안정 빌드 태그와 엔진 버전 기록을 남기면 패치나 마이그레이션 실패 시 빠르게 되돌릴 수 있습니다.

저장소 실패 신호

uasset merge잠금 없는 동시 편집
LFS pointer대용량 파일 일반 Git
generated dirs생성물 커밋
no release tag패치 기준 없음