From 4972e8f49cd42c40b0f0c34ab05bdaa034dc1596 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Tue, 14 Aug 2012 13:36:32 -0700 Subject: documentation: Added install and config steps for Juno 4.2 Fixes [YOCTO #2929] Provided an updated section on how to install and configure the Eclipse IDE so that it supports both Juno 4.2 and Indigo 3.7.2. The fix included creating a new poky.ent variable that is Juno-specific. (From yocto-docs rev: 6b0b046322420f56feb644eb6de8341dfac59df2) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-model.xml | 100 +++++++++++++++++++++----- documentation/poky.ent | 1 + 2 files changed, 83 insertions(+), 18 deletions(-) (limited to 'documentation') diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml index 3bfd1a3963..32a948bb94 100644 --- a/documentation/dev-manual/dev-manual-model.xml +++ b/documentation/dev-manual/dev-manual-model.xml @@ -525,7 +525,7 @@ Application Development Workflow - Application development involves creation of an application that you want to be able + Application development involves creating an application that you want to run on your target hardware, which is running a kernel image created using the OpenEmbedded build system. The Yocto Project provides an Application Development Toolkit (ADT) and @@ -538,8 +538,8 @@ - While we strongly suggest using the ADT to develop your application, you might - not want to. + While we strongly suggest using the ADT to develop your application, this option might not + be best for you. If this is the case, you can still use pieces of the Yocto Project for your development process. However, because the process can vary greatly, this manual does not provide detail on the process. @@ -597,7 +597,7 @@ For information on pre-built kernel image naming schemes for images that can run on the QEMU emulator, see the - "Using Pre-Built Binaries and QEMU" + "Downloading the Pre-Built Linux Kernel" section in the Yocto Project Quick Start. Install the ADT: The ADT provides a target-specific cross-development toolchain, the root filesystem, @@ -635,7 +635,7 @@ Once your application is deployed, you need to test it. Within the Eclipse IDE, you can use the debubbing environment along with the set of user-space tools installed along with the ADT to debug your application. - Of course, the same user-space tools are available separately to use if you choose + Of course, the same user-space tools are available separately if you choose not to use the Eclipse IDE. @@ -646,7 +646,14 @@ The Eclipse IDE is a popular development environment and it fully supports - development using the Yocto Project. + development using the Yocto Project. + This release of the Yocto Project supports both the Juno and Indigo versions + of the Eclipse IDE. + Thus, the following information provides setup information for both versions. + + + + When you install and configure the Eclipse Yocto Project Plug-in into the Eclipse IDE, you maximize your Yocto Project experience. Installing and configuring the Plug-in results in an environment that @@ -686,9 +693,18 @@ Installing the Eclipse IDE - It is recommended that you have the Indigo 3.7.2 version of the + It is recommended that you have the Juno 4.2 version of the Eclipse IDE installed on your development system. - If you don’t have this version, you can find it at + However, if you currently have the Indigo 3.7.2 version installed and you do + not want to upgrade the IDE, you can configure Indigo to work with the + Yocto Project. + See the + "Configuring the Eclipse IDE (Indigo)" + section. + + + + If you don’t have the Juno 4.2 Eclipse IDE installed, you can find the tarball at . From that site, choose the Eclipse Classic version particular to your development host. @@ -704,22 +720,23 @@ into a clean directory using the default name eclipse: $ cd ~ - $ tar -xzvf ~/Downloads/eclipse-SDK-3.7.2-linux-gtk-x86_64.tar.gz + $ tar -xzvf ~/Downloads/eclipse-SDK-4.2-linux-gtk-x86_64.tar.gz - One issue exists that you need to be aware of regarding the Java + If you have the Indigo 3.7.2 Eclipse IDE already installed and you want to use that + version, one issue exists that you need to be aware of regarding the Java Virtual machine’s garbage collection (GC) process. The GC process does not clean up the permanent generation space (PermGen). This space stores metadata descriptions of classes. The default value is set too small and it could trigger an out-of-memory error such as the following: - + Java.lang.OutOfMemoryError: PermGen space - - + + This error causes the application to hang. @@ -727,20 +744,67 @@ To fix this issue, you can use the --vmargs - option when you start Eclipse to increase the size of the permanent generation space: + option when you start the Indigo 3.7.2 Eclipse IDE + to increase the size of the permanent generation space: eclipse --vmargs --XX:PermSize=256M -
- Configuring the Eclipse IDE +
+ Configuring the Eclipse IDE (Juno) + + + This section presents the steps needed to configure the Juno 4.2 Eclipse IDE. + If you are using Indigo 3.7.2, see the + "Configuring the Eclipse IDE (Indigo)". + + + + Before installing and configuring the Eclipse Yocto Plug-in, you need to configure + the Juno 4.2 Eclipse IDE. + Follow these general steps: + + Start the Eclipse IDE. + Make sure you are in your Workbench and select + "Install New Software" from the "Help" pull-down menu. + + Select Juno - &ECLIPSE_JUNO_URL; + from the "Work with:" pull-down menu. + Expand the box next to "Linux Tools" and select the + "LTTng - Linux Tracing Toolkit" boxes. + Expand the box next to "Mobile and Device Development" and select the + following boxes: + + C/C++ Remote Launch + Remote System Explorer End-user Runtime + Remote System Explorer User Actions + Target Management Terminal + TCF Remote System Explorer add-in + TCF Target Explorer + + Expand the box next to Programming Languages + and select the Autotools Support for CDT + and C/C++ Development Tools boxes. + Complete the installation and restart the Eclipse IDE. + + +
+ +
+ Configuring the Eclipse IDE (Indigo) + + + This section presents the steps needed to configure the Indigo 3.7.2 Eclipse IDE. + If you are using Juno 4.2, see the + "Configuring the Eclipse IDE (Juno)". + Before installing and configuring the Eclipse Yocto Plug-in, you need to configure - the Eclipse IDE. - Follow these general steps to configure Eclipse: + the Indigo 3.7.2 Eclipse IDE. + Follow these general steps: Start the Eclipse IDE. Make sure you are in your Workbench and select diff --git a/documentation/poky.ent b/documentation/poky.ent index da04b3045d..c5f61490dc 100644 --- a/documentation/poky.ent +++ b/documentation/poky.ent @@ -23,6 +23,7 @@ + -- cgit v1.2.3-54-g00ecf