summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-02-19 09:18:25 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2018-03-03 08:35:24 +0000
commitc46b0276229d639f376633bffe55fa292ddf613a (patch)
treedf1bed08c4e511eac76e2f5c36c6c31a101b0141 /documentation
parentafb5009c3b6e6d5251d40db94fed7157ce52fc86 (diff)
downloadpoky-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')
-rw-r--r--documentation/getting-started/getting-started-yp-intro.xml97
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'>