Version: 2021.2
언어: 한국어
Perforce 통합
Unity에서 외부 버전 관리 시스템 사용

Unity용 Plastic SCM 플러그인

Unity용 Plastic SCM 플러그인은 Unity 에디터 내에서 소스 제어 기능을 제공합니다. Unity 에디터에서 Plastic SCM 창은 로컬 프로젝트의 새로운 파일이나 변경된 파일의 리스트를 표시합니다. 이곳에서 이러한 파일을 Plastic SCM으로 확인할 수 있습니다.

Unity용 Plastic SCM을 사용하면 분기, 잠금, 병합, 스탠드얼론 GUI와 같은 추가 VCS 특징을 제공하여 더 복잡한 프로젝트에서 공동으로 작업할 수 있습니다.

Unity 패키지 관리자에서 플러그인은 버전 관리 패키지를 통해 사용할 수 있습니다. 패키지는 지원되고 업데이트되는 Unity Plastic SCM의 공식 통합입니다.

버전 관리 패키지는 Unity 지원 일정을 따릅니다. 현재 지원되는 버전은 다음과 같습니다.

  • 2019.4.29f1
  • 2020.3.15f1
  • 2021.1.15f1
  • 2021.2.0b6
  • 2022.1.0a4

Plastic SCM으로 마이그레이션

해당 단계를 완료하여 콜라보레이트 마이그레이션 툴로 콜라보레이트 프로젝트를 마이그레이션합니다. 그러면 팀 구성원을 초대하고 Plastic SCM 작업 공간을 설정하고 Unity용 Plastic SCM을 설치합니다.

이력을 옮기지 않고 콜라보레이트에서 마이그레이션

모든 콜라보레이트 이력을 없애고 프로젝트를 그대로 Plastic으로 옮기려면 다음 단계를 따르십시오.

  1. 프로젝트를 열고 Services 창에서 콜라보레이트를 비활성화합니다.
  2. Unity를 닫고 새로운 Plastic 저장소와 프로젝트를 넣을 작업 공간을 만듭니다.
  3. 저장소에 초기 설정을 수행합니다(예: Unity 프로젝트에 특정한 ignore.conf 파일 사용 가능).
  4. 프로젝트를 복사하여 새로운 작업 공간에 붙여 넣습니다.
  5. 콘텐츠를 확인하고 새로운 작업 공간에서 작업을 계속 합니다!

Unity에 설치된 버전 관리 패키지가 있는 경우 훨씬 더 수월합니다!

  1. 프로젝트를 열고 Services 창에서 콜라보레이트를 비활성화합니다.
  2. Unity에서 Plastic SCM 창을 열고 작업 공간 생성을 클릭합니다.

Plastic SCM 시작하기

Unity용 Plastic SCM 플러그인 설치

Unity 패키지 관리자에서 플러그인은 버전 관리 패키지를 통해 사용할 수 있습니다.

버전 관리 패키지로 Unity용 Plastic SCM을 사용하기 위해 Unity 프로젝트에서 Plastic SCM 에셋 스토어 플러그인을 제거해야 합니다. 제거하려면 다음 단계를 따르십시오.

  1. Unity 프로젝트에서 에셋/플러그인 폴더로 이동합니다. PlasticSCM 폴더를 삭제합니다.
  2. Unity 프로젝트를 다시 열어 패키지를 다시 컴파일합니다.

참고: Unity 프로젝트의 루트에 있는 .plastic 작업 공간 폴더는 버전 관리 패키지에서 읽기가 가능하므로 제거하지 않아도 됩니다.

Window > Plastic SCM으로 이동하여 지원되는 모든 버전에서 Unity용 Plastic SCM에 액세스할 수 있습니다. 그런 다음 간단한 온보딩 프로세스를 거치게 되며 이 프로세스는 계정 설정을 안내하고 Unity 프로젝트가 올바르게 설정되었는지 확인합니다.

