HarmonyOS Next 5.0.5 Release Update Notes and Adaptation Guide

HarmonyOS Next 5.0.5 Release Update Notes and Adaptation Guide

On May 16, 2025, HarmonyOS Next 5.0.5 Release was officially updated.

I. Version Overview

HarmonyOS 5.0.5 (17) Release has been officially released! This update is based on the previous Beta1 version, focusing on optimizing system performance and stability to further enhance the development and usage experience. Although no new platform capabilities are added, underlying optimizations provide developers with a smoother and more reliable development environment.

Core Highlights

• Performance Improvement: Optimized system operation efficiency for faster application response.
• Enhanced Stability: Fixed multiple potential issues to reduce crash risks.
• Improved Development Tools: Supporting DevEco Studio is updated synchronously to adapt to the latest SDK and toolchain.

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

Component	Version Number	Description
System Version	HarmonyOS 5.0.5 Release	Software Version: 5.0.1.120 API Version: 5.0.5 (17)
DevEco Studio	5.0.5 Release (5.0.13.200)	Main version of development tools
HarmonyOS SDK	Based on OpenHarmony SDK 5.0.5.165	API 17 Release support
HarmonyOS Emulator	5.0.9.400	New support for 2in1 devices

2. Version Query Methods

• System Version: Go to device "Settings > About Phone > Software Version" and confirm whether the "API Version" is 5.0.5(17).
• DevEco Studio: Query the version via the menu bar "Help > About DevEco Studio".
• SDK: View supporting information via "Help > About HarmonyOS SDK".

Adapted Devices: Mate 60 series, Mate X5, MatePad Pro 13.2"/11" 2024 models, etc. For other devices upgraded to this version, the open capabilities must be verified based on the "API Version".

III. Detailed Update Content

1. Development Tool Enhancements

• Quick ACL Permission Application: New support for quickly applying for partial ACL permissions via auto-signing to simplify the development process. (Reference document: Support for ACL Permissions)
• Compilation Configuration Optimization:
  • Added the reExportCheckMode configuration item in the build-profile.json5 file to intercept secondary export issues of lazy import variables. (Reference documents: Project-Level Configuration | Module-Level Configuration)
• WebView Debugging Support: DevEco Studio supports automatic monitoring of WebView processes and port forwarding to improve debugging efficiency. (Reference document: Automatic Mapping of WebView Debugging Links)

2. Emulator Function Upgrade

• New Device Type Added: Supports simulation of 2in1 devices to cover development and testing needs for more foldable and hybrid-form factor devices. (Reference document: Emulator Usage Guide)

3. Toolchain Update

• Hvigor: Upgraded to version 5.17.1, supporting compilation and build for API 10 and above projects.
• ohpm: The third-party library management tool is updated to 5.0.16, optimizing dependency resolution efficiency.

IV. Adaptation Guide

1. Development Environment Upgrade

• Update DevEco Studio: Download the latest 5.0.5 Release version from the official website or complete the upgrade via in-IDE prompts.
• Synchronize SDK and Emulator: Install the supporting SDK and update the emulator to 5.0.9.400 to ensure functional integrity.

2. Notes

• Compilation Configuration Adjustment: If using lazy import to export variables, check the reExportCheckMode configuration to avoid compilation errors.
• Permission Adaptation: For modules requiring re-application of ACL permissions, it is recommended to use the auto-signing function to simplify the process.
• Device Compatibility: Users of non-officially adapted devices must confirm API version support via "About Phone".

V. Conclusion

The HarmonyOS 5.0.5 Release provides developers with a more stable development foundation through continuous optimization. It is recommended that developers upgrade supporting tools as soon as possible to fully leverage the efficiency benefits brought by performance improvements and function enhancements. In the future, Huawei will continue to advance the construction of the HarmonyOS ecosystem to help developers create better full-scenario experiences.