Android

v4.25.0.1¶

다운로드¶

	Android
다운로드	Hive SDK v4 Native Android 25.0.1
배포일	2025-03-10

주의 사항¶

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

개발 환경¶

Gradle	Android Gradle Plugin	Kotlin Gradle Plugin
v7.5	v7.4.2	v1.8.0

필수 항목¶

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

선택 항목¶

IDP¶

Facebook SDK Android v17.0.0
GooglePlay Services-Auth (Android) v20.7.0
GooglePlay Services-Games v2 (Android) v20.0.0
QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
VK (Android) v3.5.1
WeChat (Android) v6.8.0
LINE (Android) 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
Adjust(Android) v5.0.1
Singular(Android) v12.6.1
AppsFlyer(Android) v6.15.2
FirebaseAnalytics(Android) v22.1.2

CHAT¶

OkHttp(Android) v4.12.0

기타¶

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

새로운 기능¶

해당 없음

변경한 기능¶

해당 없음

해결한 버그¶

해당 없음

v4.25.0.0¶

다운로드¶

	Android
다운로드	Hive SDK v4 Native Android 25.0.0
배포일	2025-01-24

주의 사항¶

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

개발 환경¶

Gradle	Android Gradle Plugin	Kotlin Gradle Plugin
v7.5	v7.4.2	v1.8.0

필수 항목¶

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

선택 항목¶

IDP¶

Facebook SDK Android v17.0.0
GooglePlay Services-Auth (Android) v20.7.0
GooglePlay Services-Games v2 (Android) v20.0.0
QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
VK (Android) v3.5.1
WeChat (Android) v6.8.0
LINE (Android) 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
Adjust(Android) v5.0.1
Singular(Android) v12.6.1
AppsFlyer(Android) v6.15.2
FirebaseAnalytics(Android) v22.1.2

CHAT¶

OkHttp(Android) v4.12.0

기타¶

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

새로운 기능¶

인증¶

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

마케팅 어트리뷰션¶

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

채팅¶

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

매치 메이킹¶

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

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

변경한 기능¶

인증¶

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

프로모션¶

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

마케팅 어트리뷰션¶

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

기타¶

허큘리스 라이브러리 버전을 업데이트합니다.
- Android: 20241120

해결한 버그¶

인증¶

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

개발자 가이드 변경 사항¶

마케팅 어트리뷰션의 Adjust Signature 라이브러리를 제거로 인해 SDK Signature 연동 방법 변경되었습니다.

개발 환경 업데이트¶

Android¶

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

v4.24.5.0¶

다운로드¶

	Android
다운로드	Hive SDK v4 Native Android 24.5.0
배포일	2024-11-08

개발 환경¶

Gradle	Android Gradle Plugin	Kotlin Gradle Plugin
v7.5	v7.4.2	v1.8.0

필수 항목¶

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

선택 항목¶

IDP¶

Facebook SDK Android v17.0.0
GooglePlay Services-Auth (Android) v20.7.0
GooglePlay Services-Games v2 (Android) v20.0.0
QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
VK (Android) v3.5.1
WeChat (Android) v6.8.0
LINE (Android) 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
Adjust(Android) v4.38.5
adjust-android-signature-3.20.1.aar
Singular(Android) v12.6.0
AppsFlyer(Android) v6.14.2
FirebaseAnalytics(Android) v22.1.2

기타¶

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

새로운 기능¶

인증¶

인증 수단으로 Steam, X(구 Twitter)를 새롭게 지원합니다.
인증된 세션을 공유하는 인웹브라우징 기능을 제공합니다.

매치 메이킹¶

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

프로모션¶

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

변경한 기능¶

인증¶

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

해결한 버그¶

N/A

개발자 가이드 변경 사항¶

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

개발 환경 업데이트¶

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

v4.24.4.0¶

다운로드¶

	Android
다운로드	Hive SDK v4 Native Android 24.4.0
배포일	2024-10-14

개발 환경¶

Gradle	Android Gradle Plugin	Kotlin Gradle Plugin
v7.5	v7.4.2	v1.8.0

필수 항목¶

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

선택 항목¶

IDP¶

Facebook SDK Android v17.0.0
GooglePlay Services-Auth (Android) v20.7.0
GooglePlay Services-Games v2 (Android) v20.0.0
QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
VK (Android) v3.5.1
WeChat (Android) v6.8.0
LINE (Android) 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
Adjust(Android) v4.38.5
adjust-android-signature-3.20.1.aar
Singular(Android) v12.5.4
AppsFlyer(Android) v6.13.0<
FirebaseAnalytics(Android) v21.5.0

기타¶

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

새로운 기능¶

마케팅 어트리뷰션¶

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

빌링¶

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

변경한 기능¶

N/A

해결한 버그¶

N/A

개발 환경 업데이트¶

Android¶

