OpenHarmony 5.0.3 Release

Version Description

OpenHarmony 5.0.3 Release continuously improves the capabilities of the standard system, rolling out API 15 via quick iteration. Compared with 5.0.2 Release, OpenHarmony 5.0.3 Release has the following new or enhanced features:

ArkUI provides more advanced attribute settings of components and exquisite animations. For 2-in-1 devices, the window management capability supports more types of device screens or windows. The Unified Data Management Framework (UDMF) of distributed data management is improved with a new smart data platform to provide data intelligence on the device. More external devices, such as game controllers, are also supported.

OpenHarmony 5.0.1(API 13) and OpenHarmony 5.0.2(API 14) are fast iteration versions. For details, refer to the corresponding version descriptions.

A more detailed description of the enhancements is as follows:

Application framework

• Definitions and C APIs of the component startup parameter Want are added. (API Reference)

• The application context can be created based on the specified physical screen ID so that other screen information can be obtained and used. (API Reference)

• The UIAbility can be started through the C API. (API Reference)

• Callbacks for pre-closing applications are added, which can be used to ask users whether to execute or cancel operations immediately. (API Reference of UIAbility, API Reference of AbilityStage)

ArkUI

• The route navigation capability is enhanced as follows:

  • The Navigation component supports the setting of whether to enable the animation during switching between single and double column modes. (API Reference)
  • The NavDestination component supports a callback during page returning for processing the return parameters of the pop API (API Reference), and the setting of whether to hide the back button in the title bar (API Reference).
  • The NavDestination component also supports the custom transition animation for a single page (API Reference) and the system transition animation type enumeration (API Reference).

• The text and input components are enhanced as follows:

  • The TextInput, TextArea, and Search components support setting whether to prevent back button operations (onBackPressed). (API Reference of TextInput, API Reference of TextArea, API Reference of Search)
  • The TextInput, TextArea, and Search components support triggering a callback when the text content is about to change. (API Reference of TextInput, API Reference of TextArea, API Reference of Search)
  • Styled strings allow you to set images of the ResourceStr type (API Reference) and obtain the image color filter (API Reference of RichEditor).
  • The TextInput, TextArea, Search, and RichEditor components support the setting of the keyboard appearance. (API Reference of TextInput, API Reference of TextArea, API Reference of Search, API Reference of RichEditor)
  • Components support the capabilities of inserting text at a specified position and deleting text within a specified range in the editable content. (API Reference)

• The Image and Video components are enhanced as follows:

  • The Image component allows you to reset the filling color of images by passing the ColorContent type, which takes effect only for SVG images. (API Reference)
  • The Image component supports automatic conversion based on the image matrix. For example, in scenarios similar to the gallery, images can be automatically converted to achieve the optimal display of grid thumbnails. (API Reference)
  • The Video component supports the setting of whether to respond to keyboard shortcuts. (API Reference)

• The popup capability is enhanced as follows:

  • The Popup component supports the setting of attributes for popup page display and related effects, such as levelMode, levelUniqueId, and immersiveMode. (API Reference of PromptAction, API Reference of Custom Dialog Box, API Reference of showAlertDialog, API Reference of showActionSheet)
  • The bindSheet attribute supports the radius attribute for setting the corner radius of the sheet, and the detentSelection attribute for non-gesture switching. (API Reference)
  • The Popup component supports the keyboardAvoidMode attribute for setting whether popups avoid the soft keyboard. (API Reference)
  • The Popup component allows you to set the distance to avoid the keyboard. In ArkTS APIs, this feature is achieved through the keyboardAvoidDistance attribute. (C API Reference, ArkTS API Reference of Custom Dialogs, ArkTS API Reference of Base Dialog)

• The Swiper and Tabs components are enhanced as follows:

  • The Swiper and Tabs components support jumps with animations, (C API Reference of the Swiper Component, ArkTS API Reference of the Swiper Component, and ArkTS API Reference of the Tabs Component) and the setting of the page flipping mode using the mouse wheel. (API Reference of the Tabs Component, API Reference of the Swiper Component)
  • The Swiper component supports the event for intercepting swipe behavior, which can be used to determine whether the swipe behavior is allowed. In C APIs, this feature is achieved through the NODE_SWIPER_EVENT_ON_CONTENT_WILL_SCROLL attribute. (C API Reference, ArkTS API Reference)
  • The Tabs component supports new parameters for setting the universal attributes for the tab bar. (API Reference)

