Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Tycho/Migration Howto"
(→Adding p2 repositories to resolve external dependencies) |
(→Getting tests to run) |
||
Line 47: | Line 47: | ||
</pre> | </pre> | ||
− | This will tell Tycho to scan for test classes and execute them during build. Note that scanning is using | + | This will tell Tycho to scan for test classes and execute them during build. Note that by default, test class scanning is using naming convention |
<tt>**/Test*.java **/*Test.java **/*TestCase.java</tt> | <tt>**/Test*.java **/*Test.java **/*TestCase.java</tt> | ||
+ | |||
+ | to find tests. | ||
For details, see the [http://eclipse.org/tycho/sitedocs/tycho-surefire/tycho-surefire-plugin/test-mojo.html Tycho Surefire docs] | For details, see the [http://eclipse.org/tycho/sitedocs/tycho-surefire/tycho-surefire-plugin/test-mojo.html Tycho Surefire docs] |
Revision as of 07:36, 5 June 2013
This page is intended to give existing projects a jumpstart for setting up a Tycho build.
While each project is different, there are some common steps:
Contents
Scaffolding: generate pom.xml files
Maven needs pom.xml files to drive the build. See Generating POM files on how to generate an initial skeleton for these files.
Manual adjustments
In the generated top-level (parent) pom.xml, it's a good idea to globally define the tycho version to use
<properties> <tycho-version>0.18.0</tycho-version> </properties>
so you can reference it using ${tycho-version} anywhere in the child pom.xml files e.g. when configuring tycho plugins. See maven project inheritance.
In case you have deeply nested projects and used several generate-poms invocations, add a top-level parent pom.xml and reference it as parent from the intermediate parent poms. Also, adjust the modules to be built (see maven project aggregation).
Adding p2 repositories to resolve external dependencies
Almost every project has external dependencies it needs to compile against. Add all p2 repositories you need for compilation or runtime in the parent pom like in the following snippet:
<repositories> <repository> <id>eclipse-juno</id> <layout>p2</layout> <url>http://download.eclipse.org/releases/juno</url> </repository> </repositories>
Getting tests to run
If your test bundle symbolic names end with .tests, the pom generator will acccordingly define
<packaging>eclipse-test-plugin</packaging>
This will tell Tycho to scan for test classes and execute them during build. Note that by default, test class scanning is using naming convention
**/Test*.java **/*Test.java **/*TestCase.java
to find tests.
For details, see the Tycho Surefire docs
Tips:
- to skip test execution temporarily, use commandline option -DskipTests
- to debug tests, use commandline option -DdebugPort=8000
- in case you are using SWTBot, see Running SWTBot tests with Tycho
- how to run a test suite