Skip to main content
Jump to: navigation, search

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

(Tycho Document Bundle Plugin)
m (New and Noteworthy)
 
(30 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
   #versionNav{ position:absolute; top: 0px; right: 0px; border-color: transparent; background: transparent; }
 
   #versionNav{ position:absolute; top: 0px; right: 0px; border-color: transparent; background: transparent; }
 
</css>  
 
</css>  
<div id="versionNav" class="alert alert-small alert-warning">[[Tycho/Release Notes/0.22|&lt; Previous Version]] | Next Version &gt;</div>  
+
<div id="versionNav" class="alert alert-small alert-warning">[[Tycho/Release Notes/0.22|&lt; Previous Version]] | [[Tycho/Release Notes/0.24|Next Version &gt;]]</div>  
  
== SNAPSHOT builds ==
+
= Milestone 0.23.1 =
  
To try out the most recent snapshot build of 0.23.0, simply add the following snippet to your (parent) pom.xml or settings.xml, and set the property for the Tycho version (e.g. <tt>tycho-version</tt>) to <tt>0.23.0-SNAPSHOT</tt>.
+
== New and Noteworthy  ==
+
<pre>
+
<pluginRepositories>
+
  <pluginRepository>
+
    <id>tycho-snapshots</id>
+
    <url>https://repo.eclipse.org/content/repositories/tycho-snapshots/</url>
+
  </pluginRepository>
+
</pluginRepositories>
+
</pre>
+
  
=== SNAPSHOT site docs ===
+
[https://bugs.eclipse.org/bugs/buglist.cgi?classification=Technology&product=Tycho&query_format=advanced&target_milestone=0.23.1&order=bug_id&query_based_on= List of bug fixes and enhancements in 0.23.1].<br/>
  
Refer to the [https://hudson.eclipse.org/tycho/job/tycho-sitedocs/ws/target/staging/index.html latest SNAPSHOT site docs for Tycho] and [https://hudson.eclipse.org/tycho/job/tycho.extras-sitedocs/ws/target/staging/index.html Tycho Extras].
+
* This patch release fixes memory consumption <strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=470074 bug 470074]</strike>
 +
* JDT/APT, Equinox and p2 bundles shipped with Tycho have been updated from Mars RC2a to Mars final (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=469090 bug 469090]</strike>). <p>In particular this means we consume [https://bugs.eclipse.org/bugs/buglist.cgi?classification=Eclipse&component=APT&component=Core&list_id=12191370&product=JDT&query_format=advanced&resolution=FIXED&target_milestone=4.5%20RC3&target_milestone=4.5%20RC4 some JDT fixes from Mars RC3 and RC4]
 +
 
 +
= Milestone 0.23.0 =
  
 
== New and Noteworthy ==
 
== New and Noteworthy ==
  
 
[https://bugs.eclipse.org/bugs/buglist.cgi?classification=Technology&product=Tycho&query_format=advanced&resolution=FIXED&target_milestone=0.23.0&order=bug_id&query_based_on= Complete list of bug fixes and enhancements in 0.23.0]
 
[https://bugs.eclipse.org/bugs/buglist.cgi?classification=Technology&product=Tycho&query_format=advanced&resolution=FIXED&target_milestone=0.23.0&order=bug_id&query_based_on= Complete list of bug fixes and enhancements in 0.23.0]
 +
 +
=== Compiler ===
 +
 +
* The JDT compiler shipped with Tycho has been updated to Mars RC2a (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=461101 bug 461101]</strike>).
 +
* The default source/target level (i.e. no BREE in MANIFEST.MF nor source/target configured in pom.xml) has been updated to 1.7 (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=464304 bug 464304]</strike>)
 +
 +
=== Packaging Type ===
 +
 +
* A new packaging type called <tt>p2-installable-unit</tt> has been added to give more flexibility to users creating custom IUs. See [[Tycho/Packaging_Types#p2-installable-unit]] for details(<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=428310 bug 428310]</strike>).
  
 
=== Packaging ===
 
=== Packaging ===
  
 
* You can now use <tt>&lt;iu&gt;</tt> elements in an eclipse-repository's category.xml to include and/or categorize arbitrary artifacts in a p2 repository ([https://bugs.eclipse.org/bugs/show_bug.cgi?id=371983 <strike>bug 371983</strike>]). See [[Tycho/category.xml]] for details.
 
* You can now use <tt>&lt;iu&gt;</tt> elements in an eclipse-repository's category.xml to include and/or categorize arbitrary artifacts in a p2 repository ([https://bugs.eclipse.org/bugs/show_bug.cgi?id=371983 <strike>bug 371983</strike>]). See [[Tycho/category.xml]] for details.
 +
* By default, Tycho will no longer add META-INF/maven/ descriptors in feature jars. With feature jars always being unpacked during installation, these can lead to path length problems on Windows (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=451279 bug 451279]</strike>)
  
=== Tycho Document Bundle Plugin ===
+
=== p2 ===
([https://bugs.eclipse.org/bugs/show_bug.cgi?id=459214 <strike>Bug 459214</strike>]) It is now possible to select which packages actually get documented by specifying include/exclude lists in the plugin configuration.
+
  
([https://bugs.eclipse.org/bugs/show_bug.cgi?id=453602 <strike>Bug 453602</strike>]) It is now possible to use a custom doclet and to specify custom doclet artifacts. The <tt>doclet</tt> parameter will be passed to javadoc as <tt>-doclet</tt>. The <tt>docletArtifacts</tt> are resolved (including the transitive depenencies) and passed to javadoc as <tt>-docletpath</tt>.
+
* The embedded p2 version has been updated to Mars RC2a. Noteworthy p2 changes:
 +
** <font color="red">(INCOMPATIBLE CHANGE)</font> Due to a change in p2 publishers, MacOS products can no longer be built using p2 repositories older than eclipse Mars. Make sure you use Mars and configure a product installation root folder ending with ".app" (see [http://git.eclipse.org/c/tycho/org.eclipse.tycho-demo.git/tree/itp04-rcp/eclipse-repository/pom.xml Tycho demo project]. If you build a MacOS product and can't update to Mars (yet), you will probably have to skip this Tycho release. We intend to add a compatibility workaround in the next release of Tycho ([https://bugs.eclipse.org/bugs/show_bug.cgi?id=463670 bug 463670])
 +
** Support for xz-compressed p2 metadata files (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=464614 bug 464614]</strike>)
 +
** Tycho will now set a specific HTTP User-Agent header including the Tycho version used when accessing p2 repositories (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=467418 bug 467418]</strike>). This can be used to analyze HTTP access logs of the servers delivering the p2 artifacts.
  
 +
=== Test Execution ===
 +
 +
* (INCOMPATIBLE CHANGE) The tycho-surefire property <tt>testSuite</tt> had been removed. If you are building a multi-bundle project and had set the <tt>testSuite</tt> and <tt>testClass</tt> property on the CLI or in a parent pom, you have to set the property <tt>failIfNoTests</tt> to <tt>false</tt>. If you had specified <tt>testSuite</tt> and <tt>testClass</tt> in the pom file of the plugin the <tt>testsClass</tt> belongs to, you just have to remove the <tt>testSuite</tt> property ([https://bugs.eclipse.org/bugs/show_bug.cgi?id=453526 <strike>bug 453526</strike>]).
 +
 +
=== Other ===
 +
 +
* Tycho now requires Java 7 (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=463433 bug 463433]</strike>). Note that this does not affect the compiler source/target level configured in your build and you can still compile against any JDK using maven toolchains.
 +
* The embedded OSGi runtime used by Tycho during build has been updated to use Equinox from Mars RC2a (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=461101 bug 461101]</strike>).
 +
* The validation of the version qualifier in the pom is more strict. The build fails with an appropriate error message if the OSGi qualifier "qualifier" is used instead of "SNAPSHOT" (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=464887 bug 464887]</strike>) and after applying the format (<tt>&lt;format&gt;</tt> property) respectively the forced qualifier value (<tt>&lt;forcedQualifier&gt;</tt> property) there is a check if it is a valid OSGi qualifier (<strike>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=464649 bug 464649]</strike>).
 +
 +
=== Additional Tools ===
 +
 +
<ul>
 +
<li> The [https://hudson.eclipse.org/tycho/view/CI/job/tycho.extras-sitedocs/ws/target/staging/tycho-document-bundle-plugin/plugin-info.html tycho-document-bundle-plugin] now allows to specify includes and excludes for the packages to be documented ([https://bugs.eclipse.org/bugs/show_bug.cgi?id=459214 <strike>bug 459214</strike>])
 +
<li> It is now possible to use a custom doclet in the [https://hudson.eclipse.org/tycho/view/CI/job/tycho.extras-sitedocs/ws/target/staging/tycho-document-bundle-plugin/plugin-info.html tycho-document-bundle-plugin] ([https://bugs.eclipse.org/bugs/show_bug.cgi?id=453602 <strike>bug 453602</strike>]). The <tt>doclet</tt> parameter will be passed to javadoc as <tt>-doclet</tt>. The <tt>docletArtifacts</tt> are resolved (including the transitive depenencies) and passed to javadoc as <tt>-docletpath</tt>.
 
Example configuration:
 
Example configuration:
<code>
+
<pre>
 
  <configuration>
 
  <configuration>
 
     <javadocOptions>
 
     <javadocOptions>
Line 50: Line 71:
 
     </javadocOptions>
 
     </javadocOptions>
 
  </configuration>
 
  </configuration>
</code>
+
</pre>
 
+
</li>
=== Test Execution ===
+
</ul>
 
+
* (INCOMPATIBLE CHANGE) The tycho-surefire property <tt>testSuite</tt> had been removed. If you are building a multi-bundle project and had set the <tt>testSuite</tt> and <tt>testClass</tt> property on the CLI or in a parent pom, you have to set the property <tt>failIfNoTests</tt> to <tt>false</tt>. If you had specified <tt>testSuite</tt> and <tt>testClass</tt> in the pom file of the plugin the <tt>testsClass</tt> belongs to, you just have to remove the <tt>testSuite</tt> property ([https://bugs.eclipse.org/bugs/show_bug.cgi?id=453526 <strike>bug 453526</strike>]).
+
 
+
 
[[Category:Tycho|Release Notes/0.23]]
 
[[Category:Tycho|Release Notes/0.23]]

Latest revision as of 02:12, 17 July 2015

Milestone 0.23.1

New and Noteworthy

List of bug fixes and enhancements in 0.23.1.

Milestone 0.23.0

New and Noteworthy

Complete list of bug fixes and enhancements in 0.23.0

Compiler

  • The JDT compiler shipped with Tycho has been updated to Mars RC2a (bug 461101).
  • The default source/target level (i.e. no BREE in MANIFEST.MF nor source/target configured in pom.xml) has been updated to 1.7 (bug 464304)

Packaging Type

Packaging

  • You can now use <iu> elements in an eclipse-repository's category.xml to include and/or categorize arbitrary artifacts in a p2 repository (bug 371983). See Tycho/category.xml for details.
  • By default, Tycho will no longer add META-INF/maven/ descriptors in feature jars. With feature jars always being unpacked during installation, these can lead to path length problems on Windows (bug 451279)

p2

  • The embedded p2 version has been updated to Mars RC2a. Noteworthy p2 changes:
    • (INCOMPATIBLE CHANGE) Due to a change in p2 publishers, MacOS products can no longer be built using p2 repositories older than eclipse Mars. Make sure you use Mars and configure a product installation root folder ending with ".app" (see Tycho demo project. If you build a MacOS product and can't update to Mars (yet), you will probably have to skip this Tycho release. We intend to add a compatibility workaround in the next release of Tycho (bug 463670)
    • Support for xz-compressed p2 metadata files (bug 464614)
    • Tycho will now set a specific HTTP User-Agent header including the Tycho version used when accessing p2 repositories (bug 467418). This can be used to analyze HTTP access logs of the servers delivering the p2 artifacts.

Test Execution

  • (INCOMPATIBLE CHANGE) The tycho-surefire property testSuite had been removed. If you are building a multi-bundle project and had set the testSuite and testClass property on the CLI or in a parent pom, you have to set the property failIfNoTests to false. If you had specified testSuite and testClass in the pom file of the plugin the testsClass belongs to, you just have to remove the testSuite property (bug 453526).

Other

  • Tycho now requires Java 7 (bug 463433). Note that this does not affect the compiler source/target level configured in your build and you can still compile against any JDK using maven toolchains.
  • The embedded OSGi runtime used by Tycho during build has been updated to use Equinox from Mars RC2a (bug 461101).
  • The validation of the version qualifier in the pom is more strict. The build fails with an appropriate error message if the OSGi qualifier "qualifier" is used instead of "SNAPSHOT" (bug 464887) and after applying the format (<format> property) respectively the forced qualifier value (<forcedQualifier> property) there is a check if it is a valid OSGi qualifier (bug 464649).

Additional Tools

  • The tycho-document-bundle-plugin now allows to specify includes and excludes for the packages to be documented (bug 459214)
  • It is now possible to use a custom doclet in the tycho-document-bundle-plugin (bug 453602). The doclet parameter will be passed to javadoc as -doclet. The docletArtifacts are resolved (including the transitive depenencies) and passed to javadoc as -docletpath. Example configuration:
     <configuration>
        <javadocOptions>
           <ignoreError>false</ignoreError>
           <doclet>foo.bar.MyDoclet</doclet>
           <docletArtifacts>
              <docletArtifact>
                 <groupId>foo.bar</groupId>
                 <artifactId>foo.bar.mydocletartifact</artifactId>
                 <version>1.0</version>
              </docletArtifact>
           </docletArtifacts>
        </javadocOptions>
     </configuration>
    

Back to the top