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 Transforms"
m (→How To Run The Examples) |
|||
| Line 4: | Line 4: | ||
# download [http://fullmoon.torolab.ibm.com/downloads/drops/R-3.2.1-200609210945/index.php Eclipse 3.2.1] (or any subsequent maintenance release). While this hasn't been tested with Eclipse 3.3 yet there shouldn't be any issues with using 3.3 instead. | # download [http://fullmoon.torolab.ibm.com/downloads/drops/R-3.2.1-200609210945/index.php Eclipse 3.2.1] (or any subsequent maintenance release). While this hasn't been tested with Eclipse 3.3 yet there shouldn't be any issues with using 3.3 instead. | ||
| − | # check out the following projects from :pserver:anonymous@dev.eclipse.org:/cvsroot/eclipse | + | # check out the following projects from site :pserver:anonymous@dev.eclipse.org:/cvsroot/eclipse folder equinox-incubator: |
| + | #* ''org.eclipse.equinox.transforms'' | ||
| + | #* ''org.eclipse.equinox.transforms.sed'' | ||
| + | #* ''org.eclipse.equinox.transforms.xslt'' | ||
| + | #* ''org.eclipse.equinox.transforms.replace'' | ||
| + | #* ''org.eclipse.equinox.transforms.sed.manifest'' | ||
| + | #* ''org.eclipse.equinox.transforms.xslt.plugin'' | ||
| + | #* ''org.eclipse.equinox.transforms.replace.images'' | ||
# check out ''org.eclipse.osgi'' from :pserver:anonymous@dev.eclipse.org:/cvsroot/eclipse/ (see [https://bugs.eclipse.org/bugs/show_bug.cgi?id=143696 bug 143696] for why this is necessary) | # check out ''org.eclipse.osgi'' from :pserver:anonymous@dev.eclipse.org:/cvsroot/eclipse/ (see [https://bugs.eclipse.org/bugs/show_bug.cgi?id=143696 bug 143696] for why this is necessary) | ||
# From the Run menu, choose Run | # From the Run menu, choose Run | ||
Revision as of 15:33, 11 June 2007
Projects exist in the equinox incubator that allow you to provide transformations of bundle resources at the OSGi level. Various example transformers exist (XSLT, sed, replacement) that can be used to transform any resource in a bundle including but not limited to plugin.xml, MANIFEST.MF, class files, etc.
How To Run The Examples
- download Eclipse 3.2.1 (or any subsequent maintenance release). While this hasn't been tested with Eclipse 3.3 yet there shouldn't be any issues with using 3.3 instead.
- check out the following projects from site :pserver:anonymous@dev.eclipse.org:/cvsroot/eclipse folder equinox-incubator:
- org.eclipse.equinox.transforms
- org.eclipse.equinox.transforms.sed
- org.eclipse.equinox.transforms.xslt
- org.eclipse.equinox.transforms.replace
- org.eclipse.equinox.transforms.sed.manifest
- org.eclipse.equinox.transforms.xslt.plugin
- org.eclipse.equinox.transforms.replace.images
- check out org.eclipse.osgi from :pserver:anonymous@dev.eclipse.org:/cvsroot/eclipse/ (see bug 143696 for why this is necessary)
- From the Run menu, choose Run
- locate the example launch you wish to run and run it. They are named Replacement Transform Launch, Sed Transform Launch, and XSLT Transform Launch. Please note that the Sed launch will not work if you do not have the sed program available on your path.
How To Package Transformers for Distribution
Very rough ATM.
The transformer bundles work via adaptor hooks. As such, they are framework extensions and follow slightly different rules than other bundles. For full documentation on how to use adaptor hooks in your application please see Adaptor Hooks.
- ensure that all bundles required for the desired transformations are available. This typically means org.eclipse.equinox.transforms , the bundle implementing the desired transform type (ie: org.eclipse.equinox.transforms.xslt), and the bundle that provides the transformation file(s) (ie: org.eclipse.equinox.transforms.plugin).
- create (either from scratch or by copying one from your existing product configuration) a config.ini file that has your transformation file bundle in the osgi.bundles property with an eager start level. Ie: org.eclipse.equinox.transforms.xslt.plugin@1:\start. See the config.ini in org.eclipse.equinox.transforms.xslt for an example.
- ensure that the org.eclipse.equinox.transforms bundle and your transformation type bundles (ie: org.eclipse.equinox.transforms.xslt) are expressed as framework extension bundles in the osgi.framework.extensions VM property. Ie: -Dosgi.framework.extensions=org.eclipse.equinox.transforms,org.eclipse.equinox.transforms.xslt
How To Write Your Own Transformer
TBD