OpenHarmony 3.1.1 Release

Version Description

OpenHarmony 3.1.1 Release provides the following enhancements over OpenHarmony 3.1 Release:

Enhanced basic capabilities for the standard system

System service management is enhanced to support group verification. Power management now supports brightness adjustment and battery information query. The Misc services subsystem supports HTTP file download APIs.

The location service subsystem now implements basic positioning APIs. The window manager subsystem supports setting of window properties. The multimedia subsystem provides APIs related to audio focus and audio decoding.

Network management supports Ethernet connections. WebSocket JS APIs are added, which are compatible with the @system.fetch and @system.network APIs.

Enhanced distributed capabilities for the standard system

Distributed data management is now compatible with the @system.storage APIs.

Enhanced application framework capabilities for the standard system

Bundle management supports application-specific installation status query. The common event and notification subsystem provides APIs for sending and canceling notifications.

The Feature Ability (FA) model supports ability-level screen orientation query and setting, lock screen display, and screen-on during ability startup. DFX features, such as Application Not Response and suspension detection for an application's main thread, are added. More basic capabilities are added for FA widgets.

Enhanced application capabilities for the standard system

The Contacts application allows third-party applications to invoke the system call capability, so end users can use the basic communication capabilities of devices.

Version Mapping

Table 1 Version mapping of software and tools

Software/Tool	Version	Remarks
OpenHarmony	3.1.1 Release	NA
Public SDK	Ohos_sdk_public 3.1.6.6 (API Version 8 Release)	This toolkit is intended for application developers and does not contain system APIs that require system permissions. It is provided as standard in DevEco Studio 3.0 Beta4 or later. The public SDK of API version 8 was released on July 6, 2022.
Full SDK	Ohos_sdk_full 3.1.6.5 (API Version 8 Release)	This toolkit is intended for original equipment manufacturers (OEMs) and contains system APIs that require system permissions. To use the full SDK, manually obtain it from the mirror and switch to it in DevEco Studio. For details, see Guide to Switching to Full SDK.
(Optional) HUAWEI DevEco Studio	3.0 Beta3 for OpenHarmony	This tool is recommended for developing OpenHarmony applications.
(Optional) HUAWEI DevEco Device Tool	3.0 Release	This tool is recommended for developing OpenHarmony smart devices.

Source Code Acquisition

Prerequisites

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

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.)

repo init -u git@gitee.com:openharmony/manifest.git -b refs/tags/OpenHarmony-v3.1.1-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.

repo init -u https://gitee.com/openharmony/manifest.git -b refs/tags/OpenHarmony-v3.1.1-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

Source Code	Version	Mirror	SHA-256 Checksum
Full code base (for mini, small, and standard systems)	3.1.1 Release	Download	Download
Hi3516 standard system solution (binary)	3.1.1 Release	Download	Download
RK3568 standard system solution (binary)	3.1.1 Release	Download	Download
Hi3861 mini system solution (binary)	3.1.1 Release	Download	Download
Hi3516 mini system solution - LiteOS (binary)	3.1.1 Release	Download	Download
Hi3516 mini system solution - Linux (binary)	3.1.1 Release	Download	Download
Full SDK package for the standard system (macOS)	3.1.1 Release	Download	Download
Full SDK package for the standard system (Windows/Linux)	3.1.1 Release	Download	Download
Public SDK package for the standard system (macOS)	3.1.1 Release	Download	Download
Public SDK package for the standard system (Windows/Linux)	3.1.1 Release	Download	Download

What's New

This version has the following updates to OpenHarmony 3.1 Release.

Feature Updates

Table 3 New and enhanced features

Subsystem	Standard System	Mini and Small Systems
SDK	SDKs are classified into full SDKs and public SDKs. Note: The public SDK of API version 8 was released on July 6, 2022.	NA
System service management	Added group verification. The following requirement is involved: I52G5Q Adding group verification	NA
Power management	Added the APIs for brightness adjustment and battery information query. The following requirements are involved: I526UP Supporting the @system.brightness APIs I526UP Supporting the @system.battery APIs	NA
Bundle management	Added the APIs for querying whether a specified application is installed. The following requirements are involved: I56EWD Test framework configuration I55RZJ Querying whether a specified application is installed	NA
Location service	Added compatibility with basic positioning APIs. The following requirement is involved: I53WFP Basic positioning capabilities and system APIs	NA
Ability	Added the following features to the FA model: ability-level screen orientation query and setting, lock screen display, and screen-on upon startup. The following requirements are involved: I56EH7 Querying and setting the landscape/portrait mode for an ability in the FA model I50D5Y Lock screen display for an ability in the FA model I56EH7 Screen-on during ability startup in the FA model I55WB0 Carrying images in widget data I55WB0 FA widget capability supplement - formManager reconstruction I55WB0 FA widget capability supplement - widget status query I55WB0 FA widget capability supplement - deleting invalid widgets I55WB0 FA widget capability supplement - separate setting of the visibility and update status of widgets I50D8H Interception of uncatched exceptions I50D91 Application Not Response processing	NA
Media	Added APIs related to audio focus and audio decoding. The following requirements are involved: I56REO Supplementing audio focus/device APIs I522W0 AMR audio encoding	NA
Window manager	Added support for setting window properties. The following requirement is involved: I56EH7 Window property setting	NA
Network management	Added support for WebSocket and fetch APIs and Ethernet connections. The following requirements are involved: I53CKH Supporting the @system.fetch APIs I53CJX Supporting the @system.network APIs I53CKT WebSocket support I580PC Ethernet connections	NA
Misc services	Added compatibility with HTTP file download APIs. The following requirement is involved: I56Q4X Supporting file download APIs	NA
Common event and notification	Added the APIs for sending and canceling notifications. The following requirements are involved: I50EEW APIs for sending and canceling notifications	NA
Distributed data management	Added compatibility with the @system.storage APIs. The following requirement is involved: I56RF3 Supporting the @system.storage APIs	NA
Startup	Added compatibility with the @system.device APIs. The following requirement is involved: I56GBS Supporting the @system.device APIs	NA
System applications	The Contacts application allows third-party applications to invoke the system call capability. The following requirements are involved: I58ZQ4 The Contacts application allows third-party applications to invoke the system call capability.	NA

API Updates

This version does not involve API updates.

Chip and Development Board Adaptation

For details about the adaptation status, see SIG_DevBoard.

Resolved Issues

Table 4 Resolved issues

Issue No.	Description
I4UUFR	Local image compilation and build may fail for the Hi3516 development board.
I4WDD3	[RK3568] A recorded video cannot be viewed.
I50EBB	[Hi3516 burning] Images of the Hi3516 development board on a standard-system device cannot be burnt by using DevEco Device Tool.

Known Issues

Table 5 Known issues

Issue No.	Description	Impact	To Be Resolved By
I4Z3G9	[RK3568] Screen flickering occurs when the secondary window is opened in the immersive primary window.	Developer experience is affected.	2022-06-15
I58GFY	[RK3568] On the 2.4 GHz and 5 GHz frequency bands, connections fail in WPA+TKIP/AES encryption mode.	The TP-Link AX50 router cannot connect to the Wi-Fi network.	2022-06-30
I59P32	[RK3568] After the trust period of a device expires, PIN authentication cannot be performed.	This issue occurs when the timer waiting for the PIN code input times out. It can be resolved by restarting the device.	2022-06-15