Install and configure the HBuilderX Plugin - SuperApp - Alibaba Cloud Documentation Center

The HBuilderX plugin supports offline installation only. After installation and configuration, when you publish a UniApp miniapp in HBuilderX, the system automatically synchronizes the build artifacts to the Application Open Platform.

Prerequisites

Download and install HBuilderX before proceeding. For installation instructions, see Install.

Install the Plugin

Download the HBuilderX installation package.
Copy the superapp-uniapp-tool.zip installation package to the installation directory of HBuilderX.
- Installation path in Windows: ...\<Root directory of the HBuilderX installation directory>\plugins.
- Installation path in macOS: /Applications/HBuilderX.app/Contents/HBuilderX/plugins.
Decompress the package. Manually decompress superapp-uniapp-tool.zip to the plugins directory. After the package is decompressed, a file named superapp-uniapp-tool is added to the directory.
Important
On macOS, do not use the unzip superapp-uniapp-tool.zip command to extract the package. This will extract all files directly into the plugins directory, flattening the structure and preventing the plugin from loading.
Restart HBuilderX to load the plugin.

Configure the extension

Open the extension configuration page.
- Windows
  Choose Tool > Plug-in Installation. The Plug-in Installation panel appears.
- macOS
  Choose HBuilder X > Preferences. The Preferences panel appears.

Configure the extension. In the Settings.json file, click Plugins and configure the parameters.

The following table describes the parameters.

Parameter	Description
Host Address	Configure the host address for the Application Open Platform. The default is the production environment. Host: `industrysolutions.alibabacloud.com`
The path of the command line tool	Windows: Set this parameter to `<Root directory of the HBuilderX installation directory>\cli.exe`. macOS: Use the default value `/Applications/HBuilderX.app/Contents/macOS/cli`.