소스 콘트롤 통합

문서 변경내역: Warren Marshall 작성. Mike Fricker 업데이트. 홍성진 번역.

개요

게임에 들어가는 패키지와 파일에 대한 제어는 모든 개발자에게 중요하지만 프로그래머용으로 고안된, 즉 인터페이스도 거의 없고 암호같은 메시지가 뜨는 소스 콘트롤 패키지 사용법을 아티스트가 익히는 것은 꽤나 고된 일일 것입니다.

여기서는 아티스트가 언리얼 에디터 내에서 패키지를 관리할 수 있게 하여, 위와 같은 고통을 덜기 위한 방법을 설명해 드리도록 하겠습니다.

알림: 적절한 프로그래밍 인터페이스를 지원하기만 하면, 언리얼 에디터는 SCC를 가리지 않습니다.

로그인하기

먼저 소스 콘트롤을 쓰도록 되어 있는지 확인해 봅시다.

• EditorUserSettings.ini 를 텍스트 에디터로 엽니다.
• [SourceControl] 부분을 찾습니다.
• Disabled=False 로 설정합니다.
• 파일을 저장합니다!

에디터를 처음 시동할 때, 소스 콘트롤 시스템에 로그인할 것인지를 묻는 창이 뜹니다. 이는 SCC 네이티브 인터페이스를 통해 수행됩니다. 한 번 로그인한 후에는 정보가 저장되므로, 에디터 INI 파일을 지우기 전까지는 다시 로그인할 필요가 없습니다.

소스 콘트롤 패키지 아이콘

SCC가 켜지면, 콘텐츠 브라우저 패키지 트리 뷰의 패키지 옆에 아이콘이 표시될 겁니다. 표시되는 아이콘은 다음과 같습니다:

아이콘	뜻
	체크아웃 해놔서 편집할 수 있는 파일입니다.
	체크하웃 해놓지 않아 읽기 전용 파일입니다.
	다른 유저가 체크아웃한 파일입니다.
	이 파일의 현재 버전을 갖고 있지 않습니다.
	SCC 디포의 일부가 아닌 파일입니다. (추가시켜야 합니다)

편집용으로 체크아웃한 파일입니다. 에디터용으로 열어둔 패키지도 두껍게 표시됩니다.

체크아웃하지 않은 파일이며, 체크아웃시킬 수 있습니다. 즉 하드 디스크에 현재 파일을 갖고 있으며, 아무도 체크아웃하지 않은 상태라는 겁니다. 원하시면 잡으세요!

누군가 파일을 체크아웃시켰습니다. 여러 사람이 동일한 바이너리 파일을 체크아웃할 수는 없기에, 그사람이 다시 체크인시키기 전까지는 체크아웃할 수 없다는 뜻입니다.

아무도 체크아웃하지 않은 파일이지만, 현재 버전을 갖고 있지 않습니다. 언리얼 에디터를 닫고, SCC를 시작하고서, 현재 버전으로 파일을 싱크하고, 언리얼 에디터를 다시 시동하고 나서야 이 파일을 체크아웃할 수 있습니다.

파일이 새것이며 SCC 디포의 일부가 아닙니다. 소스 콘트롤에 이 새 파일을 넣으려면 메뉴의 "Add" 옵션을 사용하면 됩니다.

소스 콘트롤 메뉴

패키지나 콘텐츠 브라우저 에 우클릭하면 맥락 메뉴가 나타납니다. 여기서 소스 콘트롤 서브메뉴를 둘러볼 수 있습니다.

• Refresh (새로고침) 콘텐츠 브라우저 내 패키지의 상태는 지난 번 창을 새로고친 상태일 뿐입니다. 상태를 즉시 업데이트하려면 이 옵션을 사용하면 됩니다.

• Check Out (체크아웃) 먼저 파일 상태를 새로고친 다음 여전히 체크아웃 가능한지를 확인합니다. 가능하면 해당 파일을 SCC 디포에서 체크아웃시킵니다.

• Submit... (제출) 파일을 SCC 디포 속에다 체크인 시킵니다. SCC 프로그램에 따라 약간의 옵션을 포함하여 체크인 주석을 묻는 대화창이 뜨게 됩니다. 이 옵션은 자신에게 체크아웃된 파일일 경우에만 사용가능합니다.

• Revert (복귀) 파일을 디포 내 현재 버전으로 복귀시킵니다. 지난 제출 이후로 이 파일에 저장된 변경 사항은 버려지게 됩니다. 이 옵션은 자신에게 체크아웃된 파일일 경우에만 사용가능합니다.

• Revision History... (리비전 히스토리) SCC 프로그램이 지원하는 경우, 선택된 파일의 리비전 히스토리를 표시하는 대화창이 뜨게 됩니다.

다른 작업방식 기능

