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

From Eclipsepedia

Jump to: navigation, search
(Improvements and Fixes)
m
(12 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
   #versionNav{ position:absolute; top: 0px; right: 0px; margin-right: 1em; font-size: 84%; line-height: 1.2em; color: rgb(125, 125, 125); }
 
   #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]] | Next Version &gt;</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.
+
[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]  
 
+
== SNAPSHOT builds  ==
+
 
+
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 24: Line 12:
  
 
<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>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>
 
<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;
 
<pre>&lt;plugin&gt;
Line 39: Line 28:
 
<li>[[Tycho/Reproducible Version Qualifiers|Reproducible Version Qualifiers]]
 
<li>[[Tycho/Reproducible Version Qualifiers|Reproducible Version Qualifiers]]
 
</li>
 
</li>
 +
 +
<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
 
<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
Line 71: Line 64:
 
*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 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>.
+
* <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].
 
*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.
 
* 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.considerLocal"</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 commandline and in settings.xml.  
+
* 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 not set, behaviour is unchanged (local metadata is considered by the resolver, but warn if local-only IUs were used)
+
** 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 true, consider local metadata and do not warn  about usage of locally installed IUs
+
** if set to "<tt>ignore</tt>", locally built artifact are ignored
** if set to false, ignore local-only metadata
+
 
* Removed support for disableP2Mirrors target platform configuration, use tycho.disableP2Mirrors command line parameter or settings.xml property (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=376973 bug 376973]</strike>)
+
=== 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>
  
[https://bugs.eclipse.org/bugs/buglist.cgi?list_id=2702819&query_format=advanced&target_milestone=0.16.0&product=Tycho Complete list of bugs marked for 0.16]
 
  
 
[[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

Contents

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"/>