|
|
@@ -96,12 +96,100 @@
|
|
|
</section>
|
|
|
|
|
|
<section id='setting-up-to-use-crops'>
|
|
|
- <title>Setting Up to Use CROPS</title>
|
|
|
+ <title>Setting Up to Use CROss PlatformS (CROPS)</title>
|
|
|
|
|
|
- <para role='writernotes'>
|
|
|
- Need text.
|
|
|
- With CROPS, not sure what the basic package requirements are.
|
|
|
- Need to find this out.
|
|
|
+ <para>
|
|
|
+ With
|
|
|
+ <ulink url='https://git.yoctoproject.org/cgit/cgit.cgi/crops/about/'>CROPS</ulink>,
|
|
|
+ which leverages
|
|
|
+ <ulink url='https://www.docker.com/'>Docker Containers</ulink>,
|
|
|
+ you can create a Yocto Project development environment that
|
|
|
+ is operating system agnostic.
|
|
|
+ You can set up a container in which you can develop using the
|
|
|
+ Yocto Project on a Windows, Mac, or Linux machine.
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <para>
|
|
|
+ Follow these general steps to prepare a Windows, Mac, or Linux
|
|
|
+ machine as your Yocto Project development host:
|
|
|
+ <orderedlist>
|
|
|
+ <listitem><para>
|
|
|
+ <emphasis>Go to the Docker Installation Site:</emphasis>
|
|
|
+ <ulink url='https://www.docker.com/what-docker'>Docker</ulink>
|
|
|
+ is a software container platform that you need to install
|
|
|
+ on the host development machine.
|
|
|
+ To start the installation process, see the
|
|
|
+ <ulink url='https://docs.docker.com/engine/installation/'>Docker Installation</ulink>
|
|
|
+ site.
|
|
|
+ </para></listitem>
|
|
|
+ <listitem><para>
|
|
|
+ <emphasis>Choose Your Docker Edition:</emphasis>
|
|
|
+ Docker comes in several editions.
|
|
|
+ For the Yocto Project, the stable community edition
|
|
|
+ (i.e. "Docker CE Stable") is adequate.
|
|
|
+ You can learn more about the Docker editions from the
|
|
|
+ site.
|
|
|
+ </para></listitem>
|
|
|
+ <listitem><para>
|
|
|
+ <emphasis>Go the Install Site for Your Platform:</emphasis>
|
|
|
+ Click the link for the Docker edition associated with
|
|
|
+ your development host machine's native software.
|
|
|
+ For example, if your machine is running Microsoft
|
|
|
+ Windows Version 10 and you want the Docker CE Stable
|
|
|
+ edition, click that link under "Supported Platforms".
|
|
|
+ </para></listitem>
|
|
|
+ <listitem><para>
|
|
|
+ <emphasis>Understand What You Need:</emphasis>
|
|
|
+ The install page has pre-requisites your machine must
|
|
|
+ meet.
|
|
|
+ Be sure you read through this page and make sure your
|
|
|
+ machine meets the requirements to run Docker.
|
|
|
+ If your machine does not meet the requirements, the page
|
|
|
+ has instructions to handle exceptions.
|
|
|
+ For example, to run Docker on Windows 10, you must have
|
|
|
+ the pro version of the operating system.
|
|
|
+ If you have the home version, you need to install the
|
|
|
+ <ulink url='https://docs.docker.com/toolbox/overview/#ready-to-get-started'>Docker Toolbox</ulink>.
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <para>Another example is that a Windows machine needs to
|
|
|
+ have Microsoft Hyper-V.
|
|
|
+ If you have a legacy version of the the Microsoft
|
|
|
+ operating system or for any other reason you do not have
|
|
|
+ Microsoft Hyper-V, you would have to enter the BIOS and
|
|
|
+ enable virtualization.
|
|
|
+ </para></listitem>
|
|
|
+ <listitem><para>
|
|
|
+ <emphasis>Install the Software:</emphasis>
|
|
|
+ Once you have understood all the pre-requisites, you can
|
|
|
+ download and install the appropriate software.
|
|
|
+ Follow the instructions for your specific machine and
|
|
|
+ the type of the software you need to install.
|
|
|
+ </para></listitem>
|
|
|
+ <listitem><para>
|
|
|
+ <emphasis>Optionally Orient Yourself With Dockers:</emphasis>
|
|
|
+ If you are unfamiliar with Dockers and the container
|
|
|
+ concept, you can learn more here -
|
|
|
+ <ulink url='https://docs.docker.com/get-started/'></ulink>.
|
|
|
+ You should be able to launch Docker or the Docker Toolbox
|
|
|
+ and have a terminal shell on your development host.
|
|
|
+ </para></listitem>
|
|
|
+ <listitem><para>
|
|
|
+ <emphasis>Set Up the Containers to Use the Yocto Project:</emphasis>
|
|
|
+ Go to
|
|
|
+ <ulink url='https://github.com/crops/docker-win-mac-docs/wiki'></ulink>
|
|
|
+ and follow the directions for your particular
|
|
|
+ development host (i.e. Linux, Mac, or Windows).</para>
|
|
|
+
|
|
|
+ <para>Once you complete the setup instructions for your
|
|
|
+ machine, you have the Poky, Extensible SDK, and Toaster
|
|
|
+ containers available.
|
|
|
+ You can click those links from the page and learn more
|
|
|
+ about using each of those containers.
|
|
|
+ </para></listitem>
|
|
|
+ </orderedlist>
|
|
|
+ Once you have a container set up, everything is in place to
|
|
|
+ develop just as if you were running on a native Linux machine.
|
|
|
</para>
|
|
|
</section>
|
|
|
|
Scott Rifenbark