콘텐츠로 이동

SDK Native 릴리스 노트

Hive SDK Native의 버전 별 주요 업데이트 사항을 안내합니다.

Hive SDK Native의 타겟 OS별 업데이트 사항은 아래와 같은 OS 라벨로 구분합니다.

  • Android SDK Native Android에 해당하는 업데이트 사항
  • iOS SDK Native iOS에 해당하는 업데이트 사항
  • Windows SDK Native Windows에 해당하는 업데이트 사항
  • All SDK Native Android, iOS, Windows에 모두 해당하는 업데이트 사항

필수 숙지 사항

Hive SDK 각 릴리스 버전을 사용하기에 앞서, 버전별 제약 사항과 관련해 필수로 숙지해야 하는 설정 사항을 안내합니다.

  • Hive SDK v4 Native 25.0.0 이상에서 보안 키 발급 필수
    • 인증 보안 프로토콜 변경으로 인해, Hive SDK v4 Native 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱에서 로그인할 수 없습니다.
  • Hive SDK v4 Native 25.1.3 이상에서 PG 결제 구현 변경 필요
    • Android 25.1.3 이상에서 PG 결제를 구현하려면 PG 결제 동작 과정을 참고하여 PG 결제 구현 코드를 변경해야 합니다.

v4.26.1.0

타겟 OS별 SDK 배포일
SDK Native Android 2026-01-13
SDK Native iOS 2026-01-13

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능

빌링
인증
  • All 생년월일을 입력하는 팝업을 노출한 후, 사용자가 생년월일을 입력하면 그 값을 콜백으로 리턴하는 AuthV4.checkAgeGate 메서드를 제공합니다.
  • All 현재가 아닌 다음 로그인 세션을 자동 로그인용 세션으로 등록(ON/OFF)하는 AuthV4.setAutoLoginEnabled 메서드를 추가합니다. ON으로 설정 후 AuthV4.Helper.signIn을 실행하거나 AuthV4.signInProviderType.AUTO로 실행하면 자동 로그인을 사용할 수 있습니다.
  • Android Xiaomi로 로그인을 사용하도록 지원합니다.
프로모션
  • All 앱 미설치 사용자가 다이렉트 링크를 클릭하면, 앱 설치 완료 후에도 링크에 지정된 앱 내 페이지로 이동시키는 디퍼드 딥링크를 지원합니다.
기타
  • All Configuration 클래스에 getGameLanguage 메서드로 SDK에 설정한 언어 설정값을 확인할 수 있습니다.
  • Android 게임 내 웨뷰로 열기에서 PlatformHelper 클래스의 showInWebView 메소드로 웹뷰를 노출하는 경우 Hive Activity가 아닌 Game Activity를 사용하여 노출하는 옵션을 제공합니다.
  • iOS CocoaPod 서비스 종료에 따라 SPM(Swift Package Manager)를 통한 배포 서비스를 제공합니다.

변경한 기능

라이브러리 업데이트
  • Android Amazon AppStore (Android) v3.0.4 → v3.0.8
    • Samsung GalaxyStore IAP (Android) v6.1.1 → v6.5.0
    • Google Billing Library (Android) v7.0.0 → v8.0.0
    • QQ (Android) v3.5.17 → v3.5.18
    • Xiaomi (Android) v3.2.5_12798 → v3.4.6
  • iOS Adjust (iOS) 5.4.3 → 5.4.6
    • Airbridge (iOS) 4.7.0 → 4.8.1
    • AppsFlyer (iOS) 6.17.2 → 6.17.7
    • Firebase (iOS) 11.15.0 → 12.5.0
    • Singular (iOS) 12.8.1 → 12.9.0
    • Facebook (iOS) 18.0.0 → 18.0.2
    • Line (iOS) 5.13.0 → 5.14.0
    • QQ (iOS) 3.5.17.5 → 3.5.18
    • SDWebImage (iOS) 5.21.1 → 5.21.5
    • Recaptcha (iOS) 18.7.0 → 18.8.2
마케팅 어트리뷰션
  • All MMP에 전송하는 동일 영수증의 매출 로그가 중복 발송되지 않도록 변경합니다.
  • All Firebase 구매 이벤트 전송 시 value 키에도 매출값을 전송하도록 추가합니다.
    • 기존에는 revenue 키에 매출값을 전송하였습니다.
빌링
  • Android Google Play 결제 시 사용하는 라이브러리를 Google Play Billing Library 8.0 으로 변경합니다.
애널리틱스
  • All DMA 동의 배너 노출하기의 팝업 디자인을 변경하고 동작을 개선합니다.
    • 기존 동의 배너에서 이미 동의한 이력은 그대로 유지되며, 재노출 시 개선된 문구와 UI의 새로운 동의 배너가 표시됩니다.
    • 기존 동의 배너의 문구를 커스텀하여 사용 중이었다면, 변경된 데이터 구조에 맞춰 커스텀 동의 배너 UI 설정를 참고하여 다시 설정해야 합니다.
