Android & iOS

v4.25.1.3¶

다운로드¶

주의 사항¶

• 인증 보안 프로토콜 변경으로 인해, Hive SDK v4 Unreal Engine 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱 사용자들은 앱에서 로그인을 할 수 없습니다.

• PG 결제 프로세스의 변경으로 인해, Hive SDK v4 Unreal Engine 25.1.0 이상에서 PG 결제를 사용하려면 PG 결제 동작 과정을 참고하여 코드 구현을 수정해야 합니다.

개발 환경¶

공통 개발 환경¶

• Hive SDK v4 UE4 Android & iOS 25.1.3
• Unreal Engine 4.27 Plus
  Commit Hash: 37a1d6c1ab29a73574e7bfbc7a618977d80ab9c2

Unreal Engine 4: Android¶

• JDK 11
• Android Studio 4.1
• Android NDK r21
• Android SDK min version 24
• Android SDK target version 34

Unreal Engine 4: iOS¶

• Xcode 16.1+
• iOS Version 13.0+
• macOS Sequoia 15+

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.20.0

선택 항목¶

IDP¶

• Facebook SDK (Android) v17.0.0
• Facebook SDK (iOS) v17.4.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• Google Sign-In SDK (iOS) v8.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.17
• VK (Android) v3.5.1
• VK (iOS) v1.6.4
• WeChat (Android) v6.8.0
• WeChat (iOS) v2.0.4
• LINE (Android) v5.10.0
• LINE (iOS) v5.11.2
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.1
• OneStore (Android) v21.01.00
• WeChat (Android) v6.8.0
• Amazon (Android) v3.0.4
• Huawei (Android) v6.13.0.300

PUSH¶

• Amazon (Android) v1.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.1
• Adjust(Android) v5.0.1
• Adjust(iOS) v5.0.1
• Singular(Android) v12.6.1
• Singular(iOS) v12.6.1
• AppsFlyer(Android) v6.15.2
• AppsFlyer(iOS) v6.15.3
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v11.6.0

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.0.1
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

인증¶

• All 신규 인증 수단(IdP)으로 텔레그램을 지원합니다. Telegram 로그인을 위한 봇 설정을 참고하세요.

빌링¶

• iOS 유저에게 인앱 상품 소비 정보를 마켓에 전송할지의 동의 여부를 질의하는 기능을 신규 지원합니다.

마케팅 어트리뷰션¶

• All 마케팅 추적 이벤트 전송 시 Airbridge로 추가 어트리뷰트 전송하기 기능을 신규 지원합니다.
• Android Airbridge 디퍼드 딥링크 추적 기능을 신규 지원합니다.

채팅¶

• All 채팅 기능을 신규 지원합니다.

매치 메이킹¶

• All 매치 메이킹 기능을 업데이트하여 그룹 매치 메이킹 기능을 신규 지원합니다.

  ※ 이전 버전의 Hive SDK 인터페이스와 호환되지 않습니다. 업데이트된 매치 메이킹 기능을 사용하려면 Hive SDK v4 25.0.0 이상을 사용해야 합니다.

변경한 기능¶

인증¶

• All 더이상 사용하지 않는 Auth 모듈 클래스 및 인터페이스, 메서드, 대리자, 리스너를 삭제합니다
• All JWT 토큰을 사용해 더 강력한 보안 프로토콜을 적용합니다.
• All TalkPlus 지원 종료에 따라 TalkPlus 인증 토큰 메서드를 삭제합니다.
• Android Apple 로그인 웹뷰에서 로그인 기능 이외에 비밀번호 찾기 등과 같은 브라우징을 허용합니다.

빌링¶

• Android PG 결제의 동작 방식을 다른 빌링(IAPv4) 기능에 있는 마켓들과 동일하도록 변경합니다. Hive SDK v4 Unrel Engine 25.1.0 이상에서 PG 결제를 사용하려면 PG 결제 동작 과정을 참고하여 코드 구현을 수정해야 합니다.

프로모션¶

• All 초대 코드 정확도 향상을 위해 로그인 이벤트를 수집합니다.

마케팅 어트리뷰션¶

