Difference between revisions of "EATOP/environment"

Revision as of 11:21, 15 December 2014

Setting up an Eclipse IDE

Download and install Eclipse IDE for Automotive Software Developers version Luna.

As the memory which is provided to Eclipse by default is much too less for the following steps, the eclipse.ini file (same location as the eclipse.exe) has to be adapted to the requirements.

The most important change is to set the maximum heap-size (-Xmx parameter) to at least 1024. Otherwise eclipse will hang up during the ‘resolve target’ process (step 4 of this guide).

Here an example for the eclipse.ini file:

-startup
plugins/org.eclipse.equinox.launcher_1.3.0.v20140415-2008.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.200.v20140603-1326
-product
org.eclipse.epp.package.automotive.product
--launcher.defaultAction
openFile
--launcher.XXMaxPermSize
512M
-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
512m
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vmargs
-Dosgi.requiredJavaVersion=1.7
-Xms256m
-Xmx1024m

Install EGit in Eclipse

The recommended way to clone and import the source code of Sphinx and EATOP is to use EGit - the Eclipse Team provider for Git:

• Click Help > Eclipse Marketplace
• Search for EGit and install the plugin
• To open the Git view: Click Window > Show View > Other ... Git > Git Repositories
• Open the Git Repository Exploring perspective

Getting the source code

Git repository access

The source code of EATOP is managed in a Git repository that can be accessed in one of the following ways:

Read-only access:

• URL: http://git.eclipse.org/c/eatop/org.eclipse.eatop.git
• User name: <leave empty>
• Password: <leave empty>

Commiter access:

• URL: ssh://git.eclipse.org/c/eatop/org.eclipse.eatop.git
• User name: <YOUR_USER_NAME>
• Password: <YOUR_PASSWORD>

Cloning and importing the source code with EGit

The recommended way to clone and import the source code of EATOP is to use EGit - the Eclipse Team provider for Git:

• Open the Git Repository Exploring perspective
• Click on the Clone a Git Repository and add the clone to this view button
• Enter the Git repository access data using one of the options indicated above, and then click on Next
• Select the relevant Git repository branches (e.g. master), and then click on Next
• Make sure that Import all existing projects after clone finishes is checked and then click on Finish
• Wait until the cloning process has been completed and go back to the Plug-in Development perspective

Setting the target platform

EATOP provides target platform definitions for the two latest Eclipse releases. These target definitions are in the project org.eclipse.eatop.targets which is part of the Tools working set.

• Open the target definition file xxx.target that corresponds to the Eclipse release you want to work with;
• Wait for the completion of the Resolving Target Definition operation. This may take a while, in particular at the first time, because all directly and indirectly required target platform plug-ins and features are being downloaded or updated as necessary during that operation. If errors occur, try to close and reopen the target definition file so as to re-trigger the target platform resolution;
• Click on link Set as Target Platform (in the upper right corner of the target editor).