• The capabilities of the UIContext object are enhanced as follows:

  • Parameters of OverlayManager are added for setting whether to render the root overlay node. (API Reference)
  • The screenshot of a loaded component can be obtained based on uniqueId. (API Reference).
  • The layout information of the atomic service menu bar relative to the window can be obtained. (API Reference)
  • The drag data of the progress bar can be obtained. (C API Reference, ArkTS API Reference)

• The common capabilities of C APIs are enhanced as follows:

  • C APIs are added to support callback methods of component layout completion and component drawing completion. (API Reference of Component Layout Completion Callback, API Reference of Component Drawing Completion Callback)
  • The property style NODE_IMMUTABLE_FONT_WEIGHT of C APIs is added, which can be used to set that the font weight is not affected by any changes in the system font weight settings. (API Reference)
  • The NODE_BACKDROP_BLUR property is added to the Node property of C APIs. (API Reference)
  • A C API is added for focus control and focus event processing. (API Reference)
  • A C API is added for forwarding clone events. (API Reference)
  • A C API is added to universal events for obtaining the ID of the tap pointer that triggers the current tap event. (API Reference)
  • C APIs are added for obtaining component snapshots. (API Reference)
  • The NODE_CHECKBOX_GROUP related capabilities are added. (API Reference)

• Whether the current tap event is from the left or right hand can be obtained, which involves the following data objects:

  • The hand property of the FingerInfo object. (API Reference)
  • The hand property of the TouchObject object. (API Reference)
  • The hand property of the ClickEvent object. (API Reference)

• Gesture recognizers support finger count limits.

  • Related C APIs are added to NDK. (API Reference)
  • Gesture APIs support the isFingerCountLimited property, which is used to set whether to check the number of fingers that tap the screen. (API Reference of Long Press Gesture, API Reference of Pan Gesture, API Reference of Pinch Gesture, API Reference of Rotation Gesture, and API Reference of Swipe Gesture and API Reference of Tap Gesture)

• The capabilities of setting the mode for processing key events and re-dispatching key events are added as follows:

  • A C API for setting the mode of processing key events is added to NDK. (API Reference)
  • The NODE_DISPATCH_KEY_EVENT (component key event re-dispatch event) is added to ArkUI_NodeEventType in NDK. (API Reference)
  • An ArkTS API for setting the mode of key event processing is added to UIContext. (API Reference)
  • An ArkTS API for distributing key events to specified components is added to UIContext. (API Reference)

• The TextPicker component allows you to disable the text style change animation and default text style during the scrolling process. (API Reference)

• The Progress component supports a C API for setting the linear progress indicator style. (API Reference)

• FrameNode supports cross-language capabilities (API Reference) and expansion modes of child nodes during node traversal (API Reference).

• The Indicator component is added, which provides two types of navigation indicators: dot indicators and digit indicators. (API Reference)

• Third-party platforms connecting to the ArkUI accessibility framework support searching for the next or previous focus (ARKUI_ACCESSIBILITY_NATIVE_ACTION_TYPE_NEXT_HTML_ITEM, ARKUI_ACCESSIBILITY_NATIVE_ACTION_TYPE_PREVIOUS_HTML_ITEM) (API Reference) and multi-instance scenarios (API Reference).

• The NavDestination component information of the ohos.arkui.observer module supports the NavDestination type and uniqueId. (API Reference)

• The PatternLock component allows you to set whether unselected dots in the grid are automatically selected when the password path passes over them. (API Reference)

• Focus axis events are added to universal events to support the response to the game controller axis event (C API Reference, ArkTS API Reference).

• A C API is added for obtaining the action type of the current axis event. (C API Reference)

• The size attributes support adaptation of width and height to the parent component’s layout. (API Reference)

• The capability of obtaining component screenshots supports the definition of the component screenshot region. (API Reference)

• The Security component allows you to set the alignment of the icon and text (API Reference) and the radius of four border corners (API Reference).

Window Management

• The PiP window information, such as the ID and size, can be obtained. (API Reference)

• The layout information of all windows visible on a display can be obtained. (API Reference)

