-export instruction can be used to export a
bnd file to an executable JAR during the build process. In contrast to the export functions, this
-export instruction is supported in all drivers, including Eclipse. It can be used to continously build executable JARs or other supported exporters. It can only be used in the top level bnd.bnd file.
The format of the
-export instruction is:
-export ::= filespec ( ',' filespec )* filespec ::= path (';' PARAMATER )*
path is either a relative path in the project directory or it is a wildcard specification using globs. All files in the project directory are selected. In general, these should be bnd or bndrun files.
The following attributes are architected:
type– The type specifies the exporter type. The default type is
name– Overrides the default name of the output file. It should contain the extension. The file should not have path segments, it will be placed in the target directory. Without a name, the exporter defines the file name since the extensions can differ depending on the exporter.
bsn– Set the bundle symbolic name of the resulting JAR file if possible
version– Set the version of the resulting JAR file if possible
-profilecan be used to select a specific property profile.
-exporttype can be used to set some default attributes for a specific type.
The Exporters use a plugin mechanism and therefore the list is not closed. The following exporters are supported by bnd out of the box:
bnd.executablejar.pack– Exports a JAR file using the launcher from the
-runpathor the default if no launcher is specified.
bnd.executablejar– Similar to the previous but does not support profiles, has no automatic bsn assigned, and entries are not signed. The reason there are two types for the more or less the same format with subtle differences is for backward compatibility.
bnd.runbundles– A JAR with the runbundles. As optional Attributes
targetDirwill output all runbundles in the set directory in the resulting jar and
templatewill use a given jar/zip or directory as template to which the bundles will be added.
osgi.subsystem.application– Export into an application subsystem
osgi.subsystem.feature– Export into a feature subsystem
osgi.subsystem.composite– Export into a composite subsystem
p2– Export a P2 repository
-export: \ foo.bndrun; \ -profile=debug; \ -runkeep=true; \ name = "foo.jar, \ bar.bndrun
filespec clause does not set the
type nor the
name then it is assumed the backward compatible mode is required. This will set the output name to the file name with a
.jar extension and it will set the bundle symbolic name.