SDK 업그레이드
SDK 매니저로 SDK 업그레이드¶
기존에 설치된 SDK를 Hive SDK Manager로 업그레이드하려면 상단 메뉴에서 Hive > HIVE SDK Manager > SDK Upgrade를 클릭합니다. 클릭 후 아래 내용을 읽고 업그레이드를 진행합니다.
Interface 패키지와 Platform 패키지¶
Hive SDK v4 Unity는 25.4.0 버전부터 Interface 패키지, Platform 패키지 (Android, iOS)로 나뉘어 배포합니다.
- Interface 패키지: Hive SDK를 Unity 환경에서 구동하기 위한 인터페이스와 플러그인을 포함
- 예시: Interface 25.4.5
- Platform 패키지: Hive SDK가 지원하는 OS(Android, iOS)별 라이브러리, 리소스 파일, 설정을 포함
- 예시: Platform Android 25.4.0, Platform iOS 25.4.4
패키지를 분리한 이유¶
패키지를 분리한 이유는 아래와 같습니다.
- 꼭 필요한 패키지만 설치하기 때문에 게임 프로젝트에 Hive SDK v4 Unity를 적용하는 시간을 단축 가능
- 버그 등 이슈를 발견해 빌드를 수정하는 경우, 문제 있는 패키지만 업데이트하고 빠르게 배포 가능
- 꼭 필요한 패키지만 설치하기 때문에 Git과 같은 버전 관리 시스템 사용 시 효과적으로 변경 사항 추적 가능
패키지 적용 규칙¶
Interface 버전 각 자리가 major.minor.patch 버전 형태일 때, Interface 패키지와 Platform 패키지의 버전 적용 규칙은 아래와 같습니다.
- a. Platform 패키지는 Interface 패키지의
major값과 동일한 버전을 적용해야 함 - b. Platform 패키지는 Interface 패키지의
minor값 이하 버전을 적용 가능 - c. Platform 패키지는 a, b 규칙에 맞다면
patch버전은 모든 버전 적용 가능 - d. Platform 패키지는 대상 OS(Android, iOS)간 서로 다른 버전을 적용 가능
Warning
Platform 패키지는 현재 Unity Android, Unity iOS만 지원합니다. Unity Windows는 추후 배포할 예정입니다.
예시 1: Platform 패키지 선택¶
Interface 25.4.5을 적용 시 Platform 패키지는 아래와 같이 적용할 수 있습니다.
- 게임을 배포할 플랫폼 선택
- Android 게임만 출시한다면 Platform Android만 설치
- iOS 게임만 출시한다면 Platform iOS만 설치
- Android, iOS 모두 출시한다면 Platform Android와 Platform iOS를 모두 설치
- Platform 패키지 버전 선택
- 25.4.0 이상 모든 버전중 하나를 선택 가능
- Android, iOS 버전은 서로 다른 버전 적용 가능
- 예시: Platform Android 25.4.0, Platform iOS 25.4.4
예시 2: Interface 패키지 업데이트¶
Interface 패키지는 현재 버전보다 높은 버전으로 자유롭게 업데이트할 수 있습니다.
단, Interface 패키지를 업데이트하면서 기존 Platform 패키지가 버전 규칙과 맞지 않으면 Platform 패키지도 함께 업데이트해야 합니다.
예를 들어, 아래와 같이 Interface 패키지를 업데이트한 후에는 Platform iOS를 26.0.x 버전으로 업데이트해야 합니다.
- 현재 버전: Interface 25.4.0, Platform iOS 25.4.4
- 업데이트 타겟 버전: Interface 26.0.0
예시 3: Interface 패키지와 Platform 패키지 호환성¶
| Interface 버전 | Platform Android 버전 | Platform iOS 버전 | 호환 여부 |
|---|---|---|---|
| 25.4.5 | 25.4.0 | 25.4.4 | O |
| 25.5.3 | 25.4.1 | 25.5.5 | O |
| 26.0.0 | 25.5.5 | 26.0.1 | X (Platform Android 26.0.x 이상 버전으로 업데이트 필요) |
업그레이드 순서 (Hive SDK v4 Unity 25.4.0 이상)¶
1. 업그레이드 버전 선택¶
(1) SDK 매니저 업그레이드 가이드¶
클릭 시 SDK 매니저 가이드 페이지로 이동합니다. 가이드를 읽고 업그레이드를 진행합니다.
(2) 적용 버전 및 최신 버전 확인하기¶
현재 적용중인 Hive SDK v4 Unity 버전과 배포된 최신 버전을 확인할 수 있습니다. Hive SDK v4 Unity를 적용하지 않는 경우 적용 버전에 - 로 표시됩니다.
(3) 릴리즈 노트¶
Interface 패키지 우측에 릴리즈 노트 이동 클릭 시 해당 버전의 릴리즈 노트 페이지로 이동합니다. 업그레이드하려는 최신 버전 릴리즈 노트를 읽고 업그레이드를 진행합니다.
(4) Interface 패키지 버전 선택하기¶
업데이트 또는 신규 설치하려는 Interface 패키지를 선택합니다. 폴더 모양 아이콘 클릭 시 해당 버전의 Interface 패키지가 선택되며 Platform 패키지를 선택할 수 있는 UI 메뉴가 나타납니다. 현재 적용된 버전보다 낮은 Interface 패키지는 설치가 불가능하며 이 때에는 상태에 업그레이드 불가 아이콘이 표시됩니다.
(5) Platform 패키지 버전 선택하기¶
업데이트 또는 신규 설치하려는 Platform 패키지(Android, iOS)를 선택합니다. 먼저 해당 OS의 버전을 선택합니다. 이후 상태에 업그레이드 가능한 버전으로 아이콘이 표시되었는지 확인하였다면 체크박스를 클릭해 활성화합니다.
(6) Interface 이전 버전 보기¶
현재 설치된 Interface 패키지 버전보다 하위 버전의 목록을 확인할 수 있습니다. 하위 버전들은 상태에 업그레이드 불가로 표시되며 다운그레이드는 지원하지 않습니다.
(7) 적용¶
업그레이드 하려는 Interface 또는 Platform 패키지를 선택하였다면 적용 버튼을 통해 다음 과정으로 넘어갑니다.
2. 무결성 검증¶
업그레이드할 버전을 선택했다면 이 단계에서 업그레이드 제외할 파일을 선택하고 무결성 검증을 할 수 있습니다. 기존 SDK 버전 파일 중에 오직 무결성이 검증된 파일만 타겟 버전으로 업그레이드할 수 있습니다.
(1) 업그레이드 제외할 파일 선택¶
Hive SDK v4 Unity 패키지에 구성된 파일 중 업그레이드에서 제외할 파일을 선택합니다. 지금 수정하기를 클릭 시 업그레이드 제외 파일 목록을 작성할 수 있는 메모 파일이 나타납니다. 이후 메모 파일을 수정하고 저장합니다.
(2) 무결성 검증¶
Hive SDK v4 Unity 기존 버전 패키지를 구성하는 파일들을 원본과 비교합니다. 다시 말하면, 개발 로컬 머신에 설치한 Hive SDK v4 Unity 패키지 파일들과 SDK 매니저 서버에 존재하는 Hive SDK v4 Unity 원본 파일들을 비교합니다. 비교 결과 로컬에서 변형된 파일이 있으면 목록에 노출합니다. 목록에서 파일을 클릭하면 코드 편집기에서 코드 내용을 확인할 수 있습니다.
(3) 현재 버전으로 복원¶
변형된 파일들을 원본 파일로 복원합니다. 복원이 완료되면 위 목록에서 제외되며 업그레이드 시 업그레이드 타겟 버전 내용을 반영합니다. 만약 특정 파일을 복원하지 않고 업그레이드를 진행하면 해당 파일은 업그레이드에서 제외됩니다.
Note
무결성 검증된 파일 목록에서 변형된 파일이 없는 경우 현재 버전으로 복원 버튼이 노출되지 않습니다. 이는 현재 적용된 버전 원본 파일이 로컬에서 변형되지 않았음을 의미합니다. 따라서 무결성 검증을 통해 변형된 파일이 없는 경우, 현재 버전으로 복원 버튼 없이 다음 단계로 진행할 수 있습니다.
(4) 업그레이드¶
선택했던 Interface 및 Platform 패키지 버전으로 업그레이드를 진행합니다.
Warning
업그레이드를 시작하기 전에 업그레이드에서 제외되는 파일 목록을 반드시 확인해야 합니다.
(5) 중지¶
업그레이드 버전 선택 화면으로 돌아갑니다.
3. 업그레이드 진행¶
무결성 검증 단계에서 업그레이드를 진행 후 진행 결과를 확인할 수 있습니다.
(1) 업그레이드 적용된 버전¶
로컬 프로젝트에서 업그레이드가 완료된 Hive SDK v4 Unity의 Interface 및 Platform 패키지 버전을 확인할 수 있습니다. 업그레이드에 실패했을 경우 팝업 UI를 통해 업그레이드를 재시도 할 수 있습니다. 업그레이드가 정상 완료되었다면 해당 UI를 닫고 SDK 매니저를 종료합니다.
(2) 목록¶
업그레이드 버전 선택 화면으로 이동합니다.
Hive SDK v4 Unity 25.4.0 미만 버전을 적용하려는 경우¶
Hive SDK v4 Unity 25.4.0 미만 버전은 Interface 및 Platform 패키지 형태로 분리되어 있지 않습니다. Hive SDK로 Hive SDK v4 Unity 25.4.0 미만 버전을 신규 설치하거나 25.4.0 미만 버전으로 업데이트하려면 아래 내용을 따르세요.
- 25.4.0 미만 버전의 경우 Interface 버전 선택 시 동일한 Platform 패키지(Android, iOS)가 자동 선택됨
- 25.4.0 미만 버전은 Interface와 Platform 패키지(Android, iOS)가 항상 같은 버전으로 함께 설치됨
