iOS

v4.24.3.0

Download

---

	iOS
DOWNLOAD	Hive SDK v4 Native iOS 24.3.0
RELEASE DATE	2024-09-03

 

Development Environment

---

• Xcode 15+
  • The Xcode version should be updated following the Apple App Store policy..

 

What’s new

---

Provisioning

• A feature has been added to check whether consent from the legal representative has been obtained on the terms and conditions screen.

Changed features

---

Authentication

• Modified the logout behavior.
  • Previous: User account is logged out from the Hive SDK when signOut is called.

  Guest receives a failure response from the server when calling the signOut API.

  • Changed: When signOut is called, the Hive SDK will request confirmation from the Hive server to log out the user account and will log out based on the response.
• Guest account logout will no longer return a success response but will return an error code. The guest account session will be maintained by the Hive SDK and Hive server.
• Accounts that are suspended will automatically log out from IdP to allow login with a different account for the same IdP. This only applies if automatic login is not possible.
• When integrating with IdP using the AuthV4.connect method, switching to a suspended account will trigger a logout.
• Changed the device management service to automatically apply international phone country codes according to the device access region.
• Changed to allow Facebook login even if App Tracking Transparency (ATT) consent is denied.

Promotion

• Modified to ensure that unnecessary information is not included in the values sent via additionalInfo.
• Changed to allow displaying full banners in a 2:3 or 3:2 ratio.
• Changed the text from “Don’t show for 1 day” to “Don’t show today” on full banners.

Marketing attribution

• Changed the Adjust Signature version from v1 to v3.

Resolved bugs

---

Hive SDK common

• Fixes a crash that occurred intermittently when checking for App Tracking Transparency (ATT) consent on iOS 14 devices.
• Fixes a crash that occurred when selecting restricted access (allowing access to only some photos) in the photo library.

Notification

• Modifies to send app version information.

Development environment updates

---

• Facebook SDK 16.2.1 → 17.0.2

Developer guide changes

---

• The guidance for the type field in customized local push notifications has been updated.
• The term “large banner” has been changed to “full banner.”
• The example code for attachBaseContext, which is no longer used in the Android Life Cycle, has been removed.
• It is now indicated that checking for legal guardian consent can be performed using Configuration.getLegalGuardianConsentAgree.
• Added IdP integration guidance for accounts with usage restrictions.
• When manually updating or installing Hive SDK Unity, you must delete XML files before building the app.

 

v4.24.2.0 (2024-07-05)

What’s New

---

Hive SDK Common

• Provides a feature that returns whether users under 16 in the EU and EEA regions where GDPR applies have agreed to the terms of service, and checks if they are under 16. Check this feature here.
• Allows viewing Hive SDK debug logs and selecting specific log types to view on the MacOS console app.

Authentication

• For device management service, when the number of accounts that can be registered with a single mobile phone number is exceeded, requesting the sending of an authentication code will display the error message: “You have exceeded the number of accounts that can be created with the same mobile phone number.”

Promotion

• Provides a feature to control the exposure of cross-promotion.
• Supports “Do not show for N days” feature that improved the previous “Do not show again today”.

Changed Features

---

Promotion

• Improves usability by minimizing the consent popup for clipboard paste permission when using the game invitation (UA) feature.
  1. Changed the timing of the consent popup from immediately after launching the app to the point of initializing Hive SDK after the app is launched.
  2. Displays the popup only when there is inviter URL data in the clipboard.

Analytics

• Changes the default value of the saveAnalyticsLogBeforeCrash, which saves untransmitted logs to a file when a crash occurs, to false. Learn more here.

Bug Fixes

---

Authentication

• During the real-name verification process for users accessing from China, an error message will be displayed when the message sending limit was exceeded with the remaining time not being reset.

Promotion

• Fixes an issue where freezing occurred when exposing a new frame view for the news view.

Development Environment Updates

---

iOS

• N/A

Developer Guide Changes

---

• Due to the discontinuation of Facebook Cloud Games support starting from Hive SDK v4 24.2.0, the following pages have been updated accordingly:
  • Setting up Unity
  • Setting up Unity > Configuring Facebook Cloud Games
  • Setting up Android
  • Billing
  • Notifications
• Enhanced the explanation on the market selection screen for Hive Lebi.

 

v4.24.1.3

Download

---

	iOS
Download	Hive SDK v4 iOS 24.1.3
Release Date	2024-07-25

Changed Features

---

Authentication

• When registering a mobile device while using the device management service, the international dialing code will be automatically applied based on the device’s connection region instead of using +82.

 

