HarmonyOS Next 5.1.1 Beta1 Update Notes and Adaptation Guide

HarmonyOS Next 5.1.1 Beta1 Update Notes and Adaptation Guide

On June 16, 2025, HarmonyOS was updated to 5.1.1 (19) Beta. Based on HarmonyOS 5.1.0 (18), HarmonyOS 5.1.1 (19) Beta1 further enhances ArkUI component capabilities, provides more details for component calls, especially in gesture-related component functions; strengthens map service capabilities to enrich map scenarios for developers; enhances Hitrace logging capabilities, and more.

OS Platform Capabilities - Major Updates to ArkUI & Development Toolchain: Pop-up Enhancements, Component Upgrades, and Multi-Device Adaptation

I. Comprehensive Upgrade of ArkUI Pop-up and Interaction Capabilities

1. Optimized Pop-up Display Control

   • Supports customizing pop-up display order, border width, and color (API reference)
   • New side-swipe gesture to close ComponentContent under OverlayManager (API reference)
   • Allows setting transition animation effects between pop-up content and masks (API reference)

2. Focus and Lifecycle Management

   • Supports configuring whether pop-ups acquire focus (API reference)
   • New onNewParam callback triggers the lifecycle when a single-instance page is置顶 (API reference)

3. Deep Integration of XComponent

   • Native side can obtain XComponent node instances and register Surface lifecycle and input event callbacks (API reference)

II. New Functions for Layout and Components

1. Efficient Layout Components

   • New LazyVGridLayout for grid lazy loading (API reference)
   • Tabs supports setting the maximum number of cached sub-components and caching modes (API reference)
   • List component supports reverse layout from the end (API reference)

2. Enhanced Swiper Interaction

   • Supports customizing numeric navigation indicators and arrow styles (API reference)
   • Allows adjusting navigation point spacing and bottom position (API reference)

3. Optimizations for Other Components

   • Navigation supports dynamically acquiring/updating route stack information (API reference)
   • Attribute strings and RichEditor add paragraph spacing settings (API reference)

III. Optimization of Interaction and Animation Details

1. Input and Gesture Events

   • Key events support obtaining NumLock/CapsLock/ScrollLock status (API reference)
   • Pan gesture adds onActionStart event listening (API reference)
   • Drag and drop release supports delayed return of processing results (API reference)

2. Enhanced Visual Performance

   • Background images support stretching adjustments via the NODE_BACKGROUND_IMAGE_RESIZABLE_WITH_SLICE attribute (API reference)

IV. Multi-Device and Window Management

1. PC/2in1 Device Adaptation
   • New capability to switch between child and parent windows (API reference)
   • Screen attributes add display mode enumeration (API reference)

V. Development Toolchain and Capability Expansion

1. Performance Analysis Tools

• HiTraceMeter adds logging and trace APIs (guide)
• The hitrace command supports the --trace_level parameter to set output thresholds (guide)

2. Hardware and AI Capabilities

• Camera Kit: Supports querying camera macro functions (API reference)
• CANN Kit: Opens AscendC operator development for NPU programming (guide)

3. Key Service Upgrades

• Core Speech Kit: TTS adds tone download function (API reference)
• Device Security Kit: Supports obtaining information about scam applications (guide + API)
• Enterprise Data Guard Kit:
  • New file-only write mode (API reference)
  • Supports custom file attribute tags (API reference)

VI. Enhancement of Map and Navigation Services

• Map Kit:
  • Controls the visibility of mark text (guide)
  • Map logos support top/bottom center layout (API reference)
  • New bus route planning and metric/imperial scale switching (guide)
  • Indoor map function launched (guide)

VII. Enterprise Development Support

• MDM Kit: Supports Wi-Fi blacklist/whitelist configuration (API reference)
• Payment Kit: Adds real-name verification and face authentication (guide)
• Pen Kit: Listens for stylus double-click/pinch events (API reference)
• Scan Kit: Code generation adapts to 2in1 devices (guide)
• Vision Kit: Returns result codes when card recognition exits (API reference)

VIII. UI Design Tool Expansion

• UI Design Kit: Supports registering custom Symbols (guide + API)

📢 Developer Action Recommendations

This update covers interaction experience, multi-device adaptation, and enterprise capabilities. Key focuses include:

1. Performance optimization of pop-ups and layout components
2. New scenario-based functions of map services
3. Opportunities for hardware acceleration and AI operator development

For more details, refer to the API references and development guides for each module.

DevEco Studio 5.1.1 Beta1 (5.1.1.420) New and Enhanced Features

I. Core Capability Expansion: API 19 Project Development Support

• New API 19 project adaptation: DevEco Studio now supports development projects based on API 19 to meet low-version compatibility needs.

II. Upgrade of Build Configuration Capabilities

New Project-Level and Module-Level Configuration Fields

• build-profile.json5 (project-level & module-level):
  • Add generateSharedTgz under buildOption to control whether to generate tgz packages when compiling HSP modules.
  • Add ignoreResourcePattern under buildOption/resOptions to filter file/folder names in the resources directory or custom resource directories; matched items will not be packaged into the final product (specific configuration reference document).

New Optimized Configurations for hvigor-config.json5

• properties field:
  • Add ohos.byteCodeHar.integratedOptimization to specify whether to enable bytecode HAR integration behavior optimization.
  • Add hvigor.incremental.optimization to specify whether to enable task incremental judgment optimization.
  • Add hvigor.task.schedule.optimization to specify whether to enable task scheduling optimization (specific configuration reference document).

III. Strengthened Build Analysis and Problem Troubleshooting

• Build Analyzer memory monitoring: Supports viewing memory consumption during the build process to help developers locate build performance bottlenecks.
• Device connection problem troubleshooting: New device connection assistant function quickly diagnoses issues where devices cannot be recognized after connection.

IV. Improved Development and Debugging Efficiency

Enhanced Hot Reload and Asynchronous Debugging

• Hot Reload support: Upgraded hot reloading capabilities now support hot restart operations, further improving preview efficiency after code changes.
• ArkTS asynchronous stack viewing: Supports viewing asynchronous function call stacks during ArkTS code debugging, simplifying the debugging process for asynchronous logic.

Optimized Instrument Test Detection

• ASan detection command-line support: Instrument Test can now enable the ASan (AddressSanitizer) memory detection tool via the command line to enhance code robustness verification during testing.

V. Version Change Description

• Adjusted emulator login requirements:
  • Starting from DevEco Studio 5.1.1 Beta, emulators require account login to use;
  • Emulators in version 5.1.0 and earlier can be used directly without login.

📢 Developer Notes

1. If using HSP module compilation or resource filtering functions, update the build-profile.json5 configuration promptly;
2. When enabling bytecode/HAR optimization or task scheduling optimization, observe actual effects using build analysis tools;
3. Ensure account login before using the emulator to avoid affecting development and testing processes.

For more detailed configuration and operation guides, refer to the official documentation links for the corresponding functions.