Unreal Engine 5

Unreal Engine 개발 환경에서 사용하는 Hive SDK는 크게 Interface 패키지와 타깃 OS 별 Platform 패키지(Android, iOS, Windows)로 구성됩니다. 따라서 Interface 패키지와 게임 앱의 타깃 OS에 맞는 Platform 패키지만 선택하여 설치할 수 있습니다.

• Hive SDK Unreal Engine 5 Interface (기본 설치)
• Hive SDK Unreal Engine 5 Platform (타깃 OS에 맞는 Platform 패키지만 설치)
  • Hive SDK Unreal Engine 5 Android
  • Hive SDK Unreal Engine 5 iOS
  • Hive SDK Unreal Engine 5 Windows

Hive SDK 설치¶

Step 1. Hive SDK 최신 버전 다운로드¶

Hive SDK Unreal Engine 5 최신 버전에서 Interface 패키지와 게임 앱의 타깃 OS에 맞는 Platform 패키지를 다운로드합니다.

Step 2. Interface 패키지 설치¶

1. 다운로드한 Hive SDK v4 UE5 Interface 26.x.x.zip 압축 파일을 해제한 후, HIVESDK 폴더를 아래의 Unreal Engine 프로젝트 경로에 추가하세요.

   • 경로: <프로젝트_루트>/Plugins 경로

2. 설치한 Interface 패키지를 사용하기 위해 아래 경로의 Build.cs 파일에 의존성 코드를 추가하세요.

   • 경로: <프로젝트_루트>/Source/<프로젝트_이름>/<프로젝트_이름>.Build.cs
     • 의존성 코드:

       public class HIVESDKV4Tester : ModuleRules
       {
               public HIVESDKV4Tester(ReadOnlyTargetRules Target) : base(Target)
               {
                       PublicDependencyModuleNames.AddRange(new string[] { ... Others..., "HIVESDK"});
               }
       }
       

Step 3. Platform 패키지 설치¶

다운로드한 Hive SDK v4 UE5 {타깃 OS} 26.x.x.zip 압축 파일을 해제한 후, 생성된 폴더를 아래의 Unreal Engine 프로젝트 경로 중 타깃 OS에 맞추어 추가하세요.

• 경로: <프로젝트_루트>/Plugins/HIVESDK/Source

  <프로젝트_루트>
  └─ Plugins
          └─ Source
                  ├─ HiveSDK
                  ├─ HiveSDKAndroid    (선택)
                  ├─ HiveSDKiOS        (선택)
                  └─ HiveSDKWindows    (선택)
  

패키지 간 호환성¶

Interface 패키지와 Platform 패키지는 버전이 각기 다르더라도 아래의 패키지 적용 규칙에 따라 호환하여 적용할 수 있습니다.

• major.minor.patch 형식의 버전 구성 중 patch 버전 단위로만 호환됩니다. major와 minor 버전이 서로 일치하지 않으면 호환할 수 없습니다.
  • 예시 1: Interface 패키지 버전이 26.1.0인 경우, Platform 패키지 26.1.x 버전만 호환됩니다.(26.1.1, 26.1.2 등)
    • 예시 2: Interface 패키지 버전이 26.1.0 인 경우, Platform 패키지 26.0.0 또는 26.2.0 버전은 호환할 수 없습니다.

Hive SDK 업데이트¶

Hive SDK를 수동으로 업데이트하려면, 기존에 설치된 Hive SDK를 삭제 후 최신 버전을 설치합니다.

Step 1. Hive SDK 삭제¶

Interface 패키지 삭제¶

1. Unreal Engine <프로젝트_루트>/Plugins/HIVESDK 폴더를 삭제합니다.
2. 아래 경로의 Build.cs 파일 내 의존성 코드를 제거합니다.
   • 경로: Unreal Engine <프로젝트_루트>/Source/<프로젝트_이름>/<프로젝트_이름>.Build.cs
   • 의존성 코드:

     public class HIVESDKV4Tester : ModuleRules
     {
             public HIVESDKV4Tester(ReadOnlyTargetRules Target) : base(Target)
             {
                     PublicDependencyModuleNames.AddRange(new string[] { ... Others..., "HIVESDK(삭제)"});
             }
     }
     

Interface 패키지를 삭제하면 프로젝트 구조가 변경되었기 때문에 컴파일을 새롭게 수행하기 위해 Unreal Editor를 재실행해야 합니다.
Unreal Editor를 재실행하면 변경된 프로젝트 구조를 기준으로 컴파일이 자동으로 진행되는데, 이때 이전 프로젝트 구조에서 컴파일된 바이너리가 Intermediate, Binaries 폴더에 캐시처럼 남아있다면 빌드 에러가 발생합니다. 이 경우에는 Intermediate, Binaries 폴더를 삭제 후 Unreal Editor를 재실행하여 다시 컴파일 및 빌드 되도록 해야 합니다.

Platform 패키지 삭제¶

Unreal Engine <프로젝트_루트>/Plugins/HIVESDK/Source 경로에 설치된 Platform 패키지를 선택하여 삭제합니다.

<프로젝트_루트>
└─ Plugins
        └─ Source
                ├─ HiveSDK
                ├─ HiveSDKAndroid    (선택)
                ├─ HiveSDKiOS        (선택)
                └─ HiveSDKWindows    (선택)

Platform 패키지를 삭제하면 프로젝트 구조가 변경되었으므로, Editor 재빌드를 위해 Unreal Editor를 재실행합니다.

Step 2. 최신 버전 패키지 설치¶

Hive SDK 설치를 참고하여 최신 버전의 Interface 패키지와 Platform 패키지를 설치합니다.

주의 사항¶

Unreal Editor를 재실행하면 Unreal Engine 내장형 플러그인을 설치할 수 있습니다. 이때 CEF(Chromium Embedded Framework)를 사용한 WebBrowser는 Hive SDK에 적용된 CEF와 충돌이 발생하기 때문에 적용할 수 없습니다.