• All Adjust v5를 지원하도록 업데이트합니다.
  • Adjust Signature 라이브러리를 제거합니다.
• All Adjust로 Adiz 광고 매출 집계 시 AdMob 소스로 광고 매출 소스를 전송하도록 변경합니다.
• Android Appsflyer 광고 매출 집계 라이브러리가 메인 라이브러리에 통합된 부분을 반영합니다.
  • 6.14.2 → 6.15.2
  • Appsflyer ad-revenue 라이브러리를 제거합니다.

기타¶

• All 허큘리스 라이브러리 버전을 업데이트합니다.
  • Android: 20241120
  • iOS: 20241120
  • Unreal : 20241125

해결한 버그¶

인증¶

• Android signIn 메서드 실행 중 네트워크 응답 지연이 발생하면 간헐적으로 UI 스레드를 점유하는 문제를 해결합니다.

빌링¶

• iOS 유저 인게이지먼트를 사용해 인앱 상품 구매를 유도했을 때, IAP_UPDATE 이벤트가 추가로 발생하는 오류를 수정합니다.

프로모션¶

• iOS 이미지가 포함된 리뷰팝업 노출 중 회전 이벤트가 발생하는 경우, 노출 중인 이미지가 사리지는 오류를 수정합니다.

개발자 가이드 변경 사항¶

• 매치메이킹 > 그룹 매치에 Unreal Engine 예제 코드가 추가되었습니다.
• 채팅 > 채널을 포함한 전체 가이드에 Unreal Engine 예제 코드가 추가되었습니다.
• 빌링 > 소비 정보 전송 동의 여부 질의에 Unreal Engine 예제 코드가 추가되었습니다.
• 마케팅 어트리뷰션 > 이벤트 수동 추적 > Airbridge로 추가 어트리뷰트 전송하기에 Unreal Engine 예제 코드가 추가되었습니다.
• 시작하기 > 설치 후 작업 > Unreal Engine 4에 iOS 개발 환경에서 딥링크 설정을 위한 프로모션 추가 코드 적용 방법이 추가되었습니다.
• 시작하기 > 앱빌드 > Unreal iOS에 'HIVEAppDelegate 적용하기'와 'iOS FMallocAnsi 설정'이 제거되었습니다.

개발 환경 업데이트¶

Unreal Engine 4¶

• 4.27 plus (hash: ee4a7175fe6ea7620c3b78eea6332ebbb631b661 -> 37a1d6c1ab29a73574e7bfbc7a618977d80ab9c2)

Android¶

• AppsFlyer v6.14.2 → v6.15.2
• Adjust v4.38.5 → v5.0.1
• Singular v12.6.0 → v12.6.1

iOS¶

• Xcode 15.3 → 16.1
  • Xcode 버전의 업데이트로 iOS 최소 타겟이 13으로 상향되었습니다.
• SDWebImage v5.19.7 → v5.20.0
• Facebook v17.1.0 → v17.4.0
• Google Sign-In v7.1.0 → v8.0.0
• LINE v5.10.0 → v5.11.2
• AirBridge v4.1.0 → v4.1.1
• AppsFlyer v6.14.3 → v6.15.3
• Adjust v4.38.4 → v5.0.1
• Singular v12.5.0 → v12.6.1
• Firebase v10.29.0 → v11.6.0

v4.24.5.0¶

다운로드¶

개발 환경¶

공통 개발 환경¶

• Hive SDK v4 UE4 Android & iOS 24.5.0
• Unreal Engine 4.27 Plus
  Commit Hash: ee4a7175fe6ea7620c3b78eea6332ebbb631b661

Unreal Engine 4: Android¶

• JDK 11
• Android Studio 4.1
• Android NDK r21
• Android SDK min version 24
• Android SDK target version 34

Unreal Engine 4: iOS¶

• Xcode 15.3+
• iOS Version 12.0+
• macOS Ventura 14+

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.0.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.19.7

선택 항목¶

IDP¶

