Android & iOS
v4 24.4.0¶
다운로드¶
Unity | |
---|---|
다운로드 | Hive SDK v4 Unity Android & iOS 24.4.0 |
배포일 | 2024-10-14 |
개발 환경¶
Unity (Android)¶
- Unity 2021.3.0+
- Unity 2022.3.0+
- Unity 2023.1.0+
targetSDK 버전에 따른 Unity 호환 버전¶
Hive SDK v4.23.0.0 이후 Android 빌드 targetSDK 버전에 호환되는 Unity 버전은 아래와 같습니다.
- targetSDK 33 빌드 시
- Unity 2021 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
- targetSDK 34 빌드 시
- Unity 2022 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
Unity (iOS)¶
- Unity 2021.3.0+
- Unity 2022.3.0+
- Unity 2023.1.0+
Android¶
Gradle | Android Gradle Plugin | Kotlin Gradle Plugin |
---|---|---|
v7.5 | v7.4.2 | v1.8.0 |
iOS¶
- Xcode 15.3 이상
- Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.
필수 항목¶
- 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¶
- 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.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
새로운 기능¶
마케팅 어트리뷰션¶
- All Hive SDK에 특화된 서비스로 Airbridge를 지원합니다.
빌링¶
- Android PG를 통한 결제 시, 단일 상품을 원하는 수량만큼 구매할 수 있는 기능을 제공합니다.
변경한 기능¶
플러그인¶
- Unity Android의 Package Name 또는 iOS의 Bundle Name이 자동으로 설정되는 기능이 Hive AppId를 통해 선택적으로 동작하도록 변경합니다.
해결한 버그¶
분석¶
- iOS 동의배너 선택지 하나만 선택한 경우 올바르게 반영되지 않는 오류를 수정합니다.
개발 환경 업데이트¶
Android¶
- N/A
iOS¶
- Xcode 15 -> 15.3
v4.24.3.0¶
다운로드¶
Unity | |
---|---|
다운로드 | Hive SDK v4 Unity Android & iOS 24.3.0 |
배포일 | 2024-09-03 |
개발 환경¶
Unity (Android)¶
- Unity 2021.3.0+
- Unity 2022.3.0+
- Unity 2023.1.0+
targetSDK 버전에 따른 Unity 호환 버전¶
Hive SDK v4.23.0.0 이후 Android 빌드 targetSDK 버전에 호환되는 Unity 버전은 아래와 같습니다.
- targetSDK 33 빌드 시
- Unity 2021 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
- targetSDK 34 빌드 시
- Unity 2022 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
Unity (iOS)¶
- Unity 2021.3.0+
- Unity 2022.3.0+
- Unity 2023.1.0+
Android¶
Gradle | Android Gradle Plugin | Kotlin Gradle Plugin |
---|---|---|
v7.5 | v7.4.2 | v1.8.0 |
iOS¶
- Xcode 15 이상
- Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.
필수 항목¶
- 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
새로운 기능¶
프로비저닝¶
- All 약관 화면에서 법정 대리인 동의를 받았는지 확인하는 기능을 추가합니다.
변경한 기능¶
플러그인¶
- Unity Hive External Dependency Manager로 관리하는 XML 파일 개수를 최소화합니다.
인증¶
- 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
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 공통¶
- All GDPR을 적용하는 EU 및 EEA 지역에서 16세 미만 유저가 약관에 동의했는지 여부를 반환하는 기능을 제공합니다. 16세 미만 여부를 확인할 수 있습니다.
- Android Android OS 11 이상 기기 또는 지원하는 모듈을 설치한 기기에서 사진첩을 사용할 때 PhotoPicker를 기본으로 사용합니다.
- iOS MacOS 콘솔 앱에서도 Hive SDK 디버그 로그를 확인할 수 있으며, Hive SDK 로그중 특정 로그 타입을 선택해서 볼 수 있습니다.
Unity¶
- All Unity Editor에서 Hive SDK 디버그 로그 노출을 제어하는 기능을 제공합니다.
인증¶
- All휴대폰 번호 1개로 가입 가능한 계정 수를 초과했을 때, 인증 번호 발송을 요청하면 "같은 휴대폰 번호로 생성할 수 있는 계정 수를 초과했습니다."라는 에러 메시지를 표시합니다.
프로모션¶
- All 크로스 프로모션의 노출을 제어할 수 있는 기능을 제공합니다.
- All 오늘은 그만보기 기능을 개선한 N일 동안 그만보기를 지원합니다.
변경한 기능¶
노티피케이션¶
- Android Amazon 신규 Fire 기기에서 동작하는 런타임 라이브러리(Push Amazon Device Message 1.2.0)에 대응합니다.
프로모션¶
- iOS 게임 초대(UA) 기능 사용 시 클립보드 붙여넣기 권한 동의 팝업 노출을 최소화하여 사용성을 개선합니다.
- 권한 동의 팝업을 노출하는 시점을 초대받은 사용자가 앱을 실행하자마자에서 앱 실행 후 Hive SDK 초기화하는 시점으로 변경했습니다.
- 클립보드에 초대자 URL 데이터가 존재할 때에만 팝업을 노출하도록 변경했습니다.
애널리틱스¶
- iOS 앱에서 크래시 발생 시 미전송 로그를 파일에 저장하는 옵션인
saveAnalyticsLogBeforeCrash
설정값 기본값을false
로 변경합니다.
해결한 버그¶
인증¶
- All 중국에서 접속한 사용자에 대한 실명 인증 과정에서 문자 발송 회수 초과 시 남은 시간을 초기화하지 않고 오류 메시지를 노출하도록 수정합니다.
- Android Google Play 로그인 진행 중 뒤로가기 키를 누름으로써 로그인을 하지 않은 경우, 적절한 응답 콜백이 없었던 오류를 수정합니다.
- Android 낮은 해상도 기기에서 키보드 입력을 수행할 수 없었던 오류를 수정합니다.
프로모션¶
- iOS 새소식 뷰에서 새로운 프레임 뷰 노출하기 동작 시 프리징이 발생하는 오류를 수정합니다.
마케팅 어트리뷰션¶
- Android 커스터마이징한 약관으로 초기화 수행 시 Adjust 이벤트 발송이 지연되는 오류를 수정합니다.
개발 환경 업데이트¶
Android¶
- Samsung GalaxyStore IAP 6.1 → 6.1.1
- Amazon Device Message 1.0.1 → 1.2.0
iOS¶
- N/A
개발자 가이드 변경점¶
- Hive SDK v4 24.2.0부터 Facebook Cloud Games 지원을 중단함에 따라 아래 페이지들에 해당 내용을 추가했습니다.
- Hive 러비 상점 선택 화면에 관한 설명을 보강했습니다.
v4.24.1.2 (2024-06-27)¶
해결한 버그¶
인증¶
- Android 구글 로그인 진행중 뒤로가기 버튼을 눌러 로그인을 취소했을 때 적절한 응답 콜백이 없었던 오류를 수정합니다. 이 버그는 Hive 콘솔 내에 Google Legacy Support 값이 참인 경우에만 발생했습니다.
- Android 낮은 해상도 기기에서 키보드 입력을 할 수 없었던 오류를 수정합니다.
v4.24.1.0 (2024-05-14)¶
새로운 기능¶
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으로 업데이트하는 경우, 상품 조회가 되지 않는 오류를 수정합니다.
개발자 가이드 변경점¶
N/A
v4.24.0.0 (2024-04-30)¶
새로운 기능¶
프로모션¶
- Android 외부 페이지 노출을 위해 기기에 설정된 기본 브라우저를 이용하는 커스텀 탭을 지원합니다.
PlatformHelper
클래스showInAppBrowser
메서드로 인앱 브라우저를 노출할 수 있습니다. - iOS 외부 페이지 노출을 위해 브라우저를 이용하는 SafariViewController를 지원합니다.
PlatformHelper
클래스showInAppBrowser
메서드로 인앱 브라우저를 노출할 수 있습니다.
빌링¶
- iOS 첫 구독 할인 정보가 있는 경우 상품 정보 조회 시 함께 전달합니다.
getProductInfo
사용 시 콜백으로 받는IAPV4Product
객체 목록에서original_price
필드값과price 필드값의 차이로 할인 정보를 확인할 수 있습니다.
변경한 기능¶
Hive SDK 공통¶
- iOS 앱 버전을 구분할 때
CFBundleShortVersionString
을 추가로 사용합니다.
Unity¶
- All Unity Login Simulator 사용 시 Hive 콘솔 샌드박스에 있는 AppID와 Hive 인증키로 게스트 계정
playerId
와playerToken
실제 값을 불러오도록 변경했습니다. 샌드박스 서버에 있는 값들을 사용하므로 검증 API 호출(Authorization
과player_id
)이 가능합니다.
빌링¶
- 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을 사용하세요.
개발 환경 업데이트¶
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 설명을 변경했습니다.- iOS 설정하기에서 서드 파티 프레임워크 종속성, Podfile 작성 예시를 변경했습니다. Hive SDK 기본 동작을 위한 필수 적용 프레임워크에서
HiveAppTrackingTransparency
와HiveResource
를 제거했습니다.