dev-manual: Updates to the "Working Within Eclipse" section.

First edits to update this section to support the Luna version of
Eclipse.  I weeded out Juno, which leaves Luna as the preferred
version and Kepler as a second version if they don't want to update
to Luna.

(From yocto-docs rev: 4f2dc237aa3498402cdf637ac2e85fdf0c3bf8a0)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2015-03-03 12:21:50 -08:00 committed by Richard Purdie
parent 1beb6fc738
commit 42f5b116da
1 changed files with 43 additions and 20 deletions

View File

@ -654,8 +654,8 @@
The Eclipse IDE is a popular development environment and it fully The Eclipse IDE is a popular development environment and it fully
supports development using the Yocto Project. supports development using the Yocto Project.
<note> <note>
This release of the Yocto Project supports both the Kepler This release of the Yocto Project supports both the Luna
and Juno versions of the Eclipse IDE. and Kepler versions of the Eclipse IDE.
Thus, the following information provides setup information for Thus, the following information provides setup information for
both versions. both versions.
</note> </note>
@ -708,18 +708,19 @@
<title>Installing the Eclipse IDE</title> <title>Installing the Eclipse IDE</title>
<para> <para>
It is recommended that you have the Kepler 4.3.2 version of It is recommended that you have the Luna SR2 (4.4.2)
the Eclipse IDE installed on your development system. version of the Eclipse IDE installed on your development
However, if you currently have the Juno 4.2 version system.
However, if you currently have the Kepler 4.3.2 version
installed and you do not want to upgrade the IDE, you can installed and you do not want to upgrade the IDE, you can
configure Juno to work with the Yocto Project. configure Kepler to work with the Yocto Project.
</para> </para>
<para> <para>
If you do not have the Kepler 4.3.2 Eclipse IDE installed, If you do not have the Luna SR2 (4.4.2) Eclipse IDE
you can find the tarball at installed, you can find the tarball at
<ulink url='&ECLIPSE_MAIN_URL;'></ulink>. <ulink url='&ECLIPSE_MAIN_URL;'></ulink>.
From that site, choose the Eclipse Standard 4.3.2 version From that site, choose the Luna SR2 4.3.2 version
particular to your development host. particular to your development host.
This version contains the Eclipse Platform, the Java This version contains the Eclipse Platform, the Java
Development Tools (JDT), and the Plug-in Development Development Tools (JDT), and the Plug-in Development
@ -734,7 +735,7 @@
using the default name <filename>eclipse</filename>: using the default name <filename>eclipse</filename>:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ cd ~ $ cd ~
$ tar -xzvf ~/Downloads/eclipse-standard-kepler-SR2-linux-gtk-x86_64.tar.gz $ tar -xzvf ~/Downloads/eclipse-java-luna-SR2-linux-gtk-x86_64.tar.gz
</literallayout> </literallayout>
</para> </para>
</section> </section>
@ -757,24 +758,32 @@
select "Install New Software" from the "Help" select "Install New Software" from the "Help"
pull-down menu.</para></listitem> pull-down menu.</para></listitem>
<listitem><para>Select <listitem><para>Select
<filename>Kepler - &ECLIPSE_KEPLER_URL;</filename> <filename>Luna - &ECLIPSE_LUNA_URL;</filename>
from the "Work with:" pull-down menu. from the "Work with:" pull-down menu.
<note> <note>
For Juno, select For Kepler, select
<filename>Juno - &ECLIPSE_JUNO_URL;</filename> <filename>Kepler - &ECLIPSE_KEPLER_URL;</filename>
</note> </note>
</para></listitem> </para></listitem>
<listitem><para>Expand the box next to "Linux Tools" <listitem><para>Expand the box next to "Linux Tools"
and select the and select the
<filename>LTTng - Linux Tracing Toolkit</filename> <filename>Linux Tools LTTng Tracer Control</filename>,
boxes.</para></listitem> <filename>Linux Tools LTTng Userspace Analysis</filename>,
and
<filename>LTTng Kernel Analysis</filename> boxes.
<note>
For Kepler, select the
<filename>LTTng - Linux Tracing Toolkit</filename>
box.
</note>
</para></listitem>
<listitem><para>Expand the box next to "Mobile and <listitem><para>Expand the box next to "Mobile and
Device Development" and select the following boxes: Device Development" and select the following boxes:
<itemizedlist> <itemizedlist>
<listitem><para><filename>C/C++ Remote Launch (Requires RSE Remote System Explorer)</filename></para></listitem> <listitem><para><filename>C/C++ Remote Launch (Requires RSE Remote System Explorer)</filename></para></listitem>
<listitem><para><filename>Remote System Explorer End-user Runtime</filename></para></listitem> <listitem><para><filename>Remote System Explorer End-user Runtime</filename></para></listitem>
<listitem><para><filename>Remote System Explorer User Actions</filename></para></listitem> <listitem><para><filename>Remote System Explorer User Actions</filename></para></listitem>
<listitem><para><filename>Target Management Terminal</filename></para></listitem> <listitem><para><filename>Target Management Terminal (Core SDK)</filename></para></listitem>
<listitem><para><filename>TCF Remote System Explorer add-in</filename></para></listitem> <listitem><para><filename>TCF Remote System Explorer add-in</filename></para></listitem>
<listitem><para><filename>TCF Target Explorer</filename></para></listitem> <listitem><para><filename>TCF Target Explorer</filename></para></listitem>
</itemizedlist></para></listitem> </itemizedlist></para></listitem>
@ -814,12 +823,12 @@
<listitem><para>Click "Add..." in the "Work with:" <listitem><para>Click "Add..." in the "Work with:"
area.</para></listitem> area.</para></listitem>
<listitem><para>Enter <listitem><para>Enter
<filename>&ECLIPSE_DL_PLUGIN_URL;/kepler</filename> <filename>&ECLIPSE_DL_PLUGIN_URL;/luna</filename>
in the URL field and provide a meaningful name in the URL field and provide a meaningful name
in the "Name" field. in the "Name" field.
<note> <note>
If you are using Juno, use If you are using Kepler, use
<filename>&ECLIPSE_DL_PLUGIN_URL;/juno</filename> <filename>&ECLIPSE_DL_PLUGIN_URL;/kepler</filename>
in the URL field. in the URL field.
</note></para></listitem> </note></para></listitem>
<listitem><para>Click "OK" to have the entry added <listitem><para>Click "OK" to have the entry added
@ -879,8 +888,13 @@
For example, if you are using Kepler, do the For example, if you are using Kepler, do the
following: following:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ git checkout kepler $ git checkout luna-master
</literallayout> </literallayout>
<note>
If you are building kepler, checkout the
<filename>kepler-master</filename>
branch.
</note>
</para></listitem> </para></listitem>
<listitem><para>Change to the <listitem><para>Change to the
<filename>scripts</filename> <filename>scripts</filename>
@ -910,6 +924,15 @@
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ ECLIPSE_HOME=/home/scottrif/eclipse-poky/scripts/eclipse ./build.sh &DISTRO_NAME; &DISTRO_NAME; $ ECLIPSE_HOME=/home/scottrif/eclipse-poky/scripts/eclipse ./build.sh &DISTRO_NAME; &DISTRO_NAME;
</literallayout> </literallayout>
<note><title>REVIEWER NOTE</title>
Here is the actual guidance from the script.
I need some help understanding this thing:
<literallayout class='monospaced'>
ECLIPSE_HOME=/home/scottrif/eclipse-poky/scripts/eclipse ./build.sh
&lt;plugin branch or tag name&gt; &lt;documentation branch or tag name&gt;
&lt;release name&gt; 2&gt;&amp;1 | tee -a build.log
</literallayout>
</note>
After running the script, the file After running the script, the file
<filename>org.yocto.sdk-</filename><replaceable>release</replaceable><filename>-</filename><replaceable>date</replaceable><filename>-archive.zip</filename> <filename>org.yocto.sdk-</filename><replaceable>release</replaceable><filename>-</filename><replaceable>date</replaceable><filename>-archive.zip</filename>
is in the current directory.</para></listitem> is in the current directory.</para></listitem>