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"

(Gradle build for eTrice tests)
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
= Oomph eTrice Setup =
 
= Oomph eTrice Setup =
  
# Download and run [https://wiki.eclipse.org/Eclipse_Installer Oomph installer]
+
Prerequisites: Java 1.8 (for developers preferably a JDK).
# Switch to ''Advanced Mode''
+
 
 +
1. Download and run [https://wiki.eclipse.org/Eclipse_Installer Oomph installer] in ''Advanced Mode''
 
[[File:eTrice_oomph_advancedMode.png|thumbnail|upright|center]]
 
[[File:eTrice_oomph_advancedMode.png|thumbnail|upright|center]]
# Select desired Eclipse product + version, e.g. ''Eclipse IDE for Eclipse Committer''
+
 
# Optional for commiters: set your shh key
+
 
 +
2. Select desired Eclipse product + version, e.g. product ''Eclipse IDE for Eclipse Committer'' and version from build config in git: [http://git.eclipse.org/c/etrice/org.eclipse.etrice.git/tree/releng/org.eclipse.etrice.parent/pom.xml Tycho/Maven pom.xml]
 +
 
 +
3. Optional for commiters: set your git ssh key
 
[[File:eTrice_oomph_etrice_ssh.png|thumbnail|upright|center]]
 
[[File:eTrice_oomph_etrice_ssh.png|thumbnail|upright|center]]
# Download setup file [http://git.eclipse.org/c/etrice/org.eclipse.etrice.git/plain/team/ETrice.setup ETrice.setup]
+
 
# Add ''eTrice.setup'' to catalog
+
 
 +
4. Download the eTrice setup file [http://git.eclipse.org/c/etrice/org.eclipse.etrice.git/plain/team/ETrice.setup ETrice.setup] and add & select it in the oomph catalog
 
[[File:eTrice_oomph_eTriceSetup.png|thumbnail|upright|center]]
 
[[File:eTrice_oomph_eTriceSetup.png|thumbnail|upright|center]]
# Configure your personal installation
+
 
 +
 
 +
6. Configure your personal installation
 
[[File:eTrice_oomph_etriceConfig.png|thumbnail|upright|center]]
 
[[File:eTrice_oomph_etriceConfig.png|thumbnail|upright|center]]
 +
  
 
TODO: add eTrice to official Eclipse catalog
 
TODO: add eTrice to official Eclipse catalog
  
= Deriving from an Existing Generator =
+
= Local Build and Tests =
 +
 
 +
Once you performed the above steps and have checked 'Build Automatically' Eclipse PDE will do the build for you and you will be able to launch a runtime workbench containing the eTrice plug-ins.
 +
 
 +
Junit based tests can be launched directly from Eclipse as usual.
  
There is a minimal example that shows how a generator can be derived from the existing eTrice Java generator.
+
However, there are also end-to-end tests for the generators which have to be executed using Gradle. In order to do so you can e.g. execute Gradle from a command shell. On windows it is recommended to substitute the root directory of the eTrice sources with a drive letter (<code>subst X: C:/path/to/etrice/sources</code>).
The example shows how the derived DetailCodeTranslator handles an additional tag.
+
  
The example consist of two plugins:
+
Then execute
* 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.
+
<code>
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).
+
gradle --rerun-tasks clean build
 +
</code>
  
 
[[Category:eTrice]]
 
[[Category:eTrice]]

Revision as of 12:10, 16 February 2018

Oomph eTrice Setup

Prerequisites: Java 1.8 (for developers preferably a JDK).

1. Download and run Oomph installer in Advanced Mode

ETrice oomph advancedMode.png


2. Select desired Eclipse product + version, e.g. product Eclipse IDE for Eclipse Committer and version from build config in git: Tycho/Maven pom.xml

3. Optional for commiters: set your git ssh key

ETrice oomph etrice ssh.png


4. Download the eTrice setup file ETrice.setup and add & select it in the oomph catalog

ETrice oomph eTriceSetup.png


6. Configure your personal installation

ETrice oomph etriceConfig.png


TODO: add eTrice to official Eclipse catalog

Local Build and Tests

Once you performed the above steps and have checked 'Build Automatically' Eclipse PDE will do the build for you and you will be able to launch a runtime workbench containing the eTrice plug-ins.

Junit based tests can be launched directly from Eclipse as usual.

However, there are also end-to-end tests for the generators which have to be executed using Gradle. In order to do so you can e.g. execute Gradle from a command shell. On windows it is recommended to substitute the root directory of the eTrice sources with a drive letter (subst X: C:/path/to/etrice/sources).

Then execute

gradle --rerun-tasks clean build

Back to the top