SDK Cocos2d-x release notes¶

This guide introduces the main updates of Hive SDK Cocos2d-x by version.

Essentials¶

Before using each release version of Hive SDK, we guide you through the essential settings related to version-specific constraints.

Issuing a Security Key is mandatory for Hive SDK v4 Cocos2d-x 25.0.0 or higher
- Due to changes in the authentication security protocol, when using Hive SDK v4 Cocos2d-x 25.0.0 or higher, you must obtain a Security Key from Hive Console > Security Key Settings. If you do not obtain a security key, you will not be able to log in to the app.
Changes to PG Payment Implementation Required for Hive SDK v4 Cocos2d-x 25.1.3 or Higher
- To implement PG payments on Android 25.1.3 or higher, you must modify the PG payment implementation code by referring to PG Payment Operation Process.

v4.26.0.2¶

SDK per Target OS	Release Date
SDK Cocos2d-x iOS	2026-03-20

Fixed bugs¶

iOS Fixed an error where popups using WebView (login, banner, customer service, community, etc.) did not function properly in the iOS 26.4 environment.

v4.25.9.1¶

SDK per Target OS	Release Date
SDK Cocos2d-x iOS	-

Fixed bugs¶

iOS Fixed an error where popups using WebView (login, banner, customer service, community, etc.) did not function properly in the iOS 26.4 environment.

v4.25.8.3¶

SDK per Target OS	Release Date
SDK Cocos2d-x iOS	2026-03-20

Fixed bugs¶

iOS Fixed an error where popups using WebView (login, banner, customer service, community, etc.) did not function properly in the iOS 26.4 environment.

v4.26.1.3¶

SDK per Target OS	Release Date
SDK Cocos2d-x iOS	-

Fixed bugs¶

Authentication¶

iOS Fixed an error where the app would freeze (become unresponsive) when touching an empty space in an AgeGate pop-up requiring date of birth information or a calendar-related pop-up on an iPad device.
iOS Fixed an error where unnecessary scrollbars were displayed in some popups when the device management service was running on iOS devices.

Billing¶

iOS Fixed an error where the returned value changes when calling the getAccountUUID method.

Marketing Attribution¶

iOS Fixed an error where some text of the Digital Markets Act (DMA) consent banner was not displayed on iOS devices with a resolution of less than 1170px.

v4.26.1.2¶

SDK per Target OS	Release Date
SDK Cocos2d-x iOS	-

Changed features¶

Authentication¶

iOS If you have verified your mobile phone number when logging into your HYIVE membership in the China region, we are changing the process so that you proceed directly to ID verification during the China real-name verification step without verifying your mobile phone number.
Since the existing HYIVE membership login only verifies your Member ID (email address) and not your mobile phone number, you must verify your mobile phone number during the subsequent China real-name verification step.

Fixed bugs¶

iOS Fixed an error where distribution version verification failed due to the inclusion of an incorrectly generated bundle file Info.plist during Apple Submission.
iOS Fixed an error where PG payment was displayed as Hive Store in the refund user re-payment UI.

v4.26.1.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x iOS	-

New features¶

Authentication¶

iOS We provide the AuthV4.checkAgeGate method which displays a popup for entering the date of birth and returns the value as a callback when the user enters the date.
iOS Adds the AuthV4.setAutoLoginEnabled method, which registers the next login session, rather than the current one, as an auto-login session (ON/OFF). When set to ON and a login is performed via the login method, that login session is saved as an auto-login session. Subsequently, auto-login can be used by executing AuthV4.Helper.signIn or executing AuthV4.signIn with ProviderType.AUTO during login.

Promotion¶

iOS It supports deferred deep linking, which redirects users who have not installed the app to the in-app page specified in the link even after the app installation is complete when they click a direct link.

Others¶

iOS You can check the language setting configured in the SDK using the getGameLanguage method in the Configuration class.
iOS Following the termination of the CocoaPod service, we provide a distribution service via SPM (Swift Package Manager).

