Before you get started, you must register as a Huawei developer and complete identity verification on HUAWEI Developers. For details, please refer to Registration and Verification.

Creating an App

Create an app by following instructions in Creating a Project and Creating an App.

Generating a Signing Certificate Fingerprint

The signing certificate fingerprint is used to verify the authenticity of an app. Before releasing an app, you must generate a signing certificate fingerprint locally based on the signing certificate and configure it in AppGallery Connect.

Before you do this, make sure that the following conditions are met:

You have created the app's signing certificate. For details, please refer to Generating a Signing Certificate.
The JDK has been installed on your PC.

To generate a signing certificate fingerprint, perform the following steps:

Windows
1. Open the command-line interface (CLI) using the cmd command, and run the cd command to go to the directory where keytool.exe is located. In the following example, the JDK is installed in the Program Files folder in drive C.
  Collapse
  Word wrap
  Dark theme
  Copy code
```
cd C:\Program Files\Java\jdk\bin
```
2. Run keytool -list -v -keystore <keystore-file> and respond as prompted. In the command, <keystore-file> indicates the absolute path to the app's signing certificate.
  Example:
  Collapse
  Word wrap
  Dark theme
  Copy code
```
keytool -list -v -keystore C:\TestApp.jks
```
3. Obtain the SHA-256 certificate fingerprint.
macOS
1. Open Terminal.
2. Run keytool -list -v -keystore <keystore-file> and respond as prompted. In the command, <keystore-file> indicates the absolute path to the app's signing certificate.
  Example:
  Collapse
  Word wrap
  Dark theme
  Copy code
```
keytool -list -v -keystore /Users/admin/Downloads/HmsDemo.jks
```
3. Obtain the SHA-256 certificate fingerprint.

Configuring the Signing Certificate Fingerprint

Sign in to AppGallery Connect and click My projects.
Find your app project, and click the desired app name.
Go to Project settings > General information. In the App information area, click Add under SHA-256 certificate fingerprint, and enter the obtained SHA-256 certificate fingerprint.

NOTE
In the App information area, you can click next to Client secret to copy the client secret.
Click Save.

Setting a Data Processing Location

Before using Push Kit, you need to set a default data processing location. The available locations now are China, Germany, Russia, and Singapore. If the data processing location is different from your server location, or is different from the location of a user that the app serves, messaging latency will increase.

Push Kit will store and process your app's data at the default data processing location you set. The set default data processing location applies to all apps in the project. If you want to modify the default data processing location, you need to disable Push Kit before modifying the default data processing location. After modification, data at the original data processing location will be automatically cleared in 6 months and cannot be restored. Exercise caution when you modify the default data processing location.

NOTE

To reduce the latency caused by messaging across areas around the world, you are advised to set the data processing location based on the location of your users. For example, if you are a developer in Latin America and most of your app users are in Latin America, you are advised to set your data processing location to Singapore. If you are a developer in China but most of your app users are in Europe, you are advised to set your data processing location to Germany. For details, please refer to Setting Rules.

Enabling Push Kit

Sign in to AppGallery Connect and click My projects.
Find and click the desired project in the project list, and click the app for which you need to set Push Kit parameters.
Go to Grow > Push Kit and click Enable now. In the dialog box that is displayed, click OK.
Enable the precise messaging function. Now you can push messages to your app.
NOTE
With the precise messaging function, you can push messages by subscriber or audience, through A/B testing tasks, to iOS apps, or using other capabilities. To use this function, you need to specify a data processing location, so that your app and user data can be processed at the expected location. To ensure compliance with local laws and regulations, AppGallery Connect will distribute your app only in countries and regions served by the specified data processing location.
(Optional) Enable or disable the message receipt function at the project and app levels on the Settings page.
NOTE
- If the service rights are enabled at the project level but not at the app level, the service rights at the project level will be used.
- If the service rights are enabled both at the project and app levels, the service rights at the app level will be used.

Viewing Basic App Information

Sign in to AppGallery Connect, click My projects, find and click the desired project in the project list, and click the app whose information you want to view from the top navigation bar.
In the App information area displayed, view the app information, such as the package name, app ID, SHA-256 certificate fingerprint, client ID, and client secret.

Getting Started

Integrating the HMS Core SDK

Send feedback

Was this page helpful?

Send feedback

Reach out to us through the community for any other questions.

Community Q&A Intelligent Assistant