변경된 개발 언어로 Unity 기반의 게임을 개발할 때 Hive SDK를 포팅하는 방법과 Android 혹은 iOS 앱으로 빌드하는 방법을 안내합니다.

Hive SDK가 지원하는 Unity 버전

  • Unity 2018.4.24+
  • Unity 2019.3.7+
  • Unity 2020.1.0+
  • Unity 2021.1.0+
  • Unity 2018.4 LTS 이하 버전의 장기 지원이 종료됨에 따라 Unity는 향후 발생하는 버그 또는 이슈에 대해 조치하지 않습니다.
  • Unity 2019.4 LTS는 2021년 중반까지는 2주에 한 번, 2022년 5월까지는 한 달에 한 번 업데이트 지원 후 종료될 예정입니다.
  • Unity 2020은 현재 개발 중에 있으며, 최소 향후 2년간 업데이트 지원됩니다.

포팅하기

Unity 개발 환경을 이용한다면 Hive SDK를 플러그인의 형태로 Unity 개발 환경에 포팅해 주세요. 다음의 안내대로 Hive SDK를 개발 환경에 추가하고 필요한 설정 작업과 코드 작업을 수행하세요.

  1. Unity 개발 환경에 플러그인 추가하기
  2. 일반 설정하기
  3. Hive 설정하기
  4. 플러그인 초기화 코드 추가하기

개발 환경에 플러그인 추가하기

여러분의 게임 프로젝트를 Unity 개발 환경에서 열고, Assets > Import Package > Custom Package 메뉴에서 Plugin Package를 선택한 후 Hive 개발자 사이트에서 다운로드 받은 Unity용 Hive SDK를 선택하여 추가하세요.

Hive SDK가 정상적으로 추가되면 Unity 개발 환경 프로젝트 창에서 Hive SDK 파일을 볼 수 있습니다.

일반 설정하기

Android 앱과 iOS 앱의 설정 방법이 다릅니다. 다음 안내를 확인해 보세요.

Android

  1. File > Build Settings…를 클릭하세요. Build Settings 창이 나타납니다. Platform 목록에서 Android를 선택하세요.
  2. Switch Platform을 버튼을 클릭하세요. 플랫폼 스위치 과정이 진행됩니다.
  3. 플랫폼 스위치 과정이 완료되면 Build Settings 창에서 Player Settings… 버튼을 클릭하세요.
  4. Inspector 창의 Other Settings 섹션에서:
    • Bundle Identifier 필드에 게임의 AppID를 입력하세요. 게임 AppID를 모른다면 선행 작업 섹션을 읽어 보세요.
    • Minimum API Level을 API Level 15이상으로 설정하세요.
  5. Inspector 창의 Publish Settings 섹션에서 Signing Key를 설정하세요.

iOS

  1. File > Build Settings…를 클릭하세요. Build Settings 창이 나타납니다. Platform 목록에서 iOS를 선택하세요.
  2. Switch Platform 버튼을 클릭하세요. 플랫폼 스위치 과정이 진행됩니다.
  3. 플랫폼 스위치 과정이 완료되면 Build Settings 창에서 Player Settings… 버튼을 클릭하세요. Inspector 창이 나타납니다.
  4. Inspector 창에서:
    • Bundle Identifier 필드에 발급 받은 게임의 AppID를 입력하세요. 게임 AppID를 모른다면 선행 작업 섹션을 읽어 보세요.
    • Hive SDK가 지원하는 최소 iOS 버전대로 Target minimum iOS version을 설정하세요. Hive가 지원하는 최소 iOS버전은 8.0으로, Target Minimum iOS version 값을 8.0 이상으로 설정하세요.

