This repository contains Board Support Packages (BSPs) for devices supported by the Oniro Project, including the Volla X23 phone and the QEMU virtual device. These BSPs enable developers to build and deploy Oniro on supported hardware.

This guide provides step-by-step instructions to build and run the Oniro Emulator using the OpenHarmony-6.0-Release source.

Before proceeding, make sure you have followed the Quick Build Setup guide to prepare your build environment.

Use the following commands to fetch the Oniro source:

repo init -u https://github.com/eclipse-oniro4openharmony/manifest.git -b OpenHarmony-6.0-Release -m oniro.xml --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

Run the patching script:

bash vendor/oniro/x86_general/hook/do_patch.sh

Start the build with ccache enabled:

./build.sh --product-name x86_general --ccache --gn-args allow_sanitize_debug=true

If needed, you can undo the applied patches:

bash vendor/oniro/x86_general/hook/undo_patch.sh

After a successful build, emulator image files can be found at:

out/x86_general/packages/phone/images

.\run.bat

./run.sh

• x23: target for Volla X23 device. Oniro can be run on the Volla X23 using a layered approach, with Ubuntu Touch as the base OS and Oniro running in an LXC container. Detailed instructions are available in the Volla X23 documentation.

Oniro leverages the OpenHarmony graphics stack, which includes the ArkUI framework, Render Service, and Hardware Abstraction through HDI. More details can be found in the OpenHarmony Graphics Stack Overview.

Contributions to improve the board support packages are welcome. Please submit a pull request with your proposed changes.

This repository is distributed under the Apache 2.0 License.