브랜치
브랜치는 같은 프로젝트를 갈래로 나눠, 한 갈래에서 실험하는 동안 다른 갈래를 그대로 두는 기능입니다. 새 프로젝트는 main 브랜치 하나로 시작하고, 맨 위 줄의 main 표시가 지금 브랜치입니다.
화면
맨 위 줄 main을 누르면 VERSION CONTROL 창이 열립니다. 창 왼쪽 위 CURRENT BRANCH를 누르면 브랜치 목록이 펼쳐집니다.
| 있는 것 | 하는 일 |
|---|---|
Filter branches 칸 | 이름으로 브랜치를 찾습니다 |
| Open 목록 | 보이는 브랜치의 종류를 고릅니다. Open(열린 브랜치), Favorites(즐겨찾기), Closed(닫은 브랜치) 세 가지입니다 |
| FAVORITES | 지금 브랜치가 current 표시와 함께 나옵니다. 즐겨찾기로 지정한 브랜치도 여기 모입니다 |
| ALL BRANCHES | 나머지 열린 브랜치 |
| + New Branch | 새 브랜치를 만듭니다. 체크포인트가 하나도 없으면 흐리게 보이고 눌리지 않습니다 |
목록의 브랜치 줄에 마우스를 올리면 Switch 버튼과 ⋮가 나타납니다. ⋮ 메뉴에는 Favorite This Branch, Merge Into Current Branch, Version Control Graph, Copy Branch ID가 있고, main이 아닌 브랜치에는 Close This Branch와 Delete This Branch가 더 있습니다.
체크포인트 상세의 New Branch로 그 체크포인트에서 갈라지는 브랜치를 만들 수도 있습니다. 창 위쪽 Graph는 브랜치와 체크포인트의 갈래를 그림으로(브랜치마다 다른 색 상자와 화살표), Compare는 두 지점의 차이를 보여 줍니다.
브랜치 만들고 바꾸기
- 체크포인트를 하나 이상 남깁니다. 새 브랜치는 지금 브랜치의 마지막 체크포인트에서 갈라집니다.
- CURRENT BRANCH → + New Branch를 누릅니다.
New branch창에From: d8283db · latest checkpoint of main처럼 어디서 갈라지는지가 나옵니다. Branch name칸에 이름을 쓰고 Create Branch를 누릅니다.
확인 창 없이 바로 새 브랜치로 바뀝니다. 아래 상태 줄이 잠깐 ● 연결 중...으로 바뀌었다가 ● 실시간으로 돌아오고, 맨 위 줄의 브랜치 이름이 바뀝니다. 실측에서는 프로젝트의 첫 씬이 열렸고, 주소의 씬 ID도 바뀌었습니다(브랜치마다 씬 ID가 다릅니다). 새 브랜치의 History에는 갈라진 체크포인트가 다른 ID로 들어 있습니다.
다른 브랜치로 돌아가려면 목록에서 그 줄의 Switch를 누릅니다. 이것도 확인 없이 바로 바뀝니다. 바꾸기 전에 체크포인트를 남겨 두는 편이 안전합니다.
합치기(Merge)
합칠 결과를 받을 브랜치(예: main)로 먼저 바꾼 뒤, 가져올 브랜치(예: exp)의 ⋮ → Merge Into Current Branch를 누릅니다. Merge into main 창이 열립니다.
| 칸 | 처음 값 | 뜻 |
|---|---|---|
| Take a checkpoint of exp first | 켜짐 | 합치기 전에 가져올 브랜치의 지금 상태를 체크포인트로 남깁니다 |
| Take a checkpoint of main first | 켜짐 | 합치기 전에 받는 브랜치를 체크포인트로 남깁니다 |
| Close exp after merging | 꺼짐 | 합친 뒤 가져온 브랜치를 닫습니다 |
Merge를 누르면 Completing merge가 잠깐 나오고 끝납니다. 받는 브랜치의 History에 Checkpoint before merging branch "exp" into "main" 체크포인트가 생기고, 합친 결과는 Changes에 아직 체크포인트가 아닌 변경으로 나옵니다. 결과를 확인한 뒤 체크포인트를 남깁니다.
충돌을 고르는 화면
두 브랜치가 같은 값을 서로 다르게 바꿨으면 Resolve conflicts exp → main 창이 열립니다. 실측에서는 main에서 Box의 Position X를 -2로, exp에서 1로 바꾸고 각각 체크포인트를 남긴 뒤 합쳤습니다.
- 왼쪽 목록에서 충돌이 난 씬(
MODIFIED)을 누릅니다. 오른쪽에 엔티티와 바뀐 값(빨간 줄X -2, 초록 줄X 1)이 나옵니다. - KEEP VERSION에서 남길 쪽을 고릅니다. DESTINATION은 받는 브랜치(
main), SOURCE는 가져오는 브랜치(exp)입니다. - 모든 충돌을 고르면 왼쪽 아래 Merge가 눌립니다. 누르면 고른 값으로 합쳐집니다(실측: SOURCE를 골라 X가 1이 됨).
브랜치 닫기·지우기
⋮ → Close This Branch를 누르면 Close exp? 확인 창이 나오고, Close Branch를 누르면 목록에서 빠집니다. 닫은 브랜치는 Open 목록을 Closed로 바꾸면 보이고, 그 줄의 ⋮ → Re-Open This Branch로 다시 열 수 있습니다.
Delete This Branch는 브랜치를 지웁니다. 작성 대기 지우기 확인 창과 지운 뒤 되살릴 수 있는지 확인