Jump to: navigation, search

Difference between revisions of "Tycho/Release Notes/0.16"

m
(grouped new&noteworty by topic (like on the 0.17 page))
Line 4: Line 4:
 
</css>
 
</css>
 
<div id="versionNav">[[Tycho/Release Notes/0.15|&lt; Previous Version]] | [[Tycho/Release Notes/0.17|Next Version &gt;]]</div>
 
<div id="versionNav">[[Tycho/Release Notes/0.15|&lt; Previous Version]] | [[Tycho/Release Notes/0.17|Next Version &gt;]]</div>
 +
 +
== New and Noteworthy  ==
  
 
[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]  
 
[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]  
  
== New and Noteworthy  ==
+
=== Compiler ===
  
=== New Features  ===
+
* <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>.
 +
 
 +
=== Target Platform & Dependency Resolution ===
  
 
<ul>
 
<ul>
<li>A new packaging type [[Tycho/Packaging Types#eclipse-target-definition|"eclipse-target-definition"]] for PDE target definitions has been added</li>
+
<li>A new packaging type [[Tycho/Packaging Types#eclipse-target-definition|"eclipse-target-definition"]] for PDE target definitions has been added
<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>
 
</li>
 
+
<li>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>).
<li>[[Tycho/Reproducible Version Qualifiers|Reproducible Version Qualifiers]]
+
 
</li>
 
</li>
 
+
<li>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>).
<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>
 
+
<li>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]:
<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>
+
<pre>&lt;property name="p2.atomic.composite.loading" value="false"/&gt;</pre>
 
+
</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
+
<li> 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.)
 +
  <ul>
 +
    <li>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)</li>
 +
    <li>if set to "<tt>ignore</tt>", locally built artifact are ignored</li>
 +
  </ul>
 +
</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">
 
<source lang="xml">
 
<plugin>
 
<plugin>
Line 59: Line 59:
 
</ul>
 
</ul>
  
=== Improvements and Fixes  ===
+
=== Test Execution ===
  
* 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
+
<ul>
*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>).  
+
<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>
*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>).
+
<pre>&lt;plugin&gt;
* <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>.
+
  &lt;groupId&gt;org.eclipse.tycho&lt;/groupId&gt;
*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].
+
  &lt;artifactId&gt;tycho-surefire-plugin&lt;/artifactId&gt;
* 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.
+
  &lt;version&gt;${tycho-version}&lt;/version&gt;
* 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.)
+
  &lt;configuration&gt;
** 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)
+
    &lt;parallel&gt;classes|methods|both&lt;/parallel&gt;
** if set to "<tt>ignore</tt>", locally built artifact are ignored
+
  &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>
 +
<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>
 +
</ul>
  
=== Behaviour Changes ===
+
=== Packaging ===
  
* 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]:
+
* [[Tycho/Reproducible Version Qualifiers|Reproducible Version Qualifiers]]
<pre>&lt;property name="p2.atomic.composite.loading" value="false"/&gt;</pre>
+
* 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].
 +
* 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.
  
 +
=== Other ===
 +
 +
* 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
  
 
[[Category:Tycho|Release Notes/0.16]]
 
[[Category:Tycho|Release Notes/0.16]]

Revision as of 07:05, 10 April 2013

New and Noteworthy

Complete list of bug fixes and enhancements in 0.16.0

Compiler

Target Platform & Dependency Resolution

  • A new packaging type "eclipse-target-definition" for PDE target definitions has been added
  • 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).
  • 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"/>
  • 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
  • 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>

Test Execution

  • 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.

  • 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.

Packaging

Other

  • 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