• Facebook SDK Android v17.0.0
• Facebook SDK iOS v17.1.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• Google Sign-In SDK (iOS) v7.1.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.17
• VK (Android) v3.5.1
• VK (iOS) v1.6.4
• WeChat (Android) v6.8.0
• WeChat (iOS) v2.0.4
• LINE (Android) v5.10.0
• LINE (iOS) v5.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.1
• OneStore (Android) v21.01.00
• WeChat (Android) v6.8.0
• Amazon (Android) v3.0.4
• Huawei (Android) v6.13.0.300

PUSH¶

• Amazon (Android) v1.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.0
• Adjust(Android) v4.38.5
• adjust-android-signature-3.20.1.aar
• Adjust(iOS) v4.38.4
• AdjustSigSdk 3.20.1
• Singular(Android) v12.6.0
• Singular(iOS) v12.5.0
• AppsFlyer(Android) v6.14.2
• AppsFlyer(iOS) v6.15.3
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v10.29.0

기타¶

• GooglePlay Services-Review (Android) v2.0.1
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

인증¶

• All 신규 인증 수단으로 Steam, X(구 Twitter)를 지원합니다.
  • 사전 준비: 공통
  • 사전 준비: Android
  • 사전 준비: iOS
  • 브랜딩 가이드
• All 인증된 세션을 공유하는 인웹브라우징 기능을 제공합니다.

매치 메이킹¶

• All 신규 기능으로 매치 메이킹 서비스를 지원합니다.

프로모션¶

• All 스팟 배너에서도 광고 노출이 가능합니다.
• Android 사용자 초대 공유하기 기능에 X(구 Twitter)를 지원합니다.

변경한 기능¶

플러그인¶

• Hive Config Settings 메뉴의 위치가 변경되고 타겟 플랫폼별 설정이 가능하도록 변경되었습니다.

인증¶

• All 충돌 팝업에서 노출하는 Provider 이름을 수정합니다.

해결한 버그¶

빌링¶

• iOS 일부 상품 가격이 부동 소수점으로 정확히 표현할 수 없는 가격일 때, 이 값을 JSON 포맷에서 순환 소수로 표현하지 않고 정확한 소수점으로 표현하도록 수정합니다.
  • 예> 4.99$ (string) → 4.9900000000000011 (double) → 4.99 (JSON number)

개발자 가이드 변경 사항¶

• 크로스 프로모션 전면 배너 노출에서 showCustomContents 메서드로 스팟 배너 노출 시 주의 사항을 노트에 업데이트했습니다.
• iOS에서 Steam 로그인 사용 시 주의사항을 노트로 추가했습니다.

개발 환경 업데이트¶

Android¶

• Google reCaptcha 18.4.0 → 18.6.1
• Kotlin 1.8.0 → 1.9.22
• FCM(FirebaseCloudMessaging) 23.2.1 → 24.0.2
• AppsFlyer 6.13.0 → 6.14.2
• Singular 12.5.4 → 12.6.0
• Firebase 21.5.0 → 22.1.2

iOS¶

• SDWebImage 5.18.7 → 5.19.7
• reCaptcha 18.4.0 → 18.6.0
• Facebook 17.0.2 → 17.1.0
• QQ 3.5.16 → 3.5.17 (커스텀)
• AppsFlyer 6.14.3 → 6.15.3
• Singular 12.4.1 → 12.5.0
• Firebase 10.22.0 → 10.29.0

v4.24.4.0¶

다운로드¶

개발 환경¶

Unreal Engine 4: Android¶

• Hive SDK v4 UE4 Android & iOS 24.4.0
• Unreal Engine 4.27 Plus
  Commit Hash: ee4a7175fe6ea7620c3b78eea6332ebbb631b661
• JDK 11
• Android Studio 4.1
• Android NDK r21
• Android SDK min version 24
• Android SDK target version 34

Unreal Engine 4: iOS¶

• Hive SDK v4 UE4 Android & iOS 24.4.0
• Unreal Engine 4.27 Plus
  Commit Hash: ee4a7175fe6ea7620c3b78eea6332ebbb631b661
• Xcode 15.3+
• iOS Version 12.0+
• macOS Ventura 14+

필수 항목¶

• Kotlin (Android) v1.8.0
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.0.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.18.7

