All Products
Search

This Product

    SuperApp:Build, package, and publish a miniapp

    Document Center

    SuperApp:Build, package, and publish a miniapp

    Last Updated:Sep 25, 2025

    After debugging is complete, you can package the UniApp project as a UniApp miniapp and synchronize it to the SuperApp Business Application Platform. Alternatively, you can directly upload a locally built UniApp miniapp package (WGT), or package the project as a native app with the miniapp container integrated. This guide explains how to build, package, and publish a UniApp miniapp using the HBuilderX extension.

    Procedure

    1. After installing the HBuilderX plugin, create a UniApp project in HBuilderX. You can click the menu bar File > New > Project, select the desired project template, enter a project name, and click Create.

      imageimage

    2. After the project is created, open the manifest.json file and enter the version number for this release in the App Version Name field.

    3. From the menu bar, select Build > Mini Program-Alibaba Cloud Superapp(For uni-app Only). A release configuration window will then appear.

    4. In the pop-up dialog, enter the basic information.

    image

    image

    The following table describes the parameters.

    Parameter

    Description

    AppId

    This parameter is required. You can obtain the app ID from Application Open Platform. For more information about how to obtain the ID, see View the app ID in Create an app.

    PrivateKey File Path

    This parameter is required. Upload the key file that is downloaded from Application Open Platform. For more information about how to download the key file, see Download an HBuilder key file in Global settings.

    WGT File Path

    This optional parameter specifies the path to the WGT file that is generated after the UniApp miniapp is built.

    • If the UniApp miniapp to be published is built, select the WGT build package.

    • If the UniApp miniapp to be published is not built and the WGT file path is empty, the extension calls the HBuilderX CLI tool to build the miniapp and package the miniapp into a WGT file.

    1. Click Submit. The extension starts to publish the miniapp. After the miniapp is published, the miniapp artifact is synchronized to Application Open Platform.

    Note

    For more information about how to package a UniApp miniapp into a native app and integrate a miniapp container into the native app, see FAQ.