Jump to: navigation, search

Difference between revisions of "Developing Tycho"

m
m
Line 3: Line 3:
 
Here is the step by step approach assuming you use a Windows OS:
 
Here is the step by step approach assuming you use a Windows OS:
 
# Get an Indigo version of [http://www.eclipse.org/downloads/index-developer.php Eclipse]
 
# Get an Indigo version of [http://www.eclipse.org/downloads/index-developer.php Eclipse]
# Add the lines
+
<ol start="2">
<pre>
+
-vm
+
<PATH_TO_JDK_HOME>\bin
+
</pre>
+
:to <tt>eclipse.ini</tt>. Important point here is that it's a JDK, not a JRE as it seems m2eclipse requires this.
+
<ol start="3">
+
 
<li> Install the following additional software into Eclipse:
 
<li> Install the following additional software into Eclipse:
 
* [http://www.eclipse.org/m2e/download/ Maven Integration for Eclipse (m2e)], version 0.13.0 or later
 
* [http://www.eclipse.org/m2e/download/ Maven Integration for Eclipse (m2e)], version 0.13.0 or later
Line 24: Line 18:
  
 
In order to build Tycho, you should use the scripts in the root of the sources:
 
In order to build Tycho, you should use the scripts in the root of the sources:
# Edit <tt>bootstrap.cmd</tt> in the <tt>sonatype-tycho/</tt> root directory and adapt the variables <tt>TYCHO_TEST_TARGET_PLATFORM</tt> -> point to Eclipse SDK 3.6.2 plus delta pack, <tt>TYCHO_M2_HOME</tt> -> point to maven 3 home directory
+
# Edit <tt>bootstrap.cmd</tt> in the <tt>sonatype-tycho/</tt> root directory and adapt the variables <tt>TYCHO_TEST_TARGET_PLATFORM</tt> -> point to Eclipse SDK 3.7.0 plus delta pack, <tt>TYCHO_M2_HOME</tt> -> point to maven 3 home directory
 
# If you want to skip long-running integration tests, comment out line <tt>mvn -f tycho-its\pom.xml clean test</tt>
 
# If you want to skip long-running integration tests, comment out line <tt>mvn -f tycho-its\pom.xml clean test</tt>
 
# Execute <tt>.\bootstrap.cmd</tt>
 
# Execute <tt>.\bootstrap.cmd</tt>

Revision as of 07:43, 15 July 2011

Tycho requires a current version of m2eclipse (0.13.0 or later) in order to import the Tycho sources into Eclipse.

Here is the step by step approach assuming you use a Windows OS:

  1. Get an Indigo version of Eclipse
  1. Install the following additional software into Eclipse:
  2. Install Maven version 3.0 or later
  3. Window > Preferences > Maven > Installations > Add... and add your maven 3 installation, activate it
  4. Get the sources from [Github|https://github.com/sonatype/sonatype-tycho]; there are different ways to do this:
  5. In Eclipse, use File > Import > Existing Maven Projects and choose the sonatype-tycho/tycho-p2-resolver and sonatype-tycho/ directories; install the proposed project configurators and restart Eclipse
  6. Optional: Select all projects, right click and choose Team > Share Project > Git
  7. The result should be an eclipse workspace without build errors. m2eclipse may take some time to download required libraries to the local repo.

In order to build Tycho, you should use the scripts in the root of the sources:

  1. Edit bootstrap.cmd in the sonatype-tycho/ root directory and adapt the variables TYCHO_TEST_TARGET_PLATFORM -> point to Eclipse SDK 3.7.0 plus delta pack, TYCHO_M2_HOME -> point to maven 3 home directory
  2. If you want to skip long-running integration tests, comment out line mvn -f tycho-its\pom.xml clean test
  3. Execute .\bootstrap.cmd

Executing integration tests in Eclipse

It is possible to start the integration tests directly from Eclipse. Note however that you will still need to build Tycho through a mvn install whenever you have made changes to the Tycho code, e.g. using the bootstrap.cmd as described above. (Background: The integration tests trigger builds of test projects -- and these builds take Tycho from it's normal location, i.e. the local Maven repository.)

Tips:

  • The integration test builds use the settings stored in tycho-its/settings.xml (they don't use the default Maven settings.xml). If you have special requirements, e.g. for proxy settings, you can edit this file. Alternatively, you can point to a different settings.xml with the system property tycho.testSettings.