Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
.. SPDX-FileCopyrightText: Huawei Inc.
..
.. SPDX-License-Identifier: CC-BY-4.0
OpenHarmony - Quick Build
#########################
This section will guide you to building your first OpenHarmony image targeting
a supported reference hardware. It will also provide the steps for flashing and
booting such an image.
The steps below will focus on a Qemu-based target. If you want to get a feeling
of OpenHarmony on a real hardware, checkout the :ref:`Avenger96 support page
<SupportedBoardAvenger96>`.
.. contents::
:depth: 2
Prerequisites
*************
Have a **Ubuntu 20.04 LTS** host with all the required host packages.
.. code-block:: console
$ sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib \
build-essential chrpath socat cpio python3 python3-pip python3-pexpect \
xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev \
pylint3 xterm
Clone build system repositories
*******************************
Install Google git repo tool:
.. code-block:: console
$ sudo add-apt-repository ppa:openharmony/tools
$ sudo apt-get update
$ sudo apt-get install git-repo
Initialize a repo workspace and clone all required repositories:
.. code-block:: console
$ mkdir ohos; cd ohos
$ repo init -u https://git.ostc-eu.org/OSTC/OHOS/manifest.git -b develop
$ repo sync --no-clone-bundle
Build the openharmony-image-base image
**************************************
The following steps will build a ``openharmony-image-base``. The process will
build all its components, including the toolchain, from source.
First of all change directory into the one where the build repositories were
cloned using the repo tool. See above.
Initialize the build directory and run a build:
.. code-block:: console
$ TEMPLATECONF=../sources/meta-ohos/flavours/linux . ./sources/poky/oe-init-build-env build-ohos-linux
$ MACHINE=qemux86-64 bitbake openharmony-image-base
Booting a Qemu X86-64 target with a OpenHarmony image
*****************************************************
Once the build is done, you can run a Qemu X86-64 instance as it follows:
Once the image is done, you can run the Qemu usin the provided script wrapper:
.. code-block:: console
$ MACHINE=qemux86-64 runqemu
If the host has a VT-capable CPU, you can pass the ``kvm`` argument for better
performance. Check ``runqemu``'s help message for all available arguments.