N/A

v4.24.3.0¶

다운로드¶

	Android
다운로드	Hive SDK v4 Native Android 24.3.0
배포일	2024-09-03

개발 환경¶

Gradle	Android Gradle Plugin	Kotlin Gradle Plugin
v7.5	v7.4.2	v1.8.0

필수 항목¶

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.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.11.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¶

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.1.0
GooglePlay Services-AppUpdate (Android) v2.1.0
Google reCaptcha (Android) v18.4.0
Google reCaptcha (iOS) v18.3.0
YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

프로비저닝¶

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

변경한 기능¶

인증¶

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

프로모션¶

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

마케팅 어트리뷰션¶

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

해결한 버그¶

Hive SDK 공통¶

리소스 참조 로직을 수정하여 메모리를 확보하지 못했던 오류를 수정합니다.

노티피케이션¶

로컬 푸시 알림에서 지원하지 않는 `type` 설정 시 푸시 메시지가 정상 노출되지 않는 오류를 수정합니다.

개발 환경 업데이트¶

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

개발자 가이드 변경점¶

커스터마이징한 로컬 푸시 알림에서 `type` 필드 안내를 변경했습니다.
"대배너" 용어를 "전면 배너"로 변경했습니다.
Android Life Cycle에서 더는 사용하지 않는 `attachBaseContext` 예제 코드를 삭제했습니다.
법정대리인 동의 여부 확인을 `Configuration.getLegalGuardianConsentAgree`로 수행할 수 있음을 안내합니다.
이용 제한 계정이 있을 때 IdP 연동 안내를 추가했습니다.
Hive SDK Unity를 수동 업데이트 또는 수동 설치했을 때, 앱 빌드 전에 XML 파일들을 삭제해야 합니다.

v4.24.2.0 (2024-07-05)¶

새로운 기능¶

Hive SDK 공통¶

GDPR을 적용하는 EU 및 EEA 지역에서 16세 미만 유저가 약관에 동의했는지 여부를 반환하는 기능을 제공합니다. 16세 미만 여부를 확인할 수 있습니다.
Android OS 11 이상 기기 또는 지원하는 모듈을 설치한 기기에서 사진첩을 사용할 때 PhotoPicker를 기본으로 사용합니다.

인증¶

휴대폰 번호 1개로 가입 가능한 계정 수를 초과했을 때, 인증 번호 발송을 요청하면 "같은 휴대폰 번호로 생성할 수 있는 계정 수를 초과했습니다."라는 에러 메시지를 표시합니다.

프로모션¶

크로스 프로모션의 노출을 제어할 수 있는 기능을 제공합니다.
오늘은 그만보기 기능을 개선한 N일 동안 그만보기를 지원합니다.

변경한 기능¶

노티피케이션¶

Amazon 신규 Fire 기기에서 동작하는 런타임 라이브러리(Push Amazon Device Message 1.2.0)에 대응합니다.

해결한 버그¶

인증¶

중국에서 접속한 사용자에 대한 실명 인증 과정에서 문자 발송 회수 초과 시 남은 시간을 초기화하지 않고 오류 메시지를 노출하도록 수정합니다.
Google Play 로그인 진행 중 뒤로가기 키를 누름으로써 로그인을 하지 않은 경우, 적절한 응답 콜백이 없었던 오류를 수정합니다.
낮은 해상도 기기에서 키보드 입력을 수행할 수 없었던 오류를 수정합니다.

마케팅 어트리뷰션¶

커스터마이징한 약관으로 초기화 수행 시 Adjust 이벤트 발송이 지연되는 오류를 수정합니다.

개발 환경 업데이트¶

Android¶

Samsung GalaxyStore IAP 6.1 → 6.1.1
Amazon Device Message 1.0.1 → 1.2.0

개발자 가이드 변경점¶

Hive SDK v4 24.2.0부터 Facebook Cloud Games 지원을 중단함에 따라 아래 페이지들에 해당 내용을 추가했습니다.
- Unity 설정하기
- Unity 설정하기 > Facebook Cloud Games 설정
- Android 설정하기
- 빌링
- 노티피케이션
Hive 러비 상점 선택 화면에 관한 설명을 보강했습니다.

v4.24.1.3¶

다운로드¶

	Android
다운로드	Hive SDK v4 Android 24.1.3
배포일	2024-07-25

변경한 기능¶

인증¶

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

v4.24.1.2 (2024-06-27)¶

해결한 버그¶

인증¶

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

v4.24.1.0 (2024-05-14)¶

새로운 기능¶

N/A

변경한 기능¶

N/A

개발 환경 업데이트¶

N/A

개발자 가이드 변경점¶

N/A

v4.24.0.0 (2024-04-30)¶

새로운 기능¶

프로모션¶

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

변경한 기능¶

빌링¶

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

애널리틱스¶

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