Overview

HarmonyOS NEXT Development Suite

Enable your Mendix applications to support HarmonyOS NEXT systems through this comprehensive development suite. This package contains two core modules that work together to provide complete native mobile capabilities and seamless application deployment.

Module 1: HarmonyOS NEXT Wrapper (Mobile Capabilities)

This module is based on a native wrapper for PWA. It provided JavaScript actions to access mobile device functionalities. This module enables seamless integration with device hardware features including ambient light sensors, clipboard operations, file system access, printing capabilities, proximity sensors, QR code scanning, content sharing, media capture (photo/video), and vibration control. Enhance your mobile applications with native device capabilities for a superior user experience.

Module2: HarmonyOS NEXT  App Builder

Build and deploy your Mendix apps natively on HarmonyOS NEXT with just a few clicks!  This Mendix extension enables developers to compile and package Mendix applications specifically for HarmonyOS NEXT. Seamlessly extend your app's reach to Huawei devices running Harmony OS Next.

What This Extension Does?

The HarmonyOS NEXT App Builder is an extension that provides a streamlined workflow to:

• Package your Mendix applications for HarmonyOS NEXT compatibility
• Manage permissions and app configurations
• Handle signing certificates and profiles
• Deploy directly to connected Harmony devices

Platform Support

• HarmonyOS NEXT
• Mendix Studio Pro 10.24.0 or Higher
• AppGallery developer account
• HarmonyOS NEXT device for testing (optional but recommended)

Documentation

HarmonyOS NEXT Development Suite

This development suite contains two collaborative modules:

📱 HarmonyOS NEXT Wrapper

Provides native device functionality access

• Hardware integration: sensors, Bluetooth, NFC, Deeplink
• File management, media capture, QR code scanning
• User interaction features: clipboard, vibration, sharing
• HMS Push integration and local notification management

🔧 HarmonyOS NEXT App Builder

Provides app compilation and deployment capabilities

• One-click compilation of Mendix apps to HarmonyOS NEXT native format
• Certificate and permission management interface
• Direct device deployment and app publishing

Installation Requirements

• Dependencies: Mendix Studio Pro 10.24.0 or higher
• Platform Support: HarmonyOS NEXT
• Developer Account: Huawei AppGallery Connect access required

After installing the suite, you will see two modules in your project. Please refer to their respective documentation below.

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

HarmonyOS NEXT Wrapper

📦 This module is part of the HarmonyOS NEXT Development Suite

Typical usage scenario

The module is designed for Mendix developers building mobile applications that require access to native device functionalities. This module is particularly useful for:

• Applications requiring interaction with mobile hardware sensors (ambient light, proximity)
• Apps needing file management capabilities (selection, sharing, uploading)
• Mobile solutions that enhance user experience through native features (clipboard, vibration, sharing)
• Enterprise applications requiring document handling (printing, sharing documents)
• Applications with media capture requirements (photos, videos)
• Apps requiring push notifications and local notifications for user engagement
• Applications needing HMS push integration for Harmony devices
• Mobile apps requiring app badge management and notification permissions handling

This module bridges the gap between web-based Mendix applications and native device capabilities, enabling a more integrated and seamless user experience.

Features and limitations

Features:

• Sensor Access: Subscribe to ambient light and proximity sensors
• Clipboard Management: Copy, paste, and clear clipboard content
• File Handling: Select files from device storage
• Printing Capabilities: Print files and web pages
• Sharing Functions: Share documents and text content
• Media Capture: Take photos and record videos
• QR Code: Scan QR codes
• Haptic Feedback: Control device vibration patterns
• Push Notifications: HMS Push integration for reliable message delivery on Harmony devices
• Local Notifications: Send local notifications to users with customizable content
• Badge Management: Set and manage app icon badge numbers

Limitations:

• Features availability depends on the hardware capabilities of the device
• Background execution of certain sensors may impact battery performance

Installation

1. Import the "HarmonyOS NEXT Wrapper" module from the Mendix Marketplace
2. Add the module as a dependency in your Mendix project
3. Ensure the required permissions are configured in your native app's settings
4. Synchronize your project and rebuild your  app

Configuration

• Implementing JavaScript Actions:
  • Drag the desired JavaScript action from the module into your nanoflow
  • Configure the required parameters for each action
  • Connect the action's response to appropriate handling logic
• Sensor Usage:
  • When using sensor subscriptions (Ambient Light, Proximity), always implement the corresponding unsubscribe actions when the feature is no longer needed to prevent battery drain

Known bugs

• For applications that need to use the paste functionality of clipboard, additional ACL permissions must be requested in advance. It is recommended to use the paste controls natively provided by the Harmony system whenever possible.受限开放权限-应用权限列表-应用权限管控-程序访问控制-安全-系统 - 华为HarmonyOS开发者

--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

HarmonyOS NEXT App Builder

📦 This module is part of the HarmonyOS NEXT Development Suite

Typical Usage Scenario

The HarmonyOS NEXT App Builder extension enables Mendix developers to compile and deploy their applications directly to HarmonyOS NEXT-powered devices. This extension is particularly valuable for:

• Organizations looking to expand their application reach to HarmonyOS NEXT device users
• Teams wanting to leverage Mendix's low-code capabilities while accessing the growing HarmonyOS NEXT ecosystem
• Projects requiring native HarmonyOS NEXT capabilities not available through web applications

Features and Limitations

Features

• One-click compilation of Mendix applications to HarmonyOS NEXT native format
• Comprehensive permission management through user-friendly interface
• Built-in certificate and signing management tools
• Direct deployment to connected HarmonyOS NEXT devices
• Support for both development and production environments
• User-friendly GUI for configuration management

Limitations

• Requires separate AppGallery developer account and approval process
• Updates to the HarmonyOS NEXT platform may occasionally require extension update

Installation

1. Open Mendix Studio Pro
2. Navigate to Marketplace (accessible from the top menu)
3. Search for "HarmonyOS NEXT App Builder"
4. Click "Download" and follow the installation prompts

Configuration

Initial Setup

1. Register for a Huawei developer account at developer.huawei.com if you don't have one
2. Log in to  AppGallery Connect  and create a new application
3. Note your App ID and package name for later use

App Configuration

1. Add the extension startup parameters in the properties of Studio Pro  （“...studiopro.exe" --enable-extension-development）
2. Open your Mendix project in Studio Pro
3. Access the HarmonyOS NEXT Builder from extentions menu
4. Fill in the App Info section with details matching your AppGallery application:
   • App Name
   • Package Name (must match the one registered in AppGallery)
   • Version Code
   • PWA APP URL
5. Select required permissions for your application (camera, location, storage, etc.)

Signing Configuration

1. Create a signature in the Signing step (e.g., "debug" for development or "release" for production)
2. Go to AppGallery Connect and create a certificate
3. Create a Profile in AppGallery Connect
4. Download both certificate and Profile files
5. Place these files in your project's configuration directory
6. Rename them to match your signature name (e.g., "debug")
7. Refresh signature

Building and Deployment

1. Click "Generate Package" to create the installation file
2. Connect your HarmonyOS NEXT device to your computer via USB (ensure developer mode is enabled on the device)
3. Select your connected device from the list
4. Click "Install" to deploy directly to the device

Publish Application

Publish Application (App Bundle)