fxzyk commented 3 months ago

퍼포스에 대해서 알아보자

얼마전 회사에서 타팀분과 퍼포스 잘잘못을 가리다가 억울했던 일이 있었다..😔 그런 의미에서 퍼포스 기본 사용법을 작성해보려 한다.

※ 퍼포스 사용법은 기획/아트 위주로 작성됨을 미리 알립니다.

퍼포스란?

svn, git 과 같은 버전관리툴 중 하나이다.
언리얼에는 퍼포스가 제일 효율적이라고 들었다. 그리고 퍼포스와 연동할 수 있도록 엔진에 내장되어있다.
언리얼 연동 및 서버 설치법은 이쪽 https://docs.unrealengine.com/5.0/ko/using-perforce-as-source-control-for-unreal-engine/

퍼포스 기본 인터페이스

퍼포스를 켜면 첫 화면에 연동창이 뜬다. 워크스페이스에는 로컬에 저장할 곳을 지정해주면 된다.

워크스페이스를 지정하면 서버와 연동된다. 위 예시는 이미 서버에 파일들이 저장되어있는 경우이고 depot에는 서버의 파일, workspace에는 로컬컴퓨터의 다운로드 된 부분만 뜬다.
history : 각 사용자들이 서밋한 내용이 보여진다.
pending : 버전관리시 A->B 브랜치로 넘기기전에 잠시 대기시켜서 머무르는 공간이다. 빌드를 묶을 때는 퍼포스를 더이상 못올리게 잠궈버리기때문에 넘겨야할 것들을 pending에 차곡차곡 쌓아둔다. (이번에 타팀분이 몰라서 착각한것도 여기에서 착각하셨다 이부분은 추후에 알아보자.)
submitted : 본인이 올린 패키지 혹은 파일 내용이 보여진다.

검색은 ctrl + F 로 찾으면 된다. depot과 workspace에서는 패키지나 파일명이 찾아지고 submitted 나 history 는 다른 내용도 찾아지지만 검색이 잘 안된다. 리비전 순서를 정렬해서 수동으로 찾는게 더 빠르다.

퍼포스 사용법 - 1

로컬에 파일을 저장하고 새로고침을 하면 빈 파일표시가 뜬다. 파일을 우클릭하면 위와 같은 메뉴들이 뜨는데 이중 자주 사용하는 것들만 알아보겠다.

Get Latest Revision : 가장 최신버전으로 리비전을 다운받는다. 보통 출근하자마자 매일 최상위 폴더를 다운받아 최신버전을 유지한다.
Get Revision : 옵션이 여러가지 있는데 주로 Force~ 로 시작하는 옵션을 쓴다. 리비전을 강제로 덮어 씌울때 사용한다. 로컬에 테스트하다가 저장해둔 수치값을 롤백하고 싶을 때, 서버 최신버전을 덮어씌울 때 사용한다.
check out : 내가 쓰겠다고 잡아서 알리는 역할. 체크아웃시 lock이 되어있는지 꼭 확인해야한다. lock이 안되어있으면 타인이 먼저 올릴 수 있고 내가 하던 작업은 버려야하는 눈물나는 상황이 발생한다.
submit : 파일이나 패키지를 서버에 올린다
mark for delete : 서버에서 삭제할때 사용한다. 기록은 남아서 잘못삭제해도 롤백이 가능하다 사담으로... 입사하면 신입이고 경력이고 한번씩 실수하는 경우가 있다. 전체폴더에서 리비전다운받으려다가 이 옵션을 눌러버려서 락 걸은상태로 삭제대기가 되는것... Revert하는데도 시간이 꽤나 소요되는탓에 3~4시간동안 메신저로 죄송합니다 하며 손가락 닳도록 사과하시는 모습을 여럿 보면서 아직 실수해본적은 없으나 위험한 옵션이니 멀리하는게 좋겠다고 생각한다.
Revert Files : Unchanged files는 바꾼게 없을 때 바로 되돌리기가 가능하다. 그러나 해당 옵션은 바꾼 내용이 있을 때 사용하며 엔진에서 리버트를 하거나 엔진을 끄고 Revert Files를 눌러야한다.
Resolve files : 머지할 때 꼭 거쳐야하는 관문, 다른 브랜치로 넘길 때 어떤방식으로 리소스를 넘기는지 경로와 함께 옵션 설정을 해줘야한다.
Revision Graph : 리비전을 그래프화 시켜서 한눈에 알아보기 쉽게 보여준다. Pending과 연관되어 있으므로 자세한 내용은 다음번에 알아보도록 하겠다.

1부 끝

매일 쓰는거니 별거 없다고 생각했는데 생각보다 길어졌다..
자세한 옵션은 다음시간에... 써보겠습니다... 얼마전 개발자 두분께 퍼포스 잘잘못 이슈 때문에 여쭤보다 주워들어보니 코드쪽은 git처럼 병합이 되는 듯 합니다

참고사이트

https://pineoc.github.io/blog/2020/01/23/Perforce-basics/ https://docs.unrealengine.com/5.3/ko/using-perforce-as-source-control-for-unreal-engine/

snaag commented 3 months ago

😔😔... 오호 읽다보니 용어만 다를뿐 큰 맥락은 git 과 비슷한것같네요!! 전혀 몰랐던부분인데 배워갑니당 👀👀

mingnuj commented 3 months ago

협업 할 때는 항상 버전 관리가 힘든것 같습니다 ㅠㅠ 퍼포스 신기하네요

dev-writeup-2024 / march