Installing Eclipse

TODO: {{#todo:SEOKWREV Make sure this is good for OE 4 (11.13.13-10:57->KY+);(11.14.13-16:25->MD+);(02.27.13-17:50->MG+);(03.04.14-16:35->BS-);(03.10.14-11:30->MD+);(03.21.14-16:35->BS+)|Michael Gloff|oe 4,mg,ky,md,bs,SEOKWREV}}

Introduction

The instructions below detail the steps to install Eclipse on to a linux PC. Before beginning the installation of Eclipse, it is important to ensure that you have the necessary tools. These tools can either be command line interface (CLI) or graphical programs. This guide provides instructions for both options.

Table 1: Conventions
/download/directory/	Placeholder indicating the directory to which the SDK archive will be downloaded.
/install/directory/	Placeholder indicating the directory to which Eclipse will be extracted. EMAC recommends that this directory be located somewhere within the development user's home directory.

Required Tools

• Web browser or other FTP-aware client
• Archiving tool. Two options are available:
  • Graphical: Ark for KDE, File Roller for GNOME
  • CLI: Tar is standard

Procedure

Install Java

Eclipse is a Java application and as such requires a Java Virtual Machine (JVM) to run. Several different JVM providers are available, including OpenJDK and Oracle Java. EMAC recommends installing OpenJDK version 6 or 7 to support the Eclipse 3.6 distribution. If you will not be doing any software development in the Java language, a Java Runtime Environment (JRE) is sufficient. Otherwise, you will need to install a Java Development Kit (JDK). See the OpenJDK or Oracle website for installing either the JVM or JDK.

Installation instructions will vary widely depending on the Linux distribution used on the development system. Most distributions, including Ubuntu and Debian, have standard packages available for OpenJDK on the distribution's software repositories. For example, to install OpenJDK6 JRE on Ubuntu or Debian run:

developer@ldc:~$ sudo apt-get install openjdk-6-jre:i386

For the JDK, install the openjdk-6-jdk:i386 package instead of the JRE.

Refer to the documentation for your distribution for more information on how to install Java for your platform.

Once Java has been installed, test the installation by verifying that the java command executes properly and reports the expected version:

developer@ldc:~$ java -version

Install Eclipse

1. Download the Eclipse 3.6 distribution from the EMAC ftp site.
2. Uncompress:
   Using a graphical archiving tool: Uncompress the archive to the chosen development directory. EMAC strongly recommends that /install/directory/ is located somewhere within the developer's home directory. For assistance with extracting the archive, please see the documentation for your archiving tool.
   

Using tar from the CLI: The tar utility has the ability to both combine and extract archives. Here, the x flag is used to tell tar to extract files from the uncompressed stream sent to it from bzip2 (bzip2 is extracting the tarball and sending it to standard output). The f flag points tar to the file to extract; since a - is passed to the f flag, the file is interpreted to be the standard input file stream instead of an actual file. The v flag indicates that tar should produce verbose output (which is why it will display the files it's processing).

developer@ldc:~$ cd /install/directory
developer@ldc:~$ bzip2 -cd /download/directory/eclipse-3.6-Linux_EMAC-rc0.tar.bz2 | tar xvf -

The list of extracted files will be output to the screen. This may take a minute to complete.

...
eclipse/
...

Execute Eclipse

Eclipse requires that the 32-bit JVM be specified in order to run. Configure the default global JVM by running:

developer@ldc:~$ sudo update-alternatives --config java

Select the i386 option. If the option is not available, ensure that a 32-bit JRE is installed.

Alternatively, specify to Eclipse which JVM to use by adding the following line to eclipse/eclipse.ini

-vm /usr/lib/jvm/java-6-openjdk-i386/jre/bin/java

Ensure that the path is correct for the JVM provider and JVM version in use. Viewing the Eclipse log, ${HOME}/workspace/.metadata/.log, can be useful for troubleshooting any problems that may arise with Eclipse. Note that there are periods before both metadata and log in that path.

If the "non-Qt version" of the SDK is installed, simply run the eclipse executable in the extracted directory to start Eclipse as shown below:

developer@ldc:~$ /install/directory/eclipse/eclipse

If the "Qt version" of the SDK is installed, Eclipse will need to be run using the emac-eclipse script included in the SDK. For example, if the SDK for the system is located at /install/directory/EMAC-OE-arm-linux-gnueabi-SDK_4.0, Eclipse could be started with the following command:

developer@ldc:~$ /install/directory/EMAC-OE-arm-linux-gnueabi-SDK_4.0/emac_eclipse

Add Eclipse to PATH

Writing /path/to/eclipse/eclipse each time to start Eclipse can become tedious. For the Qt version of the SDK, an icon will be created on your desktop which will allow the user to launch Eclipse through the emac_eclipse script with a click.

For either version of the SDK, Eclipse can be launched from the shell. The process is a little bit different for the Qt version than it is for the non-Qt version.

For the "non-Qt version":

Adding the path to the Eclipse executable to the user's PATH environment variable ensures that Eclipse can be started from within any directory on the system without having to explicitly specify the path to the executable.

developer@ldc:~$ echo 'export PATH=$PATH:/home/developer/eclipse' >> ~/.bashrc

For the "Qt version":

The emac_eclipse script will need to be run to launch Eclipse and feed it the configuration it needs to work with the Qt version of the EMAC SDK. The information for the non-Qt version, above, can additionally be used to make the Eclipse executable itself runnable from anywhere on the shell, but keep in mind that running it that way will not configure it to work with the EMAC Qt SDK.

developer@ldc:~$ echo 'export PATH=$PATH:/home/developer/EMAC-OE-arm-linux-gnueabi-SDK_4.0' >> ~/.bashrc

Next Steps

After completing the installation, continue by starting Eclipse for the first time.