Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Callisto Build and Update Tips and Tricks"
Line 2: | Line 2: | ||
− | + | === Automatically versioning features appropriately === | |
I haven't tried it yet, but in | I haven't tried it yet, but in | ||
Line 24: | Line 24: | ||
This is important since a feature's qualifier needs to not just change accourding to its own changes, but also needs to reflect the "most changed" plugin it contains. | This is important since a feature's qualifier needs to not just change accourding to its own changes, but also needs to reflect the "most changed" plugin it contains. | ||
− | + | === Do not use underscore in version qualifiers === | |
− | + | ||
I think this will all work better post M5, but certainly on 3.1.x streams, and underscore is converted to a hyphen in some places, and will at first seeem to work, but then there's problems associating source with its code, etc., so ... use with care, if not outright avoid. See [[https://bugs.eclipse.org/bugs/show_bug.cgi?id=89428 | bug 89428]] for some dicussions. | I think this will all work better post M5, but certainly on 3.1.x streams, and underscore is converted to a hyphen in some places, and will at first seeem to work, but then there's problems associating source with its code, etc., so ... use with care, if not outright avoid. See [[https://bugs.eclipse.org/bugs/show_bug.cgi?id=89428 | bug 89428]] for some dicussions. | ||
+ | |||
+ | === Use the platform releng tool === | ||
+ | |||
+ | To update your map files automatically while releasing your plug-ins, the releng tool found as a download way at the bottom of the platform download page is quite helpful. The instructions are sparse, but it's fairly straightforward (right-click a project and select Team -> Release...). | ||
+ | |||
+ | When using .qualifier at the end of your Bundle-Version manifest entries, your plug-ins will be versioned according to the tags entered in your map files automatically when using the release engineering tool with the PDE basebuilder. | ||
+ | |||
+ | === Guide to understanding versioning === | ||
+ | |||
+ | Just because this page cannot be linked enough, look here for detailed information on when and how to apply new version numbers to your plug-ins and features: [[http://www.eclipse.org/eclipse/platform-core/documents/plugin-versioning.html Plug-in Versioning]] |
Revision as of 12:37, 24 February 2006
On this page, please add any little tidbits that help with the versioning, site management, etc., that are not part of other documents.
Contents
Automatically versioning features appropriately
I haven't tried it yet, but in [| bug 125801 Andrew Niefer mentions that
When using ".qualifier", the resulting feature version can take the form of
1.2.3.qualifier_suffix, where qualifier will come from the cvs tag, or date the
same as for plugins. suffix will be generated based on the qualifiers of the
contained plugins.
Whether or not to append the _suffix to the version is controlled by the
property "generateFeatureVersionSuffix" in the builder's build.properties. The
default value is false.
I personally feel that generateFeatureVersionSuffix
should be the default, but since it isn't, thought I'd document here.
This is important since a feature's qualifier needs to not just change accourding to its own changes, but also needs to reflect the "most changed" plugin it contains.
Do not use underscore in version qualifiers
I think this will all work better post M5, but certainly on 3.1.x streams, and underscore is converted to a hyphen in some places, and will at first seeem to work, but then there's problems associating source with its code, etc., so ... use with care, if not outright avoid. See [| bug 89428] for some dicussions.
Use the platform releng tool
To update your map files automatically while releasing your plug-ins, the releng tool found as a download way at the bottom of the platform download page is quite helpful. The instructions are sparse, but it's fairly straightforward (right-click a project and select Team -> Release...).
When using .qualifier at the end of your Bundle-Version manifest entries, your plug-ins will be versioned according to the tags entered in your map files automatically when using the release engineering tool with the PDE basebuilder.
Guide to understanding versioning
Just because this page cannot be linked enough, look here for detailed information on when and how to apply new version numbers to your plug-ins and features: [Plug-in Versioning]