Installation & Getting Started with Bndtools 7.1.0

There are now three ways to Install Bndtools 7.1.0+

Eclipse Marketplace Install

Note that Eclipse and the Marketplace Client Plugin for Eclipse must be installed prior to using this installation method

See the Eclipse Marketplace page

Update Site Install

Note that Eclipse must be previously installed prior to using this installation method

From the Help menu select Install New Software...
When the dialog opens, click the Add... button near the top-right.
In the Name field enter Bndtools. In the Location field enter one of the the following P2 Repository URLs

Type	URL	alt. URL
Latest stable release	`https://bndtools.org/bndtools.p2.repo/7.1.0/`	via jfrog
Latest release candidate	`https://bndtools.jfrog.io/bndtools/update-rc`
Latest build snapshot	`https://bndtools.jfrog.io/bndtools/update-snapshot`

Press Next and then Finish, acknowledging the licenses

New: Install Via Pre-Configured Setups

If you want to start fresh with a clean Eclipse installation, this option is for you.

The pre-configured setups automatically install and configure Eclipse, along with all required components for Bndtools — such as Git support, recommended Eclipse plugins, and Bndtools 7.1.0 itself.

These setups do not require an existing Eclipse installation, making them an easy way for new users to get a fully working Bndtools environment in just a few steps.

Download the Bndtools Oomph setups from the official repository.

Getting Started Materials

To get started with Bnd/Bndtools we recommend:

the Concepts behind bndtools
our Video Tour
our Tutorial building a sample application
our Project Templates
and if you feel like more tutorials and examples, check out the enroute Classic section.

Developers and Contributors: To contribute to Bndtools development

Setup source code into your existing Eclipse installation. See our Bndtools Developer Guide

To get then started with the bndtools Workspace model, you can follow some videos that can get you started.

All contributions (e.g. testing, bug reporting and fixing, documentation, examples, tutorials) welcome!

Release Notes

For more complete information on the changes in the Bndtools release, see https://github.com/bndtools/bnd/wiki#release-notes.

Known Issues

Bndtools is built to run on Eclipse 2022-09 or later. So Bndtools 7.1.0 may not run on older versions of Eclipse.
This release is based on Java 17. This tends to be not noticed for development but there are a number of runtime bundles in the distribution that now also have become Java 17 code. This could generate the error during a bndrun launch or with bnd/OSGi testing when the Execution Environment is set to < 17. The easy fix is to set this to 17. If this is impossible, the previous launchers than run on 1.8 can then be used (if they are available in the repositories). Add
```
-runpath \
  biz.aQute.launcher;version="[6.4.0,7)", \
  biz.aQute.tester.junit-platform;version="[6.4.0,7)"
```