Changed features¶

Authentication¶

iOS We support age verification methods via the web as well as through apps.
iOS Remove the automatic collection of profile images and nicknames when logging in via SNS.
iOS With the addition of AuthV4.setAutoLoginEnabled(Default: PC OFF / Mobile ON), the auto-login behavior policy is changed as follows:
Previous: When switching to a different account after an account conflict, the new account maintains auto-login on mobile and disables auto-login on PC.
Changed: When switching to a different account after an account conflict, the new account maintains auto-login on both mobile and PC if auto-login sessions have been registered using AuthV4.setAutoLoginEnabled, otherwise it is disabled (exceptions exist).

Promotion¶

iOS Fixes the WebView flickering error when navigating to an external browser via Custom View/Direct View.

Push¶

iOS When collecting tokens for push notifications, change the method to collect additional token information based on the build environment.

Marketing Attribution¶

iOS The popup design of Displaying DMA Consent Banner has been changed and its behavior improved.
Previous consent history from the existing consent banner will be retained, and upon re-display, a new consent banner with improved text and UI will be displayed.
If you were using custom text for the existing consent banner, you must reconfigure it by referring to Custom Consent Banner UI Settings to match the changed data structure.
iOS Changes are made to prevent duplicate sales logs for the same receipt from being sent to the MMP.
iOS Added the ability to send the sales value to the 'value' key as well when sending Firebase purchase events.
Previously, the sales value was sent to the 'revenue' key.

Add-ons¶

iOS Improves the visibility of the WebView close button displayed by the PlatformHelper class's showInAppView method in Open in-game WebView.

Provisioning¶

iOS We provide the Age Range API separately so that it can be applied in compliance with the App Store Liability Act.
The App Store Liability Act, set to take effect in Texas, USA on January 1, 2026, is currently on hold and can be applied selectively depending on the development situation.
It can be applied selectively in compliance with the App Store Liability Acts set to take effect in Utah, USA in May 2026 and in Louisiana, USA in July 2026.

Library updates¶

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

Others¶

iOS The Configuration.setZone behavior has been changed to be valid only until initialization.

Fixed bugs¶

Authentication¶

iOS Fixed an error where the chat message input field was intermittently not displayed while using the chatbot.
iOS Fixed an error where the adult verification popup would reappear if a registered device was deleted after adult verification while the number of registered devices in device management had been exceeded.

Promotion¶

iOS Fixed an error where the news menu did not function properly if the number of items exceeded a certain limit.
iOS Fixed an error where the system did not function properly if the width or height of the image displayed on the front banner was '0' or if the server transmitted incorrect information.
iOS Fixed an error where direct links do not work if URL parameters are missing when exposing a community via a direct link.

Push¶

iOS Fixed an error where the ForegroundPush setting was not changed to False.

Marketing Attribution¶

iOS Fixes errors where Install or Update events are missing in Firebase.

Add-ons¶

iOS Fixed an issue where the game app flickers and the window closes when the game app user's network status is offline or changes to offline when the showInAppBrowser method of the PlatformHelper class is applied in Open In-Game Browser.

v4.26.0.1¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	2025-12-18
SDK Cocos2d-x iOS	2025-12-18

Changed features¶

iOS The Xcode version for the Hive SDK development environment will be changed as follows.
Previous: Xcode 26.2 Beta2
Changed: Xcode 26.2

Provisioning¶

Android In compliance with the App Store Liability Act, the version of the Google Play Age Signals API supported by the Hive SDK will be changed as follows.
Previous: 0.0.1-Beta2
Changed: 0.0.2

v4.26.0.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

New features¶

iOS You can build the Hive SDK on iOS Xcode 26.2 or later.
The minimum supported OS version is iOS 15.

Provisioning¶

