Intro
Headers
Instructions
Macros
Commands
There are a number of built in properties that are set by bnd:
| !Property name | !Description | |||
project |
Name of the project. This is the name of the bnd file without the .bnd extension. If this name is bnd.bnd, then the directory name is used. | |||
project.file |
Absolute path of the main bnd file. | |||
project.name |
Just the name part of the file path | |||
project.dir |
The absolute path of the directory in which the bnd file resides. |
Run instructions are used to start OSGi tests and OSGi runs.
| Instructions | Argument | Description | (:cellnr:)`-runbundles``LIST SPEC` | Additional bundles that will be installed and started when the framework is launched. This property is normally part of the project's `bnd.bnd` file. | (:cellnr:)`-runvm``PROPERTIES` | Properties given to the VM before launching. This property is normally set in the cnf/build.bnd file and only in rare cases overridden in the bnd.bnd file. | (:cellnr:)`-runproperties``PROPERTIES` | Properties given to the framework when launching. Usually project specific. | (:cellnr:)`-runsystempackages``PACKAGES` | A declaration like Import-Package that specifies additional system packages to import from the class path. Usually given in the cnf/build.bnd file. | (:cellnr:)`-runpath``LIST SPEC` | A path description of artifacts that must be on the classpath of the to be launched framework. Usually given in the cnf/build.bnd file. This path should contain the framework. Any packages that a bundle on the -runpath should specify should be listed in the `export` attribute. | (:cellnr:)`-runtrace``true|'''false'''` | Trace the startup of the framework to the console. Usually used during testing and development so project specific. | (:cellnr:)`-runframework``none|'''services'''` | `NONE` indicates that a mini built in framework should be used. `SERVICES` indicates that the `META-INF/services` model must be followed for the `org.osgi.framework.launch.FrameworkFactory` class. Project specific. | (:cellnr:)`-testpath``LIST SPEC` | A path used to specify the test plugin | (:tableend:) ## Launching Launching is needed when the project's `run` action or `test` action is executed. The project creates a Project Launcher. A Project Launcher must launch a new VM and set up this VM correctly. The VM is launched with the following information. * `java` - The command to launch a new VM is bu default `java`. However, this can be overridden by setting a property called `java`. * `classpath` - The classpath set for the VM is derived from the `-runpath` property. Notice that this is supposed to contain the JAR with the framework. The `-runpath` requires bundle symbolic names for the JAR and an optional version range. bnd will use the latest version in the repository. Any packages that should be exported by the system bundle should have an export attribute containing the exported packages, like `junit.osgi;version=3.8;export="junit.framework;version=3.8,junit.misc;version=3.8". * `vm options` - These options can be set in the `-runvm` property. They are usually in the form of `-Dxya=15` or `-X:agent=bla`. Options should be separated by commas. * `main` - The class implementing the main type is defined by the launcher plugin. And example of a launcher set is: -runvm: -Xmn100M, -Xms500M, -Xmx500M -runpath: \ org.apache.felix.framework; version=3.0, \ junit.osgi;export="junit.framework;version=3.8" -runtrace: true -runproperties: launch=42, trace.xyz=true -runbundles: org.apache.felix.configadmin,\ org.apache.felix.log,\ org.apache.felix.scr,\ org.apache.felix.http.jetty,\ org.apache.felix.metatype,\ org.apache.felix.webconsole Debugging launching is greatly simplified with the -runtrace property set to true. This provides a lot of feedback what the launcher is doing. ###Access to arguments When the launcher is ready it will register itself as a service with the following properties: ||`launcher.arguments`||The command line arguments|| ||`launcher.ready`||Indicating the launcher is read|| ###Access to main thread In certain cases it is necessary to grab the main thread after launching. The default launcher will launch all the bundles and then wait for any of those bundles to register a Runnable service with a service property `main.thread=true`. If such service is registered, the launcher will call the run method and exit when this method returns. ###Timeout The launcher will timeout after an hour. There is currently no way to override this timeout. ###Mini Framework The bnd launcher contains a mini framework that implements the bare bones of an OSGi framework. The purpose of this mini framework is to allow tests and runs that want to launch their own framework. A launch that wants to take advantage of this can launch with the following property: -runframework: none ###Ant In ant, the following task provides the run facility.