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 "Developing Tycho"

m
(Replaced content with "See https://github.com/eclipse/tycho/blob/master/CONTRIBUTING.md")
 
(54 intermediate revisions by 12 users not shown)
Line 1: Line 1:
Tycho requires a current version of m2eclipse (0.13.0 or later) in order to import the Tycho sources into Eclipse.
+
See https://github.com/eclipse/tycho/blob/master/CONTRIBUTING.md
 
+
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]
+
<ol start="2">
+
<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/egit/download/ EGit Team Provider] (optional)
+
<li> Install [http://maven.apache.org/download.html Maven] version 3.0 or later
+
<li> '''Window > Preferences > Maven > Installations > Add...''' and add your maven 3 installation, activate it
+
<li> 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 [http://code.google.com/p/msysgit/ msysgit] or [http://cygwin.com/ Cygwin]), execute <tt>git clone git://github.com/sonatype/sonatype-tycho.git</tt>
+
<li> In Eclipse, use '''File > Import > Existing Maven Projects''' and choose the <tt>sonatype-tycho/tycho-p2-resolver</tt> and <tt>sonatype-tycho/</tt> directories; install the proposed project configurators and restart Eclipse
+
<li> Optional: Select all projects, right click and choose '''Team > Share Project > Git'''
+
<li> The result should be an eclipse workspace without build errors. m2eclipse may take some time to download required libraries to the local repo.
+
</ol>
+
 
+
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.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>
+
# Execute <tt>.\bootstrap.cmd</tt>
+
 
+
== 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 <tt>mvn install</tt> whenever you have made changes to the Tycho code, e.g. using the <tt>bootstrap.cmd</tt> 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 <tt>tycho-its/settings.xml</tt> (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 <tt>tycho.testSettings</tt>.
+
 
+
[[Category:Tycho]]
+

Latest revision as of 18:35, 8 April 2021

See https://github.com/eclipse/tycho/blob/master/CONTRIBUTING.md

Back to the top