Android Compliance is a new feature.
When distributing game apps to Google Play and Amazon Appstore, the Hive SDK provides the Age Range API to check user age ranges to comply with the App Store Liability Act, which goes into effect in Texas, USA, on January 1, 2026.
iOS Adding a new Compliance feature.
When distributing game apps to the Apple App Store, the Hive SDK provides the Age Range API to check user age ranges to comply with the App Store Liability Act, which goes into effect in Texas, USA, on January 1, 2026.
Supported only on iOS 26.2 or later.

Known issues¶

Provisioning¶

Android In compliance with the App Store Liability Act, Google Play Age Signals API version 0.0.1-beta02, supported by Hive SDK 26.0.0 Beta, cannot be used in user environments that receive actual age signals. ※ To receive actual age signals, please update to Hive SDK v4.26.0.1, which supports Google Play Age Signals API version 0.0.2 (non-beta version).

v4.25.9.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

New features¶

Authentication¶

All Identity Verification Service is provided.
SteamDeck does not provide identity verification services (identity verification, age verification, parental consent). You must use the identity verification service on mobile or PC and then access the game again via SteamDeck.

v4.25.8.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	2025-10-02
SDK Cocos2d-x iOS	2025-10-02

Check the Development Environment of this SDK version.

New features¶

Android Supports Android OS 16 (API Level 36).
Android When building on Android OS 15 (API Level 35) or higher, 16KB Page Size builds are supported.

Changed features¶

Android Remove the android.permission.FOREGROUND_SERVICE permission that is no longer in use.
Android The minimum Android build target is changed from 19 to 23.

Authentication¶

iOS Removes unusable library references during build in Xcode 26.

Library updates¶

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

Fixed bugs¶

Authentication¶

iOS Fixed an error where landscape mode was intermittently displayed instead of portrait mode when the chatbot popup was displayed.
iOS Modify to prevent empty array reference errors.
When using the showConflict method of the Authv4 class, a crash occurs if required input data is missing.

Analytics¶

Android Modified to prevent retransmission containing unnecessary information in the event of a concurrent client transmission failure.

v4.25.7.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

New features¶

Authentication¶

All Once age verification is complete, you can identify the verified user. Provides a method to get the identifying value. The identification information is a hashed DI value.

Changed features¶

Authentication¶

All If you configure an app to use age verification in the Hive console, the age verification process will be performed automatically after logging in.
This feature is supported only in Korea.
All The showAdultConfirm method, which performs age verification, is deprecated.
The showAdultConfirm method may be removed in a future update.

v4.25.6.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	2025-07-31
SDK Cocos2d-x iOS	2025-07-31

Check the Development Environment of this SDK version.

New features¶

Chat¶

All Adds a feature that allows you to express or mark 'Like' specific chat messages.
All It provides information that allows you to write a 'reply' to a specific chat message or indicate reply connection relationships.
All It provides a feature to mention specific users or provide information about mentioning users.

Changed features¶

Chat¶

All Change the Channel Message Lookup Method from index-based to message ID-based lookup.

v4.25.5.2¶

SDK per Target OS	Release Date
SDK Cocos2d-x iOS	-

Fixed bugs¶

Authentication¶

iOS Fixed an error where a crash occurred when displaying the chatbot in landscape mode.

v4.25.5.1¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

New features¶

Authentication¶

All We are newly providing the Switch between multiple accounts feature. The details of the related features are as follows:
Save the currently logged-in account to the device
View saved accounts
Log out and delete saved accounts
Quickly log in to other saved accounts

Promotion¶

All Adds a new Direct Link feature.

Notification¶

All A new Push Action Button is provided.
When a push notification is received, you can perform a predefined action via the Push Select Action Button.

Chat¶

All Send Message
Adds a feature to automatically translate chat messages into the user's language and to translate specific messages.
Adds a feature for announcement messages that can only be received by users of specific languages.
Adds a message ID value to WebSocket messages to guarantee the order of callbacks.
All Channel
Added a feature to view previous conversation history upon entering a chat channel.
Displays the number of people currently participating in the channel.
Provides a sorting criteria feature when viewing the channel list.
All Event Management
Adds the chat feature to send custom data events as binary.
All Connection Management
Adds a reconnection feature.

