Changelog

Learn about the latest updates and changes in the HMS Unity Plugin with our comprehensive changelog.

v2.3.7

04 April 2024

2019/2020/2021/2022 - 2018

We are thrilled to present the release of HMS Unity Plugin Version 2.3.7, featuring a range of updates, fixes, and enhancements designed to improve your development workflow. We extend our gratitude to @alihan98ersoy, @Andronovo-bit and @am1goo for their contributions. Below is an overview of the key updates:

New Features and Updates

  • Gradle Worker for UNITY 2022.3: Integrated support for Unity 2022.3 in the gradle worker, enhancing the development workflow and compatibility. (ab566946)

  • Ads Kit Enhancements:

    • Moved the operation for getting userId to AdsDemoManager and introduced a builder pattern in HMSAdsKitManager for creating ads types, improving code readability and ease of use. (27d0a14)

    • Added a new method RewardVerifyConfig.LoadRewardedAd for server-side checks, ensuring more secure and reliable ad operations. Introduced AdLoadMethod Enum for specifying the type of rewarded ad loading method. (1c899bc)

    • Enhanced sign-in operations for obtaining userId (openId) using AccountKit, ensure seamless user authentication and data retrieval. (1c899bc)

  • CloudDB and In-App Comment Callback: Upgraded CloudDB to version 1.9.1.301 from 1.5.5.300 and added a callback for in-app comments, enabling better engagement and feedback collection. (5f93c81), (c469e86), (6f443d6)

  • Kit Updates: Significant upgrades to IAP & Ads kits: (cb89eca), (39ca1e3)

    • Upgraded IAP Kit to 6.13.0.300 from 6.4.0.301, introducing the BaseReq class as the new base class for various purchase request classes.

    • Upgraded Ads Kit to 13.4.69.300 from 13.4.61.300, adding new APIs in the NativeAd class for enhanced transparency and user data management.

      • com.huawei.hms:ads-consent:3.4.61.300 => 3.4.69.300

      • com.huawei.hms:ads-identifier:3.4.58.301 => 3.4.62.300

      • com.huawei.hms:ads-installreferrer:3.4.58.301 =>3.4.62.300

    • Push Kit & AuthService, enhanced with new versions and Twitter sign-in support.

      • com.huawei.hms:push: 6.7.0.300 -> 6.11.0.300

      • com.huawei.agconnect:agconnect-auth: 1.8.0.300 -> 1.9.1.301

    • AppLinking, CloudStorage, DriveKit, upgraded to provide additional features and improvements.

      • com.huawei.agconnect:agconnect-applinking: 1.8.0.300 -> 1.9.1.301

      • com.huawei.agconnect:agconnect-storage: 1.5.0.100 -> 1.9.1.301

      • com.huawei.hms:drive: 5.0.0.307 -> 5.2.0.300

    • AGCP, updated to ensure compatibility and performance enhancements.

      • com.huawei.agconnect:agcp: 1.6.1.300 -> 1.9.1.301

Fixes

  • Code Optimization: Implemented code formatting and optimization in HMSPluginUpdaterInit.cs and HMSAdsSettingsDrawer.cs, enhancing performance and maintainability. (a24da05)

  • Compatibility and Support: Disabled HMSPluginUpdater on gaming consoles (Microsoft Xbox, Sony Playstation 4/5, and Nintendo Switch) for improved platform compatibility and user experience. (d8151c6)

Other Improvements

  • Updated several kits, including Push Kit, AuthService, AppLinking, CloudStorage, and DriveKit, to their latest versions, enhancing functionality and security.

  • Removed HMSGitStandards and updated .gitignore to foster better version control practices.

This release marks our continuous commitment to providing a robust and developer-friendly platform. We recommend updating to HMS Unity Plugin Version 2.3.7 to leverage these new features and improvements. Your feedback is invaluable to us, and we look forward to seeing the innovative experiences you create with the HMS Unity Plugin.

v2.3.6

