Tutorial seems out of date

[steinybot]

I am trying to go through the tutorial and I have encountered a couple of issues.

I am using:

Eclipse IDE for RCP and RAP Developers (includes Incubating components)

Version: 2025-09 (4.37.0)
Build id: 20250905-1456

With:

  Bndtools	7.1.0.REL-202411251545-g47e504d	bndtools.main.feature.feature.group	Bndtools
  Bndtools m2e	7.1.0.REL-202411251545-g47e504d	bndtools.m2e.feature.feature.group	Bndtools
  Bndtools PDE	7.1.0.REL-202411251545-g47e504d	bndtools.pde.feature.feature.group	Bndtools

The first screenshot of the cnf directory after having created the workspace does not match up:

The templates for a new Bnd OSGi Project are missing quite a few:

This step in the wizard didn't show:

5: In the following page you will see an overview of the folders that will be created for this new project.

It states:

However, the bundle is currently empty, because we have not defined any Java packages to include in the bundle. This is an important difference of Bndtools with respect to other tools: bundles are always empty until we explicitly add some content. You can verify this by double-clicking the bundle file and viewing its contents: it will only have a META-INF/MANIFEST.MF entry.

But that does not match what I see. For me it includes the Greeting.class even with an empty bnd.bnd file:

When I double click the bnd.bnd file it opens the source. I have to right-click and select Bnd Bundle Editor to get the editor UI. Not sure why, I'm sure this never used to be the case but I have updated Eclipse a couple of times recently.

Exporting the org.example.api package will generate the package-info.java file (different naming to the tutorial which calls it packageinfo.java which I guess is just because I chose Java 21).

The package-info.java will contain errors:

I'm guessing this is because the tutorial told us to create an empty project instead of an API project. OSGi R8 is present in the cnf/ext/build.mvn file though.

I haven't gotten any further because the create implementation project step says to choose the template Component Development which doesn't exist.

[steinybot]

I got a bit further by using the OSGi enRoute API Bundle and Provider Bundle templates.

The build path in the provider doesn't match what is added in the workspace. It was:

-testpath: \
	biz.aQute.wrapper.junit, \
	biz.aQute.wrapper.hamcrest, \
	org.assertj.core

but changing it to this worked:

-testpath: \
	org.apache.servicemix.bundles.junit, \
	assertj-core

Run descriptor template also doesn't show up for whatever reason:

[steinybot]

I haven't figured out how to get the launch configuration to work.

The only execution env I can see is felix:

Bundle resolution button fails with:

If I try and save and run anyway I get this:

[chrisrueger]

Thanks @steinybot for the report. A PR for the docs improvements is highly appreciated. I guess you are referring to this tutorial https://bndtools.org/tutorial.html ?

Regarding the other problem:

I haven't figured out how to get the launch configuration to work.

The only execution env I can see is felix:

Can you try adding Equinox Framework e.g.

org.eclipse.platform:org.eclipse.osgi:3.23.200 (maven central)

to one of your repositories? (e.g. in your cnf/ext/central.mvn or wherever your repo is defined)

It should then show up in the OSGi Framework dropdown.