OpenHarmony 5.0.2 Release

Version Description

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

ArkUI and graphics capabilities are further enhanced with advanced component attributes and animations. Web capabilities are improved to meet more application requirements. New window management capabilities and window lifecycle behaviors are added for 2-in-1 devices. Customization options for enterprise applications are added to support flexible management.

A more detailed description of the enhancements is as follows:

Application Framework

• The application startup page can be customized for 2-in-1 and tablet devices. (API Reference)

• When Want is used to pass information between objects, the parameters parameter can carry the index of the application clone (ohos.param.callerAppCloneIndex). (API Reference)

• The application-level context can be obtained. (API Reference)

• The package management capability can be called by third-party applications. (API Reference)

• The UIAbility backup and restoration capability is supported. (API Reference, Guide)

• The unique instance ID of multiple instances of an application can be obtained. (API Reference)

• The unique ID of the current system font (fontId) is added to the environment change information. (API Reference)

• A C API is added to obtain the compatible device type of the application and determine whether the application can directly run on the 2-in-1 device. (API Reference)

ArkUI

• The route navigation capability is enhanced as follows:

  • The navigation page stack can be restored upon abnormal exit. (API Reference)
  • The NavDestination component can be bound with the scrollable container. When the scrollable container is scrolled, the title bar and toolbar of all bound NavDestination components are displayed or hidden. (API Reference)
  • The Navigation component supports system transition animation enums for a single page. The system title bar animation, content animation, and no animation can be set separately. (API Reference)
  • The router option of setting whether a page can be restored is added. (API Reference)

• The text and input components’ capabilities are enhanced as follows:

  • The styled string supports background color setting, hyperlink setting, and conversion to an HTML string. (API Reference)
  • The ImageSpan component supports color filters for images. (API Reference)
  • The drawing area information of a specified character in the Text component can be obtained. (API Reference). The keyboard avoidance mode during text input supports caret avoidance. (API Reference)
  • The TextPicker component supports event callback upon scrolling stop. (API Reference)

• The scroll and swipe components’ capabilities are enhanced as follows:

  • The scrollable component supports the settings of content clipping area and edge fading effect. (API Reference)
  • The List component supports the setting of whether to display the preloaded list items and list item groups. (API Reference)
  • The Grid and WaterFlow components support the setting of whether to display the preloaded list items and list item groups. (API Reference of the Grid component, API Reference of the WaterFlow component)

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

  • A key event callback with a return value can be registered for the OH_NativeXComponent instance. (API Reference)
  • Custom attributes of a node can be obtained. (API Reference)
  • The NodeAttributeType supports a C API attribute for obtaining the total size of all child components when they are fully expanded in the scrollable component. (API Reference)

• The key event supports the unicode object, which can be used to return the Unicode value of the key corresponding to the key event. (API Reference)

• The enableHoverMode and hoverModeArea attributes are added to SheetOptions of the sheet transition to support the hover mode. (API Reference)

• DatePickerDialog supports the setting of the style of the lunar calendar switch. (API Reference)

• The six types of gesture events involved in the gesture processing capability support the setting of allowed event input types. (API Reference). FreamNode supports new gesture events. (API Reference)

• The location attributes support the re-layout of components that form a chain. (API Reference); the background attributes support the setting of removing the blur effect on the components within the window after the window loses focus. (API Reference)

• The component-level safe area padding can be set for containers. (API Reference)

• The Image component supports the setting of the image display orientation. (API Reference)

Window Management

• For applications on 2-in-1 devices, the listener for closing an application through the close button of the application window is supported. This API can be used to ignore the callback of the preset close switch. (API Reference)

• For applications on 2-in-1 devices, the size and position of the main window of an application can be customized in the module.json5 file. (Guide)

• For applications on 2-in-1 devices, the capability of restoring the minimized applications to the foreground is supported. (API Reference)

• For applications on 2-in-1 devices, the capability of obtaining visible windows at specified coordinates in the application is supported. (API Reference)

• For applications on 2-in-1 devices, the capability of enabling or disabling the main window or child window to resize itself by dragging is supported. (API Reference)

• For applications on 2-in-1 devices, the main window can be set to a modal window. (API Reference)

• For applications on 2-in-1 devices, the time when the launch page disappears can be controlled by themselves. (API Reference)

• For applications on 2-in-1 devices, you can set whether to enable the auto-save feature for the size of the main window. (API Reference)

• For applications on 2-in-1 devices, you can set whether to show the window title bar and dock bar when the cursor hovers over the hot zone while the main window is in full-screen mode. (API Reference)

• For applications on 2-in-1 devices, you can set whether to display the maximize, minimize, and close buttons on the title bar of the main window. (API Reference)