23 February 2024

2019/2020/2021/2022

We are pleased to announce the availability of version 2.3.6 for the HMS Unity Plugin. This release encompasses a comprehensive array of enhancements, including the introduction of new features, improvements to existing functionalities, bug resolutions, and the deprecation of outdated elements. This significant update, contributed to EvilMindDevs:master, spans improvements in syntax, the addition of innovative features, and more. We extend our gratitude to @alihan98ersoy and @Andronovo-bit for their contributions. Below is an overview of the key updates:

Enhancements and New Features

  • Game Addiction Prevention Demo: A new demo scene illustrating game addiction prevention mechanisms has been introduced at Huawei/Demos/Game/GameAddictionPreventionDemo/, offering developers insights into incorporating such features into their games. (4118e255)

  • Updates to Game Service & Account Kit: The GameService and Account Kit have been upgraded to their latest versions, bringing forth enhancements that enrich the development experience:

  • FAQ Button: To enhance user support and accessibility, an FAQ button has been added. (02d82e52)

  • Enhanced Ad Removal Logic: The logic for ad removal post-purchase has been improved, including modifications to SplashAd behavior. (3e432947)

  • Refinements to HMSKeyToolWindow and Issue Templates: Enhancements have been made to HMSKeyToolWindow.cs and issue templates for increased usability and clarity. (#456, #461) (d275b46d)

Deprecations and Replacements

  • The CurrentPlayer API is now deprecated in favor of GamePlayer.

  • The SetGameTrialProcess method has been deprecated.

  • The PlayerId field has been deprecated in favor of OpenId.

Bug Fixes

  • Resolution of Enum.TryParse Compatibility Issue: A fix has been implemented for compatibility issues with older C# versions concerning Enum.TryParse. (e0d5c9e9)

  • Syntax Improvements: Various syntax errors and method naming issues have been addressed to enhance code quality and maintainability. (db2495c7)

Code Quality and Refactoring

  • Namespace Refactoring: All classes and structs have been organized within appropriate namespaces to minimize conflicts and promote orderly code structure. (HUP-799, 3b47aab6)

  • Adherence to Coding Standards: A thorough refactoring has been carried out to align with best practices, including the adoption of Any() for checks of emptiness, preference for .TryParse over .Parse, and more.

  • Development Environment Standardization: The introduction of .editorconfig, .vsconfig, and settings.json aims to unify development environments and elevate code standards. (HUP-784)

Documentation Updates

  • README Revision: The README document has been updated to accurately reflect the recent modifications and enhancements. 8f0a337d)

For an exhaustive list of modifications, we recommend reviewing the commit history and the associated pull requests.

We urge all users to upgrade to the latest version to benefit from these enhancements. Your feedback and contributions are invaluable to us as they facilitate the ongoing improvement and evolution of this plugin.

v2.3.5

5 December 2023

2019/2020/2021 - 2018

Changes

  • Meta files were added (6f9d6f9).

  • Added functionality to control consumption owned items on initialization of the IAP process (43586db).

