Mobile Platform as a Service:mPaaS Compatibility with HONOR Push

Background

HONOR announced that all new devices released in 2024 and later support only HONOR Push. Existing devices will complete the push service migration by Q1 2024 and will no longer support Huawei Push. To ensure that apps using the mPaaS push service can still reach HONOR devices through the manufacturer channel, complete the HONOR Push adaptation as soon as possible.

Client upgrade

• If you use the 10.2.3 baseline, upgrade to version 10.2.3.38 or later.

• If you use a different custom baseline, contact the mPaaS helpdesk for confirmation.

Integrate HONOR Push with mPaaS on Android

HONOR Push integration involves three steps:

1. Register HONOR Push

2. Integrate HONOR Push

3. Test HONOR Push

Register HONOR Push

Log in to the HONOR developer website, register an account, and enable the push service. Enable the push feature.

Integrate HONOR Push

1. Add the Push> HONOR component by following the steps in Add a push SDK.

   Note

   The Push> HONOR component contains only the adaptation code. You must add the HONOR Push SDK dependency separately.

   Add the baseline version (10.2.3.38 or later) and the HONOR Push SDK dependency:

   implementation platform("com.mpaas.android:mpaas-baseline:10.2.3-38")
   implementation 'com.mpaas.android:push-honor'

2. Prepare a development environment compatible with HONOR Push. Development preparation> Environment information.

3. Download the mcs-services.json file from the HONOR Developer Service Platform and add it to your project. Add an application configuration file.

4. Configure the SDK Maven repository address. Configure the URL of the Maven repository for the SDK.

5. Add the following dependency to the application-level build.gradle file. Add dependencies.

   dependencies {
       // Add the following configuration
       implementation 'com.hihonor.mcs:push:7.0.61.302'
   }

   • Check Version information for available updates.

   • The mPaaS-bundled version is 7.0.61.302. You can use a later version if needed. The manufacturer SDK is generally backward compatible.

6. To use obfuscation, add the relevant obfuscation configuration:

   • Add the obfuscation script for all integration methods.

   • If you use the AAR integration method, you must add a confusion rule.

Test HONOR Push

1. Start the app on an HONOR phone and verify that the initialization method is called. For more information, see Quick Start. The push SDK then obtains and reports the HONOR Push token.

2. After the app starts, manually exit it and send a test push message:

   • If you receive the message, HONOR Push integration is successful.

   • If you do not receive the message, troubleshoot as follows.

Troubleshoot client issues

1. Verify that the HONOR configuration parameters match the HONOR Push console settings, the required entries are added in AndroidManifest.xml, and com.hihonor.push.app_id matches the value in the HONOR Push console.

2. Verify that the mcs-services.json file exists and is in the correct location.

3. Verify that the HONOR channel is enabled in the mPaaS console. Configure the Honor channel.

4. View the logcat logs for troubleshooting:

   1. In the push process, filter by mPush.PushProxyFactory and check for the following log:

      D/mPush.PushProxyFactory: found proxy com.mpaas.push.external.honor.Creator

   2. In the main process, filter by mHonor and check whether the token is obtained. If get token failed appears, look up the error code in Error codes.

   3. In the main process, filter by report channel token and check whether the HONOR manufacturer token is reported successfully. If the following log appears:

      report channel token error: xxxx

      This means the manufacturer token failed to report. Verify that the base64Code in adding the configuration file to the project has a value and the APK signature matches the one uploaded when obtaining the configuration file.

      If the Push> HONOR component is not available, verify that the HONOR component has been added.

Server configuration

Configure HONOR Push Channel

1. In the left-side navigation pane, choose Message Push> Settings> Channel Configuration.

2. Click Configure in the upper-right corner of the HONOR Push Channel configuration section. The configuration entry is displayed.

3. Obtain the package name, application ID, and key from HONOR Developer Alliance > Management Center > My Products > mobile application Details.

4. Click OK to save the configuration.

Verify HONOR Push integration

Install the app with the updated mPaaS push SDK on an HONOR phone running Magic OS 8.0 or later. Start the app, then manually exit it. In the mPaaS console, use Minimal Message Push> Priority Manufacturer Channel Policy to send a push notification to the target device. If the HONOR device receives the notification, the integration is successful.