diff options
Diffstat (limited to 'documentation')
| -rw-r--r-- | documentation/adt-manual/adt-prepare.xml | 54 |
1 files changed, 1 insertions, 53 deletions
diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index fd02696244..5e403aa84b 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml | |||
| @@ -9,61 +9,9 @@ | |||
| 9 | In order to use the ADT, you must install it, <filename>source</filename> a script to set up the | 9 | In order to use the ADT, you must install it, <filename>source</filename> a script to set up the |
| 10 | environment, and be sure both the kernel and filesystem image specific to the target architecture | 10 | environment, and be sure both the kernel and filesystem image specific to the target architecture |
| 11 | exist. | 11 | exist. |
| 12 | This chapter describes how to be sure you meet the ADT requirements. | ||
| 12 | </para> | 13 | </para> |
| 13 | 14 | ||
| 14 | <para> | ||
| 15 | This chapter describes two important terms and how to be sure you meet the ADT requirements. | ||
| 16 | </para> | ||
| 17 | |||
| 18 | <section id='yocto-project-files'> | ||
| 19 | <title>Yocto Project Files and Build Areas</title> | ||
| 20 | |||
| 21 | <para> | ||
| 22 | Before learning how to prepare your system for the ADT, you need to understand | ||
| 23 | two important terms used throughout this manual: | ||
| 24 | <itemizedlist> | ||
| 25 | <listitem><para><emphasis>The Yocto Project Files:</emphasis> | ||
| 26 | This term refers to the directory structure created as a result of downloading | ||
| 27 | and unpacking a Yocto Project release tarball or setting up a Git repository | ||
| 28 | by cloning <filename>git://git.yoctoproject.org/poky</filename>.</para> | ||
| 29 | <para>The Yocto Project files contain BitBake, Documentation, metadata and | ||
| 30 | other files that all support the development environment. | ||
| 31 | Consequently, you must have the Yocto Project files in place on your development | ||
| 32 | system in order to do any development using the Yocto Project.</para> | ||
| 33 | <para>The name of the top-level directory of the Yocto Project file structure | ||
| 34 | is derived from the Yocto Project release tarball. | ||
| 35 | For example, downloading and unpacking <filename>poky-edison-6.0.tar.bz2</filename> | ||
| 36 | results in a Yocto Project source tree whose Yocto Project source directory is named | ||
| 37 | <filename>poky-edison-6.0</filename>. | ||
| 38 | If you create a Git repository, then you can name the repository anything you like.</para> | ||
| 39 | <para>You can find instruction on how to set up the Yocto Project files on your | ||
| 40 | host development system by reading | ||
| 41 | the | ||
| 42 | "<ulink url='http://www.yoctoproject.org/docs/1.1/dev-manual/dev-manual.html#getting-setup'>Getting | ||
| 43 | Setup</ulink>" section in | ||
| 44 | <ulink url='http://www.yoctoproject.org/docs/1.1/dev-manual/dev-manual.html'> | ||
| 45 | The Yocto Project Development Manual</ulink>.</para></listitem> | ||
| 46 | <listitem><para><emphasis>Yocto Project Build Tree:</emphasis> | ||
| 47 | This term refers to the area where the Yocto Project builds images. | ||
| 48 | The area is created when you <filename>source</filename> the Yocto Project setup | ||
| 49 | environment script that is found in the Yocto Project files area. | ||
| 50 | (e.g. <filename>oe-init-build-env</filename>). | ||
| 51 | You can create the Yocto Project build tree anywhere you want on your | ||
| 52 | development system. | ||
| 53 | Here is an example that creates the tree in <filename>mybuilds</filename> | ||
| 54 | and names the Yocto Project build directory <filename>YP-6.0</filename>: | ||
| 55 | <literallayout class='monospaced'> | ||
| 56 | $ source poky-edison-6.0/oe-init-build-env $HOME/mybuilds/YP-6.0 | ||
| 57 | </literallayout> | ||
| 58 | If you don't specifically name the build directory, then BitBake creates it | ||
| 59 | in the current directory and uses the name <filename>build</filename>. | ||
| 60 | Also, if you supply an existing directory, then BitBake uses that | ||
| 61 | directory as the Yocto Project build directory and populates the build tree | ||
| 62 | beneath it.</para></listitem> | ||
| 63 | </itemizedlist> | ||
| 64 | </para> | ||
| 65 | </section> | ||
| 66 | |||
| 67 | <section id='installing-the-adt'> | 15 | <section id='installing-the-adt'> |
| 68 | <title>Installing the ADT</title> | 16 | <title>Installing the ADT</title> |
| 69 | 17 | ||