dev-manual: Updated "Building Images" section

Fixes [YOCTO #11630]

I re-wrote the "Building Images" section into a "Performing
a Simple Build" section.  A single link in the common tasks
chapter was affected by the section name change.

(From yocto-docs rev: de5a4cfa4f63538fe0a5ec0c2aacfb9222b70c4b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2017-06-28 10:02:34 -07:00
committed by Richard Purdie
parent b7356ec7f9
commit 15a41d25e9

View File

@@ -730,45 +730,61 @@
</section> </section>
</section> </section>
<section id='building-images'> <section id='performing-a-simple-build'>
<title>Building Images</title> <title>Performing a Simple Build</title>
<para> <para>
The build process creates an entire Linux distribution, including the toolchain, from source. The build process creates an entire Linux distribution,
including the toolchain, from source.
For more information on this topic, see the For more information on this topic, see the
"<ulink url='&YOCTO_DOCS_QS_URL;#qs-building-images'>Building Images</ulink>" "<ulink url='&YOCTO_DOCS_QS_URL;#qs-building-images'>Building Images</ulink>"
section in the Yocto Project Quick Start. section in the Yocto Project Quick Start.
</para> </para>
<para> <para>
The build process is as follows: Following are the high-level steps for performing a simple build
using the Yocto Project:
<orderedlist> <orderedlist>
<listitem><para>Make sure you have set up the Source Directory described in the <listitem><para>
previous section.</para></listitem> <emphasis>Set Up Your Source Directories:</emphasis>
<listitem><para>Initialize the build environment by sourcing a build Make sure you have set up the Source Directory described in the
"<link linkend='cloning-the-poky-repository'>Cloning the <filename>poky</filename> Repository</link>"
section.
</para></listitem>
<listitem><para>
<emphasis>Initialize the Build Environment:</emphasis>
Initialize the build environment by sourcing a build
environment script (i.e. environment script (i.e.
<ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink> <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
or or
<ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>). <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>).
</para></listitem> </para></listitem>
<listitem><para>Optionally ensure the <filename>conf/local.conf</filename> configuration file, <listitem><para>
which is found in the <emphasis>Make Sure Your <filename>local.conf</filename>
File is Correct:</emphasis>
Ensure the <filename>conf/local.conf</filename> configuration
file, which is found in the
<ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>, <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>,
is set up how you want it. is set up how you want it.
This file defines many aspects of the build environment including This file defines many aspects of the build environment
the target machine architecture through the including the target machine architecture through the
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'>MACHINE</ulink></filename> variable, <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'>MACHINE</ulink></filename> variable,
the packaging format used during the build the packaging format used during the build
(<ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGE_CLASSES'><filename>PACKAGE_CLASSES</filename></ulink>), (<ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGE_CLASSES'><filename>PACKAGE_CLASSES</filename></ulink>),
and a centralized tarball download directory through the and a centralized tarball download directory through the
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-DL_DIR'>DL_DIR</ulink></filename> variable.</para></listitem> <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-DL_DIR'>DL_DIR</ulink></filename> variable.
</para></listitem>
<listitem><para> <listitem><para>
<emphasis>Build the Image:</emphasis>
Build the image using the <filename>bitbake</filename> command. Build the image using the <filename>bitbake</filename> command.
If you want information on BitBake, see the For example, the following command builds the
<filename>core-image-minimal</filename> image:
<literallayout class='monospaced'>
$ bitbake core-image-minimal
</literallayout>
For information on BitBake, see the
<ulink url='&YOCTO_DOCS_BB_URL;'>BitBake User Manual</ulink>. <ulink url='&YOCTO_DOCS_BB_URL;'>BitBake User Manual</ulink>.
</para></listitem> </para></listitem>
<listitem><para>Run the image either on the actual hardware or using the QEMU
emulator.</para></listitem>
</orderedlist> </orderedlist>
</para> </para>
</section> </section>