Add support for building multi-release jars (automatic!)

[laeubi]

This is based on:

• Add support for reading Multi-Release-Jar content #5357

so to see the actual changes from this PR simply select the last commit on the review tab.

an allows to specify
Multi-Release: true
in a BND file to instruct BND building an OSGi Multi-Release Bundle based on the detected versions.

@timothyjward this also includes fixing general processing of BND in cases where multi-release is off, and methods for Jar to put versioned resources / supplemental manifests. If you think it helps, both aspects could be split into separate PRs as well.

This will fix #5346

[laeubi]

I have adjusted the example here to reflect the changes, the
clickhouse-http-client-0.3.3-SNAPSHOT.jar.zip shows the result for such a bundle build by bnd with supplemental manifests for version 9 and 11.

[timothyjward]

I think the direction here is good. We probably need some more multi-release bundle generation tests before it can be merged though.
One feature that seems likely to have issues is the generation of java.* imports for multi release manifests at versions greater than 11.

[laeubi]

We probably need some more multi-release bundle generation tests before it can be merged though.

Can you suggest a test-case that might be adapted for this purpose?

One feature that seems likely to have issues is the generation of java.* imports for multi release manifests at versions greater than 11.

According to my tests (see attached generated bundle) it simply "works", e.g. I see java.* imports for the java 11 variant.

[laeubi]

We probably need some more multi-release bundle generation tests before it can be merged though.

I have added now a test here:

bnd/biz.aQute.bndlib.tests/test/aQute/bnd/osgi/AnalyzerTest.java

Lines 24 to 53 in 51a4947

	public void multiRelease() throws Exception {
	try (Analyzer a = new Analyzer(new Jar("test"))) {
	a.setProperty("Multi-Release", "true");
	assertThat(a.check()).isTrue();
	Jar jar = a.getJar();
	String fooPath = "test/Foo.class";
	String barPath = "test/Bar.class";
	jar.putResource(fooPath,
	new FileResource(IO.getFile("testresources/mr/java8/Foo.class")));
	jar.putResource(barPath,
	new FileResource(IO.getFile("testresources/mr/java8/Bar.class")));
	jar.putVersionedResource(fooPath, 9, new FileResource(IO.getFile("testresources/mr/java9/Foo.class")));
	jar.putVersionedResource(barPath, 17, new FileResource(IO.getFile("testresources/mr/java17/Bar.class")));
	jar.setManifest(a.calcManifest());
	Manifest mainMf = jar.getManifest();
	Optional<Manifest> java9Mf = jar.getManifest(9);
	Optional<Manifest> java17Mf = jar.getManifest(17);
	assertThat(mainMf.getMainAttributes()
	.getValue(Constants.REQUIRE_CAPABILITY)).isNotNull()
	.contains("(&(osgi.ee=JavaSE)(version=1.8))");
	assertThat(java9Mf.get()
	.getMainAttributes()
	.getValue(Constants.REQUIRE_CAPABILITY)).isNotNull()
	.contains("(&(osgi.ee=JavaSE)(version=9))");
	assertThat(java17Mf.get()
	.getMainAttributes()
	.getValue(Constants.REQUIRE_CAPABILITY)).isNotNull()
	.contains("(&(osgi.ee=JavaSE)(version=17))");
	}
	}

[pkriens]

I will take over this PR