Developing Tycho

From Eclipsepedia

Jump to: navigation, search

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 from the commandline, 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.