add osgi headers via maven-bundle-plugin

[zspitzer]

following up on #128

this PR adds the maven-bundle-plugin and config

I am doing this, as we use Commonmark in Lucee, for the initial version, we wrapped the jar ourselves with OSGI metadata, but now I'd like to add some extensions and I'd rather just use commonmark jars

lucee/Lucee#2473

I have tested this locally and the OSGI Export-Package / Import-Package headers look good

But there are some warnings be thrown for each extension

[INFO] --- bundle:6.0.0:bundle (bundle) @ commonmark-ext-autolink ---
[WARNING] Bundle org.commonmark:commonmark-ext-autolink:jar:0.24.1-SNAPSHOT : Split package, multiple jars provide the same package:
Use Import/Export Package directive -split-package:=(merge-first|merge-last|error|first) to get rid of this warning
Package found in   [Jar:., Jar:commonmark, Jar:autolink]
Class path         [Jar:., Jar:commonmark, Jar:autolink]
[INFO] Building bundle: D:\work\java\commonmark-java\commonmark-ext-autolink\target\commonmark-ext-autolink-0.24.1-SNAPSHOT.jar
[INFO] Writing manifest: D:\work\java\commonmark-java\commonmark-ext-autolink\target\classes\META-INF\MANIFEST.MF

In addition, the autolink dependancy also needs OSGI metadata

[robinst]

Is it possible to only put this into the <build><plugins> of the parent pom instead of every child pom (I'm not sure if that works or not)?

[zspitzer]

This was the only way I could get it working, been a few months since I put this together, so I can't exactly remember variations I tried.

I'll revisit it and let you know what I find

[robinst]

Does this export internal packages? If yes, can we prevent them from being exported?

[zspitzer]

this is the file MANIFEST is produces

Manifest-Version: 1.0
Bnd-LastModified: 1737245630605
Build-Jdk-Spec: 21
Bundle-Description: Core of commonmark-java (a library for parsing Mar
 kdown to an AST, modifying the AST and rendering it to HTML or Markdo
 wn)
Bundle-License: https://opensource.org/licenses/BSD-2-Clause
Bundle-ManifestVersion: 2
Bundle-Name: commonmark-java core
Bundle-SymbolicName: org.commonmark
Bundle-Version: 0.24.1.SNAPSHOT
Created-By: Apache Maven Bundle Plugin 6.0.0
Export-Package: org.commonmark;version="0.24.1",org.commonmark.node;ve
 rsion="0.24.1",org.commonmark.parser;version="0.24.1";uses:="org.comm
 onmark,org.commonmark.node,org.commonmark.parser.beta,org.commonmark.
 parser.block,org.commonmark.parser.delimiter",org.commonmark.parser.b
 eta;version="0.24.1";uses:="org.commonmark.node,org.commonmark.parser
 ,org.commonmark.text",org.commonmark.parser.block;version="0.24.1";us
 es:="org.commonmark.node,org.commonmark.parser",org.commonmark.parser
 .delimiter;version="0.24.1";uses:="org.commonmark.node",org.commonmar
 k.renderer;version="0.24.1";uses:="org.commonmark.node",org.commonmar
 k.renderer.html;version="0.24.1";uses:="org.commonmark,org.commonmark
 .node,org.commonmark.renderer",org.commonmark.renderer.markdown;versi
 on="0.24.1";uses:="org.commonmark,org.commonmark.node,org.commonmark.
 renderer,org.commonmark.text",org.commonmark.renderer.text;version="0
 .24.1";uses:="org.commonmark,org.commonmark.node,org.commonmark.rende
 rer",org.commonmark.text;version="0.24.1"
Import-Package: org.commonmark;version="[0.24,1)",org.commonmark.parse
 r.delimiter;version="[0.24,1)",org.commonmark.renderer;version="[0.24
 ,1)",org.commonmark.text;version="[0.24,1)"
Require-Capability: osgi.ee;filter:="(&(osgi.ee=JavaSE)(version=11))"
Tool: Bnd-7.0.0.202310060912

[robinst]

Ok, so looks like there's no internal packages there.

Why does it have an Import-Package?

[robinst]

Closing because I made some edits, see #378.

[robinst]

@zspitzer released #378 in 0.25.0 now: https://github.com/commonmark/commonmark-java/releases/tag/commonmark-parent-0.25.0