Hercules¶

Android 20241125-2 -> 20250527
iOS 20241120 -> 20250218

Changed features¶

Android Updates the obfuscation rules required for the build.
iOS The HiveAppTrackingTransparents.framework library, which was previously provided separately, is integrated into Service.framework.

Authentication¶

All We have modified the showMyInquiry method so that the inquiry page is displayed when used, whereas it previously did not work when a Hive membership account was not used.
Android Changes the VK authentication popup from WebView to the in-app browser.

Marketing Attribution¶

iOS Changes to support automatically collected Firebase purchase events if enabled.

Fixed bugs¶

Promotion¶

iOS Modifies the corner curvature of the News UI on iPad devices.

Provisioning¶

iOS Modify so that the webview does not scroll when the terms and conditions are displayed.

Analytics¶

iOS Modify the logic to enable the transmission of Analytics logs immediately after the terms agreement is completed.

Known issues¶

Others¶

iOS An error occurs where a crash happens when using the chatbot in landscape mode.
Please update the Hive SDK to Unity iOS 25.5.2 or higher.

v4.25.2.2¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-

Changed features¶

Authentication¶

Android Due to an issue where some users were unable to access Google Credential Manager because of its low compatibility, we are rolling back the authentication method to the existing Google Sign-In.

Library updates¶

Android * Google Play Services-Auth (Android) v20.7.0 (Reintroduction of Google Sign-In rollback support)
Google Credential Play Services Auth (Android) v1.3.0 (Removal of Google Sign-In rollback)

v4.25.2.1¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-

Fixed bugs¶

Marketing Attribution¶

Android Fixed an error where the 'did' value was missing among the Hive SDK identifiers used in MMP Service Integration.

v4.25.2.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

Changed features¶

Authentication¶

All We are providing updated VK authentication methods. The new authentication methods are available at the New VK Developer Console.
iOS Updates the validation protocol for the deprecated GameKit API used for Apple GameCenter login.
Android Due to the discontinuation of support for the Google Sign-In library, we are changing to authenticate using the Google Credential Manager and the AuthorizationClient API for implicit and explicit logins.

Billing¶

Android If a product purchased via PG payment is refunded, add an order_id value to distinguish it from the previous transaction.
Android When a PG payment transaction is completed, change the purchase completion log to be sent via marketing attribution.

Promotion¶

Android Changes so that when sharing User Acquisition, it is added to the exposure list supported by Telegram.
Android Change the caching policy when displaying the WebView.

Marketing Attribution¶

All Additionally send the Hive SDK identifier to support MMP service integration.
All When manually tracking events, change to send by adding a custom attribute.
Android Changes to transmit market source information when Airbridge is initialized.
iOS When using the sendEventWithAttributes API, change the precision range of floating-point values of type semantic value from float to double.

Provisioning¶