Hive 설정하기

  1. 메뉴에서 Hive Edit Config 메뉴를 선택하세요. Inspector 화면이 나타납니다.
  2. Inspector 화면에서 Hive 이용에 필요한 값을 설정하세요.
    • OS를 선택하세요.
    • Authentication Version: 게임에서 사용하는 인증을 선택하세요.
    • Auth v4를 선택했다면 게임에서 사용하는 IdP의 정보를 발급받아 입력하세요. IdP 정보 발급은 Hive 설정을 참고하세요.
      • Facebook Settings: Facebook App ID 필드에 발급받은 게임의 Facebook App ID를 입력하세요.
      • Google Play Settings: Auth v4에서 Google Play Settings 항목은 OS를 Android로 선택 시에만 노출됩니다.
        • GooglePlay App Id 필드에 발급받은 Google Play 게임의 AppID를 입력하세요.
        • Google Server Client ID 필드에 발급받은 웹 애플리케이션의 Client ID값을 입력하세요. Google Server Client ID 필드는 Hive SDK v4.5.0 이상부터 Inspector에 입력창이 제공됩니다. v4.5.0 미만 사용 시에는 Android 설정을 참고하여 웹 애플리케이션의 Client ID값을 설정하세요.
      • QQ App ID Settings: QQ App Id 필드에 발급받은 QQ App Id를 입력하세요. QQ는 Hive SDK v4.5.0이상부터 사용이 가능합니다.
    • Auth v1을 선택했다면 게임에서 사용하는 SNS의 정보를 발급받아 입력하세요.
      • Facebook Settings: Facebook App ID 필드에 발급받은 게임의 Facebook App ID를 입력하세요.
      • Google Play Settings: GooglePlay App Id 필드에 발급받은 Google Play 게임의 AppID를 입력하세요.
    • HiveConfig Settings: hive_config.xml 파일에서 설정하는 값은 설정 가능 항목에서 확인할 수 있습니다.
    • HiveConfig Mobile App Tracking Settings: 이용할 마케팅 어트리뷰션에 대한 설정값을 입력하세요. 이용할 마케팅 어트리뷰션 대시보드에서 발급 받은 AppID, 키 혹은 토큰값을 입력합니다.
      마케팅 어트리뷰션 설정 가이드 보기
    • WriteExternalStoragePermission: Android에서 필요한 값으로, 외부 저장소 사용 권한을 유저에게 요청할 지 여부를 설정합니다. 체크하면 Hive 클라이언트가 단말기에서 초기화 될 때 유저에게 외부 저장소 권한을 요청합니다.
    • Android, Auth v4 선택 시 Inspector 스크린샷
    • Android, Auth v1 선택 시 Inspector 스크린샷
    • iOS, Auth v4 선택 시 Inspector 스크린샷
    • iOS, Auth v1 선택 시 Inspector 스크린샷
  3. Hive 설정 파일을 생성하세요.
    • Android: Regenerate Android Manifest & Hive Config 버튼을 클릭해 AndroidManifest.xml 파일과 hive_config.xml 파일을 생성하세요. hive_config.xml 파일은 다음의 디렉토리에 생성됩니다.
<프로젝트_루트>/Assets/Plugins/Android/res/raw/
  • iOS: Regenerate iOS Plist Hive Config 버튼을 클릭해 Info.plist 파일과 hive_config.xml 파일을 생성하세요. hive_config.xml 파일은 다음의 디렉토리에 생성됩니다.
<프로젝트_루트>/Assets/Plugins/iOS/

플러그인 초기화 코드 추가하기

Hive SDK Unity 플러그인을 사용하기 위해 GameObject를 생성하여 다음의 코드를 추가해 주세요. 코드는 반드시 Hive 클라이언트를 초기화하기 전 호출하세요.

 

빌드하기

Unity 개발 환경을 이용한다면 OS별로 다음 안내에 따라 빌드해주세요.

Android 빌드하기

Unity 개발 환경에서 Android용 앱을 빌드하려면 다음의 안내 중 하나를 선택하여 수행하세요.

  • Build Settings 창 이용하기:
    1. File > Build Settings…를 선택하세요. Build Settings 창이 나타납니다.
    2. Platform 목록에서 Android를 선택하세요.
    3. Build System 필드의 값으로 Gradle을 선택하세요.
    4. Build 버튼이나 Build And Run 버튼을 클릭하세요.
      • 바로 빌드하기: File > Build Run을 선택하세요.

Android Kotlin 빌드하기

Kotlin 언어로 개발한 Android용 앱을 빌드하려면 다음의 안내 중 하나를 선택하여 수행하세요.

  • Build Settings 창 이용하기:
    1. File > Build Settings…를 선택하세요. Build Settings 창이 나타납니다.
    2. Platform 목록에서 Android를 선택하세요.
    3. Build System 필드의 값으로 Gradle을 선택하세요.
    4. Build 버튼이나 Build And Run 버튼을 클릭하세요.
      • 바로 빌드하기: File > Build Run을 선택하세요.
    5. 64Bit 오류 발생 시 Player Settings > Inspector 설정에서 아래와 같이 변경합니다.

      • Scripting Backend: IL2CPP
      • Target Architectures: ARM64

Google Android Project Export용 빌드하기

