Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "ETrice/Development/GettingStartedWithEtrice"

Line 1: Line 1:
= Quick Development Setup =
+
= Oomph eTrice Setup =
# Java Setup
+
#* Lastest [http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html Java SE Development Kit 7 - JDK 7] (recommended 64bit)
+
# Eclipse Setup
+
#* [https://www.eclipse.org/downloads/packages/release/Luna/SR2 Eclipse Luna SR2] (recommended Modeling Tools)
+
#* Download [http://git.eclipse.org/c/etrice/org.eclipse.etrice.git/plain/team/LunaSoftwareItems.p2f LunaSoftwareItems.p2f] to install plugins (Import -> Install -> Install Software Items from File)
+
# Clone eTrice sources into workspace (see [[ETrice/Development/Repository |Git and eTrice]])
+
# (To be added) Settings
+
  
 +
1. Download and run [https://wiki.eclipse.org/Eclipse_Installer](Oomph installer)
 +
3. Switch to advanced mode
 +
4. Select desired Eclipse product + version, e.g. Eclipse IDE for Eclipse Committer
 +
5. Download setup file [http://git.eclipse.org/c/etrice/org.eclipse.etrice.git/plain/team/ETrice.setup](ETrice.setup)
 +
6. Add eTrice.setup to catalog
  
----
+
TODO: add eTrice to official Eclipse catalog
 
+
 
+
= Development Setup with with all eTrice features =
+
# get the sources ([[ETrice/Development/Repository |see how]])
+
# download the [http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/lunasr2 Eclipse Modeling Tools package] from Luna SR2
+
# start Eclipse
+
# Install additional Plugins (if not already installed)
+
## might be already there: Apache Commons IO for file operations (e.g. for incremental code generator)
+
### Help -> Install New Software : http://download.eclipse.org/tools/orbit/downloads/drops/R20130118183705/repository/ (the link is a p2 update site of Orbit)
+
### Apache Commons IO 2.0.1
+
## Google Guava (needed for Kieler Plugins)
+
### Help -> Install New Software : Guava - http://guava-osgi.googlecode.com/svn/trunk/repository/
+
### deselect "show only the latest versions of available software", because we need an older version
+
### select Guava 8.0.0
+
## Kieler for automatic layout of graphical editors
+
### Help -> Install New Software : http://download.eclipse.org/etrice/KIELER/kieler-0.7.1
+
### if "there are no categorized items" in the list, de-select "Group items by category" -> do not forget to -> select after installation
+
### select all Kieler Plugins
+
# import all projects from your local GIT clone to your Workspace (with EGit plugin)
+
## Git Repositories View
+
## Add Repository (local GIT clone)
+
## Context Menu of Working Directory -> Import Projects
+
## Import all Projects
+
# make sure you are using a JDK (in Eclipse: Window->Preferences->Java->Installed JREs->e.g. jdk1.6.0_24), <b>attention</b>: do not use jdk1.6.0_18 or jdk1.6.0_22!
+
 
+
= Working in the Runtime Workspace =
+
* start the runtime workspace: org.eclipse.etrice.core.room.ui -> eTrice-rt.launch (contextmenu -> Run As)
+
* follow the steps in the Tutorials chapter of the eTrice online help (use Eclipse: Help > Help Contents or view the 0.3 documentation in [http://eclipse.org/etrice/documentation/doc/etrice-doc.html HTML] or as [http://eclipse.org/etrice/documentation/manual/etrice.pdf PDF])
+
  
 
= Deriving from an Existing Generator =
 
= Deriving from an Existing Generator =

Revision as of 12:15, 13 October 2017

Oomph eTrice Setup

1. Download and run [1](Oomph installer) 3. Switch to advanced mode 4. Select desired Eclipse product + version, e.g. Eclipse IDE for Eclipse Committer 5. Download setup file [2](ETrice.setup) 6. Add eTrice.setup to catalog

TODO: add eTrice to official Eclipse catalog

Deriving from an Existing Generator

There is a minimal example that shows how a generator can be derived from the existing eTrice Java generator. The example shows how the derived DetailCodeTranslator handles an additional tag.

The example consist of two plugins:

  • examples/my.etrice.generator
  • examples/my.etrice.generator.launch

You will find the examples in the eTrice GIT repository: http://git.eclipse.org/c/etrice/org.eclipse.etrice.git/tree/examples

The first one overrides the Java generator, the second one overrides the Java launch configuration to launch the derived generator. Please have a look at the comments marked with EXAMPLE: (you can add that as a Java task tag in the preferences and use the Tasks View to locate these comments).

Copyright © Eclipse Foundation, Inc. All Rights Reserved.