All On the Terms & Conditions Details and Replay pages, the system will be modified to open a new external browser window to load the content instead of the Terms & Conditions page (WebView) in the following cases:
When navigating to a webpage outside the Terms & Conditions URL
When clicking on a hyperlink HTML tag (a tag, tel://, etc.) within the Terms & Conditions

Library updates¶

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 (Discontinued)
- Google Credential Play Services Auth (Android) v1.3.0 (new support)
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

Chat¶

All When sending or receiving message data, additional extraData is sent and received.
All When connecting to the chat server, extraData is no longer transmitted.
All Additionally, receive an integer time value instead of a string time value.
All Modified to prevent failure due to a duplicate connection state when attempting to reconnect after failing to properly release the WebSocket in situations where communication is impossible, such as network blockage.

Fixed bugs¶

Android Modify the code so that if a response is received before the set maximum timeout time is exceeded in situations where communication retries over the network or access to a distributed server is required, the communication retries or access to the distributed server is performed immediately without waiting for the timeout to expire.
iOS Fixed an error where the gameLanguage value in the hive_config.xml file was initialized when the server group Zone connected by the Hive SDK was changed using the setZone method of the Configuration class.

Authentication¶

iOS Fixed an error where QQ Web login did not proceed normally on devices running iOS 18 or higher.

Marketing Attribution¶

Android Fixed an issue where empty push notifications were displayed when using the feature to determine installation status with Adjust.
Android Modify the system to deliver sales information based on unit price and quantity when an event occurs where multiple items are purchased using Airbridge.

Provisioning¶

All Fixed an error where, when initializing the ad module (Adiz) prior to SDK initialization, the AgeGate value used for age checking operated based on the value set in hive_config.xml in compliance cases such as COPPA or GDPR.

Chat¶

Android Fixed an issue where the chat connection would intermittently fail.

Known issues¶

Marketing Attribution¶

Android There is an error where the 'did' value is missing among the Hive SDK identifiers used for MMP Service Integration. Please use version SDK v4 Unity Android & iOS 25.2.1, which resolves this issue.

v4.25.1.3¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

Changed features¶

Billing¶

Android Change the behavior of PG payments to be identical to that of markets in other billing (IAPv4) features. If you are using PG payments, you must modify your code implementation by referring to the PG Payments document.

Marketing Attribution¶

iOS New support for Airbridge Deferred Deep Link Tracking feature.

Fixed bugs¶

Billing¶

iOS Fixed an error where the background became opaque when displaying a popup UI asking for consent to transmit consumption information.
iOS Fixed an error where the app's screen orientation rotated in an unintended direction when closing the popup UI asking for consent to transmit consumption information.

Promotion¶

iOS Fixed an error where the displayed image disappeared when a rotation event occurred during the display of a review popup containing an image.

Marketing Attribution¶

iOS Fixed an error where Airbridge sent ad revenue information to AdMob instead of Adiz when transmitting via Adiz.

v4.25.0.1¶

SDK per Target OS	Release Date
SDK Cocos2d-x iOS	-

New features¶

Marketing Attribution¶

iOS Fixed an error where did and vid values automatically collected and sent by the SDK were not sent when using Hive SDK v4 25.0.0 or higher with Adjust v5 applied.

v4.25.0.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

New features¶

Authentication¶

All Telegram is supported as a new Identity Provider (IdP). Please refer to Bot Settings for Telegram Login.

Billing¶

iOS It supports a feature to ask the user whether to consent to send in-app product consumption information to the Apple App Store.

Promotion¶

All Collect login events to provide rewards when a user who entered the invitation code installs the app (../../operation/promotion/ua.md/#_7).

Matchmaking¶

All The matchmaking feature has been updated to newly support Group Matchmaking. ※ This is not compatible with the interfaces of previous versions of the Hive SDK. To use the updated matchmaking feature, you must use Hive SDK v4 25.0.0 or higher.

Marketing Attribution¶

All New support for the Send additional attributes to Airbridge feature is now available when sending marketing tracking events.
Android New support for Airbridge Deferred Deep Link Tracking feature.

Chat¶

All The Chat feature is newly supported.

Changed features¶

Authentication¶

All Deletes Auth module classes, interfaces, methods, delegates, and listeners that are no longer in use.
All Apply stronger security protocols using JWT tokens.
All The TalkPlus authentication token method is being removed due to the end of TalkPlus support.
Android Allows browsing functions such as password recovery in addition to the login function in the Apple Login WebView.

Marketing Attribution¶

All Update to support Adjust v5.
Remove the Adjust Signature library.
All Change the settings so that when aggregating Adiz ad revenue with Adjust, the ad revenue source is sent to the AdMob source.
Android Reflects the integration of the Appsflyer ad revenue aggregation library into the main library.
6.14.2 → 6.15.2
Removes the Appsflyer ad-revenue library.

Hercules¶

All 2024.11.20

Fixed bugs¶

Authentication¶

Android Resolves an issue where the UI thread is intermittently occupied when a network response delay occurs during the execution of the signIn method.

Billing¶

iOS Fixed an error where an additional IAP_UPDATE event was triggered when inducing an in-app purchase using UserEngagement.

Known issues¶

Marketing Attribution¶

iOS When using Adjust, there is an error where the did and vid values automatically collected and sent by the SDK are not transmitted. You need to update to Hive SDK v4 25.0.1 or higher.

v4.24.5.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

New features¶

All Supports Unity 6 (Unity 6000).

Authentication¶

All Steam and X (formerly Twitter) are newly supported as authentication methods.
Preparation: Common
Preparation: Android
Preparation: iOS
Branding Guide
Android It provides in-web browsing features that share authenticated sessions.

Promotion¶

All Ads can also be displayed in Spot Banner.
Android We support X (formerly Twitter) for the user invitation sharing feature.

Matchmaking¶

All We support Matchmaking Service as a new feature.

Changed features¶

Authentication¶

All Modify the Provider name displayed in the conflict popup.

Fixed bugs¶

Billing¶

iOS When the price of certain products cannot be expressed exactly as a floating-point number, modify the JSON format to display the value as a decimal number instead of a repeating decimal.
Example> 4.99$ (string) → 4.9900000000000011 (double) → 4.99 (JSON number)

v4.24.4.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

New features¶

Billing¶

Android When making a PG payment request, multiple quantity purchases using IAPv4.purchase is supported.

Marketing Attribution¶

All We support Airbridge as a service specialized for the Hive SDK.
Automatically track events with Airbridge
Manually track events with Airbridge

Fixed bugs¶

Analytics¶

iOS Fixed an error where selecting only one option for the consent banner was not reflected correctly.

v4.24.3.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

New features¶

Provisioning¶

All Adds a feature to check whether consent has been obtained from a legal representative on the terms and conditions screen.

Changed features¶

Authentication¶

All Changes the logout behavior.
Previous: When signOut is called, the Hive SDK logs out the user account. Guests receive a failure response from the server when calling the signOut API.
Changed: When signOut is called, the Hive SDK requests confirmation from the Hive server whether it is safe to log out the user account, and then logs out based on the response.
All When logging out the guest account, it no longer returns a success response, but returns an error code. It maintains the guest account session with the Hive SDK and the Hive server.
All For suspended accounts, the settings are changed to automatically log out of the IdP so that you can log in with a different account on the same IdP. This applies only when automatic login is not possible.
All When performing IdP integration using the AuthV4.connect method, change it so that if the account is switched to a suspended account, a logout is performed.
All Change the device management service to automatically apply international phone country codes based on the device's connection region.
iOS We are changing the settings to allow Facebook login even if you have declined App Tracking Transparency (ATT) consent.

Promotion¶

All Modify the value transmitted via additionalInfo so that unnecessary information is not included.
All Change to display full-screen banners at a 2:3 or 3:2 ratio
All Change the text "Don't show for 1 day" on the front banner to "Don't show today".

Marketing Attribution¶

All Adjust Signature Change the version from v1 to v3.

Library updates¶

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

Fixed bugs¶

Android Fixed the error where memory could not be allocated by modifying the resource reference logic.
iOS Fixed an error that caused intermittent crashes when checking consent for App Tracking Transparency (ATT) on iOS 14 devices.
iOS Fixed an error that causes a crash when selecting access restriction (allow access to only some photos) in the photo album.

Notification¶

Android Fixed an error where push messages were not displayed correctly in Local Push Notification when an unsupported type was set.
iOS Modify to send app version information.

v4.24.1.3¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

Changed features¶

Authentication¶

All Change the device management service to automatically apply international phone country codes based on the device's connection region.

v4.24.2.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

New features¶

All Provides a function to return whether a user under the age of 16 in the EU and EEA regions subject to GDPR has agreed to the terms. You can check whether the user is under the age of 16.
Android When using the Photo Album on devices running Android OS 11 or higher, or on devices with the supported module installed, PhotoPicker is used by default.
iOS You can view Hive SDK debug logs in the macOS console app, and select specific log types to view.

Authentication¶

All When the number of accounts that can be signed up for with one mobile phone number is exceeded, requesting the sending of a verification code displays an error message stating, "You have exceeded the number of accounts that can be created with the same mobile phone number."

Promotion¶

All It provides a feature to control the exposure of cross-promotions.
All Today, we support Don't show for N days, an improved Don't show feature.

Changed features¶

Promotion¶

iOS Improved usability by minimizing the display of the clipboard paste permission consent popup when using the Game Invitation (UA) feature.
1. Changed the timing of the permission consent popup display from immediately after the invited user launches the app to when the Hive SDK is initialized after the app launches.
2. Changed the popup to be displayed only when inviter URL data exists in the clipboard.

Notification¶

Android Supports the runtime library (Push Amazon Device Message 1.2.0) that runs on new Amazon Fire devices.

Library updates¶

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

Analytics¶

iOS Change the default value of the saveAnalyticsLogBeforeCrash setting, which is an option to save unsent logs to a file when an app crashes, to false.

Fixed bugs¶

Authentication¶

All Modified so that when the number of text messages sent is exceeded during the real-name verification process for users accessing from China, an error message is displayed instead of resetting the remaining time.
Android Fixed an error where there was no proper response callback when the user did not log in by pressing the back key during the Google Play login process.
Android Fixed an error where keyboard input could not be performed on low-resolution devices.

Promotion¶

iOS Fixed an error where freezing occurred when displaying a new frame view in the News view.

Marketing Attribution¶

Android Fixed an error where the sending of Adjust events was delayed when performing an initialization with customized terms.

v4.24.1.2¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-

Fixed bugs¶

Authentication¶

Android Fixed an error where there was no proper response callback when the login was canceled by pressing the back button while Google login was in progress. This bug occurred only when the Google Legacy Support value in the Hive console was true.
Android Fixed an error where keyboard input was not possible on low-resolution devices.

v4.24.1.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x iOS	-

Changed features¶

Library updates¶

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

Analytics¶

iOS We are changing the display of the consent banner based on whether the device consents to tracking.
- If tracking consent is declined, the consent banner will not be displayed.

Fixed bugs¶

Billing¶

iOS Fixed an error where product lookup failed when updating from a Hive SDK version lower than v4 24.0.0 (e.g., v4 23.4.0) to v4 24.0.0.

v4.24.0.0¶

SDK per Target OS	Release Date
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

New features¶

Billing¶

iOS If initial subscription discount information is available, it is passed along when retrieving product information. When using getProductInfo, you can check the discount information by looking at the difference between the original_price field value and the price field value in the list of IAPV4Product objects received as a callback.

Promotion¶

Android It supports Custom Tabs that use the default browser set on the device to display external pages. You can expose the In-App Browser using the showInAppBrowser method of the PlatformHelper class.
iOS Supports SafariViewController, which uses a browser to display external pages. You can expose an in-app browser using the showInAppBrowser method of the PlatformHelper class.

Changed features¶

iOS When distinguishing app versions, we additionally use CFBundleShortVersionString.

Billing¶

All We have changed the PG payment type text displayed in the refund user re-payment UI from "HiveStore" to "PG Payment".
Android We are changing the display of the PG payment page to the in-app webview instead of the in-app browser. This supports PG payments even on devices that do not support the in-app browser environment.

Library updates¶

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

Analytics¶

Android Change the default value of the ad identifier collection setting in the Firebase event collection feature to true.

Known issues¶

Authentication¶

iOS When using the Facebook SDK iOS 17.0.0, there is an issue where users cannot log in on iOS 17.0 or higher devices if they do not agree to "App Tracking Transparency". To implement Facebook login under these conditions, please use the Hive SDK v4 24.1.0.