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 | |
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>
-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'> |