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

Unity용 Plastic SCM 플러그인(베타)

Plastic SCM은 팀이 Unity 프로젝트에서 협업할 수 있도록 버전 관리 기능을 제공합니다.

Unity용 Plastic SCM 플러그인(베타)은 Unity 에디터 내에서 소스 컨트롤 기능을 제공합니다. Unity 에디터의 Plastic SCM 창에는 로컬 프로젝트의 새로운 또는 변경된 파일의 리스트가 표시됩니다. 여기에서 이러한 파일을 Plastic SCM으로 체크인할 수 있습니다.

Unity에서 업데이트하는 모든 파일은 자동으로 체크아웃됩니다. 이렇게 하면 다시 체크인할 때까지 다른 사용자가 업데이트할 수 없습니다.

Unity용 Plastic SCM 플러그인(베타)은 macOS 및 Windows용 Unity 2018.4 LTS 이상에서 지원됩니다. 참고: 이 플러그인은 현재 Windows의 Unity 2020.1 이상에서 지원되지 않습니다. Unity는 향후 플러그인 버전에서 이러한 버전에 대한 지원을 추가할 예정입니다.

Plastic SCM 시작하기

Unity용 Plastic SCM 플러그인 설치

Unity용 Plastic SCM 플러그인은 에셋 스토어에서 이용할 수 있습니다. Plastic SCM 플러그인을 설치하려면 다음 단계를 따르십시오.

  1. Assets > Import Package > Custom Package…를 선택합니다.
  2. PlasticSCMForUnity 패키지를 선택합니다.
  3. Import Unity Package 창에서 다음을 수행합니다.
    1. All을 선택합니다.
    2. Import를 선택합니다.

이제 Plastic SCM 플러그인이 프로젝트에서 활성화됩니다. Unity 에디터에서 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 뷰의 최신 체크인

Plastic SCM 플러그인 사용

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

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

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

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

파일 체크인

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

  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으로 마이그레이션

Plastic SCM은 콜라보레이트에서 Plastic SCM으로 프로젝트를 마이그레이션하도록 도와주는 마이그레이션 마법사를 제공합니다. Plastic SCM으로 프로젝트를 마이그레이션하려면 다음 단계를 따르십시오.

  1. 마이그레이션 마법사로 이동합니다.
  2. Unity ID 로그인 세부 정보를 입력합니다.
    1. Log in을 선택합니다.
  3. Plastic SCM 조직을 생성합니다.
    1. 지역 드롭다운에서 지역을 선택합니다.
    2. **Next를 선택합니다.
  4. 마이그레이션할 프로젝트를 선택합니다.
    1. **Next를 선택합니다.
  5. Plastic SCM에 가입할 조직의 팀원을 선택합니다.
    1. **Next를 선택합니다.
  6. Confirm을 선택합니다.

마이그레이션 마법사에서 위 단계를 완료하면 Plastic SCM이 콜라보레이트에서 Plastic SCM으로 프로젝트를 마이그레이션합니다. 또한 Plastic SCM은 초대된 팀원에게 Plastic SCM을 시작할 수 있도록 이메일 초대장을 보냅니다.

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 창에 대해 자세히 알아보십시오.

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