• The display density information of the current window can be obtained (API Reference), the system density change event of the window can be subscribed (API Reference), and the display size scale factor of the main window can be set by itself (API Reference).

• The window movement configuration is added. Currently, the screen ID can be defined, and a window can be moved to another screen. (API Reference)

• C APIs of the window management are added. You can use the APIs to set and obtain the properties of a window, and set its status bar style and navigation bar style. (API Reference)

• The fold status enumeration of the display module introduces multiple status definitions for the second fold axis. (API Reference)

• An API is added for setting the size limits for this application window on the 2-in-1 device. (API Reference)

• An API is added for specifying the cursor position within the window and moving the window. (API Reference)

• An asynchronous callback function is added for subscribing to the window close event on the 2-in-1 device. (API Reference)

• The PiP window size change event can be subscribed to. (API Reference)

• The title of the title bar can be dynamically set. (API Reference)

• The supported window modes (FULL_SCREEN, FLOATING, and SPLIT) of the main window can be set. (API Reference)

Bundle Management

In ApplicationInfo, the definition installSource is enhanced with three new options: ota, recovery, and application bundle name. (API Reference)

Distributed Data Management

• UDMF supports the capability of adding data of a specified type and content, and the corresponding query API is added. (API Reference)

• A smart data platform is added to provide data intelligence capabilities on the device, enabling AI-powered data processing on devices. (User Guide, API Reference)

• UDMF supports the capability of obtaining progress information and data. (API Reference)

File Management

• The definition and operation capabilities of atomic files are added. (API Reference)

• The total size and available size of the device’s built-in storage can be obtained. (API Reference)

• The Stat attribute supports three new properties: atimeNs (time of the last access to the file), mtimeNs (time of the last modification to the file), and ctimeNs (time of the last status change of the file). (API Reference)

• The file selector supports batch file authorization. (User Guide, API Reference)

Media

Video Encoding

C APIs are added to support the video variable refresh rate feature. (User Guide)

Image Processing

• A PixelMap object can be created from a surface ID without specifying the region. (API Reference)

• A C API is added for obtaining the memory address where the pixels of a PixelMap are stored. (API Reference)

Screen Recording

• A C API is added for setting whether to display the cursor during screen recording. (API Reference)

• A callback is added for obtaining the screen ID during screen recording. (API Reference)

Camera

• The type of a distributed camera can be obtained. (API Reference)

• The mirror recording is supported. (API Reference)

Media Library

Images in the album can be previewed and replaced through photoPicker. (API Reference)

Graphics

• The Tool class is added for converting values of the ResourceColor type to the common2D.Color objects. (API Reference)

• You are allowed to set whether the drawing font follows the theme font. (C API Reference, ArkTS API Reference)

• A C API is added for obtaining the transformation matrix calculated based on the rotation angle set by the producer and the actual valid content area of the buffer. (API Reference)

• NativeBuffer supports two new formats: NATIVEBUFFER_PIXEL_FMT_BLOB and NATIVEBUFFER_PIXEL_FMT_RGBA16_FLOAT. (API Reference)

Programming Language Runtime

A maximum of 64 runtime environments can be created for a process, and the total number of Worker threads and runtime environments created by a process cannot exceed 80.

Communications

• Wi-Fi 7 and Wi-Fi 7+ are supported. (API Reference)

• The wifiManager module supports the checking of whether a hotspot is active. (API Reference)

• The Wi-Fi management capabilities of the wifiManager module are available to enterprise applications. (API Reference)

Network Management

The URL of the system-level proxy auto-config (PAC) script can be set. (C API Reference, ArkTS API Reference)

DFX

• HiLog supports the setting of the minimum log level for application logging. (C API Reference, ArkTS API Reference)

• The sandbox of a debug application can be accessed through hdc to read logs and resources in the sandbox in the debugging state. (User Guide)

• HiAppEvent enhances the debugging capabilities for the main thread jank events. (User Guide, API Reference)

NDK

The development capability based on the OpenMP library is supported. (User Guide)

Device Management

• The button events of the game controller can be identified and distributed. (API Reference)

• The motion awareness capability is added for sensing user gestures and actions. (User Guide, API Reference)

Enterprise Customization

• The browser policy can be set for a specified browser. (API Reference)