v4.24.1.2 (2024-06-27)

What’s new

---

N/A

Changed features

---

N/A

Fixed bugs

---

N/A

Developer guide updates

---

N/A

 

v4.24.1.0 (2024-05-14)

What’s New

---

N/A

Changed Features

---

Analytics

• Changed to determine whether to display the consent banner based on whether the device consents to tracking.
  • If you refuse consent to tracking, the consent banner will not be displayed.

Development Environment Updates

---

iOS

• Update external libraries in accordance with Apple Privacy Manifest policy.
  • AppsFlyer(iOS) v6.13.1 → v6.14.3
  • QQ (iOS) v3.5.14 → v3.5.16
• Downgrade Facebook SDK.
  • Facebook SDK v17.0.0 → v16.2.1

Fixed Bugs

---

Billing

• Fix an issue where product queries fail when updating Hive SDK from versions below v4 24.0.0 (e.g., v4 23.4.0) to v4 24.0.0.

Changes to developer guide

---

N/A

 

v4.24.0.0 (2024-04-30)

What’s New

---

Promotion

• Support SafariViewController using a browser to expose external pages. You can expose In-App Browser with the showInAppBrowser method of the PlatformHelper class.

Changed Feature

---

Hive SDK Common

• Additional use of CFBundleShortVersionString to differentiate app versions

Billing

• The PG payment type phrase displayed in the refund user repayment UI has been changed from “HiveStore” to “PG payment”.

Development Environment Updates

---

iOS

• WeChat 2.0.2 → 2.0.4
• Hercules 2024.01.23 → 2024.04.11
• Singular 12.3.2 → 12.4.1

Changes to developer guide

---

• Description of displayOriginalPrice changed.
• The description of Note at the bottom of displayPrice has been changed.
• Third-party framework dependencies, Podfile writing example in Setting up iOS has been changed. Removed HiveAppTrackingTransparency and HiveResource from the required enforcement framework for Hive SDK default operation.

 

v4.23.5.1

Download

---

	iOS
DOWNLOAD	Hive SDK v4 iOS 23.5.1
RELEASE DATE	2024-06-27

 

Development Environment

---

• Xcode 15+
  • The Xcode version should be updated following the Apple App Store policy..

 

What’s new

---

N/A

Changed features

---

N/A

Development Environment Updates

---

N/A

Changes to developer guide

---

N/A

 

v4.23.5.0 (2024-05-31)

Changed Features

---

Analytics

• Changed to decide whether to display the consent banner based on the device’s tracking consent. The consent banner is not displayed if tracking consent is declined.

Development Environment Updates

---

External Library Updates

• Update external libraries in response to the Apple Privacy Manifest policy.
  • AppsFlyer(iOS) v6.13.1 → v6.14.3
  • QQ (iOS) v3.5.14 → v3.5.16
  • WeChat 2.0.2 → 2.0.4
  • Hercules 2024.01.23 → 2024.04.11
  • Singular 12.3.2 → 12.4.1
• Downgrade the Facebook SDK. This downgrade solves the issue where login is not possible if App Tracking Transparency is not consented to.
  • Facebook SDK v17.0.0 → v16.2.1

 

v4.23.4.0 (2024-04-11)

What’s New

---

Analytics

• In accordance with DMA regulations in the EU and EEA regions, supports the personal information collection consent banner exposure feature.
  • If you use one or more MarketTrackingTools and market to the EU and EEA regions, you should apply their features.
  • A re-consent request is required every 14 months, and a re-consent banner is displayed if the number of months set in the app is exceeded.
  • The consent banner can be re-displayed whenever necessary so that users can withdraw their consent at any time.

Changed Feature

---

External Libraries Update

• Update the libraries corresponding to DPR DMA:
  • Adjust 4.37.1 → 4.38.0
  • AppsFlyer 6.12.1 → 6.13.1
  • Singular 12.1.1 → 12.3.2
• Update external libraries to comply with Apple Privacy Manifest policy:
  • Facebook 16.2.1 → 17.0.0
  • Google SignIn 7.0.0 → 7.1.0

Fixed Bugs

---

Common

• Fixes an error that causes a crash when an unused useCrashReport key exists in the hive_config.xml file.

 

Changes to developer guide

---

• A new guide to displaying the analytics consent banner has been added.

 

v4.23.3.0 (2024-03-26)

Download

---

	iOS
Download	Hive SDK v4 iOS 23.3.0
Release Date	2024-03-26

 

Development Environment

---

• Xcode 15+
• The Xcode version should be updated following the Apple App Store policy.

 