선택 항목¶

IDP¶

• Facebook SDK Android v17.0.0
• Facebook SDK iOS v17.0.2
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• Google Sign-In SDK (iOS) v7.1.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.16
• VK (Android) v3.5.1
• VK (iOS) v1.6.4
• WeChat (Android) v6.8.0
• WeChat (iOS) v2.0.4
• LINE (Android) v5.10.0
• LINE (iOS) v5.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.1
• OneStore (Android) v21.01.00
• WeChat (Android) v6.8.0
• Amazon (Android) v3.0.4
• Huawei (Android) v6.13.0.300

PUSH¶

• Amazon (Android) v1.2.0
• FCM(FirebaseCloudMessaging) (Android) v23.2.1

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.0
• Adjust(Android) v4.38.5
• adjust-android-signature-3.20.1.aar
• Adjust(iOS) v4.38.4
• AdjustSigSdk 3.20.1
• Singular(Android) v12.5.4
• Singular(iOS) v12.4.1
• AppsFlyer(Android) v6.13.0
• AppsFlyer(iOS) v6.14.3
• FirebaseAnalytics(Android) v21.5.0
• FirebaseAnalytics(iOS) v10.22.0

기타¶

• GooglePlay Services-Review (Android) v2.0.1
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.4.0
• Google reCaptcha (iOS) v18.4.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

마케팅 어트리뷰션¶

• All Hive의 SDK 특화 서비스로 Airbridge를 지원합니다.
  • Airbridge로 이벤트 자동으로 추적하기
  • Airbridge로 이벤트 수동으로 추적하기

빌링¶

• Android PG 결제 시, 단일 상품을 원하는 수량만큼 구매할 수 있는 기능을 제공합니다.

변경한 기능¶

• N/A

해결한 버그¶

분석¶

• iOS 동의 배너에서 선택지를 하나만 선택한 경우, 올바르게 반영되지 않는 오류를 수정합니다.

개발 환경 업데이트¶

• N/A

개발자 가이드 변경점¶

• 마케팅 어트리뷰션에 문제 해결 가이드를 추가했습니다.

v4.24.3.0¶

다운로드¶

개발 환경¶

Unreal Engine 4: Android¶

• Hive SDK v4 UE4 Android & iOS 24.3.0
• Unreal Engine 4.27 Plus
  • Commit Hash: efd8cf7bd1770ab68ec34f10bd2e33579c4307b2
• JDK 11
• Android Studio 4.1
• Android NDK r21
• Android SDK min version 24
• Android SDK target version 34

Unreal Engine 4: iOS¶

• Hive SDK v4 UE4 Android & iOS 24.3.0
• Unreal Engine 4.27 Plus
  • Commit Hash: efd8cf7bd1770ab68ec34f10bd2e33579c4307b2
• Xcode 15.3+
• iOS Version 12.0+
• macOS Ventura 14+

필수 항목¶

• Kotlin (Android) v1.8.0
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.0.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.18.7

선택 항목¶

IDP¶

• Facebook SDK Android v17.0.0
• Facebook SDK iOS v17.0.2
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• Google Sign-In SDK (iOS) v7.1.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.16
• VK (Android) v3.5.1
• VK (iOS) v1.6.4
• WeChat (Android) v6.8.0
• WeChat (iOS) v2.0.4
• LINE (Android) v5.10.0
• LINE (iOS) v5.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• OneStore (Android) v21.01.00
• WeChat (Android) v6.8.0
• Amazon (Android) v3.0.4
• Huawei (Android) v6.13.0.300

PUSH¶

• Amazon (Android) v1.0.1
• FCM(FirebaseCloudMessaging) (Android) v23.2.1

MARKETING TRACKING ANALYTICS¶

• Adjust(Android) v4.38.5
• Adjust(iOS) v4.38.4
• Singular(Android) v12.5.4
• Singular(iOS) v12.4.1
• AppsFlyer(Android) v6.13.0
• AppsFlyer(iOS) v6.14.3
• FirebaseAnalytics(Android) v21.5.0
• FirebaseAnalytics(iOS) v10.22.0

기타¶