인증
  • All 성인 인증 방식으로 웹 뿐만 아니라 앱을 통한 방식도 지원합니다.
  • All SNS 로그인 시 프로필 이미지 및 닉네임 자동 수집 기능을 제거합니다.
  • All AuthV4.setAutoLoginEnabled(기본값: PC OFF / Mobile ON) 추가에 따라 자동 로그인 동작 정책을 다음과 같이 변경합니다.
  • 기존: 계정 충돌 발생 후 다른 계정으로 전환할 때, 바뀐 계정은 모바일은 자동 로그인을 유지하고, PC는 자동 로그인을 해제
  • 변경: 계정 충돌 발생 후 다른 계정으로 전환할 때, 바뀐 계정은 모바일과 PC 모두 AuthV4.setAutoLoginEnabled로 자동 로그인 세션 등록을 했다면 자동 로그인 유지, 안 했다면 해제 (예외 상황 존재)
푸시
  • iOS 푸시 발송을 위한 토큰 수집 시, 빌드 환경에 따라 토큰 추가 정보를 수집하도록 변경합니다.
프로모션
  • All 커스텀 뷰/다이렉트 뷰를 통해 외부 브라우저로 이동할 때 웹뷰가 깜빡거리는 오류를 해결합니다.
프로비저닝
  • All 앱스토어 책임법에 대응할 수 있는 Age Range API를 선택 적용할 수 있도록 분리하여 제공합니다.
    • 2026년 1월 1일 미국 텍사스주에서 시행되는 앱 스토어 책임법은 시행 보류 중인 상태로 개발 상황에 따라 선택하여 적용할 수 있습니다.
    • 2026년 5월 미국 유타주, 7월 루이지애나 주에서 시행되는 앱 스토어 책임법에 대응하여 선택하여 적용할 수 있습니다.
기타
  • All Configuration.setZone 동작이 초기화 이전까지만 유효하도록 변경되었습니다.
  • All PlatformHelper 클래스의 showInAppView 메소드로 노출되는 웹뷰 닫기 버튼의 시인성을 개선합니다.

해결한 버그

  • Android 전체 공통된 영역의 UI의 뒷배경이 불투명한 경우 컷아웃 영역 이내로 노출되도록 수정합니다.
기타
  • iOS PlatformHelper 클래스의 showInAppBrowser 메소드를 적용했을 때, 게임 앱 사용자의 네트워크 상태가 오프라인 상태이거나 오프라인으로 변경되는 경우 게임 앱이 깜빡이며 창이 닫히는 현상을 수정합니다.
마케팅 어트리뷰션
  • iOS Firebase 에서 Install 또는 Update 이벤트가 누락되는 오류를 수정합니다.
인증
  • iOS 챗봇 사용 중 채팅 메시지 입력 필드가 간헐적으로 노출되지 않는 오류를 수정합니다.
  • iOS 기기관리 등록 개수를 초과한 상태에서 성인 인증 후 등록된 기기를 삭제하면 다시 성인 인증 팝업이 노출되는 오류을 수정합니다.
푸시
  • Android COPPA 대상인 경우에도 푸시 알림을 위한 토큰이 수집되는 오류을 수정합니다.
  • iOS ForegroundPush 설정이 False로 변경되지 않는 오류를 수정합니다.
프로모션
  • iOS 새소식 메뉴의 개수가 일정 수를 초과하면 정상적으로 동작하지 않는 오류를 수정합니다.
  • iOS 전면 배너에 노출하는 이미지의 가로 또는 세로의 길이가 '0'이거나 서버에서 잘못된 정보를 전송하는 경우 정상적으로 동작하지 않는 오류를 수정합니다.
  • iOS 다이렉트 링크로 커뮤니티를 노출하는 경우 URL 파라미터가 없으면 다이렉트 링크가 동작하지 않는 오류를 수정합니다.

v4.26.0.1

타겟 OS별 SDK 배포일
SDK Native Android 2025-12-18
SDK Native iOS 2025-12-18

변경한 기능

  • iOS Hive SDK 개발 환경으로 Xcode 버전이 아래와 같이 변경됩니다.
    • 기존: Xcode 26.2 Beta2
    • 변경: Xcode 26.2
프로비저닝
  • Android 앱스토어 책임법 대응하여 Hive SDK에서 지원하는 Google Play Age Signals API버전이 아래와 같이 변경됩니다.
    • 기존: 0.0.1-Beta2
    • 변경: 0.0.2

v4.26.0.0

