iOS

v4.25.0.1¶

다운로드¶

주의 사항¶

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

개발 환경¶

iOS¶

• Xcode 16.1 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• SDWebImage (iOS) v5.20.0

선택 항목¶

IDP¶

• Facebook SDK iOS v17.4.0
• Google Sign-In SDK (iOS) v8.0.0
• QQ (iOS) v3.5.16
• VK (iOS) v1.6.4
• WeChat (iOS) v2.0.4
• LINE (iOS) v5.11.2

MARKETING TRACKING ANALYTICS¶

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

기타¶

• Google reCaptcha (iOS) v18.6.0

새로운 기능¶

• 해당 없음

변경한 기능¶

• 해당 없음

해결한 버그¶

마케팅 어트리뷰션¶

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

v4.25.0.0¶

다운로드¶

주의 사항¶

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

개발 환경¶

iOS¶

• Xcode 16.1 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• SDWebImage (iOS) v5.20.0

선택 항목¶

IDP¶

• Facebook SDK iOS v17.4.0
• Google Sign-In SDK (iOS) v8.0.0
• QQ (iOS) v3.5.16
• VK (iOS) v1.6.4
• WeChat (iOS) v2.0.4
• LINE (iOS) v5.11.2

MARKETING TRACKING ANALYTICS¶

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

기타¶

• Google reCaptcha (iOS) v18.6.0

새로운 기능¶

인증¶

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

빌링¶

• 유저에게 인앱 상품 소비 정보를 Apple App Store로 전송할지 동의 여부를 질의하는 기능을 지원합니다.

마케팅 어트리뷰션¶

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

채팅¶

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

매치 메이킹¶

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

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

변경한 기능¶

인증¶

• 더이상 사용하지 않는 Auth 모듈 클래스 및 인터페이스, 메서드, 대리자, 리스너를 삭제합니다.
• JWT 토큰을 사용해 보다 강화된 보안 프로토콜을 적용합니다.
• TalkPlus 지원 종료에 따라 TalkPlus 인증 토큰 메서드를 삭제합니다.

프로모션¶

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

마케팅 어트리뷰션¶

• Adjust v5를 지원하도록 업데이트합니다.
  • Adjust Signature 라이브러리를 제거합니다.
• Adjust로 Adiz 광고 매출 집계 시 AdMob 소스로 광고 매출 소스를 전송하도록 변경합니다.
  • 6.14.2 → 6.15.2
  • Appsflyer ad-revenue 라이브러리를 제거합니다.

기타¶

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

해결한 버그¶

빌링¶

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

알려진 이슈¶

마케팅 어트리뷰션¶

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

개발자 가이드 변경 사항¶

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

개발 환경 업데이트¶

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¶

다운로드¶

개발 환경¶

iOS¶

• Xcode 15.3 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• SDWebImage (iOS) v5.19.7

선택 항목¶

IDP¶

• Facebook SDK iOS v17.1.0
• Google Sign-In SDK (iOS) v7.1.0
• QQ (iOS) v3.5.16
• VK (iOS) v1.6.4
• WeChat (iOS) v2.0.4
• LINE (iOS) v5.11.0

MARKETING TRACKING ANALYTICS¶

• Adjust(iOS) v4.38.4
• AdjustSigSdk 3.20.1
• Singular(iOS) v12.5.0
• AppsFlyer(iOS) v6.15.3
• FirebaseAnalytics(iOS) v10.29.0

기타¶

• Google reCaptcha (iOS) v18.6.0

새로운 기능¶

인증¶

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

매치 메이킹¶

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

프로모션¶

• 스팟 배너에서도 광고 노출이 가능합니다.

변경한 기능¶

인증¶

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

해결한 버그¶

빌링¶

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

개발자 가이드 변경 사항¶

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

개발 환경 업데이트¶

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¶

다운로드¶

개발 환경¶

• Xcode 15.3 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• SDWebImage (iOS) v5.18.7

선택 항목¶

IDP¶

• Facebook SDK iOS v17.0.2
• Google Sign-In SDK (iOS) v7.1.0
• QQ (iOS) v3.5.16
• VK (iOS) v1.6.4
• WeChat (iOS) v2.0.4
• LINE (iOS) v5.11.0

MARKETING TRACKING ANALYTICS¶

• Adjust(iOS) v4.38.4
• AdjustSigSdk 3.20.1
• Singular(iOS) v12.4.1
• AppsFlyer(iOS) v6.14.3
• FirebaseAnalytics(iOS) v10.22.0

기타¶

• Google reCaptcha (iOS) v18.3.0

새로운 기능¶

마케팅 어트리뷰션¶

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

변경한 기능¶

• N/A

해결한 버그¶

분석¶

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

개발 환경 업데이트¶

iOS¶

• Xcode 15 -> 15.3

v4.24.3.0¶

다운로드¶

개발 환경¶

• 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

새로운 기능¶

프로비저닝¶

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

변경한 기능¶

인증¶

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

프로모션¶

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

마케팅 어트리뷰션¶

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

해결한 버그¶

Hive SDK 공통¶

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

노티피케이션¶

• 앱 버전 정보를 전송하도록 수정합니다.

개발 환경 업데이트¶

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 필드 안내를 변경했습니다.
• "대배너" 용어를 "전면 배너"로 변경했습니다.
• 법정대리인 동의 여부 확인을 Configuration.getLegalGuardianConsentAgree로 수행할 수 있음을 안내합니다.
• 이용 제한 계정이 있을 때 IdP 연동 안내를 추가했습니다.
• Hive SDK Unity를 수동 업데이트 또는 수동 설치했을 때, 앱 빌드 전에 XML 파일들을 삭제해야 합니다.

v4.24.2.0 (2024-07-05)¶

새로운 기능¶

Hive SDK 공통¶

• GDPR을 적용하는 EU 및 EEA 지역에서 16세 미만 유저가 약관에 동의했는지 여부를 반환하는 기능을 제공합니다. 16세 미만 여부를 확인할 수 있습니다.
• MacOS 콘솔 앱에서도 Hive SDK 디버그 로그를 확인할 수 있으며, Hive SDK 로그중 특정 로그 타입을 선택해서 볼 수 있습니다.

인증¶

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

프로모션¶

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

변경한 기능¶

프로모션¶

• 게임 초대(UA) 기능 사용 시 클립보드 붙여넣기 권한 동의 팝업 노출을 최소화하여 사용성을 개선합니다.
  1. 권한 동의 팝업을 노출하는 시점을 초대받은 사용자가 앱을 실행하자마자에서 앱 실행 후 Hive SDK 초기화하는 시점으로 변경했습니다.
  2. 클립보드에 초대자 URL 데이터가 존재할 때에만 팝업을 노출하도록 변경했습니다.

애널리틱스¶

• 앱에서 크래시 발생 시 미전송 로그를 파일에 저장하는 옵션인 saveAnalyticsLogBeforeCrash 설정값 기본값을 false`로 변경합니다.

• `displayOriginalPrice 설명을 변경했습니다.
• `displayPrice 하단 Note 설명을 변경했습니다.
• iOS 설정하기에서 서드 파티 프레임워크 종속성, Podfile 작성 예시를 변경했습니다. Hive SDK 기본 동작을 위한 필수 적용 프레임워크에서 HiveAppTrackingTransparency`와 HiveResource`를 제거했습니다.