What’s New

---

Changed Features

---

Hive SDK Common

• Updated SDWebImage library version: 5.18.3 → 5.18.7

Authentication

• Updated LineSDK library version: 5.10.0 → 5.11.0

Marketing Attribution

• Updated Adjust library version: 4.35.2 → 4.37.1
• Updated FirebaseAnalytics library version: 10.20.0 → 10.22.0

Fixed Bugs

---

Unity

• Fixed a Null-Reference-Exception error occurring in some Hive SDK methods callable from the Unity editor.

Authentication

• Fixed issues with identity verification screens.
• Fixed an issue that some shadows appeared on the real-name verification screen for Chinese IPs.
• Fixed an issue where the providerInfoData value was empty in the callback result of the connected IdP information when logging in on offline mode.

Community

• Fixed an issue that the standard error page supposed to be displayed when a network failure occurs during a SocialV4.showCommunity call (SocialV4.ViewType.FullScreen view type) was not displayed.

Device Management

• Fixed an issue where, despite exceeding the daily limit for sending verification numbers during mobile phone number verification prcoess, the timer for resending was reset anyway.
• Fixed an issue where text input area was activated despite exceeding the time limit for entering the verification number during mobile phone number verification process.

Promotion

• Fixed an issue where buttons in news, interstitial banners, etc., intermittently did not work on some devices (including iPhone XS Max).

Developer Guide Changes

---

• Added com.com2us.android.hive:hive-iapv4-market-hivestore as one of the values to be entered in the module-level build.gradle file.

 

v4.23.2.0 (2024-03-26)

Changed Features

---

Marketing Attribution

• Updated the Firebase Analytics library version: 10.16.0 → 10.20.0

Fixed Bugs

---

Unity

• Fixed an error in the Hive Config Inspector where some UI foldings were not working properly.

 

v4.23.1.0 (2024-02-01)

What’s New

---

Authentication

• Supports automatic login in offline mode when the device cannot be connected to the internet.

Analytics

• Provides the function to enable/disable the transmission of concurrent user status logs according to the settings in the Hive console.
  • Log Definition: hive_concurrent_user_log
  • Game Indicator, Comprehensive Indicator

Changed Features

---

Hive SDK Common

• When user device cannot be connected to the network, it will not attempt to re-execute the methods of Hive SDK features that require network connection.

Analytics

• When user device cannot be connected to the network, it will not attempt to re-send analytics logs.

Known Issues

---

There are no known issues with the release of this Hive SDK version.

 

v4.23.0.0 (2024-01-30)

Changed Features

---

Hive SDK Common

• The supported development environment is changed to Xcode 15 or higher. It can be used on macOS Ventura13.5 or higher. The supported OSs are as follows:
  • iOS 12 or higher
  • iPadOS 13 or higher

Authentication

• For device management, real-name verification for China, and etc., the send button is disabled if the user does not enter the SMS within the time limit for SMS verification.
• The reCAPTCHA library used by Hive SDK is updated to the official version.
• Each IDP is separated into libraries for optional application. The following libraries can be additionally applied:
  • Apple Sign-In
  • GameCenter
  • Hive Membership

Promotion

• Changes are made so that only one of either the news or the interstitial banner appears on the screen. Only the window called first will appear, and windows called later will not appear.
• Includes campaignId in UA campaign information.
• Updates the SDWebImage library and applies LRU cache policy related to image caching and downloading.

Billing

• No longer supports the IAPv2 interface and features.

Provisioning

• Adds the feature to expose terms of service based on accounts.

Hercules

• Updates the Hercules library version.
  • Android: 20231122
  • iOS: 20231116

Resolved Bugs

---

Authentication

• Fixed an issue where the app crashes when the camera capture button is tapped rapidly while editing the profile image.

Promotion

• Fixed an issue where the top notch area is cut off when displaying community webviews, etc., through promotion banners.

Provisioning

• Modified not to display the remaining time until the suspension is lifted for suspended users.

Datastore

• If you put an empty value to the set method as an argument, it now deletes the previously set value, ensuring proper operation.

Analytics

• In the concurrent user log transmission, changed the country code sent for unknown countries from Unknown to two space characters.

Known Issues

---

There are no known issues with this release of this Hive SDK version.

Changes in Developer Guide

---

Common

• Changed COPPA ageGateU13 to a value that can be set directly.
• Updated the hive_config.xml example.
• Removed content related to the unsupported IdP, WEIBO, from here.
• Updated content related to using and removing Hercules in Unity.
• Revised the description of in-app updates.