3D model kit improvements

  • Fixed scenes and DLL.(c3ca06b).

  • Fixed syntax in TaskListDisplay (62ee1be).

  • Modeling3dDemoManager.cs was updated (561788f).

  • Update to Modeling3dMeterialDemoManager.cs includes changes to TaskID and APIKey logic and bugfixes (552471c).

  • Created a new Modeling tab (a57191c).

  • Updated ModelingManagers (cb021b6).

  • Removed ModelingKit Android Package (ba791be). Since the ModelingKit Android Package has been removed, Manifest&gradle.properties now need to be implemented manually.

  • Created HMSModelingKitSettings.cs (8d4943b).

  • Added ability to disable automatic consumption purchases while initialization of the IAP process. #451

  • Facilitated the passing of developer payload strings through the PurchaseProduct method #450

  • Added a quick access Key Tool for SHA-256 key retrieval (#446). for more please refer to Obtain the SHA-256 with HMS Key Tool.

  • Refactored toggle labels and key names for HMS Core Installer.

  • Added Google Play Release area in the Common Libraries tab where HMS Core Installer can be enabled or disabled.

  • Introduced ask-for-star.yml in Github Action.

  • Fixed Consent methods issue in HMSAdsKitManager (364).

v2.3.4

22 August 2023

2019/2020/2021 - 2018

Changes

  • If UNITY_2022_2_OR_NEWER added to HMSGradleFixer Gradle 7.2(Unity 2022.2 and upper) now supported -> Related with https://github.com/EvilMindDevs/hms-unity-plugin/issues/426

IAP

  • The second IAP demo scene has been created to show how to use IAP and Account kit in multiple scenes.

  • A bool input has been added to the PurchaseProduct method to prevent it from being consumed optionally. Thus, those who wish can make their own consumption.

  • isUserOwnThisProduct method was added to see if the user has a specific product. (You need to call after initSuccess)

  • isIapAvailable method added.

  • GetAllOwnedPurchasesasList method added. This method will return owned products. (You need to call after initSuccess)

  • GetProductsList method added. This method will return information on products as a list. (You need to call after initSuccess)

Reminder: You can still use the GetProductInfo method for specific products.

  • OnObtainOwnedPurchasesSuccess & OnObtainOwnedPurchaseRecordSuccess callbacks fixed.

Reminder: When testing non-consumable products with a sandbox, if you consume the product, you will not see that you have the product. If you don't consume, you can also see ownedpurchases. Just consume the product before you test repurchase. This is only for sandbox testing, in a normal process, you should consume after purchase.

v2.3.3

05 May 2023

2019/2020/2021 - 2018

Changes

  • A new kit 3D Modeling Kit was added as a Beta version.

v2.3.2

07 April 2023

2019/2020/2021 - 2018

Changes

  • The GetUserPlayState and IsAllowContinuePlayGames methods have been added to assist game developers in complying with China's age restriction policies for specific games.

  • The AdskitManager's InstallReferrerFail callback action has been modified to return InstallReferrerResponse instead of void.

  • Unity Purchase has been updated to provide a purchase token after a purchase has been completed.

v2.3.1

03 March 2023

2019/2020/2021 - 2018

Changes

  • Thanks to an issue opened on Our Discord Channel, the error received from clicking the Native ad while displaying real ads, that "native ad is not in whitelist, API call event report is not allowed" has been fixed.

  • Click_catcher has a minor issue with catching clicks. Fixed.

  • Cloud Storage and Demo Improvements: OnCompleteListener, OnProgressListener, OnPausedListener, and OnCanceledListener methods Added.

v2.3.0

07 February 2023

2019/2020/2021 - 2018

Changes

  • Remove dependencies from the HMSCloudDBManager to a user-defined class. You no longer need to make any changes to HMSCloudDBManager.

  • IAP manager and demo improved. Redelivery Process for Consumables added. HMSIAPManager refactored.

  • BuyProduct method renamed as PurchaseProduct.

  • Fixed null object reference in the AUTH service Demo.

Kits updated

AdsKit:

ads-lite:13.4.61.300, ads-consent:3.4.61.300, ads-identifier:3.4.58.301, ads-installreferrer:3.4.58.301

  • Added the AdvertiserInfo API to obtain and display advertiser information, adapting the Russian advertising law.

  • Added the hasAdvertiserInfo and getAdvertiserInfo methods to the NativeAd class.

  • Added the getInstallChannel method to the ReferrerDetails class to support the function of obtaining the channel information.

AuthService:

1.8.0.300

  • Added the Alipay account support.

  • Decoupled third-party SDK dependencies.

  • Fixed minor issue with Weibo account support.

Cloud DB:

1.5.5.300

  • Added the and(), or(), beginGroup(), and endGroup() methods to the CloudDBZoneQuery class.

  • Added the getIndex() method to the CloudDBZoneQueryPolicy enum.

More:

Account Kit - 6.9.0.301 Crash - 1.8.0.300 Push Kit - 6.7.0.300 AppLinking - 1.8.0.300

v2.2.9

13 January 2023

2019/2020/2021 - 2018

Changes

  • Added HuaweiMobileServices.Utils.AndroidUtils class.

  • A Custom manifest file(disabled by default) was added for HMSUnityPlayeractivity to catch results from the StartActivityForResult method.

  • In-App comment fixed for landscape problem. But to see the results from the In-App comment in the log, you need to remove the .old extension from the ActivityResultAndroidManifest.xml.old file.

  • Fixed asynchronous send events in the analytics kit.

  • Fixed issues when using cloud storage with byte array.

  • (only 2018) .meta files restored to fix errors in the console

v2.2.8

5 December 2022

2019/2020/2021 - 2018

Changes

  • Ads kit now supporting Native Ads

  • Upgraded the ads kit versions :

com.huawei.hms:ads-lite:13.4.54.300 => com.huawei.hms:ads-lite:13.4.58.301

com.huawei.hms:ads-consent:3.4.54.300 => com.huawei.hms:ads-consent:3.4.58.304

  • Now we have a demo scene for Unity Purchase in our plugin

v2.2.7

31 October 2022

2019/2020/2021 - 2018

Changes

v2.2.6

28 September 2022

2019/2020/2021 - 2018

Changes

  • APM is supported now.

  • Auth service demo null reference handled

  • Adding missing methods to the AppMessaging module

  • Ads scene demo toggle bug fixed

v2.2.5

01 September 2022

2019/2020/2021 - 2018

Changes

  • Scan Kit is supported now.

  • Cloud Storage is supported now.

  • Version comparison fixed.

  • The HMS Kit Settings editor has been redesigned.

  • Added ToString method in HMSException.

v2.2.4

05 August 2022

2019/2020/2021 - 2018

Changes

  • Location Kit is supported now.

  • Install Referrer is supported now.

  • Demo scene UI improvements.

  • Redelivery process added to the IAP demo.

  • setNonPersonalizedAd and setRequestLocation methods were added to the ads demo.

  • Publishing API editor optimized.

  • Ads editor optimized.

  • HMSCore installer SDK added.

v2.2.32 - Hotfix

07 July 2022

2019/2020/2021

Changes

  • Drive Kit is supported now.

  • The crash demo scene is fixed.

  • The IAP demo scene is always landscape now.

  • The Game service demo scene is fixed.

v2.2.3

17 June 2022

2019/2020/2021 - 2018

Changes

Added two new features:

Bugs fixed:

  • #180 BannerAds extra large #128 BannerAds left-right not working #129 position top is not positioned within the safe area

Now users can load custom size banner ads (Not recommended).

v2.2.2

20 May 2022

2019/2020/2021 - 2018

Changes

  • Version updates com.huawei.hms:hwid:6.3.0.301 --> com.huawei.hms:hwid:6.4.0.301 com.huawei.hms:hianalytics:6.3.2.300 --> com.huawei.hms:hianalytics:6.4.1.302 com.huawei.agconnect:agconnect-crash:1.6.3.300 --> com.huawei.agconnect:agconnect-crash:1.6.5.300 com.huawei.hms:game:5.0.4.303 --> com.huawei.hms:game:6.2.0.301 com.huawei.hms:iap:6.3.0.300 --> com.huawei.hms:iap:6.4.0.301 com.huawei.hms:nearby:6.2.0.300 --> com.huawei.hms:nearby:6.2.0.301 com.huawei.hms:ads-lite:13.4.51.300 --> com.huawei.hms:ads-lite:13.4.54.300 com.huawei.hms:ads-consent:3.4.51.300 --> com.huawei.hms:ads-consent:3.4.54.300 com.huawei.hms:push:6.3.0.302 --> com.huawei.hms:push:6.3.0.304 com.huawei.agconnect:agcp:1.4.2.300 --> com.huawei.agconnect:agcp:1.6.5.300 com.huawei.hms:base:5.2.0.300 --> com.huawei.hms:base:6.4.0.303 com.huawei.agconnect:agconnect-core:1.5.0.300 --> com.huawei.agconnect:agconnect-core:1.6.5.300

  • The JosAppsClient.init() method is deleted and replaced with the JosAppsClient.init(AppParams appParams) method

  • AppParams class added for JosAppsClientWrapper.cs

  • The issue where launching the push kit with other kits delayed the loading of the scene was fixed with Coroutine

  • Fixed null invokes in HMSPushKitManager onAwake

  • Invoke the GMS Login when the HMS Core APK is not installed Example added in HMSAccountKitManager

  • Even if the HMS exception error code was different, it always returned 0. This bug is fixed.

  • GameService Init first bug fixed

  • HMSGameServiceManager - added else condition for if HuaweiId is null case

  • SetChannel and SetPropertyCollection added to the HiAnalyticsInstance.cs

  • SetIdTokenSignAlg method added to the AccountAuthParamsHelper.cs

  • Updated the README about permissions required for the Nearby service

v2.2.1

29 Apr 2022

2019/2020/2021 - 2018

Changes

  • Lists of countries and languages ​​in PMS API sorted,

  • Minor UI fixes in PMS API,

  • Fixed bug when IAP product identifier consisted of numeric only,

  • #303 -> Requesting via Email and Phone verification code method(RequestVerifyCode) in AGConnectAuth Fixed.

v2.2

2019/2020/2021 - 2018

Changes

  • Demos are changed due to v2.2 HMSXManager GameObject dependency has been lifted. Users now can use services without needing a GameObject of the kit they wanted to use.

  • Manifest merger failed caused by Gradle Fixer bug fixed.

  • DriveKit was removed from Kit Settings.

  • When unity cannot obtain the settings file, from now on it will throw a NullReference exception

  • Use Test ads toggle's position changed due to visibility.

  • Managers are not dependent on Monobehaviour and they are singleton. Deprecated methods are renewed with valid ones.

  • Manager Class names are now fixed with names from developer.huawei.com. Changed Names: HMSAccountManager -> HMSAccountKitManager HMSAnalyticsManager -> HMSAnalyticsKitManager HMSGameManager -> HMSGameServiceManager

  • Ads kit consent added.

v2.1.2

2019/2020/2021 - 2018

Changes

Android Gradle plugin must be 3.5.4 or later. For that Unity's Gradle must be 5.4.1 or later. Unity 2020 and 2021 already have, but Unity 2019 and 2018 require Gradle configuration.

Kit Updates

  • push:5.3.0.301 -> push:6.1.0.300

  • remoteconfig:1.5.0.300 -> remoteconfig:1.6.3.300

  • cloud-database:1.4.5.300 -> cloud-database:1.5.0.300

  • auth:1.4.2.301 -> auth:1.6.3.300

  • nearby:5.3.0.300 -> nearby:6.2.0.300

  • appmessaging:1.4.2.301 -> appmessaging:1.6.3.300

  • iap:5.3.0.300 -> iap:6.3.0.300

  • crash:1.4.2.301 -> crash:1.6.3.300

  • hianalytics:5.3.1.300 -> hianalytics:6.3.2.300

  • ads-lite:13.4.39.302 -> ads-lite:13.4.51.300

  • ads-consent:3.4.39.302 -> ads-consent:3.4.51.300

  • hwid:5.3.0.302 -> hwid:6.3.0.301

  • com.huawei.agconnect:agcp:1.4.2.300 -> com.huawei.agconnect:agcp:1.6.3.300

  • com.huawei.gconnect:agconnect-core:1.4.1.300 -> com.huawei.agconnect:agconnect-core:1.5.0.300

Earlier Versions

Please refer to Releases.

PreviousRelease NotesNextUpgrade Guide

Last updated