HarmonyOS Next 5.1.0 Release Update Notes and Adaptation Guide

HarmonyOS Next 5.1.0 Release Update Notes and Adaptation Guide

On June 11, 2025, the HarmonyOS Next 5.1.0 documentation was officially released alongside the launch of the Huawei Pura80, with the 5.1.0 system scheduled for official release in July. Below is an overview of the updated capabilities and adaptation guidance for 5.1.0.

I. Version Overview

The HarmonyOS 5.0.5 (17) Release has been officially launched! Building on the previous Beta1 version, this update focuses on optimizing system performance and stability to further enhance development and usage experiences. Although no new platform capabilities were added, underlying optimizations provide developers with a smoother and more reliable development environment.

HarmonyOS 5.1.0 (18) further enhances ArkUI component capabilities and provides more detailed component calling functionalities based on HarmonyOS 5.0.5 (17). It also improves the flexibility of acquiring and using critical information such as application processes and data while ensuring security.

Notably, HarmonyOS 5.1.0 (18) supports smart wearable device development for the first time. ArkUI has added a series of component capabilities tailored for the circular dials of wearable devices.

Core Highlights

• First-time support for smart wearable device development

II. Supporting Relationship Description

To ensure smooth development, developers must verify the following supporting relationships to avoid compatibility issues caused by version inconsistencies.

1. Complete Supporting Information

Software Package	Release Type	Version Number	Build Version	Release Date
System	Release	HarmonyOS 5.1.0 Release	Software Version (for reference): 5.1.0.118 (Pura 80 series) Software Version (for reference): 5.1.0.110 (Watch 5 series) API Version (for developers): 5.1.0 (18)	2025/06/11
DevEco Studio	Release	DevEco Studio 5.1.0 Release	5.1.0.828	2025/06/11
SDK	Release	HarmonyOS 5.1.0 Release SDK	Based on OpenHarmony SDK Ohos_sdk_public 5.1.0.110 (API 18 Release)	2025/06/11

2. Application Project Version Configuration Recommendations

For applications developed using this version, the recommended configuration items related to versions in the build-profile.json5 file are as follows:

build-profile.json5 Configuration Item	Existing Applications	New Applications
Configuration Recommendations	Configuration Example
compileSdkVersion	No explicit configuration is required; the supporting SDK version is used by default during compilation, i.e., “compileSdkVersion”: “5.1.0(18)”	Recommended to use 5.0.5(17) Release for new applications.
compatibleSdkVersion	It is recommended to keep the same as the compatibleSdkVersion before project upgrading.	Keep consistent with the version before upgrading, e.g., “compatibleSdkVersion”: “5.0.0(12)”
targetSdkVersion	It is recommended to adapt to the latest changes in the new version and then configure it as: “targetSdkVersion”: “5.1.0(18)”. If you expect to delay adapting to changes, you can configure targetSdkVersion to be the same as that before project upgrading.	1. After adapting to changes, configure it as: “targetSdkVersion”: “5.1.0(18)” 2. If the application does not adapt to changes temporarily, configure it to the value before project upgrading, e.g., “targetSdkVersion”: “5.0.0(12)”

III. Introduction to OS Platform Updates

Change Description

The HarmonyOS 5.1.0 Release focuses on providing the following open capabilities.

New Technological Trends! A Wave of Capability Updates

In the advancing digital era, various technology Kits continue to iterate and upgrade, unlocking numerous new skills for developers and bringing cooler and more convenient experiences to millions of users. Let's dive into the notable updates:

Ability Kit: Full-capability Upgrade for Enhanced Experience

The Ability Kit, like an all-around player, has gained numerous new skills in this update:

• It can create application contexts based on specified data encryption levels, with different encryption levels corresponding to different paths for more refined data management.
• New ability to synchronously obtain the current process name, facilitating precise process information positioning for easier debugging and optimization.
• New function to get the reason for application launch, distinguishing between message triggers and other factors to clarify application startup logic.
• The launch framework now supports HAR/HSP and so files, expanding resource compatibility for application launch.
• When launching an Ability, you can specify the maximum and minimum width and height for the main window, enabling flexible interface layout adaptation to more scenarios.
• Additional functions such as obtaining the detailed reason for the application's last exit and setting the color mode of UIAbility further enhance application controllability and user experience.

Account Kit: New Approaches to Account Authorization

The Account Kit introduces new features for Huawei account authorization:

• Supports Wearable devices to obtain user avatar, nickname, phone number, risk level, and other information, strengthening account functions and expanding application scenarios for wearable devices.
• Can also obtain user risk levels in login scenarios, adding an extra layer of security for secure logins.

AppGallery Kit: New Vitality for the App Market

The AppGallery Kit revitalizes the app market by updating functions and icon management services, including Wearable devices to enrich app market玩法 on wearable devices and provide users with more personalized and convenient app acquisition and management experiences.

AR Engine: Unlocking a New AR World

The AR Engine adds ArkTS APIs for motion tracking, environmental tracking, hit detection, and more:

