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.
JarProcessor Options
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:
- 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.args: A comma separated list of arguments to pass to pack200 for this jar
- pack200.default.args: A comma separated list of default 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.