Skip to content

hbyw618/bnd

 
 

Repository files navigation

README bnd

bnd is a swiss army knife for OSGi, it creates manifest headers for you based on analyzing the class code, it verifies your settings, it manages project dependencies, gives you quote of the day, diffs jars, and much more.

The information about bnd can be found at http://www.aQute.biz/Bnd

Repository

The git repository contains all code. It contains the following projects:

  • aQute.libg - Library to be statically linked (Conditional-Package)
  • biz.aQute.bnd - A command line utility and ant plugin
  • biz.aQute.bndlib - The core library
  • biz.aQute.bndlib.tests - Tests for the core library
  • biz.aQute.jpm - Just another package manager for Java
  • biz.aQute.junit - Junit tester (runs on Java 1.4)
  • biz.aQute.launcher - Launcher (runs on Java 1.4)
  • biz.aQute.repository - Different repos with OBR
  • biz.aQute.resolve - OBR Resolver
  • cnf - Configuration directory
  • demo - Used in testing
  • dist - Contains the distribution after 'ant dist'
  • osgi.r5 - OSGi jars without all dependencies

License

All code is Apache 2.0 Licensed so you can do what you want with the source code.

API

though I am usually pretty good at backward compatibility, there is no guarantee. This is an unpaid project and one of the most annoying thing of work is being backward compatible on the Java API when you know a better way to do it. Properties will be backward compatible if there is any possibility. So be aware, its ok to use this package but do not complain if new releases require some work.

If you're building a tool with a general audience, e.g. bndtools, that includes bnd for a general audience I would appreciate if you got in touch with me so I can keep in touch. I am always interested in ideas.

Eclipse

bndtools is the development environment of bnd. An earlier Eclipse plugin in bnd is no longer available.

Building

The workspace root has a build.xml that builds all project in proper order. Due to the fact that bnd builds itself there are certain cases where you get an error during build. Trying again should fix the issue.

Each project directory has a build.xml. The following targets are available:

ant build (default) - Build ant clean - Clean the project ant test - Run a bnd OSGi test ant junit - Run standard JUnit tests in the test package ant dist - Create a dist directory with all the bundles in repo format + obr indexes

Outputs are stored in the tmp directory in the different projects.

Testing

The main tests are in the biz.aQute.bndlib.tests project. These are standard JUnit tests. They are all in the src/test directory. Tests are quite extensive and run from the Eclipse JUnit screen.

Release

bnd is continuously built on Cloudbees: https://bndtools.ci.cloudbees.com/#

A more comprehensive release process is in the works.

Feedback

Feedback is always welcome, for general discussions use bndtools-users@googlegroups.com

Bugs and issues should go to https://github.com/bndtools/bnd

Other feedback or specific functionality send to Peter.Kriens@aQute.biz

About

bnd, the swiss army knife for OSGi. A tool to build bundles.

Resources

Stars

Watchers

Forks

Packages

No packages published