-
Notifications
You must be signed in to change notification settings - Fork 20
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #213 from chrisrueger/oomph-setups
Add Oomph setups links and improve Installation and Developer Guide
- Loading branch information
Showing
4 changed files
with
115 additions
and
45 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,45 +1,67 @@ | ||
| --- | ||
| title: Install Bndtools 7.0.0 | ||
| title: Installation & Getting Started with Bndtools 7.0.0 | ||
| --- | ||
|
|
||
| There are different flavors you can install Bndtools. | ||
|
|
||
| You can install Bndtools via the [Marketplace](#marketplace) or directly install from the [Update Site](#update-site) | ||
| ## Users: If you just want to use Bndtools for your own projects | ||
|
|
||
| <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> | ||
| - via the [Eclipse Marketplace](#marketplace) | ||
| - or directly install into Eclipse from the [Update Site](#update-site) | ||
| - another option are [pre-configured Eclipse setups via installer](https://bndtools.org/bndtools.p2.repo/) | ||
|
|
||
| To get then started with the [bndtools Workspace model](workspace.html), you can follow some videos that can get you started. | ||
| ## Developers: If you want to contribute to bndtools | ||
|
|
||
| ## Enhancements | ||
| - Setup source code into your existing Eclipse installation. See our [Bndtools Developer Guide](/development.html) | ||
|
|
||
| * Bndtools is built to run on Eclipse 2020-06 or later. So Bndtools 7.0.0 may not run on older versions of Eclipse. | ||
| <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> | ||
|
|
||
| For more complete information on the changes in the Bndtools release, see <https://github.com/bndtools/bnd/wiki#release-notes>. | ||
| To get then started with the [bndtools Workspace model](workspace.html), you can follow some videos that can get you started. | ||
|
|
||
| ## Known Issues | ||
|
|
||
| * 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 | ||
| ``` | ||
| -runpath \ | ||
| biz.aQute.launcher;version="[6.4.0,7)", \ | ||
| biz.aQute.tester.junit-platform;version="[6.4.0,7)" | ||
| ``` | ||
| ## Marketplace | ||
|
|
||
| The recommended way to install Bndtools via the [Eclipse Marketplace](https://marketplace.eclipse.org/content/bndtools). | ||
|
|
||
| <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"><img typeof="foaf:Image" class="img-responsive" src="https://marketplace.eclipse.org/sites/all/themes/solstice/public/images/marketplace/btn-install.png" alt="Drag to your running Eclipse* workspace. *Requires Eclipse Marketplace Client" /></a> | ||
| <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"> | ||
| <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" /> | ||
| </a> | ||
|
|
||
| ## Update Site | ||
|
|
||
| * 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 URLs | ||
| * In the Name field enter `Bndtools`. In the Location field enter one of the the following P2 Repository URLs | ||
|
|
||
| | Type |URL | | ||
| |----------------------------|-------------------------------------------------------| | ||
| | Latest stable release | https://bndtools.jfrog.io/bndtools/update-latest | | ||
| | Latest release candidate | https://bndtools.jfrog.io/bndtools/update-rc | | ||
| | Latest build snapshot | https://bndtools.jfrog.io/bndtools/update-snapshot | | ||
| | Type |URL |alt. URL| | ||
| |----------------------------|-------------------------------------------------------|--| | ||
| | Latest stable release | `https://bndtools.org/bndtools.p2.repo/7.0.0/` | via [jfrog](https://bndtools.jfrog.io/bndtools/update-latest) | | ||
| | 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 | ||
|
|
||
|
|
||
| ## Getting Started | ||
|
|
||
| To get started with Bnd/Bndtools we recommend: | ||
| - the [Concepts](concepts.html) behind bndtools | ||
| - our [Video Tour](/workspace.html) | ||
| - our [Tutorial](tutorial.html) building a sample application | ||
| - and our [Project Templates](/manual/templates.html) | ||
|
|
||
| ## 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 2020-06 or later. So Bndtools 7.0.0 may not run on older versions of Eclipse. | ||
|
|
||
| * 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 | ||
| ``` | ||
| -runpath \ | ||
| biz.aQute.launcher;version="[6.4.0,7)", \ | ||
| biz.aQute.tester.junit-platform;version="[6.4.0,7)" | ||
| ``` |