Several methods exist that allow you to build an image within the Yocto Project. This procedure shows how to build an image using BitBake from a Linux host.
For information on how to build an image using Toaster, see the Yocto Project Toaster Manual.
For information on how to use
devtool
to build images, see the
"Using devtool
in Your SDK Workflow"
section in the Yocto Project Application Development and
the Extensible Software Development Kit (eSDK) manual.
The build process creates an entire Linux distribution from source
and places it in your
Build Directory
under tmp/deploy/images
.
For detailed information on the build process using BitBake, see the
"Images"
section in the Yocto Project Reference Manual.
You can also reference the
"Building Images"
section in the Yocto Project Quick Start.
The following figure and list overviews the build process:
![]() |
Set up Your Host Development System to Support Development Using the Yocto Project: See the "Setting Up to Use the Yocto Project" section in the Yocto Project Quick Start for options on how to get a build host ready to use the Yocto Project.
Initialize the Build Environment:
Initialize the build environment by sourcing the build
environment script (i.e.
oe-init-build-env
).
Make Sure Your local.conf
File is Correct:
Ensure the conf/local.conf
configuration
file, which is found in the
Build Directory,
is set up how you want it.
This file defines many aspects of the build environment
including the target machine architecture through the
MACHINE
variable,
the packaging format used during the build
(PACKAGE_CLASSES
),
and a centralized tarball download directory through the
DL_DIR
variable.
Build the Image:
Build the image using the bitbake
command.
For example, the following command builds the
core-image-minimal
image:
$ bitbake core-image-minimal
For information on BitBake, see the BitBake User Manual.