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.
Difference between revisions of "Equinox/p2/Publisher"
(→Getting Involved) |
(→Features And Bundles Publisher Application) |
||
Line 23: | Line 23: | ||
</tt> | </tt> | ||
− | In this example, the plugins in /<location with a plugin and feature directory>/plugins and features in <location with a plugin and feature directory>/features | + | In this example, the plugins in '''/<location with a plugin and feature directory>/plugins''' and features in '''/<location with a plugin and feature directory>/features''' will be published in the '''file:/<some location>/repository''' repository. The artifacts will also be published, and the repositories (artifacts.xml and content.xml) compressed. |
===Product Publisher=== | ===Product Publisher=== |
Revision as of 15:38, 7 May 2009
The Publisher is the means by which deployable entities get added to repositories. It consists of an extensible set of publishing actions, applications and Ant tasks that allow users to generate p2 repositories from a number of different sources.
Contents
Headless Applications
The Publisher consists of a number of headless (no GUI) Eclipse Applications that can be used to generate metadata from a variety of sources. Examples of such applications include:
- FeaturesAndBundles Publisher: Generates metadata from a set of features and bundles
- Product Publisher: Generates metadata from a .product file
- Category Publisher: Generates categories for an existing repository
- UpdateSite Publisher: Generates metadata from an UpdateSite
- Install Publisher: Generates metadata from an existing Eclipse install
Features And Bundles Publisher Application
The Features and Bundles Publisher Application (org.eclipse.equinox.p2.publisher.eclipse.FeaturesAndBundlesPublisherApplication) is a headless application that is capable of generating metadata (p2 repositories) from pre-build Eclipse bundles and features. The application can be invoked as follows:
java -jar <targetProductFolder>/plugins/org.eclipse.equinox.launcher_*.jar -application org.eclipse.equinox.p2.publisher.eclipse.FeaturesAndBundlesPublisherApplication -metadataRepository file:/<some location>/repository -artifactRepository file:/<some location>/repository -source /<location with a plugin and feature directory> -compress -publishArtifacts
In this example, the plugins in /<location with a plugin and feature directory>/plugins and features in /<location with a plugin and feature directory>/features will be published in the file:/<some location>/repository repository. The artifacts will also be published, and the repositories (artifacts.xml and content.xml) compressed.
Product Publisher
The Product Publisher Application (org.eclipse.equinox.p2.publisher.eclipse.ProductPublisherApplication) is a headless application that is capable of generating product configuration metadata. The product publisher does not publish the bundles or features that constitute the product. The application c
Ant Tasks
TODO: Add information about the ANT Tasks the Publisher provides
PDE Build
TODO: Add information about how to publish repositories using PDE Build. There is also some information about the ANT tasks PDE build provides at: PDE Ant Tasks
Extensible API
Getting Involved
There are a number of ways to get involved with the development of The Publisher. In particular:
- Experiment with and give feedback on the publisher's provisional API
- Ensure the publisher Java Docs are accurate (and provide feedback / patches where needed)
- Experiment with the publisher's ANT tasks and headless applications
- Review the list of outstanding publisher bugs Open Publisher Bugs
The publisher developer discusses take place on the p2-dev list