HarmonyOS Next 5.0.3 Beta2 Update Notes and Adaptation Guide, CodeGenie Accesses DeepSeek

HarmonyOS Next 5.0.3 Beta2 Update Notes and Adaptation Guide, CodeGenie Accesses DeepSeek

On March 10, 2025, Huawei released the HarmonyOS 5.0.3 Beta2 documentation. HarmonyOS 5.0.3 Beta2 is the second Beta version of API 15. Compared with HarmonyOS 5.0.3 Beta1, it further enriches development scenarios. For example, ArkUI further expands configurable properties of components, callable capabilities, recognizable gestures, etc.; adds support for gamepad recognition and event response; enhances detailed functions of map services, etc. In terms of IDE, CodeGenie accesses the DeepSeek intelligent agent to provide AI capabilities such as intelligent Q&A.

The complete supporting information for HarmonyOS 5.0.3 Beta2 is as follows:

Software Package	Release Type	Version Number	Build Version	Release Date
System	Beta	HarmonyOS 5.0.3 Beta2	5.0.0.131	2025/03/06
DevEco Studio	Beta	DevEco Studio 5.0.3 Beta2	5.0.9.200	2025/03/06
SDK	Beta	HarmonyOS 5.0.3 Beta2 SDK	Based on OpenHarmony SDK Ohos_sdk_public 5.0.3.131 (API 15 Beta2)	2025/03/06

OS Platform Capabilities

New Features

New and updated features are as follows:

Ability Kit

• New support for creating an application context based on a specified physical screen ID to obtain and use other screen-related information.
• New support for launching UIAbility via C API, only available for 2in1 devices.
• New support for application pre-closing callback methods, which can be used to ask users to choose immediate execution or cancellation, only available for 2in1 devices.

ArkData

• New intelligent data platform provides edge-side data intelligence capabilities to complete the closed-loop of data and AI intelligence on the edge, only available for 2in1 devices.
• UDMF newly supports capabilities to obtain progress information and data.

ArkGraphics 2D

• NativeBuffer adds support for BLOB format (NATIVEBUFFER_PIXEL_FMT_BLOB) and RGBA16 float format (NATIVEBUFFER_PIXEL_FMT_RGBA16_FLOAT).

ArkTS

• 【Specification Update】The maximum number of runtime environments created by a process is increased from 16 to 64, and the total number of simultaneously running Worker threads and runtimes created by the process must not exceed 80.

ArkUI

• Basic components newly support inserting text at specified positions in edited text and deleting content in specified areas.
• General events add focus axis events to support response to gamepad axis events; C API additionally supports obtaining the operation type value of the current axis event.
• The pattern password lock component newly supports setting whether unselected grid dots are automatically selected when the password path passes through.
• Window management adds defined C APIs for window management, mainly used to set and obtain properties of specified windows, as well as set the status bar and navigation bar styles of specified windows.
• The Image component newly supports color filling capability that can override original colors, only valid for SVG format image sources.
• The Image component newly supports automatic transformation based on image matrices, providing automatic transformation optimization when presenting grid thumbnails in scenarios like photo galleries.
• Tabs and Swiper components newly support setting mouse wheel page-turning modes.
• NavDestination newly supports callbacks for event returns to pass parameters during event returns.
• The TextPicker component newly supports configuring text styles for each selection item.
• The Progress component adds C API support for setting linear progress bar styles.
• The foldable screen status enumeration in the screen attribute module adds multiple state definitions for the second fold axis.
• The Node attribute style of C API adds a background blur effect attribute NODE_BACKDROP_BLUR.
• FrameNode newly supports cross-language capabilities.
• FrameNode newly supports selecting the expansion mode of child nodes when traversing nodes.
• Size settings newly support adapting width and height to the parent component layout.
• Text components in TextMenuItem newly support shortcut key prompts (labelInfo).
• Three types of pop-up components newly support setting pop-up display levels and related attributes/effects (levelMode, levelUniqueId, immersiveMode).
• bindSheet newly supports radius (corner radius) and detentSelection (non-gesture gear switching) attributes.
• New navigation point components provide two styles: dot navigation points and numeric navigation points.
• Swiper and Tabs components newly support animated jump modes.
• The Swiper component newly supports scroll behavior interception events to determine whether to allow scrolling, with C API controlled by the property NODE_SWIPER_EVENT_ON_CONTENT_WILL_SCROLL.
• Third-party platform access to the ArkUI accessibility framework newly supports finding the previous/next focus (ARKUI_ACCESSIBILITY_NATIVE_ACTION_TYPE_NEXT_HTML_ITEM, ARKUI_ACCESSIBILITY_NATIVE_ACTION_TYPE_PREVIOUS_HTML_ITEM).
• Third-party platform access to the ArkUI accessibility framework newly supports multi-instance scenarios.
• The ohos.arkui.observer module's NavDestination component information adds NavDestination type and uniqueId.
• New support for screenshot capabilities via C API.
• UIContext newly supports obtaining screenshots of loaded components by uniqueId.
• UIContext newly supports obtaining layout information of the meta-service menuBar relative to the window.
• General events add C API support for obtaining the ID triggering the current touch event.
• Windows add a同名 interface (same-name interface) for setting application window size limits on 2in1 devices.
• Windows add a同名 interface (same-name interface) for specifying the mouse position within the window and moving the window.
• Windows add asynchronous callbacks for window close event listening on 2in1 devices.
• Windows newly support enabling listening for picture-in-picture window size change events.
• Windows newly support dynamically setting the title of the window title bar.
• Windows add settings for main window support modes (fullscreen, floating window, split screen, etc.).
• NavDestination newly supports setting whether to hide the back button in the title bar.
• New C API support for focus control and focus event handling.
• New C API support for cloned event forwarding.
• The Popup component adds a keyboardAvoidMode attribute to set whether the Popup bubble avoids the soft keyboard.
• Pop-ups newly support setting the distance to avoid the keyboard.
• Attribute strings newly support setting ResourceStr type images.
• The image object of attribute strings newly supports obtaining the color filter effect (colorFilter) of attribute string images.
• Drag and drop capabilities newly support obtaining drag progress bar data.
• Component screenshot capabilities newly support defining screenshot areas.
• The Tabs component adds parameters to support setting the position of Tab labels.
• Text components newly support triggering callbacks when text content is about to change.
• New support for identifying whether touch-related events come from the left or right hand, involving multiple modules: event modules add related C APIs; the FingerInfo object in gesture binding methods adds a hand attribute; the TouchObject object in touch events adds a hand attribute; the clickevent object in click events adds a hand attribute.
• New support for checking the number of fingers touching the screen, involving multiple modules: NDK adds related C APIs; components add the isFingerCountLimited attribute to set whether to check the number of touching fingers.
• New support for setting key event processing priorities and re-dispatching capabilities, involving: NDK adds C APIs for setting key event processing priorities; the ArkUI_NodeEventType enumeration in NDK adds NODE_DISPATCH_KEY_EVENT; UIContext adds ArkTS APIs for setting key event processing priorities and dispatching key events to specified components.
• C API newly supports NODE_CHECKBOX_GROUP related capabilities.

