From 5731def9011cd77b0a984cdb8e86e12c9f8c12ce Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 10 Jul 2017 14:56:28 -0700 Subject: sdk-manual: Converted SDK build section to procedure The section needed to be a step-by-step procedure. (From yocto-docs rev: de4868c97c1199b39b3c3e68b4ff159f6546cd9e) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/sdk-manual/sdk-appendix-obtain.xml | 141 ++++++++++++++--------- 1 file changed, 85 insertions(+), 56 deletions(-) (limited to 'documentation/sdk-manual') diff --git a/documentation/sdk-manual/sdk-appendix-obtain.xml b/documentation/sdk-manual/sdk-appendix-obtain.xml index 3fae8052ac..ae30995304 100644 --- a/documentation/sdk-manual/sdk-appendix-obtain.xml +++ b/documentation/sdk-manual/sdk-appendix-obtain.xml @@ -91,65 +91,94 @@ As an alternative to locating and downloading a SDK installer, - you can build the SDK installer assuming you have first sourced - the environment setup script. - See the - "Building Images" - section in the Yocto Project Quick Start for steps that show you - how to set up the Yocto Project environment. - In particular, you need to be sure the - MACHINE - variable matches the architecture for which you are building and that - the - SDKMACHINE - variable is correctly set if you are building a toolchain designed to - run on an architecture that differs from your current development host - machine (i.e. the build machine). - - - - To build the SDK installer for a standard SDK and populate - the SDK image, use the following command: - + you can build the SDK installer. + Follow these steps: + + + Set Up the Build Environment: + Be sure you are set up to use BitBake in a shell. + See the + "Building Images" + section in the Yocto Project Quick Start for steps that + show you how to set up the Yocto Project environment. + + + Make Sure You Are Building an Installer for the Correct Machine: + Check to be sure that your + MACHINE + variable in the local.conf file in your + Build Directory + matches the architecture for which you are building. + + + Make Sure Your SDK Machine is Correctly Set: + If you are building a toolchain designed to run on an + architecture that differs from your current development host + machine (i.e. the build machine), be sure that the + SDKMACHINE + variable in the local.conf file in your + Build Directory is correctly set. + + + Build the SDK Installer: + To build the SDK installer for a standard SDK and populate + the SDK image, use the following command form. + Be sure to replace image with + an image (e.g. "core-image-sato"): + $ bitbake image -c populate_sdk - - You can do the same for the extensible SDK using this command: - + + You can do the same for the extensible SDK using this command + form: + $ bitbake image -c populate_sdk_ext - - These commands result in a SDK installer that contains the sysroot - that matches your target root filesystem. - - - - When the bitbake command completes, the SDK - installer will be in - tmp/deploy/sdk in the Build Directory. - Notes - - - By default, this toolchain does not build static binaries. - If you want to use the toolchain to build these types of - libraries, you need to be sure your SDK has the - appropriate static development libraries. - Use the - TOOLCHAIN_TARGET_TASK - variable inside your local.conf file - to install the appropriate library packages in the SDK. - Following is an example using libc - static development libraries: - + + These commands result in a SDK installer that contains the + sysroot that matches your target root filesystem. + + When the bitbake command completes, + the SDK installer will be in + tmp/deploy/sdk in the Build Directory. + Notes + + + By default, this toolchain does not build static + binaries. + If you want to use the toolchain to build these + types of libraries, you need to be sure your SDK + has the appropriate static development libraries. + Use the + TOOLCHAIN_TARGET_TASK + variable inside your local.conf + file to install the appropriate library packages + in the SDK. + Following is an example using + libc static development + libraries: + TOOLCHAIN_TARGET_TASK_append = " libc-staticdev" - - - - For additional information on building the installer, - see the - Cookbook guide to Making an Eclipse Debug Capable Image - wiki page. - - - + + + + For additional information on building the + installer, see the + Cookbook guide to Making an Eclipse Debug Capable Image + wiki page. + + + + + + Run the Installer: + You can now run the SDK installer from + tmp/deploy/sdk in the Build Directory. + Following is an example: + + $ cd ~/poky/build/tmp/deploy/sdk + ./poky-glibc-x86_64-core-image-sato-core2-64-toolchain-ext-&DISTRO;.sh + + + -- cgit v1.2.3-54-g00ecf