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 "JarProcessor Options"
(→META-INF/eclipse.inf properties) |
|||
| Line 7: | Line 7: | ||
===META-INF/eclipse.inf properties=== | ===META-INF/eclipse.inf properties=== | ||
The following properties are currently read from the eclipse.inf file: | The following properties are currently read from the eclipse.inf file: | ||
| + | |||
| + | Set an exclusion property to true to use it: | ||
*jarprocesor.exclude : Exclude this jar from all processing | *jarprocesor.exclude : Exclude this jar from all processing | ||
*jarprocessor.exclude.pack : Exclude this jar pack200 | *jarprocessor.exclude.pack : Exclude this jar pack200 | ||
| Line 13: | Line 15: | ||
*jarprocessor.exclude.children.pack : Exclude children of this jar from pack200 | *jarprocessor.exclude.children.pack : Exclude children of this jar from pack200 | ||
*jarprocessor.exclude.children.sign : Exclude children of this jar from signing | *jarprocessor.exclude.children.sign : Exclude children of this jar from signing | ||
| − | + | <br> | |
| − | *pack200.args: | + | Pack200 arguments properties are comma separated lists of arguments: |
| − | *pack200.default.args: | + | *pack200.args: Arguments to pass to pack200 for this jar |
| − | + | *pack200.default.args: Arguments to use for pack200 on any nested jars if they don't specify their own pack200.args. | |
| + | <br> | ||
The Jar Processor will also write the following properties to the eclipse.inf file: | The Jar Processor will also write the following properties to the eclipse.inf file: | ||
*pack200.conditioned: Indicates that this jar has been conditioned with pack200 | *pack200.conditioned: Indicates that this jar has been conditioned with pack200 | ||
Revision as of 17:22, 3 November 2006
When processing a given jar, there 3 places that the jar processor looks for properties to control the processing:
- In the Jar's META-INF/eclipse.inf file
- If the jar is a nested jar, then in the containing jars' META-INF/eclipse.inf files.
- In the top level pack.properties placed in the input zip or directory.
META-INF/eclipse.inf properties
The following properties are currently read from the eclipse.inf file:
Set an exclusion property to true to use it:
- jarprocesor.exclude : Exclude this jar from all processing
- jarprocessor.exclude.pack : Exclude this jar pack200
- jarprocessor.exclude.sign : Exclude this jar from signing
- jarprocessor.exclude.children : Exclude children of this jar from all processing
- jarprocessor.exclude.children.pack : Exclude children of this jar from pack200
- jarprocessor.exclude.children.sign : Exclude children of this jar from signing
Pack200 arguments properties are comma separated lists of arguments:
- pack200.args: Arguments to pass to pack200 for this jar
- pack200.default.args: Arguments to use for pack200 on any nested jars if they don't specify their own pack200.args.
The Jar Processor will also write the following properties to the eclipse.inf file:
- pack200.conditioned: Indicates that this jar has been conditioned with pack200
- pack200.args: The arguments that were passed to pack200 when conditioning this jar.
Notice that pack200.args is both input and output.
pack.properties
The following properties are understood from the pack.properties file:
- sign.excludes: A comma separated list of jar names to exclude from signing.
- pack.excludes: A comma separated list of jar names to exclude from packing.
Both of the above properties over-ride anything in the eclipse.inf files. The full jar name must be specified (eg: org.eclipse.update.core_3.2.0.v20092006-1400.jar)
- pack200.default.args: The default arguments to use with pack200. Values specified in the eclipse.inf files will over-ride this.
Other properties
By setting a vm system property "org.eclipse.update.jarprocessor.pack200" you can control which pack200 (or unpack200) command is used by the processing. Possible values are:
- @jre : ${JAVA_HOME}/bin/pack200
- @path : Use the first pack200 on the system search path
- @none : Do not use pack200.
- <directory> : The directory in which to find a pack200 command.
If this property is not set, the jar processor will look first in ${JAVA_HOME}\bin and then on the system search path.