AppGallery Kit

• New application metadata management service supports dynamic icon management.

ArkWeb

• New support for cookie persistence.

Basic Service Kit

• Upload/download newly supports uploading multiple files with a single upload request, configured via the multipart parameter in Config.
• The clipboard newly supports setting progress indicators.

Camera Kit

• New support for obtaining distributed camera device types.
• New support for mirror video recording.

Connectivity Kit

• Opens Wi-Fi management capabilities of the wifiManager module for enterprise applications.

Core File Kit

• The file picker newly supports batch file authorization.

Device Security Kit

• New support for anti-fraud applications to obtain scam messages.
• New support for anti-fraud applications to obtain scam call records.

Enterprise Data Guard Kit

• New support for watermark protection when opening KIA files.
• New support for enterprise recovery key management.

IAP Kit

• PurchaseParameter adds the quantity parameter to support purchasing multiple items in a single transaction.
• New support for non-game application order refunds.

IME Kit

• New support for moving the input method window.

Input Kit

• New support for identifying and dispatching key events from gamepad devices.

Localization Kit

• New support for obtaining simplified language representations, such as simplifying "en-Latn-US" to "en".

Map Kit

• New support for setting and viewing Logo zoom ratios.
• New support for displaying 3D earth on maps.
• New support for setting custom tile layers.
• New support for implementing polyline textures via texturing.
• New support for Marker collision detection.
• New support for segmenting polylines to set textures and dynamically set textures.
• New petalMaps module supports launching Petal Maps.
• New map Picker supports setting theme colors.
• The division query control newly supports launching sub-windows.
• New support for map Picker close callbacks.
• New support for aggregated expansion icon click callbacks.

MDM Kit

• New support for setting browser hosting policies for specified browsers.

Media Kit

• Screen recording newly supports callback for obtaining the screen ID of the recording.

Media Library Kit

• New support for previewing and replacing images in the album via photoPicker.

Multimodal Awareness Kit

• New support for action awareness capabilities to sense user behaviors and actions.

Preview Kit

• New C API supports file opening acceleration.

Remote Communication Kit

• New OntimeInfo interface provides callbacks for HTTP request success/failure to monitor request outcomes.

Speech Kit

• TextReader newly supports unregistering callbacks that scroll to the bottom of the playlists with user-defined parameters.

Adaptation Guide

Changes for all applications are as follows:

Component/Module	Change Description	Adaptation Suggestion for Historical Projects
ArkUI	Default behavior change of onDragStart interface for Image, Text, and ListItem components	Requires adaptation
	Axis events support BEGIN, END, and CANCEL type callback triggers	No adaptation needed
	SetStyledString interface of TextController supports saving set attribute string information to the called TextController	Requires adaptation
	On 2in1 devices, the floating window layer is adjusted from below the dock to above the dock	No adaptation needed
Call Service Kit	Call capsules are not displayed when the call application is in the foreground	Requires adaptation
Performance Analysis Kit	HiAppEvent module's onReceive, OH_HiAppEvent_OnReceive, and takeNext interfaces support isolated subscription of clone application failure logs	No adaptation needed

UI style changes are as follows:

Change Description	Adaptation Suggestion for Historical Projects
Dynamic photo auto-play effect change	No adaptation needed
After the NavDestination title bar toolbar supports follow-hand sliding to hide, it does not resume display if no operation is performed for more than 2 seconds; the show/hide animation effect of the Tabs component's TabBar changes	No adaptation needed

DevEco Studio

Changes in DevEco Studio Beta2 (5.0.9.200) are as follows:

• CodeGenie accesses the DeepSeek intelligent agent to provide AI capabilities such as intelligent Q&A. For details, refer to Intelligent Q&A.
• For compilation and build error scenarios, support clicking the Explain with AI icon behind error content to enable CodeGenie to analyze and provide possible error causes and solutions. For details, refer to Intelligent Analysis of Compilation Errors.