Skip to main content

Notice: This Wiki is now read only and edits are no longer possible. Please see: for the plan.

Jump to: navigation, search


A category.xml file can be used to include content into a p2 repository and to specify how to display the content in the p2 installation dialog. For it to be used by a Tycho build, it needs to be placed into the root of an eclipse-repository project.

The category.xml format was originally defined by the Eclipse PDE project. There are extensions to the format only supported by p2 and Tycho.

Format overview

Stub category.xml file:

<?xml version="1.0" encoding="UTF-8"?>
   <!-- Include features -->
   <feature id="" version="1.4.100.v2009"/>
   <!-- Since Tycho 1.1.0 (, features can declare platform-specific compatibility for multi-platform builds -->
   <!-- Examples: -->
   <feature id="" version="0.0.0" os="linux"/>
   <!-- Directly include bundles, without a feature -->
   <bundle id="" version="1.3.1.v2013"/>
   <!-- Directly include any iu -->
   <iu id=""/>
   <!-- Include all IUs matching an expression -->
       <expression type="match">
           id == $0
   <!-- Categories -->
   <feature id="">
      <category name=""/>
   <category-def name="" label="Category Label">
      <description>Details on the category</description>
   <!-- example for a dynamic category -->
   <category-def name="javax" label="Bundles starting with javax."/>
      <category name="javax"/>
      <query><expression type="match">id ~= /javax.*/</expression></query>

Including artifacts

TODO details on feature, bundle, and iu (since Tycho 0.23.0) elements

Categorizing content

TODO details on category-def and category elements

Back to the top