Huawei's official guidance: Understand how the HarmonyOS application of HarmonyOS is on the shelves

According to the release of Huawei Hongmeng, everyone has always been concerned about how to put HarmonyOS applications on the shelves. Now, Huawei officials have sorted out the process and precautions of HarmonyOS applications from creation, debugging to the listing. Hope this helps you on your journey to the shelves!

1. Create/Add Application

After the HarmonyOS application is developed, whether it is to debug or put the application on the shelf, you first need to create/add the HarmonyOS application under the project in AppGallery Connect (hereinafter referred to as AGC). The current method of creating applications is controlled according to the developer account status and invited list. The details are shown in the following table:

We can find from the table that if you want to directly create an app and put an app on the shelf, you must satisfy "real name + already on the invited list". If you just add an app and debug an app under the project, the account status and the invited list must be the same as No No requirement. Therefore, the small partners who want to list the application first confirm whether they meet the prerequisites (how to real-name and join the invited list will be introduced in the chapter on the application of the shelf).

Create an app directly

Log in to the AGC web page with the developer account that has been real-named and is on the invite list, and is on the page "My Application".

AGC webpage

After clicking "My Apps", the "HarmonyOS Apps" tab will appear. Select "HarmonyOS Application" to create a HarmonyOS application. For details, see Creating an Application Directly.

Create an app directly Doc guide

Add an application under the project

Before adding applications under the project, if the project has not been created in the AGC, you need to create the project first, so that different platform versions of an application can be added to the same project (for example, an application has an Android version and a HarmonyOS version, then You can both add them to the same AGC project), see Creating Projects for details.

Create project

After you have the AGC project, you can log in to the AGC page, enter "My Projects", and then add and create HarmonyOS applications. For details, see Adding Applications under Projects.

Add the application under the project

Be careful:

  • The package name filled in by AGC to create an application must be unique in the entire network, and the HarmonyOS application package name cannot be the same as the Android application package name. If the package name is prompted to be occupied, the package name needs to be changed.
  • Directly creating HarmonyOS applications does not need to fill in the package name, it is automatically parsed by the uploaded software package. Adding a HarmonyOS application under the project must fill in the package name
  • You can add existing applications under the project. Do not modify the application name after selecting the application, otherwise, it will be regarded as a new application.

Debug the application

After the HarmonyOS application development is completed, and the application has been created and added to the project in AGC, debugging can be started. If you only debug in the simulator, you can not configure the signature information; but if you need to debug in the real machine, you must configure the signature information. Huawei provides two application debugging (signature) methods: automatic signature method and manual signature method. A manual signature is required for listing.

Auto Sign

Complete automatic signing and debugging directly in the development tool HUAWEI DevEco Studio (hereinafter referred to as IDE). For details, see Debugging with the Simulator.

Debug with the emulator

Be careful:

  • If the IDE does not have an automatic signing option, it is recommended to upgrade the IDE to the latest version. The auto-signature feature is only supported in DevEco Studio V2.1 Release and later.
  • The debugging method of automatic signature will automatically create a digital certificate and a profile file for debugging in the AGC, but the current AGC debugging certificate only supports at most 2, that is, it only supports automatic debugging for two applications at the same time. In the upper limit, you need to "abolish" redundant debugging certificate files on the "Users and Access > Certificate Management" page. 3) A maximum of 100 debugging devices are supported.
  • The value of "bundleName" in the config.json file of the HarmonyOS application must be consistent with the package name of the AGC application. If the package name conflicts, you can modify the bundleName to avoid it.
  • If an error is reported and the connection to the AGC website fails, please check whether you are using a proxy, etc. You can disconnect the proxy and try again.

Manual signature

The relevant process is shown in Figure 4. First, generate the secret key and certificate request file in the IDE, then take the two files generated in the IDE and go to AGC to apply for the application debugging certificate and debugging profile file, and finally go back to the IDE to configure the signature, compile and build the APP, and then you can debug. For detailed procedures, please refer to Manually Debugging HarmonyOS Applications.

Manually debug HarmonyOS applications

Be careful:

  • Local debugging must use the debugging certificate and the debugging Profile file, and the debugging certificate and the Profile file must match. Using a release certificate and release profile file for debug scenarios will cause the app to fail to install.
  • The current AGC debugging certificate only supports up to 2. If the upper limit is reached, you need to "revocation" the redundant debugging certificate files on the "Users and Access > Certificate Management" page.
  • The application applying for debugging the Profile file must match the local debugging application.

On-shelf applications

After local debugging, you can package the HarmonyOS application and submit it to the AGC. As shown in Figure 5, similar to debugging, the developer needs to generate the secret key and certificate request file in the IDE first, and then take the two files generated in the IDE to go to AGC to apply for the application release certificate and release profile file (note that the Release certificate, no longer debugs certificate), and then go back to the IDE to configure the signature and compile and build the APP. After the above work is completed, the application will be launched.

For details, please click the corresponding link to view:

Step 1: Real name of developer account

Step 2: Send an email to apply to join the invited list

Steps 3 and 4: generate the key and certificate request files

Step 5: Create a project at AGC

Step 6: Add the HarmonyOS application under the project

Step 7: Apply for an application publishing certificate

Step 8: Apply for the release of the Profile file

Be careful:

  • Currently, AGC can apply for a maximum of 1 release certificate; a maximum of 100 profiles can be applied for.
  • The release application must use the release certificate and release profile file, and the release certificate and profile file must match. The package cannot be uploaded if the debug certificate and debug profile are used for release scenarios.
  • The application applying for publishing the Profile file must match the publishing application.

Step 9: Configure the signature information

Step 10: Compile and build the APP

Be careful:

  • The final compiled HarmonyOS application package should be in .app format and cannot exceed 2GB. Otherwise, the package will fail to upload.
  • In addition to the .app package, AGC also parses and detects the size of the .hap package in the .app package: the size of the hap package of sports watch/router type cannot exceed 20MB, and the size of hap package of mobile phone/smartwatch/large screen type cannot exceed 20MB 2GB.
  • The installation-free .hap package cannot exceed 10MB.
  • The release certificate used to compile the .app package must use the certificate downloaded by AGC, otherwise, it will cause the upload of the package to fail.

Step 11: List the HarmonyOS app

Be careful:

  • The uploaded app icons, screenshots, videos, etc. must meet the requirements of the app market, otherwise, the upload will fail.
  • If you need to test the application in a small range in advance, you can choose to release the open test version.
  • Uploading materials or software packages require a pure public network environment and requires disconnecting when using a proxy.


The above is the process and points to be sorted out for you. If you have more questions, please click the link and leave a message in the forum. Huawei will continue to improve and optimize according to your feedback!

Post a Comment