Skip to content

Android & iOS

v4.25.6.0

Download

Cocos2d-x Android & iOS
Download Hive SDK v4 Cocos2d-x Android & iOS 25.6.0
Release date 2025-07-31

Development environment

Cocos2d-x

  • Cocos2d-x 3.17.2

Android

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

iOS

Notes

  • Due to changes in authentication security protocols, when using Hive SDK v4 Cocos 25.0.0 or higher, you must issue a security key in Hive Console > Security Key Settings. Without a security key, login will not be possible in the app.

  • Due to changes in the PG payment process, to use PG payment with Hive SDK v4 Cocos 25.1.3 or higher, refer to the PG payment flow and update your code implementation.


New features

Chat

  • All Added the ability to express or display 'likes' on specific chat messages.
  • All Added the ability to write 'replies' to specific chat messages and provide information about reply relationships.
  • All Added the ability to mention specific users and provide information about user mentions.


Changed features

Chat


v4.25.5.1

New features

Authentication

  • All Provided a new multi-account login feature. Details include: * Save the currently logged-in account to the device * View saved accounts * Logout and delete saved accounts * Quickly login with another saved account

Promotion

Notification

  • All Added new push action button feature. * When receiving a push notification, you can perform predefined actions via push action buttons.

Chat

  • All Message sending * Added automatic translation of chat messages to the user's language and the ability to translate specific messages. * Added the ability to send announcement messages that only users of specific languages can receive. * Added message ID to websocket messages to ensure callback order.
  • All Channel * Added the ability to view previous chat history when entering a chat channel. * Provided the number of participants in the current channel. * Added sorting options when retrieving channel lists.
  • All Event management * Added the ability to send custom data events in binary.
  • All Connection management * Added reconnection feature.


Changed features

Common

  • Android Updated obfuscation rules required for builds.
  • iOS The previously separate HiveAppTrackingTransparents.framework library is now integrated into Service.framework.

Authentication

  • All When not using Hive membership accounts, the showMyInquiry method now displays the inquiry page.
  • Android Changed VK authentication popup from webview to in-app browser.

Marketing attribution

  • iOS Now supports automatic collection of Firebase purchase events.

Hercules

  • All Updated Hercules library. * Android 20250527 * iOS 20250218


Fixed bugs

Provisioning

  • iOS Fixed so that webview does not scroll when terms are displayed.

Promotion

  • iOS Fixed corner radius of news UI on iPad devices.

Analytics

  • iOS Fixed logic so that analytics logs can be sent immediately after agreeing to terms.


v4.25.2.0

Changed features

Provisioning

  • All On the terms details and review pages, if the link is not a terms URL or contains a hyperlink tag, it now opens in an external browser.

Authentication

  • All Changed VK authentication method. The new method can be used in the new VK developer console.

  • iOS Updated the verification protocol for deprecated GameKit API used in Apple GameCenter login.

  • Android Due to the end of support for Google Sign-In library, authentication now uses Google Credential Manager and AuthorizationClient API for both implicit and explicit login.

Billing

  • Android When a product purchased via PG payment is refunded, an order_id value is added to distinguish from previous transactions.
  • Android Upon completion of PG payment transaction, purchase completion logs are now sent from the client.

Promotion

  • Android Added Telegram to the exposure list for UserAcquisition sharing.
  • Android Changed caching policy for webview exposure.

Marketing attribution

  • All Added Hive SDK identifier for integration with MMP services.
  • All When manually tracking events, custom attributes can now be added.
  • Android When initializing Airbridge, market source information is now sent.
  • iOS When using sendEventWithAttributes API, the precision range for semantic value type floating-point values is changed from float to double.

Chat

  • All When sending or receiving message data, extraData is now sent and received.
  • All When connecting to the chat server, extraData is no longer sent.
  • All Integer time values are now received in addition to string time values.
  • All When network is blocked and websocket cannot be properly disconnected, changed so that reconnection attempts do not fail due to duplicate connections.

