Skip to content

Commit 8d93f25

Browse files
authored
Update installation.md
Simplification and addition/promotion of new setups-based installation
1 parent 847e231 commit 8d93f25

File tree

1 file changed

+22
-20
lines changed

1 file changed

+22
-20
lines changed

installation.md

Lines changed: 22 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,32 +2,26 @@
22
title: Installation & Getting Started with Bndtools 7.1.0
33
---
44

5-
There are different flavors you can install Bndtools.
5+
There are now three ways to Install Bndtools 7.1.0+
66

7-
## Users: If you just want to use Bndtools for your own projects
7+
## New: Install Via Pre-Configured Setups
8+
There are now setups that will install and configure all of Eclipse, all other components used by Bndtools (e.g. git support), and Bndtools 7.1.0 itself. The setups *do not* require having a previously installed version of Eclipse, and so can be helpful for new users to get a working Bndtools environment quickly and easily.
89

9-
- via the [Eclipse Marketplace](#marketplace)
10-
- or directly install into Eclipse from the [Update Site](#update-site)
11-
- another option are [pre-configured Eclipse setups via installer](https://bndtools.org/bndtools.p2.repo/)
10+
Bndtools 7.1.0 setups [found here](https://bndtools.org/bndtools.p2.repo/)
1211

13-
## Developers: If you want to contribute to bndtools
12+
## Eclipse Marketplace Install
1413

15-
- Setup source code into your existing Eclipse installation. See our [Bndtools Developer Guide](/development.html)
16-
17-
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/Ry6XNGm7C-k" frameborder="1" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
18-
19-
To get then started with the [bndtools Workspace model](workspace.html), you can follow some videos that can get you started.
14+
Note that Eclipse and the Marketplace Client Plugin for Eclipse must be installed prior to using this installation method
2015

21-
22-
## Marketplace
23-
24-
The recommended way to install Bndtools via the [Eclipse Marketplace](https://marketplace.eclipse.org/content/bndtools).
16+
See the [Eclipse Marketplace](https://marketplace.eclipse.org/content/bndtools) page
2517

2618
<a href="https://marketplace.eclipse.org/marketplace-client-intro?mpc_install=1220" class="drag" title="Drag to your running Eclipse* workspace. *Requires Eclipse Marketplace Client">
2719
<img style="width:80px;" typeof="foaf:Image" class="img-responsive" src="https://marketplace.eclipse.org/modules/custom/eclipsefdn/eclipsefdn_marketplace/images/btn-install.svg" alt="Drag to your running Eclipse* workspace. *Requires Eclipse Marketplace Client" />
2820
</a>
2921

30-
## Update Site
22+
## Update Site Install
23+
24+
Note that Eclipse must be previously installed prior to using this installation method
3125

3226
* From the Help menu select `Install New Software...`
3327
* When the dialog opens, click the `Add...` button near the top-right.
@@ -41,25 +35,33 @@ The recommended way to install Bndtools via the [Eclipse Marketplace](https://ma
4135

4236
* Press `Next` and then `Finish`, acknowledging the licenses
4337

44-
45-
## Getting Started
38+
## Getting Started Materials
4639

4740
To get started with Bnd/Bndtools we recommend:
4841
- the [Concepts](concepts.html) behind bndtools
4942
- our [Video Tour](/workspace.html)
5043
- our [Tutorial](tutorial.html) building a sample application
5144
- and our [Project Templates](/manual/templates.html)
5245

46+
## Developers and Contributors: To contribute to Bndtools development
47+
48+
- Setup source code into your existing Eclipse installation. See our [Bndtools Developer Guide](/development.html)
49+
50+
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/Ry6XNGm7C-k" frameborder="1" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
51+
52+
To get then started with the [bndtools Workspace model](workspace.html), you can follow some videos that can get you started.
53+
54+
All contributions (e.g. testing, bug reporting and fixing, documentation, examples, tutorials) welcome!
55+
5356
## Release Notes
5457

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

57-
5860
## Known Issues
5961

6062
* Bndtools is built to run on Eclipse 2022-09 or later. So Bndtools 7.1.0 may not run on older versions of Eclipse.
6163

62-
* This release is based on Java 17. This tends to be not noticed for developmet 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
64+
* 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
6365
```
6466
-runpath \
6567
biz.aQute.launcher;version="[6.4.0,7)", \

0 commit comments

Comments
 (0)