일반 작업에는 콘텐츠 브라우저 없이도 소스 콘트롤과 인터페이스할 수 있는 방법이 여럿 있습니다.

변경시 체크아웃 프롬프트

패키지가 dirty로 마크(저장할 필요가 있게)될 때마다, 해당 패키지를 소스 콘트롤에서 체크아웃시키겠냐고 묻는 대화창이 뜨게 됩니다. 이를 통해 콘텐츠 브라우저 를 열고 찾아갈 필요 없이 작업중인 패키지를 빠르게 체크아웃시킬 수 있습니다. 이 대화창은 패키지가 처음 변경될 때만 뜨며, 해당 패키지를 저장하고 소스 콘트롤에 체크인시킬 때까지 다시 뜨지 않습니다. 에디터는 느린 작업 도중 변경된 패키지를 큐에 쌓기도 합니다. 예를 들어 라이팅을 빌드할 때 여러 패키지가 변경될 수 있습니다. 걔들을 전부 한번에 체크아웃시킬지 묻게 됩니다.

• Check Out Selected: (선택된 것 체크아웃) 소스 콘트롤에서 선택된 패키지를 체크아웃시킵니다. 알림: 유령된(ghosted) 패키지는 다른 사람이 체크아웃시켰거나 헤드 리비전에 있지 않아서 체크아웃 불가능한 것을 말합니다.
• Make Writable: (쓰기가능으로 만들기) 선택된 패키지를 쓰기가능으로 만듭니다. 유령된 패키지도 쓰기가능으로 만들 수 있습니다. 그냥 이름 옆의 체크박스를 클릭하기만 하면 됩니다. 유령된 패키지에는 "사각형" 아이콘이 뜨게 됩니다. 이는 "선택된 것 체크아웃"을 클릭할 때 어느게 무시될 패키지인가 알아볼 수 있게 해 줍니다. 이 옵션은 소스 콘트롤 프로그램이 변경사항에 대한 정보를 잃어버리게 만들기에, 체크아웃되지 않은 파일을 읽기 전용으로 만들어 버리는 소스 콘트롤 프로그램에서는 이 옵션을 사용하지 않는 게 좋을 겁니다.
• Ask Me Later: (나중에 물어봐) 에디터 세션 동안에는 목록에 있는 패키지 체크아웃 여부를 묻지도 않고, 아무것도 체크아웃시키지 않습니다. 그래도 특수한 저장 기능을 사용할 때는 여전히 패키지 체크아웃 여부를 묻긴 합니다.

기타 알림: 소스 콘트롤에 있지 않으면서 디스크나 패키지에 쓰기가능으로 되어있는 패키지 변경시에는 이런 대화창이 뜨지 않습니다.

이런 기능을 사용하고 싶지 않으면 메인 에디터 창의 View(보기) 메뉴 아래에 Preference(개인 설정)으로 가서 "Prompt for Checkout on Package Modification."(패키지 변경시 체크아웃 묻기)를 끄시면 됩니다.

저장 도중 체크아웃

에디터의 저장 옵션 다수 또한 소스 콘트롤에서 패키지 체크아웃을 물어 옵니다. 몇몇 소스 콘트롤 프로그램은 체크아웃되지 않은 파일을 읽기 전용으로 만들어 버립니다. 에디터는 읽기 전용 파일을 저장할 수 없기에, 체크아웃하거나 쓰기가능으로 만들어야 저장할 수 있습니다. 저장 작업에 대한 상세 정보는 에디터 패키지 저장 절차 및 언리얼 에디터 유저 가이드 페이지를 참고하십시오.

퍼포스 전용

퍼포스 연결 대화창

소스 콘트롤을 켜고 에디터를 처음 시작할 때는 이 창이 뜨게 됩니다.

• Server: 퍼포스 서버 주소 및 포트
• User: 퍼포스 사용자명
• Client Spec: 체크아웃 및 파일 제출시 사용할 client spec. 퍼포스 새버전에서는 workspace 라고도 불립니다. 사용자명을 입력하고 나면 그에 연관된 client spec을 둘러볼 수도 있습니다.

EditorUserSettings.ini 파일에서 이 값을 편집할 수도 있습니다. [SourceControl] 부분에서 이 세팅을 찾아 보십시오:

PortName=(위의 Server와 동일)

UserName=(위의 User와 동일)

ClientSpecName=(위의 Client spec과 동일)

요약

SCC 통합은 아직 갈 길이 멀기에, 이 문서도 그에 따라 업데이트될 예정입니다.

고급 통합

이 문서는 NXN Alienbrain 7.5 이상용 고급 기능성 추가법에 대한 설명서이나, 이 통합 솔루션은 다른 애셋 관리 솔루션을 사용하는 유저용 가이드로도 손색이 없을 겁니다:

• Advanced_NXN_Alienbrain_7.5_integration_to_UnrealEd3.zip