• GooglePlay Services-Review (Android) v2.1.0
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.4.0
• Google reCaptcha (iOS) v18.4.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

Unreal Engine¶

• All [플러그인] Unreal Engine 전용 인터페이스를 제공합니다.
• 기존 C++ 인터페이스와 호환 가능합니다.

• All 신규 Unreal Engine 전용 인터페이스를 지원하는 샘플 코드를 제공합니다.

• All Unreal Engine 5.4 지원합니다.

프로비저닝¶

• All 약관 화면에서 법정 대리인 동의를 받았는지 확인하는 기능을 추가합니다.
• Configuration 클래스의 getLegalGuardianConsentAgree 메소드 리턴값으로 확인할 수 있습니다.

변경한 기능¶

인증¶

• All 로그아웃 동작을 변경합니다.
  • 기존: signOut 호출 시 Hive SDK에서 사용자 계정을 로그아웃
  게스트는 signOut API 호출 시 서버에서 실패 응답
  • 변경: signOut 호출 시 Hive SDK는 Hive 서버에 사용자 계정을 로그아웃시켜도 되는지 확인 요청 후 응답 결과에 따라 로그아웃
• All 게스트 계정 로그아웃 시 더는 성공 응답을 반환하지 않고, 에러 코드를 반환합니다. Hive SDK와 Hive 서버에서 게스트 계정 세션을 유지합니다.
• All 이용 정지 계정은 자동으로 IdP 로그아웃을 시켜서 동일 IdP 다른 계정으로 로그인할 수 있도록 변경합니다. 자동 로그인을 할 수 없는 경우에만 해당합니다.
• All `AuthV4.connect` 메서드로 IdP 연동을 진행할 때, 이용 정지 계정으로 계정을 전환하면, 로그아웃을 수행하도록 변경합니다.
• All 기기 관리 서비스에서 국제 전화 국가 번호를 기기 접속 지역에 따라 자동으로 적용하도록 변경합니다.
• iOS 앱 추적 투명화(ATT) 동의를 거절한 경우에도 페이스북 로그인을 할 수 있도록 변경합니다.

프로모션¶

• All additionalInfo로 전송하는 값에 불 필요한 정보가 담기지 않도록 수정합니다.
• All 2:3 또는 3:2 비율로 전면 배너를 노출할 수 있도록 변경합니다.
• All 전면 배너에서 "1일 동안 그만 보기" 텍스트를 "오늘은 그만 보기"로 변경합니다.

마케팅 어트리뷰션¶

• All Adjust Signature 버전을 v1에서 v3로 변경합니다.

해결한 버그¶

Hive SDK 공통¶

• Android 리소스 참조 로직을 수정하여 메모리를 확보하지 못했던 오류를 수정합니다.
• iOS iOS 14 기기에서 앱 추적 투명화(ATT) 동의 여부를 확인할 때 간헐적으로 크래시가 발생하는 오류를 수정합니다.
• iOS 사진첩에서 접근 제한(일부 사진만 접근 허용)을 선택하면 크래시가 발생하는 오류를 수정합니다.

노티피케이션¶

• Android 로컬 푸시 알림에서 지원하지 않는 type 설정 시 푸시 메시지가 정상 노출되지 않는 오류를 수정합니다.
• iOS 앱 버전 정보를 전송하도록 수정합니다.

개발 환경 업데이트¶

Android¶

• Google Play Billing Library 6.1 → 7.0
• Google Play Service Games 20.0.0 → 20.1.2
• Adjust 4.38.5 → 4.38.2

iOS¶

• Facebook SDK 16.2.1 → 17.0.2
• Adjust 4.38.0 → 4.38.4

v4.24.1.3¶

다운로드¶

개발 환경¶

Unreal Engine 4: Android¶

• Unreal Engine 4.27 Plus
  • Commit Hash: 0db0b74ff0822a57a5ce49a4cd10c8672fc57a4b
• JDK 8
• AndroidStudio 4.1
• Android NDK r21
• Android SDK min version 21
• Android SDK target version 34

Unreal Engine 4: iOS¶

