Home

Awesome

bnd

GitHub release (latest SemVer) Rebuild CodeQL GitHub issues GitHub commit activity

bnd & bndtools

Bnd/Bndtools 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, diffs jars, and much more. At the core is a library with all the functions. The library is then used in a myriad of subsystems to provide the core functionality to the rest of the world.

Feedback

Well, assuming you were born after 1970 you probably know how to file an issue? :-) We got a good record fixing bugs. However, to help us, it always works best if you can provide the smallest possible example as a github repo. If the bug is consistent we tend fix it really fast. At least specify the environment where the bug appears, we got lots of variants.

General feedback is of course also always welcome! The bnd discourse site mail list is open for any topic even remotely associated with bnd. And we even love to hear also how people use the product that takes so much of our time.

And the ones we love most are of course PRs! The documentation of bnd is fully included in this workspace. From a typo to a brilliant essay on Launchpad, submit a PR and we probably take it. Don't ask what bnd can do for you, ask what you can do for bnd!

License

This program and the accompanying materials are made available under the terms of the Apache License, Version 2.0 which is available at https://www.apache.org/licenses/LICENSE-2.0, or the Eclipse Public License 2.0 which is available at https://www.eclipse.org/legal/epl-2.0.

API

We go out of our way to be backward compatible. There are thousands of extensive test cases and we use our own baselining tool to verify that we do not make gratuitious changes. Since this tool is part of Bndtools we often find out early enough that there are alternatives to breaking changes. We strictly follow OSGi semantic versioning. This means that we mark exported packages with a package version.

We try to keep major versions to a minimum but sometimes we must. This is clearly marked with a major release number.

The master branch is release 7 currently and the Java release version is 17. Since some libraries are used in the embedded world that have a slower uptake of the Java release train we keep a classic branch that continues a major release 6 on Java 1.8. The classic branch does not include the plugins.

Contributing

Want to work on Bnd/Bndtools? There are instructions to get you started. Please let us know if anything feels wrong or incomplete.

Some more instructions how to get started with bndtools development can be found here

Repo Structure

Branches

We have the following branches:

We generally do not use other branches. Issues and features are handled through PR's from forked repos.

Issues

Open issues are the one actively scheduled to go into the next milestone(s).

All other issues will be closed. However, some issues we close because we just lack people that are interested in working on them. We explicitly mark those issues with abeyance. If you got time to spare, do not hesitate to open them and indicate you're willing to work on them. We will then properly schedule and track them. If you need to find them, use this filter: is:issue label:abeyance, make sure is:open is not in the filter.

Milestones

We try to have a release every 3-6 months and plan these with milestones.

PRs

PRs should be submitted via another repo. After approval, they will be built to check for our requirements.

Actions

Actions trigger workflows depending on the branch. PR's for verification require approval when not from a known contributor. We verify the code quality with CodeQL and the contribution rules are also checked.

Using the latest development SNAPSHOT build of Bnd/Bndtools

All our artifacts are in the biz.aQute.bnd group id.

Bnd Gradle Plugins are finally released to the Gradle default repository as well. Bnd Maven Plugins are stored in the listed repos.

Bndtools requires a p2 repository and is therefore special:

Building

We use Gradle and Maven to build and the repo includes gradlew and mvnw at the necessary versions. We require at least Java 17.

Acknowledgments

YourKit supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.

Powered by Artifactory

YourKit

icons8 – For some of the icons