타겟 OS별 SDK 배포일
SDK Native Android 2025-12-08
SDK Native iOS 2025-12-08

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능

  • iOS iOS Xcode 26.2 이상에서 Hive SDK를 빌드할 수 있습니다.
    • 최소 지원 OS 버전은 iOS 15 입니다.
프로비저닝
  • Android 컴플라이언스 기능을 새롭게 추가합니다.
    • Google Play와 Amazon Appstore로 게임 앱을 배포하는 경우, Hive SDK에서는 2026년 1월 1일 미국 텍사스주에서 시행되는 앱 스토어 책임법에 대응하기 위해 사용자 연령 범위를 확인하는 Age Range API 를 제공합니다.
  • iOS 컴플라이언스 기능을 새롭게 추가합니다.
    • Apple App Store로 게임 앱을 배포하는 경우, Hive SDK에서는 2026년 1월 1일 미국 텍사스주에서 시행되는 앱 스토어 책임법에 대응하기 위해 사용자 연령 범위를 확인하는 Age Range API 를 제공합니다.
      • iOS 26.2 이상에서만 지원합니다.

알려진 이슈

프로비저닝
  • Android 앱스토어 책임법에 대응하여 Hive SDK 26.0.0 Beta에서 지원하는Google Play Age Signals API 0.0.1-beta02 버전은 실제 연령 신호를 수신하는 사용자 환경에서는 사용할 수 없습니다.
    실제 연령 신호를 수신하려면 Google Play Age Signals API 0.0.2 버전(비베타 버전)을 지원하는 Hive SDK v4.26.0.1로 업데이트하세요.

v4.25.9.0

타겟 OS별 SDK 배포일
SDK Native Android -
SDK Native iOS -

안내 사항: 본 SDK 버전은 별도 배포 파일을 제공하지 않으며, 해당 기능은 상위 버전 SDK에 포함됩니다.

새로운 기능

인증
  • All 본인 확인 서비스를 제공합니다.
    • SteamDeck에서는 본인 확인 서비스(본인 확인, 성인 인증, 보호자 동의)를 제공하지 않습니다. 모바일 또는 PC에서 본인 확인 서비스를 이용 후 다시 SteamDeck에서 게임에 접속해야 합니다.

v4.25.8.0

타겟 OS별 SDK 배포일
SDK Native Android 2025-10-02
SDK Native iOS 2025-10-02

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능

  • Android Android OS 16(API Level 36)을 지원합니다.
  • Android Android OS 15(API Level 35) 이상으로 빌드 시, 16KB Page Size 빌드를 지원합니다.

변경한 기능

  • Android 더 이상 사용하지 않는 android.permission.FOREGROUND_SERVICE 권한을 제거합니다.
  • Android Android 최소 빌드 타겟이 1923으로 변경됩니다.
라이브러리 업데이트
  • Android Adjust(Android) 5.2.0 → 5.4.2
    • Airbridge(Android) 4.3.0 → 4.7.1
    • AppsFlyer(Android) 6.16.2 → 6.17.3
    • Firebase-analytics(Android) 22.1.2 → 23.0.0
    • Singular(Android) 12.7.0 → 12.10.0
    • Facebook(Android) 17.0.0 → 18.0.1
    • Line(Android) 5.10.0 → 5.11.1
    • play-services-auth(Android) (Google Sign-In) 20.7.0 → 21.3.0
    • play-services-games-v2(Android) (Play Games Services) 20.1.2 → 21.0.0
    • play-services-ads-identifier(Android) 18.0.1 → 18.2.0
    • play-services-analytic(Android) 18.0.4 → 18.1.1
    • firebase messaging(Android) 24.0.2 → 25.0.0
    • onestore(Android) 21.01.00 → 21.02.01
    • google-core-review(Android) 2.0.1 → 2.0.2
    • Recaptcha(Android) 18.6.1 → 18.7.1
    • Kotlin(Android) 1.9.22 → 2.1.21
  • iOS Adjust(iOS) 5.2.0 → 5.4.3
    • Airbridge(iOS) 4.3.0 → 4.7.0
    • AppsFlyer(iOS) 6.16.1 → 6.17.2
    • Firebase(iOS) 11.6.0 → 11.15.0
    • Singular(iOS) 12.7.1 ->12.8.1
    • Facebook(iOS) 17.4.0 → 18.0.0
    • Google Sign-In(iOS) 8.0.0 → 9.0.0
    • Line(iOS) 5.11.2 ->5.13.0
    • QQ(iOS) 3.5.17.4 → 3.5.17.5
    • SDWebImage(iOS) 5.20.0 → 5.21.1
    • Recaptcha(iOS) 18.6.0 → 18.7.0
인증
  • iOS Xcode 26에서 빌드 시 사용할 수 없는 라이브러리 참조를 제거합니다.

