콘텐츠로 이동

SDK 업그레이드

SDK 매니저로 Hive SDK 업그레이드

SDK 매니저를 통해 Hive SDK를 신규 설치하거나 업그레이드하려면, Content Browser에서 HiveSDKManager 플러그인 폴더 내의 EUW_HiveSDKManager를 마우스 우클릭하여 Run Editor Utility Widget을 실행합니다.

SDK 매니저 실행

SDK 매니저 메뉴가 실행되면, SDK Upgrade를 클릭하여 실행합니다.

SDK 매니저 업그레이드 메뉴 실행

업그레이드 순서

1. 업그레이드 버전 선택

SDK 매니저 업그레이드 버전 선택

(1) SDK 매니저 업그레이드 가이드

클릭하면 SDK 매니저 가이드 페이지로 이동합니다. 가이드를 읽고 업그레이드를 진행합니다.

(2) 적용 버전 및 최신 버전 확인하기

현재 적용 중인 Hive SDK 버전과 배포된 최신 버전을 확인할 수 있습니다. Hive SDK를 적용하지 않는 경우 적용 버전에 -로 표시됩니다.

(3) 릴리즈 노트

Interface 패키지 우측에 릴리즈 노트 이동을 클릭하면 해당 버전의 릴리즈 노트 페이지로 이동합니다. 업그레이드하려는 최신 버전 릴리즈 노트를 읽고 업그레이드를 진행합니다.

(4) Interface 패키지 버전 선택하기

업데이트 또는 신규 설치할 Interface 패키지를 선택합니다. Interface 버전을 선택하면 Platform 패키지 선택 UI가 표시됩니다.

Warning

현재 적용 중인 버전보다 낮은 버전으로의 다운그레이드는 지원하지 않습니다.

(5) Platform 패키지 버전 선택하기

신규 설치 또는 업데이트하려는 Platform 패키지(Android, iOS, Windows)를 선택합니다. 이후, 콤보박스를 통해 적용하고자 하는 버전(major.minor.patch)을 선택합니다.

Platform 패키지 major와 minor 버전은 Interface 패키지와 동일해야 합니다. Platform 패키지 patch 버전은 Interface 패키지 patch 버전과 같거나 더 높은 버전을 선택할 수 있습니다.

  • 예시: Interface 패키지 버전이 26.0.0
    • Platform 패키지 버전
      • 26.0.0, 26.0.1, 26.0.2 (호환됨)
      • 25.9.0 (호환되지 않음)
      • 25.9.1 (호환되지 않음)
      • 26.1.0 (호환되지 않음)
      • 26.1.1 (호환되지 않음)

Interface 패키지와 호환되기만 하면, Android, iOS, Windows 각 Platform 패키지 버전은 서로 달라도 무방합니다.

Note

Platform 패키지와 Interface 패키지에 관한 더 자세한 내용은 다음을 참고하세요.

(6) 적용

업그레이드하려는 패키지를 선택했다면 적용 버튼을 통해 다음 과정으로 넘어갑니다.

2. 무결성 검증

업그레이드할 버전을 선택했다면 이 단계에서 업그레이드 제외할 파일을 선택하고 무결성 검증을 할 수 있습니다. 기존 Hive SDK 버전 파일 중에 오직 무결성이 검증된 파일만 타겟 버전으로 업그레이드할 수 있습니다.

SDK 매니저 업그레이드 무결성 검증 화면-1

(1) 업그레이드 제외할 파일 선택

Hive SDK 패키지에 구성된 파일 중 업그레이드에서 제외할 파일을 선택합니다. 지금 수정하기를 클릭하면 업그레이드 제외 파일 목록을 작성할 수 있는 메모 파일이 나타납니다. 이후 메모 파일을 수정하고 저장합니다.

(2) 무결성 검증

Hive SDK 기존 버전 패키지를 구성하는 파일들을 원본과 비교합니다. 다시 말하면, 개발 로컬 머신에 설치한 Hive SDK 패키지 파일들과 SDK 매니저 서버에 존재하는 Hive SDK 원본 파일들을 비교합니다. 비교 결과 로컬에서 변형된 파일이 있으면 목록에 노출합니다.

(3) 현재 버전으로 복원

변형된 파일들을 원본 파일로 복원합니다. 복원이 완료되면 위 목록에서 제외되며 업그레이드 시 업그레이드 타겟 버전 내용을 반영합니다. 만약 특정 파일을 복원하지 않고 업그레이드를 진행하면 해당 파일은 업그레이드에서 제외됩니다.

Note

무결성 검증된 파일 목록에서 변형된 파일이 없는 경우 현재 버전으로 복원 버튼이 노출되지 않습니다. 이는 현재 적용된 버전 원본 파일이 로컬에서 변형되지 않았음을 의미합니다. 따라서 무결성 검증을 통해 변형된 파일이 없는 경우, 현재 버전으로 복원 버튼 없이 다음 단계로 진행할 수 있습니다.

SDK 매니저 업그레이드 무결성 검증 화면-2

(4) 업그레이드

선택했던 Interface 및 Platform 패키지 버전으로 업그레이드를 진행합니다.

(5) 중지

업그레이드 버전 선택 화면으로 돌아갑니다.

3. 업그레이드 진행

무결성 검증 단계 후 업그레이드를 진행하고 결과를 확인할 수 있습니다.

SDK 매니저 업그레이드 완료 화면

(1) 업그레이드 적용된 버전

업그레이드가 완료된 Hive SDK의 Interface 및 Platform 패키지 버전을 확인할 수 있습니다.

(2) 에디터 재시작

Unreal Engine의 특성으로 인해, 플러그인을 신규 설치하거나 업데이트한 후에는 에디터를 다시 시작해야 합니다.

Note

안정적인 플러그인 적용을 위해 반드시 즉시 에디터 재시작을 권장합니다.