• The network proxy of a specified user can be set (only for 2-in-1 devices). (API Reference)

Input Method

• The state of the input method can be obtained. (API Reference)

• APIs are added for custom communication between input method applications and text boxes. (API Reference of Input Method Framework, API Reference of Input Method Service)

• The input method keyboard window can be moved. (API Reference)

Pasteboard

The progress indicator can be set. (C API Reference, ArkTS API Reference)

Web

The cookies can be persisted. (API Reference)

Upload and Download

• The upload and download tasks can be grouped and notifications can be displayed by group. (API Reference)

• A maximum of 8192 characters can be contained in an upload or download URL. (API Reference)

• Multiple files can be uploaded through a single upload request by setting the multipart parameter in Config. (API Reference)

• The notification bar can be customized. (API Reference)

Globalization

• The standard ICU C library (ICU4C) supports Unicode string processing (ustring.h) and ICU text abstract representation (utext.h). (API Reference)

• The simplified representation of a language can be obtained. For example, the simplified representation of en-Latn-US is en. (API Reference)

Resource Scheduler

A listener callback for the canceling of a continuous task is added. (API Reference)

Mapping Relationship

Table 1 Version mapping of software and tools

Source Code Acquisition

Prerequisites

1. Register your account with Gitee.

2. Register an SSH public key for access to Gitee.

3. Install the git client and git-lfs, and configure user information.

   git config --global user.name "yourname"
   git config --global user.email "your-email-address"
   git config --global credential.helper store
   

4. Run the following commands to install the repo tool:

   curl -s https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo  #If you do not have the permission, download the tool to another directory and configure it as an environment variable by running the chmod a+x /usr/local/bin/repo command.
   pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests
   

Acquiring Source Code Using the repo Tool

Method 1 (recommended)

Use the repo tool to download the source code over SSH. (You must have an SSH public key for access to Gitee.)

• Obtain the source code from the version branch. You can obtain the latest source code of the version branch, which includes the code that has been incorporated into the branch up until the time you run the following commands:

  repo init -u git@gitee.com:openharmony/manifest.git -b OpenHarmony-5.0.3-Release --no-repo-verify
  repo sync -c
  repo forall -c 'git lfs pull'
  

• Obtain the source code from the version tag, which is the same as that released with the version.

  repo init -u git@gitee.com:openharmony/manifest.git -b refs/tags/OpenHarmony-v5.0.3-Release --no-repo-verify
  repo sync -c
  repo forall -c 'git lfs pull'
  

Method 2

Use the repo tool to download the source code over HTTPS.

• Obtain the source code from the version branch. You can obtain the latest source code of the version branch, which includes the code that has been incorporated into the branch up until the time you run the following commands:

  repo init -u https://gitee.com/openharmony/manifest -b OpenHarmony-5.0.3-Release --no-repo-verify
  repo sync -c
  repo forall -c 'git lfs pull'
  

• Obtain the source code from the version tag, which is the same as that released with the version.

  repo init -u https://gitee.com/openharmony/manifest -b refs/tags/OpenHarmony-v5.0.3-Release --no-repo-verify
  repo sync -c
  repo forall -c 'git lfs pull'
  

Acquiring Source Code from Mirrors

Table 2 Mirrors for acquiring source code

Resolved Issues

Table 3 Resolved issues

Unfixed Vulnerabilities

Table 4 Known issues

你可能感兴趣的鸿蒙文章

harmony 鸿蒙OpenHarmony 1.0 (2020-09-10) (EOL)

harmony 鸿蒙OpenHarmony 1.1.0 LTS (2021-04-01) (EOL)

harmony 鸿蒙OpenHarmony 1.1.1 LTS (2021-06-22) (EOL)

harmony 鸿蒙OpenHarmony 2.0 Canary (2021-06-01)

harmony 鸿蒙OpenHarmony v1.1.3 LTS (EOL)

harmony 鸿蒙OpenHarmony 1.1.4 LTS (EOL)

harmony 鸿蒙OpenHarmony v1.1.2 LTS (EOL)

harmony 鸿蒙OpenHarmony 1.1.5 LTS (EOL)

harmony 鸿蒙OpenHarmony v2.2 Beta2

harmony 鸿蒙OpenHarmony 3.0 LTS