• Capable of managing AR sessions, obtaining device poses, detecting planes in the environment, recognizing plane semantics, and acquiring depth estimation information to enable more realistic AR object placement.
• C APIs also excel in image tracking, depth map acquisition, grid scanning information, etc., supporting powerful functions like measurement and volume estimation to open new possibilities for AR applications.

ArkData: Smarter Data Management

ArkData introduces a smart data platform with data retrieval and fine-grained sorting capabilities:

• RelationalStore adds rootDir configuration to support opening databases in non-database directories, enhancing flexibility.
• ArkData RDB vector data management provides approximate query solutions, and relational databases can obtain column data types by specified column indices or names, upgrading data management comprehensively.

ArkTS: A Tool for Improving Programming Efficiency

TaskPool shines in ArkTS with support for specifying task execution concurrency and queuing strategies, as well as canceling tasks in the task pool by task ID for more precise task management:

• ArkTS container collections add many practical methods in API 18, such as from, isArray for Array, and toString, toLocaleString for TypedArray, making operations more convenient.
• Sendable can replace data with the least recently used when cache space is insufficient, and Worker can specify priorities when creating tasks, overall boosting programming efficiency.

ArkUI: A Major Refresh of Interface Interaction

ArkUI deeply optimizes text and input components:

• Text components can set text thickness to remain unchanged with system fonts, share selected text, and wrap lines by syllable hyphens.
• Rich text components can set maximum line counts, and TextInput components can set text ellipsis positions, polishing text interaction details for a more user-friendly experience.

Adapting to circular screens is a highlight, with new rotating crown events and a host of new components like arc list components and arc index bar components, perfectly suitable for circular screen scenarios such as wearable devices, offering novel and interesting interactions.

General drag-and-drop, pop-up, form selection, scrolling, and sliding components have also been significantly enhanced:

• Pop-ups can set display order and custom background blur.
• Form selection components add SegmentedButtonV2, etc., enriching and smoothing interface interactions.

New C APIs, such as gesture interruption event callback functions with configurable user-defined data and functions to obtain the width, height, and coordinate information of event-hit components, as well as setting custom focus traversal logic and dynamically acquiring gesture configuration parameters, provide developers with more underlying operation possibilities.

New features like cross-instance node migration, node lifecycle callback interfaces, component screenshotting, menu pop-up vibration effects, soft keyboard pop-up animation monitoring for window management, and sub-window hierarchy settings make UI operations and management more flexible and diverse.

Other Kits: Colorful Updates

• Audio Kit: New Float32 format audio output and spatial audio management capabilities, enhancing both sound quality and immersive experience.
• AVCodec Kit: Video decoding supports MPEG2 and MPEG4, expanding video format compatibility.
• Basic Service Kit: Upload and download now support application cache download, speed limiting, and setting content-type fields; the clipboard can also obtain content change counts, packing practical functions.
• CANN Kit: After renaming, new testing options are added for more professional collection of Profiling performance data.
• Car Kit: Navigation information services help map applications achieve more accurate POI search results.
• Cloud Foundation Kit: Brings cloud services to Wearable devices, expanding the application ecosystem.
• Game Service Kit: In-game near-field fast transmission and the addGameCustomData interface add vitality to game interactions.
• Graphics Accelerate Kit: New resource package pre-downloading to improve loading efficiency.
• Health Service Kit: New emotional and heart rate variability sampling data types and manual data synchronization capabilities for more comprehensive health monitoring.
• IAP Kit: Consumable and non-consumable product purchases now support Wearable devices, expanding shopping scenarios.
• Image Kit: New C API to obtain image editable flags for convenient image processing.
• Localization Kit: New capabilities to obtain user-preferred temperature units, support fine-grained formatting and path localization display, catering to localization needs.
• MDM Kit: Can disable/enable more feature restrictions, support installing certificates by system accounts, and subscribe to account events for more powerful management.
• Media Kit: Player passes through SEI field data, supports new playback strategies and dynamic video super-resolution algorithms, upgrading audio-visual experiences.
• PDF Kit: New functions to obtain transparent background PDF page images and page link jump information for more convenient document processing.
• Pen Kit: Supports setting toolbar brushes and displaying RGB color values for取色, enabling more intuitive creation.
• Performance Analysis Kit: Supports dumping virtual machine raw heap snapshots for in-depth performance analysis.
• Remote Communication Kit: MultipartForm adds boundary delimiter fields for more precise data transmission.
• Scan Kit: New automatic zoom settings for clearer and more efficient code scanning.
• Scenario Fusion Kit: New scenario-based Input components and support for multiple recommended scenarios, making intelligent filling more intuitive.
• Share Kit: New function to obtain user sharing results for有据可依的 sharing channel statistics.
• Test Kit: New capabilities for finding and simulating operations on various controls, easing testing work.
• UI Design Kit: New Hds navigation components for better page跳转 and style expansion.
• Vision Kit: New PC device cursor entry/exit text event monitoring for more detailed interaction.