• For applications on 2-in-1 devices, the main window can be placed above other application windows. (API Reference)

• For applications on 2-in-1 devices, you can move an application window without the system title bar. (API Reference)

• You can set an effect template for a window, for example, the background blur effect with perspective. (API Reference)

• You can subscribe to the display change event of a window, for example, when the window is moved to another display. (API Reference)

• The modality type of the child window can be set. (API Reference)

Bundle Management

• HSP supports the declaration of UIAbility components except the entry ability in the configuration file. (Guide)

• The orientation attribute in the abilities tag of the module.json5 file can be configured using the resource index ($string).

• In the extensionAbilities tag of the module.json5 file, the extensionProcessMode attribute supports the runWithMainProcess type, indicating that the ExtensionAbility and the main process of the application share the same process.

• In the extensionAbilities tag of the module.json5 file, the process attribute is supported for running the ExtensionAbility whose type is embeddedUI in the same process with abilities.

Distributed Data Management

• The newly added flushSync API can store data in the cached Preferences instance to the persistent file of the shared user preferences. (API Reference)

• In the StoreConfig attribute of a relational database (RDB), the cryptoParam parameter is supported for customizing encryption parameters. (API Reference)

• RDB supports the creation of concurrent transaction objects. (API Reference)

• The Unified Data Management Framework (UDMF) supports the data structure of the content widget type (ContentForm). (API Reference)

• UDMF supports the setting of ShareOptions for the application data. (API Reference)

File Management

• The name extension of a file that is successfully saved can be obtained. (API Reference)

Media

• The streaming media supports more error codes to explain the exception scenarios. (API Reference)

• The playback control supports the capability of casting semi-modal objects. (API Reference)

• The screen recording supports a C API for setting the maximum frame rate. (API Reference)

• The media library supports the configuration of the text on the complete button, which can be displayed as “Done”, “Send”, or “Add”. (API Reference)

• The PhotoPickerComponent of the media library supports the videoPlayStateChangedCallback. (API Reference)

• The PhotoPickerComponent of the media library supports the onVideoPlayStateChanged callback. (API Reference)

• The camera supports a C API and an ArkTS API for setting the recording quality priority, with HIGH-QUALITY and POWER-BALANCE options. (C API Reference, ArkTS API Reference)

Graphics

• A C API is added to obtain the global font collection of the system. (API Reference)

• The C API capability of Decoupled VSync (DVSync) is added to improve the smoothness of self-drawing animations. (API Reference)

• A blur effect filter is added, with the tile modes of the shader effect provided, which affects the blur effect of image edges. (API Reference)

• A C API is added to enable the browser to support dynamic frame rates. (API Reference)

Security

The ECC algorithm used by asymmetric key generation and conversion, key agreement, and signature verification supports the secp256k1 curve.

Enterprise Customization

• The capability of disabling the device camera is added for enterprise applications. (API Reference)

• For enterprise application installation events, a callback is added to return the bundle name and account ID. (API Reference)

• Enterprise applications can delegate other applications to set device management policies. (API Reference)

• Enterprise applications on the 2-in-1 device can enable or disable the device fingerprint authentication capability. (API Reference)

• Enterprise applications on the 2-in-1 device can disable the screen snapshot function. (API Reference)

• Enterprise applications on the 2-in-1 device support watermark configuration. (API Reference)

• Enterprise applications on the 2-in-1 device support adding applications that need to be kept alive through the device administrator application. (API Reference)

• Enterprise applications on the 2-in-1 device support adding disallowed USB device types through the device administrator application. (API Reference)

USB

USB management supports checking whether applications have the permission to access USB accessories. (API Reference)

Input Method

In the input method framework, the EditorAttribute supports the bundle name of the application to which the editor belongs. (API Reference)

Pasteboard

• The pasteboard supports the definition and use of content objects in multiple formats through MIME. (API Reference)

• A C API and an ArkTS API are added to obtain the content of the MIME type on the pasteboard. (C API Reference, ArkTS API Reference)

Web

• When a user collapses the soft keyboard, the focus can be moved from the text box to the web body. (API Reference)

• A C API is added to obtain the URL of the last frame that calls JavaScriptProxy. (API Reference)

• The default user agent can be obtained. (API Reference)

• The cookie value can be set for a specified URL. (API Reference)

• The up, down, left, and right nested scrolling modes are supported. (API Reference)

• The memory occupied by the Web component can be automatically trimmed based on the specified memory pressure level. (API Reference)

• Web pages can be saved as PDF files. (API Reference)

• The duration of the scrolling animation can be set. (scrollTo, scrollBy)

• The scroll bar can be forcibly displayed. (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.2-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.2-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.2-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.2-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