We use essential cookies for the website to function, as well as analytics cookies for analyzing and creating statistics of the website performance. To agree to the use of analytics cookies, click "Accept All". You can manage your preferences at any time by clicking "Cookie Settings" on the footer. More Information.

Only Essential Cookies
Accept All
Application DistributionAppGallery Connect (HarmonyOS 5 or Later)Managing ProfilesRequesting a Debug Profile

Requesting a Debug Profile

NOTICE

The entrance for requesting ACL permissions has been moved to the ACL permissions tab page on the Project settings page. When creating a profile, you can only add the ACL permissions that have been obtained. To use an ACL permission, request it and then create a profile.

In the debugging phase, you need to configure a debug profile to perform manual signing. You can request a debug profile and download it by referring to this document. For details about how to perform manual signing, please refer to Signing Your App/Atomic Service Manually.

NOTE

You can request up to 100 profiles for an app.

Procedure

  1. Sign in to AppGallery Connect and choose Certificates, app IDs, and profiles.
  2. In the navigation tree on the left, choose Profiles. On the page displayed, click Add in the upper right corner.

  3. On the Add profile page, configure mandatory information including the app name and profile name.

    Expand

    Parameter

    Description

    App name

    Select the app for which you want to request a debug profile.

    Package

    The value is automatically displayed after an app name is selected.

    Profile name

    Enter no more than 100 characters.

    Type

    Select Debug.

    Certificate

    Click Select and select a debug certificate.

    NOTICE

    You cannot select a release certificate for a debug profile.

    Device

    Click Select and select one or more debugging devices. You can select up to 100 devices. Deleted devices cannot be selected.

  4. (Optional) If you have requested and obtained ACL permissions for your app or atomic service, add these permissions to the profile so that you can use them. If ACL permissions are not involved, skip this step.

    After you select an app name, the Permissions to request field will be displayed in the lower part of the Add profile page. If you select Restricted ACL permissions (HarmonyOS API 9 or later), all ACL permissions obtained by your app or atomic service will be added to the profile.

    Click View to view the ACL permissions that have been obtained by the app or atomic service in the displayed dialog box.
    NOTE

    If your app or atomic service has not obtained any ACL permissions or you want to add more ACL permissions, click the request here link to go to the ACL permissions tab page to request the permissions. For details, please refer to Requesting ACL Permissions. After obtaining the ACL permissions, add them to the profile by referring to this chapter.

  5. Click Add in the upper right corner. The debug profile is successfully requested.

    If the fingerprint of the debug certificate associated with the profile has not been configured for the app or atomic service, you will be prompted to do so. For details, please refer to Configuring a Public Key Fingerprint. This step is required only when the app or atomic service has integrated Huawei open capabilities that depend on the public key fingerprint.

  6. Click Download to save the generated profile to the local device for subsequent signing.
    NOTE
    • A profile becomes effective once it is successfully requested. If the profile becomes invalid or revoked, it will no longer be available. In this case, you need to request a new profile.
    • If you have modified the ACL permissions after creating a profile, create a new profile.

  7. (Optional) Change the debugging devices bound to a debug profile in Effective state. To do so, click Edit device and select the desired debugging devices.
    NOTE
    • After the debugging devices are changed, a new debug profile will be generated. Download the new profile after its status changes to Effective.
    • If you want to add a new debugging device, follow the instructions in Registering a Device to add the device to the device list in AppGallery Connect. Then click Edit device, select the new device, and download the debug profile again.