Others

  • Updated external libraries. * Airbridge(Android) v4.1.0 → v4.3.0 * Airbridge(iOS) v4.1.1 → v4.3.0 * Adjust(Android) v5.0.1 → v5.2.0 * Adjust(iOS) v5.0.1 → v5.2.0 * Singular(Android) v12.6.1 → v12.7.0 * Singular(iOS) v12.6.1 → v12.7.1 * AppsFlyer(Android) v6.15.2 → v6.16.2 * AppsFlyer(iOS) v6.15.3 → v6.16.1 * QQ(iOS) 3.5.17.3 → 3.5.17.4


Fixed bugs

Common

  • Android When communication retry is needed or connecting to a distributed server, if a response is received before the maximum timeout, retry or connect immediately without waiting for the timeout.

  • iOS Fixed an error where the gameLanguage value in hive_config.xml was reset when changing the server group zone using the Configuration class's setZone method.

Provisioning

  • All When initializing the ad module (Adiz) before SDK initialization and complying with COPPA or GDPR, fixed an error where the AgeGate value operated based on the value set in hive_config.xml.

Authentication

  • iOS Fixed an error where QQ web login did not work properly on devices with iOS 18 or higher.

Marketing attribution

  • Android Fixed an issue where empty push notifications were displayed when using Adjust to determine installation status.

  • Android When using Airbridge, fixed so that sales information is sent according to unit price and quantity when multiple items are purchased.

Chat

  • Android Fixed intermittent connection failures when connecting to chat.

v4.25.1.3

Changed features

Marketing attribution

Billing

  • Android Changed PG payment behavior to match other billing (IAPv4) markets. If using PG payment, refer to the PG payment flow and update your code.


v4.25.1.0

Fixed bugs

Marketing attribution

  • iOS Fixed an error where ad revenue information sent via Adiz was sent as AdMob in Airbridge instead of Adiz.

Billing

  • iOS Fixed an error where the popup UI for agreeing to send consumption information was displayed with an opaque background.

  • iOS Fixed an error where the app screen rotated unintentionally when closing the popup UI for agreeing to send consumption information.

Promotion

  • iOS Fixed an error where images disappeared when a rotation event occurred during review popup with images.


v4.25.0.0

New features

Authentication

Billing

Marketing attribution

Chat

  • All Newly supports chat features.

Matchmaking

  • All Updated matchmaking feature to newly support group matchmaking.
     <span style='color:#FF0000;'>※ Not compatible with previous Hive SDK interfaces. To use the updated matchmaking feature, use Hive SDK v4 25.0.0 or higher.</span>


Changed features

Authentication

  • All Removed unused Auth module classes, interfaces, methods, delegates, and listeners.
  • All Applied stronger security protocol using JWT tokens.
  • All Removed TalkPlus authentication token methods due to end of TalkPlus support.
  • Android Allowed browsing such as password recovery in Apple login webview, not just login.

Promotion

  • All Collects login events so that rewards can be given when a user who entered an invitation code installs the app. See here.

Marketing attribution

  • All Updated to support Adjust v5. * Removed Adjust Signature library.
  • All When aggregating ad revenue with Adjust, sends AdMob as the ad revenue source.
  • Android Reflected integration of Appsflyer ad revenue aggregation library into the main library. * 6.14.2 → 6.15.2 * Removed Appsflyer ad-revenue library.

Others

  • All Updated Hercules library version. * Android: 20241120 * iOS: 20241120


Fixed bugs

Authentication

  • Android Fixed an issue where UI thread was intermittently occupied if network response was delayed during signIn method execution.

Billing

  • iOS Fixed an error where an extra IAP_UPDATE event occurred when using UserEngagement to induce in-app product purchases.


v4.24.5.0

New features

Authentication

Matchmaking

Promotion

  • All Spot banners now support ad exposure.
  • Android Added support for X (formerly Twitter) in user invite sharing.


Changed features

