bndversion

Returns the current running bnd version as full major.minor.micro

Summary

Returns the version number of the bnd tool currently being used to process the build.

Syntax

${bndversion}

Parameters

None. This macro takes no parameters.

Behavior

Returns the current bnd version as a string in the format major.minor.micro (without the qualifier/build timestamp).

For example: 7.0.0 or 6.4.0 or 5.3.0

Examples

# Display bnd version in bundle manifest
Bundle-BuildTool: bnd-${bndversion}

# Conditional logic based on bnd version
-include ${if;${vcompare;${bndversion};7.0.0};modern.bnd;legacy.bnd}

# Document which bnd version was used
Bundle-Comment: Built with bnd ${bndversion}

# Version-specific features
-conditionalpackage: ${if;${vcompare;${bndversion};6.4.0};com.new.*;com.legacy.*}

Use Cases

Build Documentation: Record which version of bnd was used to build a bundle
Conditional Configuration: Apply different settings based on bnd version
Feature Detection: Enable features only available in newer bnd versions
Troubleshooting: Help identify build environment for debugging
Version Requirements: Verify minimum bnd version requirements

Notes

The version returned does not include the qualifier (e.g., build timestamp or snapshot indicator)
This is the runtime version of bnd, not a property that can be set
Useful for ensuring reproducible builds when combined with version checks
Can be combined with vcompare for version comparisons

vcompare - Compare version strings
version - Format version numbers with masks

See test cases in MacroTestsForDocsExamples.java