From cbda3472e371c24a38d1e7b49cd718fffd6ddb25 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 16 May 2018 14:23:23 -0700 Subject: dev-manual: Moved the "Simple Build" section I had a section on building an image up in chapter that talks about getting set up to use YP. I moved the build section to a new parent section that will hold topics on building various things. I renamed the section to "Building a Simple Image". I had to fix several links in the sdk-manual, overview-manual, and dev-manual. (From yocto-docs rev: c119fc7c6148e7b08acad374fe2981842e9462a3) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../dev-manual/dev-manual-common-tasks.xml | 165 +++++++++++++++++++++ documentation/dev-manual/dev-manual-start.xml | 140 ----------------- 2 files changed, 165 insertions(+), 140 deletions(-) (limited to 'documentation/dev-manual') diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index c781286df3..9f993d21e3 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -5163,6 +5163,171 @@ +
+ Building + + + This section describes various build procedures. + For example, the steps needed for a simple build, a target that + uses multiple configurations, building an image for more than + one machine, and so forth. + + +
+ Building a Simple Image + + + In the development environment, you need to build an image + whenever you change hardware support, add or change system + libraries, or add or change services that have dependencies. + Several methods exist that allow you to build an image within + the Yocto Project. + This section presents the basic steps you need to build a + simple image using BitBake from a build host running Linux. + Notes + + + For information on how to build an image using + Toaster, + see the + Toaster User 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. + + + For a quick example on how to build an image using + the OpenEmbedded build system, see the + Yocto Project Quick Build + document. + + + + + + + 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 Overview and Concepts Manual. + + + + 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 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_FILE;): + + $ source &OE_INIT_FILE; [build_dir] + + + When you use the initialization script, the + OpenEmbedded build system uses + build as the default Build + Directory in your current work directory. + You can use a build_dir + argument with the script to specify a different build + directory. + Tip + A common practice is to use a different Build + Directory for different targets. + For example, ~/build/x86 for a + qemux86 target, and + ~/build/arm for a + qemuarm target. + + + + 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: + + $ bitbake target + + + For information on BitBake, see the + BitBake User Manual. + + The target is the name of the + recipe you want to build. + Common targets are the images in + meta/recipes-core/images, + meta/recipes-sato/images, and so + forth all found in the + Source Directory. + Or, the target can be the name of a recipe for a + specific piece of software such as BusyBox. + For more details about the images the OpenEmbedded build + system supports, see the + "Images" + chapter in the Yocto Project Reference Manual. + + As an example, the following command builds the + core-image-minimal image: + + $ bitbake core-image-minimal + + Once an image has been built, it often needs to be + installed. + The images and kernels built by the OpenEmbedded + build system are placed in the Build Directory in + tmp/deploy/images. + For information on how to run pre-built images such as + qemux86 and qemuarm, + see the + Yocto Project Application Development and the Extensible Software Development Kit (eSDK) + manual. + For information about how to install these images, + see the documentation for your particular board or + machine. + + + +
+
+ + + + + + +
Building Targets with Multiple Configurations diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index a1b502b8eb..201cbe7340 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -1080,146 +1080,6 @@
-
- Building an Image - - - In the development environment, you need to build an image whenever - you change hardware support, add or change system libraries, or add - or change services that have dependencies. - Several methods exist that allow you to build an image within the - Yocto Project. - This section shows you how to build an image using BitBake from a - Linux host. - Notes - - - For information on how to build an image using - Toaster, - see the - Toaster User 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. - - - For a quick example on how to build an image using the - OpenEmbedded build system, see the - Yocto Project Quick Build - document. - - - - - - - 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 Overview and Concepts Manual. - - - - 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 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_FILE;): - - $ source &OE_INIT_FILE; [build_dir] - - - When you use the initialization script, the - OpenEmbedded build system uses build as - the default Build Directory in your current work directory. - You can use a build_dir argument - with the script to specify a different build directory. - Tip - A common practice is to use a different Build Directory for - different targets. - For example, ~/build/x86 for a - qemux86 target, and - ~/build/arm for a - qemuarm target. - - - - 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: - - $ bitbake target - - - For information on BitBake, see the - BitBake User Manual. - - The target is the name of the - recipe you want to build. - Common targets are the images in - meta/recipes-core/images, - meta/recipes-sato/images, etc. all found - in the - Source Directory. - Or, the target can be the name of a recipe for a specific - piece of software such as BusyBox. - For more details about the images the OpenEmbedded build - system supports, see the - "Images" - chapter in the Yocto Project Reference Manual. - - As an example, the following command builds the - core-image-minimal image: - - $ bitbake core-image-minimal - - Once an image has been built, it often needs to be installed. - The images and kernels built by the OpenEmbedded build system - are placed in the Build Directory in - tmp/deploy/images. - For information on how to run pre-built images such as - qemux86 and qemuarm, - see the - Yocto Project Application Development and the Extensible Software Development Kit (eSDK) - manual. - For information about how to install these images, see the - documentation for your particular board or machine. - - - -
-
Speeding Up the Build -- cgit v1.2.3-54-g00ecf