diff options
| author | Scott Rifenbark <srifenbark@gmail.com> | 2018-02-19 09:18:25 -0800 |
|---|---|---|
| committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2018-03-03 08:35:24 +0000 |
| commit | c46b0276229d639f376633bffe55fa292ddf613a (patch) | |
| tree | df1bed08c4e511eac76e2f5c36c6c31a101b0141 /documentation/getting-started | |
| parent | afb5009c3b6e6d5251d40db94fed7157ce52fc86 (diff) | |
| download | poky-c46b0276229d639f376633bffe55fa292ddf613a.tar.gz | |
getting-started: Added "Development Methods" section
This section introduces the ways a developer can use the Yocto
Project. They can use BitBake from a Linux shell, they can
got through CROPS, they can use Toaster, and they can use the
Eclipse IDE. The section overviews these possibilities.
(From yocto-docs rev: 95af6303364f94f91c94fd0bd1890b4e6351048e)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/getting-started')
| -rw-r--r-- | documentation/getting-started/getting-started-yp-intro.xml | 97 |
1 files changed, 95 insertions, 2 deletions
diff --git a/documentation/getting-started/getting-started-yp-intro.xml b/documentation/getting-started/getting-started-yp-intro.xml index 45c4b9ffdc..617e562753 100644 --- a/documentation/getting-started/getting-started-yp-intro.xml +++ b/documentation/getting-started/getting-started-yp-intro.xml | |||
| @@ -832,9 +832,102 @@ | |||
| 832 | </section> | 832 | </section> |
| 833 | </section> | 833 | </section> |
| 834 | 834 | ||
| 835 | <section id='the-development-environment'> | 835 | <section id='gs-development-methods'> |
| 836 | <title>The Development Environment</title> | 836 | <title>Development Methods</title> |
| 837 | 837 | ||
| 838 | <para> | ||
| 839 | The Yocto Project development environment usually involves a | ||
| 840 | <ulink url='&YOCTO_DOCS_REF_URL;#hardware-build-system-term'>Build Host</ulink> | ||
| 841 | and target hardware. | ||
| 842 | You use the Build Host to build images and develop applications, | ||
| 843 | while you use the target hardware to test deployed software. | ||
| 844 | </para> | ||
| 845 | |||
| 846 | <para> | ||
| 847 | This section provides an introduction to the choices or | ||
| 848 | development methods you have when setting up your Build Host. | ||
| 849 | Depending on the your particular workflow preference and the | ||
| 850 | type of operating system your Build Host runs, several choices | ||
| 851 | exist that allow you to use the Yocto Project. | ||
| 852 | <note> | ||
| 853 | For additional detail about the Yocto Project development | ||
| 854 | environment, see the | ||
| 855 | "<link linkend='overview-development-environment'>The Yocto Project Development Environment</link>" | ||
| 856 | chapter. | ||
| 857 | </note> | ||
| 858 | <itemizedlist> | ||
| 859 | <listitem><para> | ||
| 860 | <emphasis>Native Linux Host:</emphasis> | ||
| 861 | By far the best option for a Build Host. | ||
| 862 | A system running Linux as its native operating system | ||
| 863 | allows you to develop software by directly using the | ||
| 864 | <ulink url='&YOCTO_DOCS_REF_URL;#bitbake-term'>BitBake</ulink> | ||
| 865 | tool. | ||
| 866 | You can accomplish all aspects of development from a | ||
| 867 | familiar shell of a supported Linux distribution.</para> | ||
| 868 | |||
| 869 | <para>For information on how to set up a Build Host on | ||
| 870 | a system running Linux as its native operating system, see | ||
| 871 | TBD. | ||
| 872 | </para></listitem> | ||
| 873 | <listitem><para> | ||
| 874 | <emphasis>CROss PlatformS (CROPS):</emphasis> | ||
| 875 | Typically, you use | ||
| 876 | <ulink url='https://git.yoctoproject.org/cgit/cgit.cgi/crops/about/'>CROPS</ulink>, | ||
| 877 | which leverages | ||
| 878 | <ulink url='https://www.docker.com/'>Docker Containers</ulink>, | ||
| 879 | to set up a Build Host that is not running Linux (e.g. | ||
| 880 | <trademark class='registered'>Microsoft</trademark> | ||
| 881 | <trademark class='trademark'>Windows</trademark> | ||
| 882 | or | ||
| 883 | <trademark class='registered'>macOS</trademark>). | ||
| 884 | <note> | ||
| 885 | You can, however, use CROPS on a Linux-based system. | ||
| 886 | </note> | ||
| 887 | CROPS is an open source, cross-platform development | ||
| 888 | framework that provides an easily managed, extensible | ||
| 889 | environment for building binaries targeted for a variety | ||
| 890 | of architectures on Windows, macOS, or Linux hosts. | ||
| 891 | Once the Build Host is set up using CROPS, you can prepare | ||
| 892 | a shell environment to mimic that of a shell being used | ||
| 893 | on a system natively running Linux.</para> | ||
| 894 | |||
| 895 | <para>For information on how to set up a Build Host with | ||
| 896 | CROPS, see TBD. | ||
| 897 | </para></listitem> | ||
| 898 | <listitem><para> | ||
| 899 | <emphasis>Toaster:</emphasis> | ||
| 900 | Regardless of what your Build Host is running, you can | ||
| 901 | use Toaster to develop software using the Yocto Project. | ||
| 902 | Toaster is a web interface to the Yocto Project's | ||
| 903 | OpenEmbedded build system. | ||
| 904 | The interface enables you to configure and run your | ||
| 905 | builds. | ||
| 906 | Information about builds is collected and stored in a | ||
| 907 | database. | ||
| 908 | You can use Toaster to configure and start builds on | ||
| 909 | multiple remote build servers.</para> | ||
| 910 | |||
| 911 | <para>For information about and how to use Toaster, | ||
| 912 | see the | ||
| 913 | <ulink url='&YOCTO_DOCS_TOAST_URL;'>Toaster User Manual</ulink>. | ||
| 914 | </para></listitem> | ||
| 915 | <listitem><para> | ||
| 916 | <emphasis><trademark class='trade'>Eclipse</trademark> IDE:</emphasis> | ||
| 917 | If your Build Host supports and runs the popular | ||
| 918 | Eclipse IDE, you can install the Yocto Project Eclipse | ||
| 919 | plug-in and use the Yocto Project to develop software. | ||
| 920 | The plug-in integrates the Yocto Project functionality | ||
| 921 | into Eclipse development practices.</para> | ||
| 922 | |||
| 923 | <para>For information about how to install and use the | ||
| 924 | Yocto Project Eclipse plug-in, see the | ||
| 925 | "<ulink url='&YOCTO_DOCS_SDK_URL;#sdk-eclipse-project'>Developing Applications Using Eclipse</ulink>" | ||
| 926 | section in the Yocto Project Application Development and | ||
| 927 | the Extensible Software Development Kit (eSDK) Manual. | ||
| 928 | </para></listitem> | ||
| 929 | </itemizedlist> | ||
| 930 | </para> | ||
| 838 | </section> | 931 | </section> |
| 839 | 932 | ||
| 840 | <section id='reference-embedded-distribution'> | 933 | <section id='reference-embedded-distribution'> |