Unity 개발 환경에서 개발한 프로젝트를 Google Android 프로젝트로 추출하려면 다음의 안내를 따라 수행하세요.

  1. File > Build Settings > Player Settings…를 선택하세요. Inspector 창이 나타납니다.
  2. Inspector 창의 Other Settings 섹션 아래 Bundle Identifier 값을 AppID와 동일한 값으로 입력하세요.
  3. Unity 개발 환경 버전에 따라 다음과 같이 수행하세요.
    • Unity 5.5 이상:
    1. File > Build Settings…를 클릭하세요. Build Settings 창이 나타납니다.
    2. Platform 목록에서 Android를 클릭하세요.
    3. Export Project 필드의 값으로 Gradle을 선택하세요.
    4. Export 버튼을 클릭해 Android 프로젝트를 추출하세요.
    • Unity 5.5 미만:
    1. File > Build Settings…를 클릭하세요. Build Settings 화면이 나타납니다.
    2. Platform 목록에서 Android를 클릭하세요.
    3. Google Android Project 필드를 체크하세요.
    4. Export 버튼을 클릭해 Android 프로젝트를 추출하세요.
  4. Android Studio를 실행시키고, Import project (Eclipse ADT, Gradle, etc.) 옵션을 선택하세요.
  5. Unity3D Android 프로젝트 경로를 선택하여 추출한 프로젝트를 임포트 하세요.

 

iOS 빌드하기

iOS용 앱을 빌드하려면 다음의 안내를 따르세요.

  1. Unity 개발 환경에서 File > Build Settings…를 클릭하세요. Build Settings 화면이 나타납니다.
  2. Platform 목록에서 iOS를 클릭하세요.
  3. Build 버튼을 클릭하여 Xcode 프로젝트를 생성하세요.
  4. 1-3번 단계에서 생성한 프로젝트를 Xcode에서 여세요.
  5. Xcode에서 Build Settings 탭을 선택한 후 bitcode를 검색하세요. 검색 결과로 나온 Enable Bitcode 옵션을 No로 선택하세요.

iOS Swift 빌드하기

Swift 언어로 개발한 iOS용 앱을 빌드하려면 다음의 안내를 따르세요.

  1. 지원 버전: Xcode 11 이상
  2. Unity 개발 환경에서 File > Build Settings…를 클릭하세요. Build Settings 화면이 나타납니다.
  3. Platform 목록에서 iOS를 클릭하세요.
  4. Build 버튼을 클릭하여 Xcode 프로젝트를 생성하세요.
  5. 1-3번 단계에서 생성한 프로젝트를 Xcode에서 여세요.
  6. Xcode에서 Build Settings 탭을 선택한 후 bitcode를 검색하세요. 검색 결과로 나온 Enable Bitcode 옵션을 No로 선택하세요.
  7. Build Settings > Always Embed Swift Standard Libraries 값을 Yes으로 설정합니다.
  8. 프로젝트 설정 > General 하위 Frameworks, Libraries, Embedded Content 항목의 구성이 아래와 같은지 확인하고, 파일이 없을 경우 + 버튼을 클릭해 추가합니다.
  9. 기존 SDK에서 변경된 파일을 삭제하거나 추가합니다. Hive SDK를 처음 사용한다면 이 단계를 실행하지 않습니다.

    • framework
      • HIVE_SDK.framwork 삭제
      • VKSdk.a 삭제
      • WXApi.a 삭제
      • Singular.a 삭제
      • HIVECore.framework 추가
      • HIVEProtocol.framework 추가
      • HIVEService.framework 추가
      • VKSdk.framework 추가
      • WXApi.framework 추가
      • Singular.framework 추가
    • resources
      • HIVE_SDK_resource.bundle 삭제
      • VKSdkResources.bundle 삭제
      • HIVEResource.bundle 추가

Unity 시뮬레이터 실행하기

Hive SDK v4.5.0 이상부터 Unity 시뮬레이터상에서 로그인 콜백을 받을 수 있습니다. 사용방법은 사용하는 인증에 따라 다릅니다.

인증 v4 사용 시
  1. unity 메뉴에서 Hive > LoginSimulator > Open AuthV4 Setting을 엽니다.
  2. playerId, playerName, playerImageUrl, playerToken, did에 원하는 값을 입력합니다. playerId는 int64 (long) 형식이니 주의하세요.
  3. Apply를 누르고 AuthV4, setup, signin을 시도합니다
인증 v1 사용 시
  1. unity 메뉴에서 Hive > LoginSimulator > Open AuthV1 Setting을 엽니다.
  2. did, vid, accessToken에 원하는 값을 입력합니다.
  3. Apply를 누르고 AuthV1, initialize와 login을 시도합니다.