• Intro Headers Instructions Macros Commands
  • Fork me on GitHub
    • Introduction
    • How to install bnd
    • Guided Tour
    • Guided Tour Workspace & Projects
    • Concepts
    • Best practices
    • Build
    • Project Setup
    • Generating JARs
    • Versioning
    • Baselining
    • Service Components
    • Metatype
    • Contracts
    • Bundle Annotations
    • Accessor Properties
    • SPI Annotations
    • Resolving Dependencies
    • Launching
    • Startlevels
    • Testing
    • Testing with Launchpad
    • Packaging Applications
    • JPMS Libraries
    • Wrapping Libraries to OSGi Bundles
    • Generating Documentation
    • Commands
    • For Developers
    • Tips for Windows users
    • Tools bound to bnd
    • Headers
    • Instruction Reference
    • Instruction Index
    • Macro Reference
    • Macro Index
    • Plugins
    • External Plugins
    • Settings
    • Errors
    • Warnings
    • Frequently Asked Questions
  • How to install bnd

    bnd is not a single product, it is a library (bndlib) used in many different software build environments. It runs inside Maven, ant, gradle, Eclipse, sbt, and maybe one day in Intellij. To install bnd, you will have to install these tools.

    • Ant Plugin The plugin to build bnd artifacts with ant.
    • Bnd Gradle Plugins The Bnd Gradle Plugins from the Bnd developers.
    • Bnd Maven Plugins The Bnd Maven Plugins from the Bnd developers.
    • Eclipse Bndtools The most famous of them all, the one and only Bndtools!
    • Apache Felix Maven Bundle Plugin The Apache Felix Maven Bundle Plugin.
    • Gradle Bundle Plugin A Gradle Plugin from Artyom Dmitriev.
    • Gradle OSGi Plugin The Gradle OSGi Plugin that comes with Gradle.
    • Mill OSGi Plugin A Mill Plugin to create OSGi Bundles.
    • OSGi-Run Plugin A Gradle Plugin to create and run an OSGi runtime.

    Command Line

    That said, there is also a command line version of bnd, providing an easy way to try out its many features. You can install bnd through brew on MacOS.

    You can also run bnd command as executable jar, which can be downloaded from JFrog:

    java -jar biz.aQute.bnd-{VERSION}.jar <command>
    

    Libraries

    The binaries are available on JFrog. The latest version can be found at:

    https://bndtools.jfrog.io/bndtools/libs-snapshot
    

    If you are a maven user, you can find many version in central. The coordinates are:

    	<dependency>
    		<groupId>biz.aQute.bnd</groupId>
    		<artifactId>biz.aQute.bndlib</artifactId>
    		<version>....</version>
    	</dependency>
    

    Source Code

    bnd is maintained at github. If you want to change the code, just clone it and modify it. In general we accept pull requests, and often even highly appreciate them.

    Manual

    The manual is also on github. If you see an improvement, do not hesitate to clone the repo and create a pull request. Improvements are bug corrections but we also like short articles about how to do do something with bnd.

    Communication Settings

    If you’re behind a firewall that requires proxies or you use repositories that require authentication see -connection-settings.

    • GitHub