Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

IGB runs within an OSGi framework, also called an OSGI "container" or "runtime." This means you can extend IGB without modifying the core IGB code base. By implementing a few well-described interfaces and using the Apache maven project management tool, you can add new menu items, create new kinds of tracks, or connect IGB to all-new data sources - all functionality without re-installing or even re-starting IGB.

This tutorial introduces the IGB platform by demonstrating a very simple IGB App that adds a new entry to the IGB Edit Tools menu. 

Get started: clone IGB Hello World App

Clone the IGB Hello World App project - this contains complete, working example

Requirements

...

  • App

...

...

...

 

...

Compile the App

Next, open the igb-app-Open the hello-world project  project in Netbeans (or your preferred IDE).

Select In Netbeans, select the Hello World IGB App in the Netbeans from the Projects tab, right-click, and select and then select Run > Build.

Building the App will create creates a new directory named "target" which can serve as a new App repository. This new directory contains compiled code as well as a meta-data about the App it contains.

...

Once you add "target" as a new local App storerepository, you should see the Hello World App added as a new App in the IGB App Manager window, as show shown below:

Install App

To install the hello world App:

...

To check that installation worked correctly, select the Edit Tools menu. Check that there is  now a new menu item named Hello World App.

Run App

To run the App:

  • Select Edit > Hello World App
  • Observe a dialog appears containing the message "Hello IGB World!

...

Next step: Modify your code

Open the file MenuBarExpansionExamplefile HelloWorldIgbApp.java in the Netbeans editor. Edit the message your IGB App prints and re-build your App. Then, return to the IGB App Manager, un-install and then re-install your App. When you select the the menu item again, a dialog should appear showing your new message.

Note that you can rapidly repeat this edit-build-uninstall-install cycle. You don't have to re-build IGB or even restart it, which makes development much faster than if you had to modify the IGB code directly.

...

.

...

It's not enough to create and deploy an App; you should also provide an easy-to-understand README.md file suitable for display in the IGB App Manager. See Create Markdown to display in IGB App Manager