Authentication

  • All Modified provider name displayed in conflict popup.


Fixed bugs

Billing

  • iOS Fixed so that prices that cannot be exactly represented as floating-point numbers are now shown as accurate decimals in JSON format. * Example: 4.99$ (string) → 4.9900000000000011 (double) → 4.99 (JSON number)


v4.24.4.0

New features

Marketing attribution

Billing

  • Android Supports purchasing a desired quantity of a single product via PG payment.


Fixed bugs

Analytics

  • iOS Fixed an error where selecting only one option in the consent banner was not properly reflected.


v4.24.3.0

New features

Provisioning

  • All Added the ability to check whether legal guardian consent has been obtained on the terms screen.


Changed features

Authentication

  • All Changed logout behavior. * Before: Hive SDK logged out the user account when signOut was called. Guest accounts received a failure response from the server when calling signOut API. * After: When signOut is called, Hive SDK requests Hive server to confirm if the user account can be logged out, and logs out based on the response.
  • All When logging out a guest account, no longer returns a success response, but returns an error code. Hive SDK and Hive server maintain the guest account session.
  • All For suspended accounts, automatically logs out IdP so that another account can be logged in with the same IdP. Only applies when auto-login is not possible.
  • All When linking IdP with AuthV4.connect, switching to a suspended account now triggers logout.
  • All Device management service now automatically applies international phone country code based on device region.
  • iOS Facebook login is now possible even if App Tracking Transparency (ATT) consent is denied.

Promotion

Marketing attribution


Fixed bugs

Hive SDK common

  • Android Fixed an error where memory was not released due to resource reference logic.
  • iOS Fixed intermittent crash when checking ATT consent status on iOS 14 devices.
  • iOS Fixed crash when selecting limited photo access in the photo album.

Notification

  • Android Fixed an error where unsupported type settings in local push notifications caused push messages to not display.
  • iOS Modified to send app version information.


v4.24.2.0

New features

Hive SDK common

Authentication

  • All When requesting authentication code after exceeding the maximum number of accounts per phone number, displays an error message: "Exceeded the number of accounts that can be created with the same phone number."

Promotion


Changed features

Notification

  • Android Supports runtime library (Push Amazon Device Message 1.2.0) for new Amazon Fire devices.

Promotion

  • iOS Improved usability by minimizing clipboard permission popup when using game invite (UA) feature. * Changed timing of popup from app launch to Hive SDK initialization. * Popup now only appears if inviter URL data exists in clipboard.

Analytics

  • iOS Default value for saveAnalyticsLogBeforeCrash option, which saves unsent logs to file on crash, is now false.


Fixed bugs

Authentication

  • All In real-name verification for users in China, fixed so that remaining time is not reset and error message is displayed when SMS send limit is exceeded.
  • Android Fixed an error where no callback was provided when pressing back key during Google Play login.
  • Android Fixed an error where keyboard input was not possible on low-resolution devices.

Promotion

  • iOS Fixed freezing issue when displaying new frame view in news view.

Marketing attribution

  • Android Fixed delay in Adjust event sending when initializing with customized terms.


v4.24.1.2

Fixed bugs

Authentication

  • Android Fixed an error where no callback was provided when pressing back button during Google login. This bug only occurred when Google Legacy Support was enabled in Hive console.
  • Android Fixed an error where keyboard input was not possible on low-resolution devices.


v4.24.1.0

Changed features

Analytics

  • iOS Changed to determine consent banner display based on device tracking consent. * If tracking consent is denied, the consent banner is not displayed.


v4.24.0.0

New features

Promotion

  • Android Supports custom tabs using the device's default browser for external page display. Use PlatformHelper class showInAppBrowser method to display in-app browser.
  • iOS Supports SafariViewController for external page display. Use PlatformHelper class showInAppBrowser method to display in-app browser.

Billing

  • iOS When product has first subscription discount, product info query returns both original_price and price fields in IAPV4Product object for discount info.


Changed features

