Vendor Channel Parameter Application Guide
This document guides users through obtaining push parameters for vendor channels and completing vendor parameter configuration in the Jiguang console.
Obtain HarmonyOS Parameters
Register a Huawei Developer Account
Go to Huawei Developer Alliance and register a Huawei developer account. For details, see Register Account.
Create a Project
Developers should decide whether to create a new project based on actual business needs. If a new project is not required, proceed directly to the following steps.
Enable Push Service
Go to APP ID > HarmonyOS and open the HarmonyOS app you created.
Important: After creating the HarmonyOS app, make sure to configure its SHA256 certificate/public key fingerprint. Click Add Public Key Fingerprint (HarmonyOS API 9 and later) next to SHA256 Certificate/Public Key Fingerprint, and select the certificate file used for Configure Signing during SDK integration.
Obtain Service Key
Go to Credentials > Project-Level Credentials > Service Account Credentials.
After you click Confirm, the service credential JSON file is downloaded automatically. Store it securely and upload it to the Jiguang console.
Obtain the App-Level Client ID
Go to App Management, select the HarmonyOS app, then copy its Client ID from Basic Information.
Use the app-level Client ID, not the project-level Client ID. For the field location and definition, see Huawei's official guide, Viewing App Information.
Configure HarmonyOS on the Jiguang Platform
Go to Jiguang Console > Message Push > Push Settings > Integration Settings, select HarmonyOS, enter the package name, upload the service key JSON file, enter the app-level Client ID, and save the configuration.
The app-level Client ID is used for message recall through the HarmonyOS vendor channel. Omitting it does not affect regular pushes, but HarmonyOS vendor-channel recall will not take effect.
Enable the HarmonyOS Channel on the Jiguang Platform
Go to Jiguang Console -> Message Push -> Push Settings -> Integration Settings, select the HarmonyOS platform, and enable the HarmonyOS channel.
HarmonyOS Channel Receipt Configuration Guide
After completing HarmonyOS vendor channel SDK integration, developers need to enable and configure message receipts on the Huawei Open Platform before HarmonyOS delivery statistics and other data can be called back to the Jiguang platform. The specific steps are as follows:
Log in to the Huawei AppGallery Connect website.
Click My Projects, find your project in the project list, and navigate to the Configuration tab through Growth -> Push Service -> Configuration.
On this page, you can configure project-level receipts or app-level receipts. Note that a project-level receipt message receiving URL applies to all apps under the project. If you configure both project-level and app-level receipt URLs, the app-level receipt URL information is used first.
The following uses app-level receipts as an example. Select the app for which receipts need to be configured, and click Enable for the app receipt status.
Enter receipt parameter configuration and create a new receipt.
After clicking Create Receipt, configure the following parameters.
- Receipt name: enter a custom name.
- Callback URL:
https://xpnscb.jpush.cn/v3/hmpnsreport - Supported version: make sure to select Huawei V2.
- Click Test Receipt to functionally test the receipt URL, then click Submit to complete receipt creation.
