Skip to content
Snippets Groups Projects

docs: Restructure quick build section to clarify runqemu

Merged Andrei Gherzan requested to merge agherzan/oniro:ag/docs into kirkstone
1 file
+ 26
12
Compare changes
  • Side-by-side
  • Inline
+ 26
12
@@ -57,8 +57,8 @@ Initialize a repo workspace and clone all required repositories:
@@ -57,8 +57,8 @@ Initialize a repo workspace and clone all required repositories:
.. _Building an Oniro image:
.. _Building an Oniro image:
Building an Oniro image
Building and Running an Oniro image
***********************
***********************************
The following steps will build a ``oniro-image-base``. The process will
The following steps will build a ``oniro-image-base``. The process will
build all its components, including the toolchain, from source.
build all its components, including the toolchain, from source.
@@ -84,12 +84,23 @@ Oniro image or an OpenHarmony compatible one.
@@ -84,12 +84,23 @@ Oniro image or an OpenHarmony compatible one.
A. Standard Oniro image
A. Standard Oniro image
-----------------------
-----------------------
All that is left is to run the build:
As the build directory is now initialized, you can proceed to running the build
 
process:
.. code-block:: console
.. code-block:: console
$ MACHINE=qemux86-64 bitbake oniro-image-base
$ MACHINE=qemux86-64 bitbake oniro-image-base
 
Once the image is built, you can run a Qemu instance using the provided
 
script wrapper as follows:
 
 
.. code-block:: console
 
 
$ MACHINE=qemux86-64 runqemu oniro-image-base wic ovmf slirp
 
 
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.
 
.. _Building with OpenHarmony:
.. _Building with OpenHarmony:
B. Building with OpenHarmony compatibility
B. Building with OpenHarmony compatibility
@@ -110,22 +121,25 @@ the following:
@@ -110,22 +121,25 @@ the following:
This will enable OpenHarmony features and add OpenHarmony Standard System
This will enable OpenHarmony features and add OpenHarmony Standard System
features to the `oniro-image-base` image.
features to the `oniro-image-base` image.
All that is left is to run the build:
As the build directory is now initialized, you can proceed to run the build
 
process:
.. code-block:: console
.. code-block:: console
$ MACHINE=qemuarm bitbake oniro-image-base
$ MACHINE=qemuarm bitbake oniro-image-base
Booting a Qemu X86-64 Target with a |main_project_name| image
Once the image is built, you can run a Qemu instance using the provided
*************************************************************
script wrapper as follows:
Once the image is built, you can run a Qemu X86-64 instance using the provided script wrapper as follows:
.. code-block:: console
.. code-block:: console
$ MACHINE=qemux86-64 runqemu oniro-image-base wic ovmf slirp
$ MACHINE=qemuarm runqemu oniro-image-base serialstdio nographic slirp
If the host has a VT-capable CPU, you can pass the ``kvm`` argument for better
Runtime Login
performance. Check ``runqemu``'s help message for all available arguments.
*************
 
 
Once the target has booted, a login shell will prompt for a user/password
 
combination. By default, the OS uses the following:
The default user name is **oniro** with **oniro** as a password.
- user name: **oniro**
 
- password: **oniro**
Loading