해결한 버그

분석
  • Android 클라이언트 동접 전송 실패 시, 불필요한 정보를 포함하여 재전송하지 않도록 수정합니다.
인증
  • iOS 챗봇 팝업 노출 시, 세로 모드가 아닌 가로 모드가 간헐적으로 노출되는 오류를 수정합니다.
  • iOS 빈배열 참조 오류가 발생하지 않도록 수정합니다.
    • Authv4 클래스의 showConflict 메서드 사용 시, 필수 입력 데이터가 없는 경우 크래시가 발생합니다.

v4.25.7.0

타겟 OS별 SDK 배포일
SDK Native Android -
SDK Native iOS -

안내 사항: 본 SDK 버전은 별도 배포 파일을 제공하지 않으며, 해당 기능은 상위 버전 SDK에 포함됩니다.

새로운 기능

인증
  • All 성인 인증을 완료하면 성인 인증된 사용자를 식별할 수 있습니다. 식별하는 값을 얻는 메서드를 제공합니다. 식별 정보는 해시한 DI값 입니다.

변경한 기능

인증
  • All Hive 콘솔에서 성인 인증을 사용하는 앱을 설정하면, 로그인 이후 성인 인증 절차가 자동으로 수행됩니다.
    • 한국에서만 지원하는 기능입니다.
  • All 성인 인증을 수행하는 showAdultConfirm 메서드를 deprecated합니다.
    • showAdultConfirm 메서드는 이후 업데이트 시 제거할 수 있습니다.

v4.25.6.0

타겟 OS별 SDK 배포일
SDK Native Android 2025-07-31
SDK Native iOS 2025-07-31

새로운 기능

채팅
  • All 특정 채팅 메시지에 '좋아요'를 표현하거나, 표기할 수 있는 기능을 추가합니다.
  • All 특정 채팅 메시지의 '답글'을 작성하거나, 답글 연결 관계를 표기할 수 있는 정보를 제공합니다.
  • All 특정 사용자를 멘션하거나, 사용자를 멘션하는 정보를 제공하는 기능을 제공합니다.

변경한 기능

채팅

v4.25.5.2

타겟 OS별 SDK 배포일
SDK Native iOS 2025-07-30

해결한 버그

인증
  • iOS 가로모드에서 챗봇을 노출하는 경우 크래시가 발생하는 오류를 수정합니다.

v4.25.5.1

타겟 OS별 SDK 배포일
SDK Native Android 2025-07-23
SDK Native iOS 2025-07-23

새로운 기능

노티피케이션
  • All 푸시 액션 버튼을 신규로 제공합니다.
    • 푸시 알람 수신 시, 푸시 선택 액션 버튼을 통해 사전에 정의된 액션을 수행할 수 있습니다.
인증
  • All 여러 계정 간 전환 기능을 신규로 제공합니다. 관련 세부 기능은 아래와 같습니다.
    • 현재 로그인된 계정을 기기에 저장
    • 저장된 계정을 조회
    • 저장된 계정을 로그아웃하고 삭제
    • 저장된 다른 계정으로 빠른 로그인
채팅
  • All 메시지 전송
    • 채팅 메시지가 사용자의 언어로 자동 번역되어 수신하는 기능과 특정 메시지를 번역하는 기능을 추가합니다.
    • 특정 언어 사용자만 수신할 수 있는 공지 메시지 기능을 추가합니다.
    • 웹소켓 메시지에 메시지 id값을 추가하여 콜백의 순서 보장을 제공합니다.
  • All 채널
    • 채팅 채널 입장 시 이전 대화 이력을 조회할 수 있는 기능을 추가합니다.
    • 현재 채널에 참여한 인원수를 제공합니다.
    • 채널 목록 조회시 정렬 기준 기능을 제공합니다.
  • All 이벤트 관리
  • All 연결 관리
    • 재연결 기능을 추가합니다.
프로모션
허큘리스 업데이트
  • Android 20241125-2 -> 20250527
  • iOS 20241120 -> 20250218

변경한 기능

  • Android 빌드에 필요한 난독화 규칙을 업데이트합니다.
  • iOS 분리되어 제공되었던 HiveAppTrackingTransparents.framework 라이브러리가 Service.framework에 통합됩니다.
마케팅 어트리뷰션
  • iOS 자동으로 수집하는 Firebase 구매 이벤트를 활성화한 경우 지원하도록 변경합니다.
인증
  • All Hive 멤버십 계정을 사용하지 않는 경우 동작하지 않았던 showMyInquiry 메소드를 사용 시 문의하기 페이지가 노출되도록 변경합니다.
  • Android VK 인증 팝업을 웹뷰에서 인앱브라우저로 변경합니다.

