B4A Library HMS - Huawei SDK

Huawei is the number one manufacturer of phones (https://www.statista.com/statistics...by-smartphone-vendors-since-4th-quarter-2009/). Due to USA restrictions, the new phones that they sell do not include Google Play, Google Play Services and other Google components.
They have created their own ecosystem and as developers we shouldn't ignore this ecosystem. There might be opportunities here.

Currently this library supports analytics, push notifications, DRM check, ads and in app purchases.
I want to thank @Ferdari and other developers who already built wrappers for some of HMS features. Their work did help me while building this library.

The implementation is built in such way that it will not add the HMS SDK unless the build configuration includes the HMS conditional symbol (Ctrl + B):

1604048765052.png


Instructions:

  1. Register as a Huawei developer: https://developer.huawei.com/consumer/en/
  2. Download the attached zip and www.b4x.com/android/files/hms_sdk.zip. Unzip them and copy all files to the additional libraries folder.
  3. Open the AppGallery Connect page and create a new project.
  4. Find the Manage APIs page and make sure that Analytics Kit and Push Kit (if needed) are enabled.

    1604049036603.png


  5. Go to the General Information tab. Set the SHA-256 fingerprint. You can find it in the IDE under Tools - Private Sign Key:

    1604049160669.png
  6. Download agconnect-services.json and put it in the project folder (where the b4a file is located).
  7. Add the HMS symbol to the build configuration (Ctrl + B) and make sure that the package name matches the project package name defined in AppGallery Connect.
  8. Add to main module:

    B4X: 
    #Region HMS Libs+
#if HMS
#additionaljar: hms-push-5.0.2.300.aar
#additionaljar: hms-agconnect-core-1.4.1.300.aar
#additionaljar: hms-agconnect-credential-1.4.0.300.aar
#additionaljar: hms-agconnect-https-1.4.0.300.aar
#additionaljar: hms-availableupdate-5.0.3.301.aar
#additionaljar: hms-base-5.0.3.301.aar
#additionaljar: hms-datastore-core-1.4.0.300.aar
#additionaljar: hms-device-5.0.3.301.aar
#additionaljar: hms-hianalytics-5.0.4.300.aar
#additionaljar: hms-Log-5.0.3.301.aar
#additionaljar: hms-network-common-4.0.18.300.aar
#additionaljar: hms-network-grs-4.0.18.300.aar
#additionaljar: hms-opendevice-5.0.2.300.aar
#additionaljar: hms-security-encrypt-1.1.5.301.aar
#additionaljar: hms-security-ssl-1.1.5.301.aar
#additionaljar: hms-security-base-1.1.5.301.aar
#additionaljar: hms-stats-5.0.3.301.aar
#additionaljar: hms-tasks-1.4.1.300.aar
#additionaljar: hms-ui-5.0.3.301.aar
#additionaljar: hms-update-2.0.7.301.aar
#AdditionalJar: hms-hianalytics-core-5.0.4.300.jar
#AdditionalJar: hms-hianalytics-framework-5.0.4.300.jar
#AdditionalJar: hms-greendao-3.3.0.jar
#AdditionalJar: hms-greendao-api-3.3.0.jar
#AdditionalJar: hms-datastore-annotation-1.4.0.300.jar
#AdditionalJar: hms-drm-2.5.4.302.aar
#AdditionalJar: hms-apptouch-5.0.2.300.aar
#AdditionalJar: hms-ads-banner-13.4.30.301.aar
#AdditionalJar: hms-ads-base-13.4.30.301.aar
#AdditionalJar: hms-ads-interstitial-13.4.30.301.aar
#AdditionalJar: hms-ads-lang-13.4.30.301.aar
#AdditionalJar: hms-ads-lite-13.4.30.301.aar
#AdditionalJar: hms-ads-native-13.4.30.301.aar
#AdditionalJar: hms-ads-reward-13.4.30.301.aar
#AdditionalJar: hms-ads-splash-13.4.30.301.aar
#AdditionalJar: hms-ads-template-13.4.30.301.aar
#AdditionalJar: hms-iap-5.1.0.300.aar
#AdditionalJar: hms-scan-2.0.0.300.aar
#AdditionalJar: hms-dynamic-api-1.0.13.303.aar
#AdditionalJar: hms-ml-computer-agc-inner-2.0.5.304.aar
#AdditionalJar: hms-ml-computer-camera-inner-2.0.5.304.aar
#AdditionalJar: hms-ml-computer-commonutils-inner-2.0.5.304.aar
#AdditionalJar: hms-ml-computer-ha-inner-2.0.5.304.aar
#AdditionalJar: hms-ml-computer-sdkbase-inner-2.0.5.304.aar
#CustomBuildAction: folders ready, %WINDIR%\system32\cmd.exe, /c copy ..\agconnect-services.json bin\extra\assets\
#End If
#End Region
  9. Add to manifest editor:
    B4X: 
    #if HMS
CreateResourceFromFile(Macro, hms.hms)
CreateResourceFromFile(Macro, hms.hms_push)
CreateResourceFromFile(Macro, hms.hms_drm)
CreateResourceFromFile(Macro, hms.hms_ads)
SetApplicationAttribute(android:usesCleartextTraffic, "true")
#end if
  10. Add to B4XMainPage (or the Activity for non-B4XPages projects):
    B4X: 
    Sub Class_Globals
Private Root As B4XView
Private xui As XUI
Private hms As HMSManager
End Sub

Public Sub Initialize

End Sub

Private Sub B4XPage_Created (Root1 As B4XView)
hms.Initialize
hms.EnableLogs
Root = Root1
Root.LoadLayout("MainPage")
End Sub
  11. Make sure that Huawei AppGallery app is installed on the target device.
  12. Run the project in debug mode. It will show analytics related logs. Move the app to the background and to the foreground a few times. You should see a message similar to:
    B4X: 
    10-30 11:05:02.794 20298 21440 I HiAnalyticsSDK: SendTask=> events PostRequest sendevent TYPE : oper, TAG : _openness_config_tag, resultCode: 200 ,reqID:7d328467a831341dcfb442174a5c8208
  13. You should also see the traffic in:

    1604049454602.png

Tips & Notes

  • The analytics logs are only redirected in debug mode.
  • In debug mode you might see an "application not responding" message from time to time. It is related to these logs. It doesn't happen in release mode.

Push notifications: https://www.b4x.com/android/forum/threads/hms-huwaei-push-kit.124100/#content


Updates

Update both the attached HMS.zip and www.b4x.com/android/files/hms_sdk.zip
  • V1.07 - New HMS_NewToken event that is raised in the Starter service when a new push token is available:
    B4X: 
    Private Sub HMS_NewToken(Token As String)
Log("New_Token: " & Token)
End Sub
  • V1.05 - HMS.ScanBitmap - scans a bitmap for known barcode types.
  • V1.04 - Support for barcode scanning: https://www.b4x.com/android/forum/threads/hms-barcode-qr-scan.133334/
    Make sure to update the dependencies list, hms_sdk and hms.zip.
  • V1.03 - Support for in app purchases. The dependencies list was updated. See this tutorial:

    HMS - In App Purchases

    HMS v1.03 adds support for in app purchases. There are several steps that need to be done on HUAWEI developers console, including: enable merchant service, enable IAP API and add products. https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides/introduction-0000001050033062...
    www.b4x.com www.b4x.com
  • V1.02 - Support for banner and interstitial ads. The dependencies and manifest editor snippets were updated.

    HMS Ads

    HMS v1.02 adds support for banner and interstitial ads. https://www.b4x.com/android/forum/threads/hms-huawei-sdk.124034/ Make sure to update the dependencies list and the manifest editor items. The code is simple: 'Banner Dim banner As B4XView = hms.CreateBannerAd("testw6vs28auh3"...
    www.b4x.com www.b4x.com
  • V1.01 - Missing CheckDRM method added.
  • V1.00 - Support for DRM (verification of paid apps): https://www.b4x.com/android/forum/threads/hms-huawei-drm-verification.124725/
 

Attachments

  • hms.zip
    8.4 KB · Views: 113
Last edited:
Click to expand...
S

Scantech

Well-Known Member
Licensed User
Longtime User
Is this a requirement needed to upload apk?

Also im confused with number 10? What do i add in activity?
 
Last edited:
Erel

Erel

B4X founder
Staff member
Licensed User
Longtime User
Scantech said:
Is this a requirement needed to upload apk?
Click to expand...
No. You can upload APKs to Huawei app gallery without it.

Scantech said:
Also im confused with number 10? What do i add in activity?
Click to expand...
You need to add an initialize an HmsManager object. Better to do it in the starter service in non-B4XPages projects.
 
fbritop

fbritop

Active Member
Licensed User
Longtime User
Thanks, with all test going, I have put it, take it, put it take it son many times.
I´ve seen now there is a background service (HMSMessagingService). I have seen in within the b4xlib file, and also when we send a data payload only message from HW Console I see the service start. But how do we access that service?. I know it is there because to check it out I tried to create a service with the same name but (correctly) it complains that the service already exists
 
fbritop

fbritop

Active Member
Licensed User
Longtime User
Thanks, whats the point on this code under HMMSMessagingService.bas?


B4X: 
#if Java
import com.huawei.hms.push.*;
@Override
 public void onNewToken(String paramString) {
     BA.Log("onNewToken: " + paramString);
 }
 @Override
  public void onMessageReceived(RemoteMessage message) {
     BA.Log("onMessageReceived: " + message);
 }
 
#end if
 
C

CaptKronos

Active Member
Licensed User
Longtime User
I have followed the tutorial and am getting a "client api invalid" error.
B4X: 
--------- beginning of main
11-20 11:29:05.351 14266 14266 I HMSSDK_AutoInit: Push init start
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit: Push init failed
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit: com.huawei.hms.common.ApiException: 907135003: client api invalid
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.opendevice.a.a(ErrorEnum.java:272)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.opendevice.k.doExecute(GetTokenTask.java:58)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.opendevice.k.doExecute(GetTokenTask.java:34)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.common.internal.TaskApiCall.onResponse(TaskApiCall.java:190)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.common.internal.HuaweiApiManager$ConnectionManager.innerConnectionFailed(HuaweiApiManager.java:327)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.common.internal.HuaweiApiManager$ConnectionManager.onConnectionFailed(HuaweiApiManager.java:341)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.common.internal.BaseHmsClient.notifyFailed(BaseHmsClient.java:415)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.common.internal.BaseHmsClient.resolution(BaseHmsClient.java:389)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.common.internal.BaseHmsClient.checkAvailabilityAndConnect(BaseHmsClient.java:367)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.common.internal.BaseHmsClient.connect(BaseHmsClient.java:427)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.common.internal.HuaweiApiManager$ConnectionManager.connect(HuaweiApiManager.java:307)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.common.internal.HuaweiApiManager$ConnectionManager.sendRequest(HuaweiApiManager.java:227)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.common.internal.HuaweiApiManager.connectAndSendRequest(HuaweiApiManager.java:146)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at com.huawei.hms.common.internal.HuaweiApiManager.handleMessage(HuaweiApiManager.java:131)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at android.os.Handler.dispatchMessage(Handler.java:102)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at android.os.Looper.loop(Looper.java:214)
11-20 11:29:08.113 14266 14302 E HMSSDK_AutoInit:     at android.os.HandlerThread.run(HandlerThread.java:65)
11-20 11:29:09.654 14266 14266 I HiAnalyticsSDK:
11-20 11:29:09.654 14266 14266 I HiAnalyticsSDK: =======================================
11-20 11:29:09.654 14266 14266 I HiAnalyticsSDK:  HiAnalyticsSDK_5.0.4.300
11-20 11:29:09.654 14266 14266 I HiAnalyticsSDK: =======================================
** Activity (main) Pause, UserClosed = false **
** Service (starter) Destroy (ignored)**
 
Erel

Erel

B4X founder
Staff member
Licensed User
Longtime User
V1.02 - Support for banner and interstitial ads. The dependencies and manifest editor snippets were updated.

HMS Ads

HMS v1.02 adds support for banner and interstitial ads. https://www.b4x.com/android/forum/threads/hms-huawei-sdk.124034/ Make sure to update the dependencies list and the manifest editor items. The code is simple: 'Banner Dim banner As B4XView = hms.CreateBannerAd("testw6vs28auh3"...
www.b4x.com www.b4x.com
 
S

skaliwag

Member
Licensed User
Longtime User
Excellent library.
I agree - Huawei is too large a user base to ignore.
One quick question (for now) - why is ClearTextTraffic required?
 
Erel

Erel

B4X founder
Staff member
Licensed User
Longtime User
V1.03 - Support for in app purchases.

HMS - In App Purchases

HMS v1.03 adds support for in app purchases. There are several steps that need to be done on HUAWEI developers console, including: enable merchant service, enable IAP API and add products. https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides/introduction-0000001050033062...
www.b4x.com www.b4x.com

New dependency:
B4X: 
#AdditionalJar: hms-iap-5.1.0.300.aar
 
Ferdari

Ferdari

Active Member
Licensed User
Longtime User
Erel said:
Currently this library supports analytics, push notifications, DRM check, ads and in app purchases.
I want to thank @Ferdari and other developers who already built wrappers for some of HMS features. Their work did help me while building this library.
Click to expand...
I Thank you for simplifying the integration and the other Huawei services, certainly i will use your library as mine is incomplete.
 
You must log in or register to reply here.

Similar Threads

Erel
  • Article
B4A Library HMS - Barcode / QR Scan
Replies
0
Views
3K
Erel
Erel
Erel
  • Article
B4A Library HMS - In App Purchases
Replies
0
Views
2K
Erel
Erel
Erel
  • Article
B4A Library HMS Ads
Replies
10
Views
3K
Erel
Erel
Erel
  • Article
B4A Library HMS (Huawei) - DRM verification
Replies
2
Views
2K
Erel
Erel
Erel
  • Article
B4A Library HMS / Huwaei Push Kit
Replies
0
Views
2K
Erel
Erel
Top