Plastic SCM 플러그인 사용

Plastic SCM 플러그인은 Unity 에디터에서 Plastic SCM 창을 활성화합니다. Plastic SCM 창에서는 다음과 같은 파일 변경을 관리할 수 있습니다.

  • 프로젝트를 소스 컨트롤에 연결
  • 파일 체크인
  • 변경 사항 되돌리기
  • 파일 리비전 비교

** Plastic SCM ** 창에는 프로젝트의 새로운 또는 변경된 파일 리스트가 표시됩니다. 새 파일을 추가하거나 기존 파일에 변경 사항을 저장하면 Plastic SCM 창에 영향을 받은 파일이 자동으로 표시됩니다.

Plastic SCM 창을 열려면 Window > Plastic SCM을 선택하십시오.

새로운 작업 공간 생성

Unity 프로젝트에서 Plastic SCM 플러그인을 사용하려면 Plastic SCM 창에서 또는 Plastic SCM GUI에서 프로젝트에 대한 작업 공간을 생성해야 합니다.

Unity 에디터에서 프로젝트에 대한 새로운 작업 공간을 생성하려면 다음 단계를 따르십시오. 1. Window > Plastic SCM을 선택합니다. 2. 저장소 이름, 작업 공간 이름 및 프로젝트 경로를 지정합니다. 기본적으로 기존 프로젝트 경로 및 이름이 사용됩니다. 3. Plastic SCM을 개발자(전체 Plastic SCM 기능 사용)로 또는 아티스트(간단한 워크플로 용도)로 사용할지 선택합니다.

작업 공간을 생성하면 Plastic SCM 창에 프로젝트 파일이 표시됩니다. 또한 Plastic SCM은 작업 공간, 즉 프로젝트 폴더에 무시 파일을 자동으로 생성합니다.

프로젝트 파일을 소스 컨트롤에 커밋

프로젝트를 Plastic SCM 작업 공간에 연결하면 Plastic SCM 창의 Pending Changes 탭에 기존 프로젝트 파일이 모두 Added and private로 표시됩니다. 이러한 파일을 작업 공간에 포함하려면 체크인해야 합니다.

파일을 체크인하면 Pending changes 탭이 새로 고쳐지고 체크인한 파일이 더 이상 표시되지 않습니다. 또한 이제 Plastic SCM GUI에 다음이 표시됩니다.

  • 작업 공간 탐색기의 프로젝트 파일
  • Changesets 뷰의 최신 체크인

파일 체크인

파일을 체크인하려면 다음 단계를 따르십시오.

  1. Window > Plastic SCM을 선택합니다.
  2. Plastic SCM 창에서 체크인할 파일을 선택합니다.
  3. 텍스트 필드에서 변경 사항에 대한 설명을 입력합니다.
  4. Checkin을 선택합니다.

변경 사항이 Plastic SCM GUI의 Changesets 뷰에 나타납니다.

무시 파일

Plastic SCM 플러그인을 사용하여 작업 공간을 생성하면 작업 공간에 무시 파일이 자동으로 생성됩니다. 여기에는 소스 컨트롤에서 제외할 파일 타입 및 경로의 기본 리스트가 들어 있습니다. 공유 저장소에서 제외할 다른 파일이 프로젝트에 있는 경우 다음 단계에 따라 무시 파일에 추가하십시오.

  1. Plastic SCM 창에서 무시할 파일을 마우스 오른쪽 버튼으로 클릭합니다.
  2. Add to ignored list를 선택합니다.
  3. 파일 이름을 선택합니다.

무시하려고 선택한 파일이 Pending changes 리스트에서 제거됩니다. 특정 파일 이름, 전체 폴더 그리고 특정 확장자가 포함된 모든 파일을 무시할 수 있습니다.

무시 파일에 대해 자세히 알아보십시오.

파일 변경 사항 보기