These updates are like a technological feast, with each Kit shining in its field and continuously pushing technological applications toward smarter, more convenient, and more humanized directions. For developers, this means more powerful tools and broader creative spaces; for users, it means expecting richer and more stunning digital experiences in the future. Let's look forward to these new capabilities taking root and bearing fruit, bringing more wonderful changes to life and work!

Adaptation Guide

Changes in UI Style Effects:

Change Description	Adaptation Recommendations for Historical Projects
Button default value changed to the new rounded rectangle type	No adaptation needed
Fixed calculation errors in Popup advanced component width limits	No adaptation needed
The maximum height of the semi-modal bottom style defaults to avoid the status bar safe area	No adaptation needed

IV. DevEco Studio Change Description

Change Description

The tool list, supported API scope, and development version information carried by DevEco Studio 5.1.0.828 are as follows:

Component	Version	Description
DevEco Studio	DevEco Studio 5.1.0 Release (5.1.0.828)	-
HarmonyOS SDK	HarmonyOS 5.1.0 Release SDK	-
HarmonyOS Emulator	HarmonyOS Emulator 5.1.0 Release (5.1.0.505)	Emulator.
Hvigor	5.18.4	Compilation and build tool DevEco Hvigor (Hvigor) for API 10+ projects.
ohpm	5.1.2	Package management tool for OpenHarmony third-party libraries.
compatibleSdk	Minimum compatible version: 4.0.0(10)	Minimum SDK version compatible with HarmonyOS applications/meta-services.
modelVersion	5.1.0	Development version number.

The command line tool list, supported API scope, and development version information for DevEco Studio 5.1.0.828 are as follows:

Component	Version	Description
Command Line	5.1.0.828	Command line toolset version.
codelinter	5.1.120	Tool for executing code inspection and repair.
hstack	5.1.0	Tool for restoring obfuscated crash stacks of release apps to source code stacks.
hvigorw	5.18.4	Compilation and build tool DevEco Hvigor (Hvigor) for API 10+ projects.
ohpm	5.1.2	Package management tool for OpenHarmony third-party libraries.
sdk	HarmonyOS 5.1.0 Release SDK	-
compatibleSdk	Minimum compatible version: 4.0.0(10)	Minimum SDK version compatible with HarmonyOS applications/meta-services.
modelVersion	5.1.0	Development version number.

New and Enhanced Features of DevEco Studio 5.1.0 Release (5.1.0.828):

• DevEco Studio supports developing API 18 projects.
• DevEco Studio supports development on macOS 15.
• DevEco Studio supports TV and Wearable device development.
• New support for quickly applying for partial ACL permissions via auto-signing.
• Code Linter supports configuring custom inspection rules.
• Supports querying changes in APIs used in projects.
• Code Linter adds performance and correctness code inspection rules, with some rules changing their rule sets.
• OhosHapContext, OhosHspContext, and OhosHarContext add the getBuildMode interface to obtain the specified BuildMode for the current build.
• The hvigor-config.json5 file adds the maxSemiSpaceSize field under nodeOptions, and the hvigorw command-line tool adds the --max-semi-space-size parameter to set the maximum semi-space size of the daemon process new generation memory.
• The following fields are added under properties in hvigor-config.json5:
  • ohos.har.excludeHspDependencies to specify whether to exclude dependent HSPs in the product module.json when building HAR packages.
  • ohos.obfuscationRules.optimization to specify whether to optimize the collection method of obfuscation configuration files in third-party dependencies when obfuscation is enabled in release mode, reducing collection time and accelerating compilation.
• The build-profile.json5 file of HSP modules adds the consumerFiles field under obfuscation to configure the relative path of obfuscation rule files passed to the integration party.
• The build-profile.json5 file of HAR modules adds the following fields (refer to the module-level build-profile.json5 file for details):
  • packingOptions/asset object under buildOption to customize files or directories packed into the product.
  • packSourceMap under buildOption/arkOptions to specify whether to pack sourceMap files into the product when compiling bytecode HAR.
• The maxFlowDepth field is added under buildOption/arkOptions/tscConfig in the project-level build-profile.json5 to set the maximum recursion depth.
• The resCompileThreads field is added under buildOption/resOptions in both project-level and module-level build-profile.json5 files to specify the number of resource compilation threads.
• The hvigorw command-line tool adds the buildInfo task to print configuration information in project-level or module-level build-profile.json5 files.
• Some hvigorw commands can be executed in any directory without switching to the project root directory.
• New error codes for compilation and build.
• New support for UBSan detection.
• Incremental debugging adds support for rawfile resource debugging.
• The Native debugger supports forwarding JSVM debugging ports.
• New error codes for the emulator.
• Enhanced DevEco Profiler tuning tool capabilities:
  • New Energy consumption analysis template.
  • The Frame template supports viewing layout information for specified Frame pages.
• Snapshot analysis supports one-click expansion toward the minimum reference distance in the reference chain.
• Black-box coverage testing now supports