해결한 버그

분석
  • iOS 약관 동의가 끝난 직후 Analytics 로그를 전송 가능하도록 로직을 수정합니다.
프로모션
  • iOS iPad 기기에서 새소식 UI의 모서리 곡률을 수정합니다.
프로비저닝
  • iOS 약관 노출시 웹뷰 스크롤이 되지 않도록 수정합니다.

알려진 이슈

기타
  • iOS 가로모드에서 챗봇을 사용하는 경우 크래시가 발생하는 오류가 발생합니다.
    • Hive SDK Unity iOS 25.5.2 이상으로 업데이트 하세요.

v4.25.2.2

타겟 OS별 SDK 배포일
SDK Native Android 2025-06-23

본 SDK 버전의 개발 환경을 확인하세요.

변경한 기능

라이브러리 업데이트
  • Android * GooglePlay Services-Auth(Android) v20.7.0 (Google Sign-In 롤백 재지원)
    • Google Credential Play Services Auth(Android) v1.3.0 (Google Sign-In 롤백 제거)
인증
  • Android Google Credential Manager의 호환성이 낮아 일부 유저가 접속할 수 없는 이슈로 인해, 인증 방법을 기존의 Google Sign-In 으로 롤백하여 변경합니다.

v4.25.2.1

타겟 OS별 SDK 배포일
SDK Native Android 2025-05-14

본 SDK 버전의 개발 환경을 확인하세요.

해결한 버그

마케팅 어트리뷰션
  • Android MMP 서비스와 연동에 사용되는 Hive SDK 식별자 중 did 값이 누락되는 오류를 수정합니다.

v4.25.2.0

타겟 OS별 SDK 배포일
SDK Native Android 2025-04-29
SDK Native iOS 2025-04-29

변경한 기능

라이브러리 업데이트
  • Android Airbridge(Android) v4.1.0 → v4.3.0
    • Adjust(Android) v5.0.1 → v5.2.0
    • Singular(Android) v12.6.1 → v12.7.0
    • AppsFlyer(Android) v6.15.2 → v6.16.2
    • GooglePlay Services-Auth(Android) v20.7.0 (지원중단)
    • Google Credential Play Services Auth(Android) v1.3.0 (신규지원)
  • iOS Airbridge(iOS) v4.1.1 → v4.3.0
    • Adjust(iOS) v5.0.1 → v5.2.0
    • Singular(iOS) v12.6.1 → v12.7.1
    • AppsFlyer(iOS) v6.15.3 → v6.16.1
    • QQ(iOS) 3.5.17.3 → 3.5.17.4
마케팅 어트리뷰션
  • All MMP 서비스와 연동을 지원하도록 Hive SDK 식별자를 추가로 전송합니다.
  • All 이벤 수동 추적 시 커스텀 어트리뷰트를 추가하여 전송하도록 변경합니다.
  • Android Airbridge 초기화 시, 마켓 출처 정보를 전송하도록 변경합니다.
  • iOS sendEventWithAttributes API 사용 시, semantic value 타입의 부동소수점 값의 정밀도 범위를 float에서 double형으로 변경합니다.
빌링
  • Android PG 결제로 구매한 상품을 환불한 경우, 이전 트랜잭션과 구분하기 위해 order_id 값을 추가합니다.
  • Android PG 결제 트랜잭션 완료 시, 구매 완료 로그를 마케팅 어트리뷰션을 통해 전송하도록 변경합니다.
인증
  • All VK 인증 수단을 변경하여 제공합니다. 변경된 인증 방식은 신규 VK 개발자 콘솔에서 사용할 수 있습니다.
  • iOS Apple GameCenter 로그인 시 사용하는 deprecated된 GameKit API의 검증 프로토콜을 업데이트합니다.
  • Android Google Sign-In 라이브러리 지원 중단에 따라 묵시적 및 명시적 로그인 시 Google Credential Manager와 AuthorizationClient API로 인증하도록 변경합니다.
채팅
  • All 메시지 데이터를 전송하거나 수신할 때 extraData를 추가로 전송하고 수신합니다.
  • All 채팅 서버 연결 시, extraData를 더 이상 전송하지 않습니다.
  • All 문자열 시간값이 아닌 정수형 시간값을 추가로 수신합니다.
  • All 네트워크 차단 등 통신이 불가능한 상황에서 웹소켓을 정상적으로 해제하지 못하고 재연결을 시도할 때, 중복 연결 상태로 실패하지 않도록 변경합니다.
프로모션
  • Android UserAcqutision 공유 시, Telegram이 지원하는 노출 목록에 추가되도록 변경합니다.
  • Android 웹뷰 노출 시, 캐싱 정책을 변경합니다.