업데이트된 파일을 이전 버전과 비교하려면 Plastic SCM 창에서 파일을 마우스 오른쪽 버튼으로 클릭하고 Diff를 선택하십시오. 그러면 저장소 소스와 로컬 사본을 비교하는 Differences 뷰가 열립니다. 이 뷰는 텍스트 전용 뷰입니다.

파일 변경 사항 되돌리기

프로젝트에 대한 변경 사항 중 유지하지 않으려는 사항이 있을 경우 이전 버전, 즉 최신 체크인 버전으로 되돌릴 수 있습니다. 파일 변경 사항을 되돌리려면 Pending changes 탭에서 파일을 선택하고 Undo changes를 선택하십시오.

Plastic SCM 창

Unity 에디터의 Plastic SCM 창을 사용하여 프로젝트에 대한 버전 관리를 수행하십시오. 프로젝트가 아직 Plastic SCM에 연결되지 않았으면 Plastic SCM 창에 새 작업 공간을 생성하기 위한 뷰가 표시됩니다. 아래 표에는 이 뷰의 필드에 대한 설명이 나와 있습니다.

필드 설명
Repository name 저장소의 이름입니다. 기본적으로 프로젝트의 이름입니다.
Workspace name 작업 공간의 이름입니다. 기본적으로 프로젝트의 이름입니다.
Path on disk 프로젝트 경로입니다. 기본적으로 열려 있는 프로젝트의 위치입니다.
Developer 라디오 버튼 브랜치 병합, 푸시/풀 등을 비롯한 전체 Plastic SCM 기능을 사용하려면 이 옵션을 선택합니다.
Artist 라디오 버튼 병합 또는 다중 브랜치 없이 간단한 파일 체크인 워크플로를 사용하려면 이 옵션을 선택합니다.
Create workspace 버튼 제공한 세부 정보를 사용하여 프로젝트에 대한 작업 공간을 만듭니다.

아래 표에는 Unity 에디터의 Plastic SCM 창에 대한 설명이 나와 있습니다.

필드 설명
Branch 현재 작업 중은 작업 공간의 브랜치를 표시합니다.
Pending changes 프로젝트에서 변경된 파일의 리스트를 표시합니다.
Incoming changes 프로젝트의 로컬 버전에 아직 없는 작업 공간의 외부 변경 사항을 표시합니다.
Launch branch explorer(Developer 모드 전용) 클릭하면 브랜치 탐색기가 열립니다.
Launch Plastic(Developer 모드 전용) 클릭하면 Plastic SCM이 열립니다.
Configure Gluon(Artist 모드 전용) 클릭하면 Plastic Gluon이 설정 모드로 열립니다.
Launch Gluon(Artist 모드 전용) 클릭하면 Plastic Gluon이 열립니다.

Pending changes 탭

Pending changes 탭에는 프로젝트의 로컬 버전에 있는 새로운 또는 변경된 파일이 표시됩니다. 이 탭을 사용하여 Plastic 작업 공간으로 파일을 체크인하고, 버전 관리에서 파일을 제외하고, 변경된 파일을 이전 체크인 버전과 비교할 수 있습니다.

필드 설명
Checkin changes 선택한 파일을 작업 공간으로 커밋합니다. 텍스트 상자에 설명을 입력한 후 변경 사항을 체크인해야 합니다.
Undo changes 선택한 파일에 적용된 로컬 변경 사항을 되돌립니다.
Keep items locked(Artist 모드 전용) 체크인 작업 후 항목을 잠금 상태로 유지합니다. 예를 들어 파일을 여러 번 변경한 후 개별 변경 사항으로 체크인하려는 경우에 유용합니다. 항목을 잠금 해제하려면 이 버튼을 선택 해제하십시오.
Options 클릭하면 Options 창이 열립니다.
Item 파일 경로의 이름입니다. 파일은 변경 사항의 타입별로 그룹화됩니다. 예를 들면 다음과 같습니다.
Changed
Deleted
Added
Status 파일의 상태입니다. 예를 들면 다음과 같습니다.
Changed
Removed locally
Private
Size 파일의 크기입니다.
Extension 파일 확장자입니다.
타입 파일 타입입니다.
Date modified 변경 사항의 날짜 및 시간입니다.
Repository 변경이 이루어진 저장소이며, 다른 사용자가 변경한 경우 로컬 저장소 또는 원격 저장소입니다.

