diff options
| -rw-r--r-- | documentation/sdk-manual/sdk-appendix-obtain.xml | 47 |
1 files changed, 44 insertions, 3 deletions
diff --git a/documentation/sdk-manual/sdk-appendix-obtain.xml b/documentation/sdk-manual/sdk-appendix-obtain.xml index 0bb5dd2497..eb57938a42 100644 --- a/documentation/sdk-manual/sdk-appendix-obtain.xml +++ b/documentation/sdk-manual/sdk-appendix-obtain.xml | |||
| @@ -105,9 +105,50 @@ | |||
| 105 | <emphasis>Set Up the Build Environment:</emphasis> | 105 | <emphasis>Set Up the Build Environment:</emphasis> |
| 106 | Be sure you are set up to use BitBake in a shell. | 106 | Be sure you are set up to use BitBake in a shell. |
| 107 | See the | 107 | See the |
| 108 | "<ulink url='&YOCTO_DOCS_QS_URL;#qs-building-images'>Building Images</ulink>" | 108 | "<ulink url='&YOCTO_DOCS_DEV_URL;#setting-up-the-development-host-to-use-the-yocto-project'>Setting Up the Development Host to Use the Yocto Project</ulink>" |
| 109 | section in the Yocto Project Quick Start for steps that | 109 | section in the Yocto Project Development Manual for information |
| 110 | show you how to set up the Yocto Project environment. | 110 | on how to get a build host ready that is either a native |
| 111 | Linux machine or a machine that uses CROPS. | ||
| 112 | </para></listitem> | ||
| 113 | <listitem><para> | ||
| 114 | <emphasis>Clone the <filename>poky</filename> Repository:</emphasis> | ||
| 115 | You need to have a local copy of the Yocto Project | ||
| 116 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> | ||
| 117 | (i.e. a local <filename>poky</filename> repository). | ||
| 118 | See the | ||
| 119 | "<ulink url='&YOCTO_DOCS_DEV_URL;#cloning-the-poky-repository'>Cloning the <filename>poky</filename> Repository</ulink>" | ||
| 120 | and possibly the | ||
| 121 | "<ulink url='&YOCTO_DOCS_DEV_URL;#checking-out-by-branch-in-poky'>Checking Out by Branch in Poky</ulink>" | ||
| 122 | and | ||
| 123 | "<ulink url='&YOCTO_DOCS_DEV_URL;#checkout-out-by-tag-in-poky'>Checking Out by Tag in Poky</ulink>" | ||
| 124 | sections all in the Yocto Project Development Manual for | ||
| 125 | information on how to clone the <filename>poky</filename> | ||
| 126 | repository and check out the appropriate branch for your work. | ||
| 127 | </para></listitem> | ||
| 128 | <listitem><para> | ||
| 129 | <emphasis>Initialize the Build Environment:</emphasis> | ||
| 130 | While in the root directory of the Source Directory (i.e. | ||
| 131 | <filename>poky</filename>), run the | ||
| 132 | <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink> | ||
| 133 | environment setup script to define the OpenEmbedded | ||
| 134 | build environment on your build host. | ||
| 135 | <literallayout class='monospaced'> | ||
| 136 | $ source &OE_INIT_FILE; | ||
| 137 | </literallayout> | ||
| 138 | Among other things, the script creates the | ||
| 139 | <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>, | ||
| 140 | which is <filename>build</filename> in this case | ||
| 141 | and is located in the | ||
| 142 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>. | ||
| 143 | After the script runs, your current working directory | ||
| 144 | is set to the <filename>build</filename> directory. | ||
| 145 | <note> | ||
| 146 | For information on running a memory-resident | ||
| 147 | <ulink url='&YOCTO_DOCS_REF_URL;#usingpoky-components-bitbake'>BitBake</ulink>, | ||
| 148 | see the | ||
| 149 | <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink> | ||
| 150 | setup script. | ||
| 151 | </note> | ||
| 111 | </para></listitem> | 152 | </para></listitem> |
| 112 | <listitem><para> | 153 | <listitem><para> |
| 113 | <emphasis>Make Sure You Are Building an Installer for the Correct Machine:</emphasis> | 154 | <emphasis>Make Sure You Are Building an Installer for the Correct Machine:</emphasis> |