• Unreal Engine 4.27 Plus
  • Commit Hash: 0db0b74ff0822a57a5ce49a4cd10c8672fc57a4b
• Xcode 15.1+
• iOS Version 12.0+
• macOS Ventura 14+

필수 항목¶

• Kotlin (Android) v1.8.0
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.0.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.18.7

선택 항목¶

IDP¶

• Facebook SDK Android v17.0.0
• Facebook SDK iOS v16.2.1
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.0.0
• Google Sign-In SDK (iOS) v7.1.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.16
• VK (Android) v3.5.1
• VK (iOS) v1.6.4
• WeChat (Android) v6.8.0
• WeChat (iOS) v2.0.4
• LINE (Android) v5.10.0
• LINE (iOS) v5.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v6.0.1
• OneStore (Android) v21.01.00
• WeChat (Android) v6.8.0
• Amazon (Android) v3.0.4
• Huawei (Android) v6.13.0.300

PUSH¶

• Amazon (Android) v1.0.1
• FCM(FirebaseCloudMessaging) (Android) v23.2.1

MARKETING TRACKING ANALYTICS¶

• Adjust(Android) v4.38.2
• Adjust(iOS) v4.38.0
• Singular(Android) v12.5.4
• Singular(iOS) v12.4.1
• AppsFlyer(Android) v6.13.0
• AppsFlyer(iOS) v6.14.3
• FirebaseAnalytics(Android) v21.5.0
• FirebaseAnalytics(iOS) v10.22.0

기타¶

• GooglePlay Services-Review (Android) v2.1.0
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.4.0
• Google reCaptcha (iOS) v18.4.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

변경한 기능¶

인증¶

• All 기기 관리 서비스 이용중 모바일 기기 등록 시, 국제 전화 국가 번호를 +82가 아니라 기기 접속 지역에 따라 자동으로 적용하도록 변경합니다.

v4.24.1.2 (2024-07-01)¶

다운로드¶

개발 환경¶

Unreal Engine 4: Android¶

• Unreal Engine 4.27 Plus
  • Commit Hash: 0db0b74ff0822a57a5ce49a4cd10c8672fc57a4b
• JDK 8
• AndroidStudio 4.1
• Android NDK r21
• Android SDK min version 21
• Android SDK target version 34

Unreal Engine 4: iOS¶

• Unreal Engine 4.27 Plus
  • Commit Hash: 0db0b74ff0822a57a5ce49a4cd10c8672fc57a4b
• Xcode 15.1+
• iOS Version 12.0+
• macOS Ventura 14+

필수 항목¶

• Kotlin (Android) v1.8.0
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.0.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.18.7

선택 항목¶

IDP¶

• Facebook SDK Android v17.0.0
• Facebook SDK iOS v16.2.1
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.0.0
• Google Sign-In SDK (iOS) v7.1.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.16
• VK (Android) v3.5.1
• VK (iOS) v1.6.4
• WeChat (Android) v6.8.0
• WeChat (iOS) v2.0.4
• LINE (Android) v5.10.0
• LINE (iOS) v5.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v6.0.1
• OneStore (Android) v21.01.00
• WeChat (Android) v6.8.0
• Amazon (Android) v3.0.4
• Huawei (Android) v6.13.0.300

PUSH¶

• Amazon (Android) v1.0.1
• FCM(FirebaseCloudMessaging) (Android) v23.2.1

MARKETING TRACKING ANALYTICS¶

• Adjust(Android) v4.38.2
• Adjust(iOS) v4.38.0
• Singular(Android) v12.5.4
• Singular(iOS) v12.4.1
• AppsFlyer(Android) v6.13.0
• AppsFlyer(iOS) v6.14.3
• FirebaseAnalytics(Android) v21.5.0
• FirebaseAnalytics(iOS) v10.22.0

기타¶

• GooglePlay Services-Review (Android) v2.1.0
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.4.0
• Google reCaptcha (iOS) v18.4.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

해결한 버그¶

인증¶