Pending changes 뷰에 대해 자세히 알아보십시오.

Incoming changes 탭

Incoming changes 탭에는 프로젝트의 로컬 버전에 아직 없는 작업 공간의 외부 변경 사항이 표시됩니다. 이 탭을 사용하여 원격 작업 공간에서 최신 변경 사항을 가져오십시오.

필드 설명
Update workspace 작업 공간의 외부 변경 사항으로 프로젝트를 업데이트합니다.
Path 파일 경로 및 이름입니다.
Last edited by(Artist 모드 전용) 변경 사항을 체크인한 사용자입니다.
Size 파일의 크기입니다.
Date modified(Artist 모드 전용) 파일의 최근 체크인 날짜입니다.
Author(Developer 모드 전용) 변경 사항을 체크인한 사용자입니다.
Details(Developer 모드 전용) 업데이트가 관련 변경 사항으로 수행할 작업을 설명합니다.
Resolution method(Developer 모드 전용) 디렉토리 충돌을 해결할 때 사용자가 선택한 해결 방법을 표시합니다.

들어오는 변경 사항 기능에 대해 자세히 알아보십시오.

Options 창

Options 창을 사용하여 Plastic SCM 창의 동작을 제어하십시오. 아래 표에는 Plastic SCM 창에 대한 옵션이 설명되어 있습니다.

필드 설명
What to find
Show checkouts 다음 파일을 표시합니다.
Plastic에서 명시적으로 체크아웃한 파일
이동한 파일
병합이 진행 중인 파일
Find changed files in the workspace 작업 공간 디렉토리 구조를 확인하여 타임스탬프를 통해 변경된 파일을 식별합니다.
Check the content to determine files as changed, not just timestamp 타임스탬프가 업데이트된 파일의 해시를 계산하여 파일 콘텐츠가 실제로 변경되었는지 확인합니다.
What to show
Auto-refresh Plastic은 수동 새로고침을 방지하기 위해 보류 중인 변경 사항 리스트를 자동으로 새로 고칩니다.
Show private files 새 파일 또는 툴 생성 콘텐츠와 같이 소스 컨트롤에 커밋되지 않은 파일을 표시합니다.
Show ignored files 무시 리스트에 추가한 파일을 표시합니다.
Show hidden files 숨김 리스트에 추가한 파일을 표시합니다.
Show deleted files and directories Plastic 컨트롤 외부의 작업 공간에서 수동으로 삭제한 파일을 표시합니다.
Move detection
Find moved and renamed files and directories 이름이나 위치가 변경된 파일에 대한 작업 공간을 검색합니다. 한 파일이 삭제되고 다른 파일이 추가된 경우를 예로 들 수 있습니다.
Match binary files only when they have the same extension 바이너리 파일에 대한 파일 매칭을 동일한 확장자를 가진 파일로 제한합니다.
Match text files only when they have the same extension 텍스트 파일에 대한 파일 매칭을 동일한 확장자를 가진 파일로 제한합니다.
Similarity percentage 유사한 파일을 위치나 이름이 변경된 파일로 간주하는 방식을 정의합니다.
텍스트 파일의 경우 이 비율은 콘텐츠와 관련됩니다.
바이너리 파일의 경우 이 비율은 파일 크기와 관련됩니다.
디렉토리 구조의 경우 총 디렉토리 항목 수의 백분율로 표시되는 자식과 관련됩니다.

Options 창에 대해 자세히 알아보십시오.

Perforce 통합
Unity에서 외부 버전 관리 시스템 사용