Android & iOS

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를 추가했습니다.