Tycho/Release Notes/0.19

< Previous Version | Next Version >

Detailed list of bug fixes and enhancements in 0.19.0

New and Noteworthy

Target Platform & Dependency Resolution

• (INCOMPATIBLE CHANGE) The syntax for specifying profile properties during dependency resolution was changed to the normal <key>value</key> syntax. See bug 412283 for an example.
• (INCOMPATIBLE CHANGE) system-scoped pom dependencies will now be ignored if used with pomDependencies=consider (bug 415774).
  This corner case was supported only half-way anyway. If you absolutely have to use local-only jars with pomDependencies=consider, use e.g. mvn install:install-file instead which will allow to reference them as normal (compile-scoped) pom dependencies without a hardcoded filesystem path.
• Bundle-ClassPath: external:... MANIFEST entries in referenced bundles no longer fail the build, but will be ignored with a warning now (bug 370958)
• The logging of download problems for artifacts from p2 repositories has been significantly improved.

Test Execution

• Add experimental support for test runtime provisioned by p2.
  This can be used for integration test scenarios which require a fully provisioned application (including root files, start levels, etc.), same as it would be delivered to customers.
  Example: To install product under test with ID "example.product.id", test bundle and tycho surefire test harness bundles using the p2 director, use the following pom.xml snippet in the test module:

  <plugin>
     <groupId>org.eclipse.tycho</groupId>
     <artifactId>tycho-surefire-plugin</artifactId>
     <version>${tycho-version}</version>
     <configuration>
        <testRuntime>p2Installed</testRuntime>
     </configuration>
  </plugin>
  <plugin>
     <groupId>org.eclipse.tycho</groupId>
     <artifactId>target-platform-configuration</artifactId>
     <version>${tycho-version}</version>
     <configuration>
        <dependency-resolution>
           <extraRequirements>
              <!-- add dependency  to product IU under test -->
              <requirement>
                 <type>p2-installable-unit</type>
                 <id>example.product.id</id>
                 <versionRange>0.0.0</versionRange>
              </requirement>
           </extraRequirements>
        </dependency-resolution>
     </configuration>
  </plugin>
  

  Note that testRuntime=p2Installed currently only works when testing products. You can also run tests on existing product archives built elsewhere. To do this, just make sure to extract the product archive into target/work before the tests are run(i.e. in a phase prior to integration-test). See site docs for details.

• Add suppport for runOrder parameter in tycho-surefire-plugin to run tests in random order (bug 409923)
• To avoid OSGi framework restarts caused by stale bundle cache entries (e.g. if maven clean phase is omitted), the OSGi test runtime is now launched with -Dosgi.clean=true by default (bug 415489)

Packaging

• (INCOMPATIBLE CHANGE) files included in a bundle via additionalFileSets now take precedence over bin.includes if conflicting (bug 419849)

Other

• tycho-version-plugin:set-version now also updates versions of exported packages, when the packages have the same version as the bundle version without qualifier.
• Reproducible version qualifiers based on git commit timestamps (bug 402949)
  • (INCOMPATIBLE CHANGE) By default, any uncommitted local changes will now fail the build to ensure reproducibility.
  • Configuration option jgit.dirtyWorkingTree allows to control behaviour in case of uncommitted changes detected for a module:
    • error (default): fail the build if git status is not clean. This is useful for production builds to make sure the commit timestamp build qualifier used is really reproducible
    • warning: warn about any uncommitted changes and use the current build timestamp as build qualifier for the "dirty" module. This is useful for local builds with uncommitted changes.
    • ignore: do not check whether git status is clean and use the timestamp of the last git commit as build qualifier regardless of uncommitted changes done on top. This can be used in case jgit should report a false positive dirty working tree or in case you want to restore pre-0.19.0 behaviour.
  Sample configuration:

  <plugin>
     <groupId>org.eclipse.tycho</groupId>
     <artifactId>tycho-packaging-plugin</artifactId>
     <version>${tycho.version}</version>
     <dependencies>
        <dependency>
           <groupId>org.eclipse.tycho.extras</groupId>
           <artifactId>tycho-buildtimestamp-jgit</artifactId>
           <version>${tycho-extras.version}</version>
        </dependency>
     </dependencies>
     <configuration>
        <timestampProvider>jgit</timestampProvider>
        <jgit.dirtyWorkingTree>warning</jgit.dirtyWorkingTree>
     </configuration>
  </plugin>
  

• Port tycho's JDT compiler to maven-compiler-plugin 3.x (bug 405385)
• (INCOMPATIBLE CHANGE) plugging Tycho's JDT compiler into maven-compiler-plugin 2.x is no longer supported due to incompatible plexus compiler API changes
• The versions of JDT, p2 and Equinox used by Tycho have been updated to Kepler SR1 (bug 418998)