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 "Tycho/Release Notes/0.16"

(mention new parallel test support and extensible test framework features)
m
(31 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
<css>
 
<css>
 
   #bodyContent{ position:relative; }
 
   #bodyContent{ position:relative; }
   #versionNav{ position:absolute; top: 0px; right: 0px; font-size: 84%; line-height: 1.2em; margin-right: 1em }
+
   #versionNav{ position:absolute; top: 0px; right: 0px; margin-right: 1em; font-size: 84%; line-height: 1.2em; color: rgb(125, 125, 125); }
</css>  
+
</css>
<div id="versionNav">[[Tycho/Release Notes/0.15|&lt; Previous Version]] | <font style="color:gray">Next Version &gt;</font></div>  
+
<div id="versionNav">[[Tycho/Release Notes/0.15|&lt; Previous Version]] | [[Tycho/Release Notes/0.17|Next Version &gt;]]</div>
Tycho 0.16.0 is currently in development. This page shows a preview of features which will be available in the 0.16.0 release.
+
  
== SNAPSHOT builds  ==
+
[https://bugs.eclipse.org/bugs/buglist.cgi?classification=Technology&product=Tycho&query_format=advanced&resolution=FIXED&target_milestone=0.16.0&order=bug_id&query_based_on= Complete list of bug fixes and enhancements in 0.16.0]  
 
+
To try the most recent snapshot build of 0.16.0, simply add the following snippet to your (parent) pom.xml and set tycho version to 0.16.0-SNAPSHOT.
+
<pre>&lt;pluginRepositories&gt;
+
  &lt;pluginRepository&gt;
+
    &lt;id&gt;tycho-snapshots&lt;/id&gt;
+
    &lt;url&gt;https://oss.sonatype.org/content/groups/public/&lt;/url&gt;
+
  &lt;/pluginRepository&gt;
+
&lt;/pluginRepositories&gt;
+
</pre>
+
[https://bugs.eclipse.org/bugs/buglist.cgi?classification=Technology&product=Tycho&query_format=advanced&resolution=FIXED&target_milestone=0.16.0&order=bug_id&query_based_on= List of bug fixes and enhancements in 0.16.0]  
+
  
 
== New and Noteworthy  ==
 
== New and Noteworthy  ==
Line 22: Line 11:
 
=== New Features  ===
 
=== New Features  ===
  
*Support for parallel test execution with JUnit &gt;= 4.7 has been added.<br>If you use Junit &gt;= 4.7, you can run classes or methods in parallel by adding <tt>-Dparallel=classes|methods</tt> on the commandline or by configuring<br>&lt;plugin&gt;<br> &lt;groupId&gt;org.eclipse.tycho&lt;/groupId&gt;<br> &lt;artifactId&gt;tycho-surefire-plugin&lt;/artifactId&gt;<br> &lt;version&gt;${tycho-version}&lt;/version&gt;<br> &lt;configuration&gt;<br> &lt;parallel&gt;classes|methods&lt;/parallel&gt;<br> &lt;/configuration&gt;<br>&lt;/plugin&gt;<br>Executing tests in parallel can be useful e.g. if you have long-running integration tests which are not CPU-bound.<br> Under the hood, this feature was enabled by porting the parallel features of the junit4.7 surefire provider to tycho
+
<ul>
 +
<li>A new packaging type [[Tycho/Packaging Types#eclipse-target-definition|"eclipse-target-definition"]] for PDE target definitions has been added</li>
 +
<li>Support for parallel test execution with JUnit &gt;= 4.7 has been added.<br>If you use Junit &gt;= 4.7, you can now have test classes or methods executed by several threads in parallel by adding <tt>-Dparallel=classes|methods|both</tt> on the commandline or by configuring<br>
 +
<pre>&lt;plugin&gt;
 +
  &lt;groupId&gt;org.eclipse.tycho&lt;/groupId&gt;
 +
  &lt;artifactId&gt;tycho-surefire-plugin&lt;/artifactId&gt;
 +
  &lt;version&gt;${tycho-version}&lt;/version&gt;
 +
  &lt;configuration&gt;
 +
    &lt;parallel&gt;classes|methods|both&lt;/parallel&gt;
 +
  &lt;/configuration&gt;
 +
&lt;/plugin&gt;
 +
</pre>
 +
Executing tests in parallel can be useful e.g. if you have long-running integration tests which are not CPU-bound.<br> Under the hood, this feature was enabled by porting the junit4.7 surefire provider to Tycho.
 +
</li>
  
*Support for test frameworks is extensible now. This means you can add support for test frameworks other than JUnit if you provide an implementation of [http://git.eclipse.org/c/tycho/org.eclipse.tycho.git/tree/tycho-surefire/tycho-surefire-plugin/src/main/java/org/eclipse/tycho/surefire/provider/spi/TestFrameworkProvider.java TestFrameworkProvider]
+
<li>[[Tycho/Reproducible Version Qualifiers|Reproducible Version Qualifiers]]
 +
</li>
  
<br>  
+
<li>Support for generating [http://git.eclipse.org/c/tycho/org.eclipse.tycho.extras.git/commit/?id=526be434a79a430efba50d4f54eb91ddaa6cf766 Eclipse-SourceReferences] MANIFEST headers for [[EGit/New and Noteworthy/2.0#Support_for_Eclipse-SourceReferences_manifest_headers| git]] has been added. Other SCMs can be plugged in by implementing [http://git.eclipse.org/c/tycho/org.eclipse.tycho.git/tree/tycho-packaging-plugin/src/main/java/org/eclipse/tycho/packaging/sourceref/SourceReferencesProvider.java SourceReferencesProvider].</li>
 +
 
 +
<li>Basic support for [[Tycho/Execution Environments|custom execution environment profiles]] (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=385930 bug 385930]</strike>)</li>
 +
 
 +
<li> A new plugin to validate target platforms. This plugin takes as input one or several target platforms and ensures they can be resolved, fails otherwise
 +
<source lang="xml">
 +
<plugin>
 +
  <groupId>org.eclipse.tycho.extras</groupId>
 +
  <artifactId>target-platform-validation-plugin</artifactId>
 +
  <version>${tychoExtrasVersion}</version>
 +
  <executions>
 +
      <execution>
 +
        <phase>validate</phase>
 +
        <goals>
 +
            <goal>validate-target-platform</goal>
 +
        </goals>
 +
        <configuration>
 +
            <targetFiles>
 +
              <param>indigo.target</param>
 +
              <param>juno.target</param>
 +
            </targetFiles>
 +
            <failOnError>true</failOnError>
 +
        </configuration>
 +
      </execution>
 +
  </executions>
 +
</plugin>
 +
</source>
 +
</li>
 +
</ul>
  
 
=== Improvements and Fixes  ===
 
=== Improvements and Fixes  ===
  
 +
* If several tycho versions were inadvertently mixed within the same reactor, this could lead to cryptic errors like ClassCastExceptions. This situation is now detected early and the build will fail with a clear error message
 
*Providing [[Tycho/Target Platform/Authentication and Mirrors#Credentials|credentials for a p2 repository]] specified in a target file is now more convenient – the use of the non-standard <tt>id</tt> attribute in target files is no longer necessary (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=377086 bug 377086]</strike>).  
 
*Providing [[Tycho/Target Platform/Authentication and Mirrors#Credentials|credentials for a p2 repository]] specified in a target file is now more convenient – the use of the non-standard <tt>id</tt> attribute in target files is no longer necessary (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=377086 bug 377086]</strike>).  
 
*Access to p2 repository can be [[Tycho/Target Platform/Authentication and Mirrors#Mirrors|redirected to a mirror location]]. This now works for both target files and repositories specified in the POM (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=356016 bug 356016]</strike>).
 
*Access to p2 repository can be [[Tycho/Target Platform/Authentication and Mirrors#Mirrors|redirected to a mirror location]]. This now works for both target files and repositories specified in the POM (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=356016 bug 356016]</strike>).
 +
* <tt>tycho-compiler-plugin</tt> now has a boolean option <tt>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=384113 requireJREPackageImports]</tt> which will fail the build if set to <tt>true</tt> and non-java.* packages provided by the JDK are not explicitly imported. <br/> This is the design-time equivalent of setting equinox runtime option <tt>[[Equinox Boot Delegation|osgi.compatibility.bootdelegation=false]]</tt>.
 +
*Support for test frameworks is extensible now. This means you can add support for test frameworks other than JUnit if you provide an implementation of [http://git.eclipse.org/c/tycho/org.eclipse.tycho.git/tree/tycho-surefire/tycho-surefire-plugin/src/main/java/org/eclipse/tycho/surefire/provider/spi/TestFrameworkProvider.java TestFrameworkProvider].
 +
* The [http://www.eclipse.org/tycho/sitedocs/tycho-p2/tycho-p2-director-plugin/plugin-info.html tycho-p2-director-plugin] can now create product installations which have meta-requirements on the installer. This for example allows to execute custom touchpoint actions during the installation. See the [http://git.eclipse.org/c/tycho/org.eclipse.tycho.git/tree/tycho-its/projects/product.metaRequirements integration test] for an example.
 +
* Added a property <tt>"tycho.localArtifacts"</tt> which allows to control whether artifacts installed in the local maven repository by previous tycho builds should be considered by the resolver or not. The property can be specified on the command line and in settings.xml. (See also [[Tycho/Target Platform#Locally built artifacts|this section]] in the target platform documentation.)
 +
** if unset (or set to "<tt>default</tt>"), the behaviour is unchanged (local metadata is considered by the resolver, and there is a warning if locally built units were used)
 +
** if set to "<tt>ignore</tt>", locally built artifact are ignored
 +
 +
=== Behaviour Changes ===
 +
 +
* With Tycho 0.15, if a composite site was loaded as part of the target platform resolution for a build, and some of the child sites were missing, a warning would be logged but the build would continue. With Tycho 0.16.0, the build instead fails. To recover the old behaviour, add this property to your composite*.xml files. See also [https://issues.jboss.org/browse/JBIDE-12914], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=356561#c52]:
 +
<pre>&lt;property name="p2.atomic.composite.loading" value="false"/&gt;</pre>
 +
  
 
[[Category:Tycho|Release Notes/0.16]]
 
[[Category:Tycho|Release Notes/0.16]]

Revision as of 22:13, 18 November 2012

Complete list of bug fixes and enhancements in 0.16.0

New and Noteworthy

New Features

  • A new packaging type "eclipse-target-definition" for PDE target definitions has been added
  • Support for parallel test execution with JUnit >= 4.7 has been added.
    If you use Junit >= 4.7, you can now have test classes or methods executed by several threads in parallel by adding -Dparallel=classes|methods|both on the commandline or by configuring
    <plugin>
       <groupId>org.eclipse.tycho</groupId>
       <artifactId>tycho-surefire-plugin</artifactId>
       <version>${tycho-version}</version>
       <configuration>
         <parallel>classes|methods|both</parallel>
       </configuration>
    </plugin>
    

    Executing tests in parallel can be useful e.g. if you have long-running integration tests which are not CPU-bound.
    Under the hood, this feature was enabled by porting the junit4.7 surefire provider to Tycho.

  • Reproducible Version Qualifiers
  • Support for generating Eclipse-SourceReferences MANIFEST headers for git has been added. Other SCMs can be plugged in by implementing SourceReferencesProvider.
  • Basic support for custom execution environment profiles (bug 385930)
  • A new plugin to validate target platforms. This plugin takes as input one or several target platforms and ensures they can be resolved, fails otherwise
    <plugin>
       <groupId>org.eclipse.tycho.extras</groupId>
       <artifactId>target-platform-validation-plugin</artifactId>
       <version>${tychoExtrasVersion}</version>
       <executions>
          <execution>
             <phase>validate</phase>
             <goals>
                <goal>validate-target-platform</goal>
             </goals>
             <configuration>
                <targetFiles>
                   <param>indigo.target</param>
                   <param>juno.target</param>
                </targetFiles>
                <failOnError>true</failOnError>
             </configuration>
          </execution>
       </executions>
    </plugin>

Improvements and Fixes

  • If several tycho versions were inadvertently mixed within the same reactor, this could lead to cryptic errors like ClassCastExceptions. This situation is now detected early and the build will fail with a clear error message
  • Providing credentials for a p2 repository specified in a target file is now more convenient – the use of the non-standard id attribute in target files is no longer necessary (bug 377086).
  • Access to p2 repository can be redirected to a mirror location. This now works for both target files and repositories specified in the POM (bug 356016).
  • tycho-compiler-plugin now has a boolean option requireJREPackageImports which will fail the build if set to true and non-java.* packages provided by the JDK are not explicitly imported.
    This is the design-time equivalent of setting equinox runtime option osgi.compatibility.bootdelegation=false.
  • Support for test frameworks is extensible now. This means you can add support for test frameworks other than JUnit if you provide an implementation of TestFrameworkProvider.
  • The tycho-p2-director-plugin can now create product installations which have meta-requirements on the installer. This for example allows to execute custom touchpoint actions during the installation. See the integration test for an example.
  • Added a property "tycho.localArtifacts" which allows to control whether artifacts installed in the local maven repository by previous tycho builds should be considered by the resolver or not. The property can be specified on the command line and in settings.xml. (See also this section in the target platform documentation.)
    • if unset (or set to "default"), the behaviour is unchanged (local metadata is considered by the resolver, and there is a warning if locally built units were used)
    • if set to "ignore", locally built artifact are ignored

Behaviour Changes

  • With Tycho 0.15, if a composite site was loaded as part of the target platform resolution for a build, and some of the child sites were missing, a warning would be logged but the build would continue. With Tycho 0.16.0, the build instead fails. To recover the old behaviour, add this property to your composite*.xml files. See also [1], [2]:
<property name="p2.atomic.composite.loading" value="false"/>

Back to the top