Based on HarmonyOS 5.1.0(18), HarmonyOS 5.1.1(19) enhances the ArkUI component features by providing more component calling details, particularly for gestures. It also strengthens the Map Kit capabilities by enriching the map use cases and enhances the logging and tracing functionality of HiTrace.
For more details, see New and Enhanced Features of the OS and New and Enhanced Features of DevEco Studio.
Version Information
Correct version mappings allow for a smoother experience in application development.
Before reading the version updates and changes, ensure that the version mapping is consistent with the developer suite you are using.
[h2]5.1.1(19) Release Developer Suite
| Software Package | Release Type | Version | Released On |
|---|---|---|---|
| API version | Release | 5.1.1(19) *Note: The range of API capabilities supported by the device system is determined by its API version. | 2025/06/30 |
| DevEco Studio | Release | DevEco Studio 5.1.1 Release (5.1.1.850) (Patch release) | 2025/10/24 |
| DevEco Studio 5.1.1 Release (5.1.1.840) (Patch release) | 2025/09/05 | ||
| DevEco Studio 5.1.1 Release (5.1.1.830) (Patch release) | 2025/08/07 | ||
| DevEco Studio 5.1.1 Release (5.1.1.823) (Patch release) | 2025/07/16 | ||
| DevEco Studio 5.1.1 Release (5.1.1.820) | 2025/06/30 | ||
| SDK | Release | HarmonyOS 5.1.1 Release SDK Based on OpenHarmony SDK Ohos_sdk_public 5.1.1.212 (API 19 Release) | 2025/10/24 |
| HarmonyOS 5.1.1 Release SDK Based on OpenHarmony SDK Ohos_sdk_public 5.1.1.202 (API 19 Release) | 2025/06/30 |
- This version is exclusively available on Mate 60 series devices to which the version is directly pushed. Developers using other devices will not be able to access the new features of 5.1.1(19).
- To query the API version, tap the device name in Settings of the device and go to About.
- To query the DevEco Studio version, choose on DevEco Studio. To download the latest DevEco Studio version, click here.
- The SDK is integrated into DevEco Studio, and the matching version is automatically installed when you install DevEco Studio. To query the SDK version, choose on DevEco Studio.
[h2]5.1.1(19) Beta1
| Software Package | Release Type | Version | Released On |
|---|---|---|---|
| API version | Beta | 5.1.1(19) Beta1 *Note: The range of API capabilities supported by the device system is determined by its API version. | 2025/06/12 |
| DevEco Studio | Beta | DevEco Studio 5.1.1 Beta1 (5.1.1.420) | 2025/06/12 |
| SDK | Beta | HarmonyOS 5.1.1 Beta1 SDK Based on OpenHarmony SDK Ohos_sdk_public 5.1.1.66 (API 19 Beta1) | 2025/06/12 |
Application Project Version Configuration Recommendations
To ensure compatibility across devices with different system versions, you must correctly configure the SDK version dependencies for your application project.
Applications developed using a beta development suite cannot be released to AppGallery. If you need to release your application, you are advised to use 5.0.5 (17) Release for development.
For applications developed with this version, the following configurations are recommended in the build-profile.json5 file.
| Configuration Item in build-profile.json5 | Existing Application | New Application | |
|---|---|---|---|
| Recommended Configuration | Configuration Example | ||
| compileSdkVersion | No explicit configuration is needed. By default, the matched SDK version is used during compilation, which is as follows: "compileSdkVersion": "5.1.1(19)" | N/A | 5.0.5 (17) Release is recommended for development. |
| compatibleSdkVersion | Whenever possible, maintain consistency with the compatibleSdkVersion used before project upgrade. | Same as that before the upgrade, for example: "compatibleSdkVersion": "5.0.0(12)" | |
| targetSdkVersion | Option 1 (recommended): Adapt to the latest changes and use "targetSdkVersion": "5.1.1(19)". Option 2: If adaptation is deferred, retain the pre-upgrade value. | 1. Example for option 1: "targetSdkVersion": "5.1.1(19)"
2. Example for option 2: "targetSdkVersion": "5.0.0(12)" | |