• Android 구글 로그인 진행중 뒤로가기 버튼을 눌러 로그인을 취소했을 때 적절한 응답 콜백이 없었던 오류를 수정합니다. 이 버그는 Hive 콘솔 내에 Google Legacy Support 값이 참인 경우에만 발생했습니다.
• Android 낮은 해상도 기기에서 키보드 입력을 할 수 없었던 오류를 수정합니다.

v4.24.1.0 (2024-06-07)¶

새로운 기능¶

N/A

변경한 기능¶

애널리틱스¶

• iOS 기기의 추적 동의 여부에 따라 동의배너 노출여부를 결정하도록 변경합니다.
  • 추적 동의를 거절한 경우에는 동의배너를 노출하지 않습니다.

개발 환경 업데이트¶

iOS¶

• Apple Privacy Manifest 정책 대응에 따라 외부 라이브러리를 업데이트 합니다.
  • AppsFlyer(iOS) v6.13.1 → v6.14.3
  • QQ (iOS) v3.5.14 → v3.5.16
• Facebook SDK를 다운그레이드합니다.
  • Facebook SDK v17.0.0 → v16.2.1

해결한 버그¶

빌링¶

• iOS Hive SDK v4 24.0.0 미만 버전(예: v4 23.4.0)에서 v4 24.0.0으로 업데이트하는 경우, 상품 조회가 되지 않는 오류를 수정합니다.

v4.24.0.0 (2024-04-30)¶

새로운 기능¶

프로모션¶

• Android 외부 페이지 노출을 위해 기기에 설정된 기본 브라우저를 이용하는 커스텀 탭을 지원합니다. PlatformHelper 클래스 showInAppBrowser 메서드로 인앱 브라우저를 노출할 수 있습니다.
• iOS 외부 페이지 노출을 위해 브라우저를 이용하는 SafariViewController를 지원합니다. PlatformHelper 클래스 showInAppBrowser 메서드로 인앱 브라우저를 노출할 수 있습니다.

빌링¶

• iOS 첫 구독 할인 정보가 있는 경우 상품 정보 조회 시 함께 전달합니다. getProductInfo 사용 시 콜백으로 받는 IAPV4Product 객체 목록에서 original_price 필드값과 price 필드값의 차이로 할인 정보를 확인할 수 있습니다.

변경한 기능¶

Hive SDK 공통¶

• iOS 앱 버전을 구분할 때 CFBundleShortVersionString을 추가로 사용합니다.

빌링¶

• All 환불 유저 재결제 UI에서 노출되는 PG 결제 타입 문구를 "HiveStore"에서 "PG 결제"로 변경했습니다.
• Android PG 결제 페이지를 인앱 브라우저가 아니라 인앱 웹뷰에서 노출하도록 변경합니다. 인앱 브라우저 환경을 지원하지 않는 기기에서도 PG 결제를 지원합니다.

애널리틱스¶

• Android Firebase 이벤트 수집 기능 중 광고 식별자 수집 설정 기본값을 true로 변경합니다.

알려진 문제점¶

인증¶

• iOS Facebook SDK iOS 17.0.0 사용 시 iOS 17.0 이상 기기에서 사용자가 "앱 추적 투명성(App Tracking Transparency)"에 동의하지 않는 경우 로그인을 할 수 없는 문제가 있습니다. 해당 조건에서 Facebook 로그인을 구현하려면 Hive SDK v4 24.1.0을 사용하세요.

개발 환경 업데이트¶

Unreal Engine 4¶

• Unreal Engine 4.27 Plus
  • Commit Hash: 0db0b74ff0822a57a5ce49a4cd10c8672fc57a4b

Android¶

• GooglePlay Services-Games v2 (Android) v19.0.0 → 20.0.0
• Facebook SDK Android v16.2.0 → 17.0.0
• LINE (Android) v5.9.1 → 5.10.0

iOS¶

• WeChat 2.0.2 → 2.0.4
• Hercules 2024.01.23 → 2024.04.11
• Singular 12.3.2 → 12.4.1

개발자 가이드 변경점¶

• displayOriginalPrice 설명을 변경했습니다.
• displayPrice 하단 Note 설명을 변경했습니다.
• Hive 기능 선택 적용하기 (Android, iOS) 이미지가 변경되었고 하단에 Note를 추가했습니다.