iOS

• Added Apple Game Center to the IdP integration guide.
• Changed the content of the iOS Podfile as Hive SDK features were internally divided into separate libraries.
• Updated the description related to automatically adding required permissions for the SDK to Xcode Signing & Capabilities via script in Unity.

 

v4.22.0.4 (2023-11-30)

Fixed Bugs

---

Analytics

• Fixed an error that the sales event of the Singular marketing attribution was not analyzed properly.

Billing

• iOS Fixed an error that it was unable to receive the NOT_OWNEND response callback when you try to restore a subscription type product via restoreSubscription, given that there actually was no subscription made in fact.

Known Issues

---

There are no known issues deploying this version of the Hive SDK.

 

v4.22.0.0 (2023-09-15)

What’s New

---

Analytics

• You can collect advertising exposure and ad sales information from marketing tracking tools (Analytics.sendAdRevenueEvent) like Singular, Adjust, AppsFlyer, and Firebase. To use this feature, you first need to update Podfile file in compliance with the Hive SDK 4.22.0.

Authentication

• Add a method to reset the terms and conditions agreement history. You can reset terms and conditions agreement history by calling the resetAgreement() method.

Changed Features

---

Hive SDK Common

• The UI rotation bound to the app configuration is changed to be bound to the HiveOrientation value set in the hive_config.xml. The screen rotation is supported for every UI provided from the Hive SDK.
• Move the “close” button (X button) inside the dialog for pop-up UI, review UI, etc.
• If you try to initialize the Hive SDK after termination of the game service, the error code will be returned.

Authentication

• Change the text displayed when using the device management service.
  • A line has been added recommending the use of the device management service.
  • Added a ‘Close’ button to move to the previous step in the text authentication process while using the device management function.
• Remove the customer center link URL that is displayed when users accessing from China undergoes real name authentication.
• When attempting to log in, an error code is returned due to the termination of the game service.

Billing

• When paying in Amazon Market and Apple App Store, the pending purchase feature is supported.
  • UserEngagement global callback handler declaration example codes have been changed. The IAP_UPDATED event EventEnd callback code has been changed, and this code change must be applied first if you want to provide the pending payment feature for the payments in Amazon Marketplace and Apple App Store.

Marketing Attribution

• When using Adjust, a deep link is provided to run already installed apps. Also, when a user clicks a deep link and runs an already installed app, tracking the Adjust attribution and re-attribution is provided.
• Change the AppsFlyer library to the latest version.
  • the previous version: v6.9.2
  • the latest version: v6.12.1

Community

• Puts the domain included the starting URL of the community in the domain whitelist. For example, if the starting URL of the Zenonia community is “https://www.zenonia.co.kr/ko/board/6″, “https://www.zenonia.co.kr” is included in the whitelist. On the Whitelisted domains, running JavaScript codes is allowed, and these domains can receive REST API POST requests.

Fixed Bugs

---

Hive SDK Common

• When there is no external library, a separate error code is provided instead of the Unknown or No Response error code.

Authentication

• About the implicit login function with the AuthV4Helper class, if a restricted account is logged in, the error code that was incorrectly sent as Invalid Session is returned as Need Exit.
• You now can also customize maintenance pop-up with more than two buttons.

Marketing Attribution

• Fixed an error that sending additional information with the wrong key when sending a purchase event with the AppsFlyer.
  • custsom_product_id → custom_product_id

Known Issues

---

There are no known issues deploying this version of the Hive SDK.

Changes in Developer Guide

---

• Added Data Store error code (RESPONSE_FAIL:DataStoreGameIsBeingInspected).
• According to the release policy change starting with Hive SDK 4.22.0, the guide structure regarding the release notes and downloads have been updated. The term “crossplay” has been changed to “Windows,” which refers to the OS, and the contents of the existing development guide of the crossplay are merged to the Windows section of the each guide for the Hive SDK module (Authentication, Promotion, Billing, Hercules, etc.), excluding the crossplay launcher.
• Updated Applying iOS Framework.

 

v4.21.1.3 (2023-11-08)

Download

---

	iOS
Download	Hive SDK v4 iOS 21.1.3
Release Date	2023-11-07

 

Fixed Bugs

---

Analytics

• Fixed an error that the sales event of the Singular marketing attribution was not analyzed properly.

Billing

• iOS Fixed an error that it was unable to receive the NOT_OWNEND response callback when you try to restore a subscription type product via restoreSubscription, given that there actually was no subscription made in fact.

Known Issues

---

There are no known issues deploying this version of the Hive SDK.