Hive SDK common

  • iOS Now also uses CFBundleShortVersionString to distinguish app versions.

Billing

  • All Changed PG payment type wording in refund UI from "HiveStore" to "PG payment".
  • Android Changed PG payment page to display in in-app webview instead of in-app browser. Now supports PG payment on devices that do not support in-app browser.

Analytics

  • Android Default value for collecting ad identifier in Firebase event collection is now true.

v4.23.0.0


Download

Cocos2d-x Android/iOS
Download Hive SDK v4 Cocos2d-x Android+iOS 23.0.0
Release Date 2024-04-25

 

Development Environment

Cocos2d-x

  • 3.17.2

Android

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

iOS

 

Changed Features

Hive SDK Common

  • Android Access to the Java Enum interface ResultAPI class is changed. See the example below.
    • Previously: Only ResultAPI.Companion.getSUCCESS() was supported.
    • Changed: Both ResultAPI.Companion.getSUCCESS() and ResultAPI.SUCCESS are supported.
  • Android Both instance method style and class method style are supported in Java. See the example below.
    • Previously: Only IAPV4.INSTANCE.getProductInfo was supported.
    • Changed: Both IAPV4.INSTANCE.getProductInfo and IAPV4.getProductInfo are supported.
  • Android Adjustments are made so that inquiry windows, chatbots, and adult authentication windows do not exceed the screen range on Z-Flip 5 front display.
  • iOS 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

  • All 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.
  • Android Each IDP is separated into libraries for optional application. The following libraries can be additionally applied:
    • Apple Sign-In
    • Weverse
    • Membership
  • Android Changes are made to trust only login information directly verified by Hive Server during Google Play Games login, resolving some cases of AuthV4ServerResponseError.
  • iOS The reCAPTCHA library used by Hive SDK is updated to the official version.
  • iOS Each IDP is separated into libraries for optional application. The following libraries can be additionally applied:
    • Apple Sign-In
    • GameCenter
    • Membership

Promotion

  • All 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.
  • All Includes campaignId in UA campaign information.
  • iOS Updates the SDWebImage library and applies LRU cache policy related to image caching and downloading.

Billing

  • All No longer supports the IAPv2 interface and features.
  • Android Changes are made so that when there is a pending purchase, the delayed purchase result does not affect the current ongoing payment.

Provisioning

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

Hercules

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


Fixed Bugs

Authentication

  • Android Fixed an issue where buttons are displayed incorrectly when the usage restriction popup is shown in Portuguese.
  • iOS Fixed an issue where the app crashes when the camera capture button is tapped rapidly while editing the profile image.

Promotion

  • Android Fixed an error where line breaks do not work correctly when the app is changed from foreground > background > foreground again while the game exit popup is displayed.
  • iOS Fixed an issue where the top notch area is cut off when displaying community webviews, etc., through promotion banners.

Provisioning

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

Datastore

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

Notification

  • Android Fixed an issue where the push message contents do not appear due to a problem in the process of retrieving push messages for displaying when the app is relaunched.

Analytics

  • All 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.

Developer Guide Changes

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.
  • Revised the description of in-app updates.

Android

  • Added minimum versions for Gradle, Android Gradle Plugin, Kotlin Gradle Plugin here.
  • Changed the content of the Android Gradle file as Hive SDK features were internally separated into separate libraries.
  • Removed related content from AndroidManifest.xml settings as WeChat Auth is automatically added by Hive SDK. Also removed content as Hive SDK does not directly use FOREGROUND SERVICE.
  • Changed the content related to setting required libraries in build.gradle for Facebook Cloud Game builds here.
  • Changed the content of the module-level build.gradle file for adding Firebase Analytics here.
  • Updated adding Huawei build settings.
  • Changed the content related to setting required libraries in build.gradle for Google Play Games on PC builds here.
  • Changed the content of the module-level build.gradle file for supporting Google login here.
  • Revised the description as the ONE Store version was updated to 21.01.00 here.

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.