perforce 가이드

P4 유저 가이드

• P4 User's Guide

최신 버전 받기 - Get Latest revision

1. Workspace 트리에서 갱신을 원하는 파일 혹은 폴더를 선택.
2. 마우스 오른 클릭후 Get Latest revision을 선택.
   

1. 혹은 갱신을 원하는 파일 혹은 폴더를 선택후 단축키 Ctrl+Shift+G

편집을 위해 체크 아웃하기 - Check out

1. Workspace 트리에서 갱신을 원하는 파일 혹은 폴더를 선택.
2. 마우스 오른 클릭후 Check out을 선택.
   

1. 혹은 갱신을 원하는 파일 혹은 폴더를 선택후 단축키 Ctrl+E

 로컬에서 변경된 파일을 유지한 상태로 체크아웃이 된다.

새로운 파일을 P4에 등록하기 - Mark for Add

1. Workspace 트리에서 파일이나 폴더를 선택.
2. 마우스 오른 클릭하여 Mark for Add를 선택.
3. Submit을 진행.

파일이나 폴더를 P4에서 삭제하기 - Mark for Delete

1. Workspace 트리에서 파일이나 폴더를 선택.
2. 마우스 오른 클릭하여 Mark for Delete를 선택.
3. 로컬에 있는 파일은 즉시 삭제.
4. Submit을 진행하면 P4 서버에 반영된다.

작업 완료후 P4 서버에 올리기 - Submit

• 작업한 내용을 일괄적으로 올리기.
  1. Pending 탭을 선택후 변경 리스트에서 변경 목록을 선택. ( 통상 default )
  2. 마우스 오른 클릭하여 Revert Unchanged Files를 선택.
     Check out 목록중에 파일이 실제로 변경되었는지를 검사하여 변경된 파일만 추려냄.
  3. 마우스 오른 클릭하여 Submit 선택.
  4. 변경 사항에 대한 설명을 간략하게 서술후 Submit 버튼 클릭.

• 특정 파일 혹은 폴더를 선택해서 올리는 방법 : 작업한 내용중 일부 파일이나 폴더에 국한된 내용만 일괄적으로 업로드를 원하는 경우.
  1. Workspace에서 특정 파일이나 폴더를 선택.
  2. 마우스 오른 클릭하여 Revert Unchanged Files를 선택.
     Check out 목록중에 파일이 실제로 변경되었는지를 검사하여 변경된 파일만 추려냄.
  3. 마우스 오른 클릭하여 Submit 선택. ( Ctrl + S )

P4에 등록되지 않은 로컬 파일이나 체크 아웃하지 않고 편집한 파일 찾기 - Reconcile Offine Work

1. 검사를 원하는 폴더를 선택후 마우스 오른 클릭후,
2. Reconcile Offine Work를 선택 폴더를 검색후 목록이 출력된다.
3. 상단 리스트에 수정된 파일 목록(Modified files)이 나타나고, 중간 리스트에 서버에 등록되지 않은 로컬 파일이 출력된다.
4. 원하는 파일을 선택후 마우스 오른 클릭하여
   • 삭제를 원하는 경우 Delete Local File를 클릭.
   • 서버에 로컬 파일을 추가하려면 Mark for Add를 클릭. Submit을 진행.
   • 체크아웃 하지 않은 상태에서 변경된 내용을 P4서버로 반영하려면 Check out을 클릭. Submit을 진행.
   • 체크아웃 하지 않은 상태에서 변경된 내용을 원본으로 복구하려면 Revert를 클릭.

체크 아웃하고 있는 사람 확인하기

1. 특정 폴더나 파일로 이동후 오른쪽 상단에 있는 Files 탭을 선택. 보이지 않는다면 Menu > View > Files in Folder 선택.
2. 특정 파일에 Checked Out By 항목을 보연 체크 아웃 하고 있는 사람의 ID가 보인다.

 Checked Out By 항목이 보이지 않는 경우에는 리스트 콘트롤 네임 영역을 우클릭하여 해당 항목을 추가.

작업중인 내용 되돌리기 - Revert

1. Workspace에서 특정 파일이나 폴더를 선택.
2. 마우스 오른 클릭후 Revert나 Revert Files를 선택.

1. 혹은 Pending 탭에서 특정 파일이나 변경 리스트를 선택.
2. 마우스 오른 클릭후 Revert나 Revert Files를 선택.

이전 버전으로 되돌리기 - Rollback to Revision...

1. Workspace에서 특정 파일이나 폴더를 선택.
2. 마우스 오른 클릭후 File History나 Folder History를 선택.
3. 활성화된 History 탭에서 되돌리고자 하는 이전 버전을 확인후 선택.
4. 마우스 오른 클릭후 Rollback… 선택.
5. 되될리기를 하려면 내용 확인후 Yes 버튼 클릭.

충돌 발생시 - Resolve

아래와 같이 출력되는 경우 동일 파일을 누군가 편집하여 올린 버전과 자신이 수정한 버전이 충돌한 경우이다.

다중 Check Out으로 인하여 파일 버전 충돌시 해결 방법은 아래와 같이 바이너리 파일, 텍스트 파일 두가지 경우로 나뉜다.

바이너리 타입 ( 이미지, .upk, .doc, .xls 파일 등등 )

1. 충돌이 발생한 파일을 선택후 마우스 오른 클릭하여 Resolve를 선택.
   

1. 아래와 같이 Resolve 창이 출력된다.
   
2. 자신의 파일을 유지할 경우에는 Accept Yours를 클릭.
3. 다른 사람의 파일을 유지할 경우에는 Accept Theirs를 클릭.

텍스트 타입 ( 소스 파일 등등 )

1. 충돌이 발생한 파일을 선택후 마우스 오른 클릭하여 Resolve를 선택.
   
2. 아래와 같이 Resolve 창이 출력된다.
   
3. 자신의 파일을 유지할 경우에는 Accept Yours를 클릭.
4. 다른 사람의 파일을 유지할 경우에는 Accept Theirs를 클릭.
5. 다른 사람의 작업 내용과 자신의 작업 내용을 병합할 경우에는 Accept Merged를 클릭.
6. 혹시 편집한 부분이 충돌한 경우에는 Run Merge Tool을 클릭하여 수동으로 편집 해줘야 한다.
7. Araxis Merge의 경우 삼분할된 창에서 가운대 창이 최종본이므로 주의하여 병합을 수행하면 된다.

기타

Can’t clobber writable file

Can’t clobber writable file 오류가 발생하는 경우가 있는데, 일반적인 퍼포스 클라이언트로 작업을 진행 하는 경우에는 그냥 Continue 버튼을 클릭하여 받기를 하면 대부분 해결이 된다.
다만, 빌드서버등에서 커멘드 명령으로 자동으로 받게 하는 환경에서는 위 오류가 발생하는 경우 난감한데 아래와 같은 방법으로 대응하는 방법이 있다.

1. 퍼포스 클라이언트에서 Menu » Connection » Edit Current Workspace…를 선택해서 워크스페이스 속성 편집창을 띄운다.
2. Options 항목에서 clobber 항목을 선택.