프로비저닝
  • All 약관 상세보기 및 다시 보기 페이지에서 아래 경우에는 약관 페이지(웹뷰)가 아니라 외부 브라우저를 새로 열어서 로딩하도록 변경합니다.
    • 약관 URL을 벗어나는 웹페이지로 이동하는 경우
    • 약관 내 하이퍼링크 HTML 태그(a 태그, tel:// 등)를 클릭한 경우

해결한 버그

  • Android 네트워크를 통한 통신 재시도가 필요하거나 분산 서버에 접속해야 하는 상황에서 설정된 최대 타임아웃 시간이 초과하기 전에 응답이 오는 경우, 더 이상 타임아웃을 기다리지 않고 즉시 통신 재시도를 하거나 분산 서버에 접속하도록 수정합니다.
  • iOS Configuration 클래스의 setZone 메서드를 사용하여 Hive SDK에서 접속하는 서버 그룹 Zone이 변경되는 경우, hive_config.xml 파일의 gameLanguage 값이 초기화 되는 오류를 수정합니다.
마케팅 어트리뷰션
  • Android Adjust를 사용하여 설치 여부를 판단하는 기능을 사용하는 경우, 내용이 없는 푸시 알림이 노출되는 현상을 수정합니다.
  • Android Airbridge 사용 시 복수의 개수를 구매하는 이벤트가 발생한 경우, 단가와 개수에 따른 매출 정보를 전달하도록 수정합니다.
인증
  • iOS iOS 18 이상의 기기에서 QQ 웹로그인이 정상적으로 진행되지 않는 오류를 수정합니다.
채팅
  • Android 채팅 연결시, 간헐적으로 연결이 실패하는 현상을 수정합니다.
프로비저닝
  • All SDK의 초기화 이전에 광고 모듈(Adiz) 초기화 진행 시 COPPA나 GDPR와 같은 컴플라이언스를 준수하는 경우, 연령을 체크하는 AgeGate 값이 hive_config.xml에 설정된 값으로 동작하는 오류를 수정합니다.

알려진 이슈

마케팅 어트리뷰션

v4.25.1.3

타겟 OS별 SDK 배포일
SDK Native Android 2025-04-10
SDK Native iOS 2025-04-10

본 SDK 버전의 개발 환경을 확인하세요.

변경한 기능

마케팅 어트리뷰션
빌링
  • Android PG 결제의 동작 방식을 다른 빌링(IAPv4) 기능에 있는 마켓들과 동일하도록 변경합니다. PG 결제를 적용중이라면 PG 결제 문서를 참고해 코드 구현을 수정해야 합니다.

해결한 버그

마케팅 어트리뷰션
  • iOS Adiz를 통해 광고수익 정보 전송 시, Airbridge에서 Adiz가 아닌 AdMob으로 전송되는 오류를 수정합니다.
빌링
  • iOS 소비 정보 전송 동의 여부를 질의하는 팝업 UI를 노출 시, 배경화면이 불투명한 오류를 수정합니다.
  • iOS 소비 정보 전송 동의 여부를 질의하는 팝업 UI를 닫을 시, 의도하지 않은 방향으로 앱의 화면 방향이 회전하는 오류를 수정합니다.
프로모션
  • iOS 이미지가 포함된 리뷰팝업 노출 중 회전 이벤트가 발생하는 경우, 노출 중인 이미지가 사리지는 오류를 수정합니다.

v4.25.0.1

타겟 OS별 SDK 배포일
SDK Native iOS 2025-03-10

새로운 기능

마케팅 어트리뷰션
  • iOS Adjust v5 가 적용된 Hive SDK v4 25.0.0 이상 사용 시, SDK에서 자동으로 수집하여 전송하는 did, vid 값이 전송되지 않는 오류를 수정합니다.

v4.25.0.0

타겟 OS별 SDK 배포일
SDK Native Android 2025-01-24
SDK Native iOS 2025-01-24

새로운 기능

마케팅 어트리뷰션
매치 메이킹
  • All 매치 메이킹 기능을 업데이트하여 그룹 매치 메이킹 기능을 신규 지원합니다. ※ 이전 버전의 Hive SDK 인터페이스와 호환되지 않습니다. 업데이트된 매치 메이킹 기능을 사용하려면 Hive SDK v4 25.0.0 이상을 사용해야 합니다.
빌링
인증
채팅
  • All 채팅 기능을 신규 지원합니다.
프로모션

변경한 기능

마케팅 어트리뷰션
  • All Adjust v5를 지원하도록 업데이트합니다.
    • Adjust Signature 라이브러리를 제거합니다.
  • All Adjust로 Adiz 광고 매출 집계 시 AdMob 소스로 광고 매출 소스를 전송하도록 변경합니다.
  • Android Appsflyer 광고 매출 집계 라이브러리가 메인 라이브러리에 통합된 부분을 반영합니다.
    • 6.14.2 → 6.15.2
    • Appsflyer ad-revenue 라이브러리를 제거합니다.
인증
  • All 더이상 사용하지 않는 Auth 모듈 클래스 및 인터페이스, 메서드, 대리자, 리스너를 삭제합니다
  • All JWT 토큰을 사용해 더 강력한 보안 프로토콜을 적용합니다.
  • All TalkPlus 지원 종료에 따라 TalkPlus 인증 토큰 메서드를 삭제합니다.
  • Android Apple 로그인 웹뷰에서 로그인 기능 이외에 비밀번호 찾기 등과 같은 브라우징을 허용합니다.
허큘리스 업데이트
  • All 2024.11.20

해결한 버그

빌링
  • iOS UserEngagement를 사용해 인앱 상품 구매를 유도했을 때, IAP_UPDATE 이벤트가 추가로 발생하는 오류를 수정합니다.
인증
  • Android signIn 메서드 실행 중 네트워크 응답 지연이 발생하면 간헐적으로 UI 스레드를 점유하는 문제를 해결합니다.

알려진 이슈

마케팅 어트리뷰션
  • iOS Adjust를 사용하는 경우 SDK에서 자동으로 수집하여 전송하는 did, vid 값이 전송되지 않는 오류가 있습니다. Hive SDK v4 25.0.1 이상으로 업데이트가 필요합니다.

v4.24.5.0

타겟 OS별 SDK 배포일
SDK Native Android 2024-11-08
SDK Native iOS 2024-11-08

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능

  • All Unity 6(Unity 6000)을 지원합니다.
매치 메이킹
인증
프로모션
  • All 스팟 배너에서도 광고 노출이 가능합니다.
  • Android 사용자 초대 공유하기 기능에 X(구 Twitter)를 지원합니다.

변경한 기능

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

해결한 버그

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

v4.24.4.0

타겟 OS별 SDK 배포일
SDK Native Android 2024-10-14
SDK Native iOS 2024-10-14

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능

마케팅 어트리뷰션
빌링
  • Android PG 결제 요청 시, IAPv4.purchase를 사용한 다중 수량 구매를 지원합니다.

해결한 버그

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

v4.24.3.0

타겟 OS별 SDK 배포일
SDK Native Android 2024-09-03
SDK Native iOS 2024-09-03

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능

프로비저닝
  • All 약관 화면에서 법정 대리인 동의를 받았는지 확인하는 기능을 추가합니다.

변경한 기능

라이브러리 업데이트
  • Android Google Play Billing Library 6.1 → 7.0 Google Play Service Games 20.0.0 → 20.1.2
  • iOS Facebook SDK 16.2.1 → 17.0.2
마케팅 어트리뷰션
인증
  • 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일 동안 그만 보기" 텍스트를 "오늘은 그만 보기"로 변경합니다.

해결한 버그

  • Android 리소스 참조 로직을 수정하여 메모리를 확보하지 못했던 오류를 수정합니다.
  • iOS iOS 14 기기에서 앱 추적 투명화(ATT) 동의 여부를 확인할 때 간헐적으로 크래시가 발생하는 오류를 수정합니다.
  • iOS 사진첩에서 접근 제한(일부 사진만 접근 허용)을 선택하면 크래시가 발생하는 오류를 수정합니다.
노티피케이션
  • Android 로컬 푸시 알림에서 지원하지 않는 type 설정 시 푸시 메시지가 정상 노출되지 않는 오류를 수정합니다.
  • iOS 앱 버전 정보를 전송하도록 수정합니다.

v4.24.1.3

타겟 OS별 SDK 배포일
SDK Native Android 2024-07-25
SDK Native iOS 2024-07-25

본 SDK 버전의 개발 환경을 확인하세요.

변경한 기능

인증
  • All 기기 관리 서비스에서 국제 전화 국가 번호를 기기 접속 지역에 따라 자동으로 적용하도록 변경합니다.

v4.24.2.0

타겟 OS별 SDK 배포일
SDK Native Android 2024-07-05
SDK Native iOS 2024-07-05

새로운 기능

  • All GDPR을 적용하는 EU 및 EEA 지역에서 16세 미만 유저가 약관에 동의했는지 여부를 반환하는 기능을 제공합니다. 16세 미만 여부를 확인할 수 있습니다.
  • Android Android OS 11 이상 기기 또는 지원하는 모듈을 설치한 기기에서 사진첩을 사용할 때 PhotoPicker를 기본으로 사용합니다.
  • iOS MacOS 콘솔 앱에서도 Hive SDK 디버그 로그를 확인할 수 있으며, Hive SDK 로그중 특정 로그 타입을 선택해서 볼 수 있습니다.
인증
  • All 휴대폰 번호 1개로 가입 가능한 계정 수를 초과했을 때, 인증 번호 발송을 요청하면 "같은 휴대폰 번호로 생성할 수 있는 계정 수를 초과했습니다."라는 에러 메시지를 표시합니다.
프로모션

변경한 기능

노티피케이션
  • Android Amazon 신규 Fire 기기에서 동작하는 런타임 라이브러리(Push Amazon Device Message 1.2.0)에 대응합니다.
라이브러리 업데이트
  • Android Samsung GalaxyStore IAP 6.1 → 6.1.1 Amazon Device Message 1.0.1 → 1.2.0
분석
  • iOS 앱에서 크래시 발생 시 미전송 로그를 파일에 저장하는 옵션인 saveAnalyticsLogBeforeCrash 설정값 기본값을 false로 변경합니다.
프로모션
  • iOS 게임 초대(UA) 기능 사용 시 클립보드 붙여넣기 권한 동의 팝업 노출을 최소화하여 사용성을 개선합니다.
    1. 권한 동의 팝업을 노출하는 시점을 초대받은 사용자가 앱을 실행하자마자에서 앱 실행 후 Hive SDK 초기화하는 시점으로 변경했습니다.
    2. 클립보드에 초대자 URL 데이터가 존재할 때에만 팝업을 노출하도록 변경했습니다.

해결한 버그

마케팅 어트리뷰션
  • Android 커스터마이징한 약관으로 초기화 수행 시 Adjust 이벤트 발송이 지연되는 오류를 수정합니다.
인증
  • All 중국에서 접속한 사용자에 대한 실명 인증 과정에서 문자 발송 회수 초과 시 남은 시간을 초기화하지 않고 오류 메시지를 노출하도록 수정합니다.
  • Android Google Play 로그인 진행 중 뒤로가기 키를 누름으로써 로그인을 하지 않은 경우, 적절한 응답 콜백이 없었던 오류를 수정합니다.
  • Android 낮은 해상도 기기에서 키보드 입력을 수행할 수 없었던 오류를 수정합니다.
프로모션
  • iOS 새소식 뷰에서 새로운 프레임 뷰 노출하기 동작 시 프리징이 발생하는 오류를 수정합니다.

v4.24.1.2

타겟 OS별 SDK 배포일
SDK Native Android 2024-06-27

본 SDK 버전의 개발 환경을 확인하세요.

해결한 버그

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

v4.24.1.0

타겟 OS별 SDK 배포일
SDK Native iOS 2024-05-14

변경한 기능

라이브러리 업데이트
  • iOS AppsFlyer(iOS) v6.13.1 → v6.14.3 QQ (iOS) v3.5.14 → v3.5.16 Facebook SDK v17.0.0 → v16.2.1
분석
  • iOS 기기의 추적 동의 여부에 따라 동의배너 노출여부를 결정하도록 변경합니다.
    • 추적 동의를 거절한 경우에는 동의배너를 노출하지 않습니다.

해결한 버그

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

v4.24.0.0

타겟 OS별 SDK 배포일
SDK Native Android 2024-04-30
SDK Native iOS 2024-04-30

새로운 기능

빌링
  • iOS 첫 구독 할인 정보가 있는 경우 상품 정보 조회 시 함께 전달합니다. getProductInfo 사용 시 콜백으로 받는 IAPV4Product 객체 목록에서 original_price 필드값과 price 필드값의 차이로 할인 정보를 확인할 수 있습니다.
프로모션
  • Android 외부 페이지 노출을 위해 기기에 설정된 기본 브라우저를 이용하는 커스텀 탭을 지원합니다. PlatformHelper 클래스 showInAppBrowser 메서드로 인앱 브라우저를 노출할 수 있습니다.
  • iOS 외부 페이지 노출을 위해 브라우저를 이용하는 SafariViewController를 지원합니다. PlatformHelper 클래스 showInAppBrowser 메서드로 인앱 브라우저를 노출할 수 있습니다.

변경한 기능

  • iOS 앱 버전을 구분할 때 CFBundleShortVersionString을 추가로 사용합니다.
라이브러리 업데이트
  • 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
분석
  • Android Firebase 이벤트 수집 기능 중 광고 식별자 수집 설정 기본값을 true로 변경합니다.
빌링
  • All 환불 유저 재결제 UI에서 노출되는 PG 결제 타입 문구를 "HiveStore"에서 "PG 결제"로 변경했습니다.
  • Android PG 결제 페이지를 인앱 브라우저가 아니라 인앱 웹뷰에서 노출하도록 변경합니다. 인앱 브라우저 환경을 지원하지 않는 기기에서도 PG 결제를 지원합니다.

알려진 이슈

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