Wiki
Quickstart
터미널 없이 10분 안에 첫 checkin.
이 페이지는 uVersion 프로젝트에 합류해 작업을 시작하려는 분을 위한 것입니다. 모든 작업은 데스크톱 클라이언트에서 이루어지며, 명령줄을 입력할 필요가 없습니다.
스튜디오의 uVersion 서버 주소, 사용자 이름, 그리고 비밀번호만 알면 됩니다 (이 정보는 스튜디오 관리자가 전달해 주었습니다).
1. 데스크톱 클라이언트 설치
사용 중인 시스템에 맞는 클라이언트를 uversion.io/downloads 에서 내려받으세요.
- Windows:
uVersion_x.y.z_x64-setup.exe. 더블클릭한 뒤 설치 프로그램을 따르세요. - macOS (Apple Silicon):
uVersion_x.y.z_macos-arm64.app.zip. 압축을 풀고uVersion.app을 응용 프로그램 으로 드래그하세요. - Linux:
uVersion_x.y.z_amd64.AppImage(포터블) 또는uVersion_x.y.z_amd64.deb(apt).
2. 서버에 로그인
데스크톱 클라이언트를 실행하세요. 처음 열면 세 가지 정보를 묻습니다.
- 서버 주소: 스튜디오의 주소(예:
https://uversion.mygamestudio.com) - 사용자 이름
- 비밀번호
한 번 로그인하면 클라이언트가 세션을 기억합니다. 매일 비밀번호를 다시 입력할 필요가 없습니다.
3. 프로젝트를 내 컴퓨터로 가져오기
데스크톱 클라이언트에서:
- 접근 권한이 있는 프로젝트 목록이 표시됩니다
- 원하는 프로젝트 옆의 Clone 을 클릭합니다
- 디스크에서 내려받을 위치(빈 폴더)를 선택합니다
- 클라이언트가 프로젝트 전체를 내려받습니다. 진행률 표시줄이 나타납니다
광 회선 기준으로 10 GB당 약 1~2분 을 예상하세요. 완료되면 프로젝트를 Unreal에서 열 준비가 됩니다.
4. 파일을 편집하고 제출하기
일반적인 3단계 워크플로:
- 편집하기 전에 파일을 예약합니다(checkout). 예약해 둔 동안에는 다른 사람이 변경할 수 없습니다.
- Unreal이나 다른 어떤 도구에서든 파일을 편집합니다.
- 무엇을 바꿨는지 설명하는 짧은 메시지와 함께 변경 사항을 제출합니다(checkin).
팀원이 이미 파일을 예약해 두었다면, 그 사람의 이름과 함께 알림을 보내는 해제 요청 버튼이 표시됩니다.
이 파일을 저장할 수 없는 이유는?
프로젝트의 파일은 예약하기(checkout) 전까지 읽기 전용입니다.
이는 팀원이 작업 중인 asset을 실수로 편집하는 것을 막기 위한 안전장치입니다.
데스크톱 클라이언트에서 또는 Unreal에서 직접 checkout하면 파일을 편집할 수 있게 됩니다.
5. Unreal에서 바로 작업하기
프로젝트에 uVersion 플러그인(프로젝트 내 Plugins/uVersion/ 폴더)이 포함되어 있으면,
에디터를 벗어나지 않고 모든 작업을 할 수 있습니다.
- Unreal에서 프로젝트를 엽니다
- 메뉴 Tools → Source Control → Connect to Source Control
- 드롭다운에서 uVersion 을 선택합니다
- 확인합니다. 인증 정보는 데스크톱 클라이언트에서 자동으로 가져옵니다.
연결되면 모든 소스 컨트롤이 Unreal 안에서 이루어집니다.
- asset을 마우스 오른쪽 버튼으로 클릭 → Source Control → Check Out 으로 예약
- Content Browser의 작은 아이콘으로 각 asset의 상태 확인
- 기록에서 Blueprint diff 사용 가능
- checkin 시 자동 검증(Blueprint 컴파일, 명명 규칙 등)
다음 단계
- 데스크톱 클라이언트의 모든 기능 알아보기
- 프로젝트에 Unreal Engine 플러그인 설치하기