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.
Developing Tycho
Revision as of 08:43, 15 July 2011 by Jan.sievers.sap.com (Talk | contribs)
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:
- Get an Indigo version of Eclipse
- Install the following additional software into Eclipse:
- Maven Integration for Eclipse (m2e), version 0.13.0 or later
- EGit Team Provider (optional)
- Install Maven version 3.0 or later
- Window > Preferences > Maven > Installations > Add... and add your maven 3 installation, activate it
- Get the sources from [Github|https://github.com/sonatype/sonatype-tycho]; there are different ways to do this:
- In EGit, open the Git Repositories view, select Clone a Git Repository and clone from the location https://github.com/sonatype/sonatype-tycho.git
- In a shell (e.g. from msysgit or Cygwin), execute git clone git://github.com/sonatype/sonatype-tycho.git
- 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
- Optional: Select all projects, right click and choose Team > Share Project > Git
- 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:
- 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
- If you want to skip long-running integration tests, comment out line mvn -f tycho-its\pom.xml clean test
- 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.