Multiplatform Installer for NetBeans Platform Applications

DZone 's Guide to

Multiplatform Installer for NetBeans Platform Applications

· Java Zone ·
Free Resource

Even with recent advances in NetBeans, getting your NetBeans Platform application out to the public could be a lot simpler. First of all, having to build separate installers per platform is both time consuming and unnecessary, and adds to the build time and deployment time of every iteration of your application.

That’s why I created Wusher (WebStart Usher) – a specialized installer for NetBeans Platform applications. Your build script already creates a zip distribution either from Ant, Maven or directly in your IDE. Coupled with Wusher, that’s all you need to install a first class application on Windows, Mac and Linux.

Quick overview

As stated, you only need a single deliverable, not a separate build per target platform. Wusher will still do platform specific operations like adding icon to the dock and creating a first class app on the Mac, adding to the Start menu on Windows and adding to the Gnome/KDE menu on Linux. Also, you don’t need to merge your build with the installer, you just upload your zip distribution to any URL resolvable location and link to it from your installer.

You configure all builtin options directly in the jnlp file, you only need to write code if you would like to perform custom pre/post processing steps, like adding more wizard panels or adding options to existing panels.

The download screen on Linux

Try it directly by installing the Paint Demo from the NetBeans samples:

You can take a look at the jnlp file used to configure the above installer or browse the source code for the installer.

Here are some more screenshots:

The welcome screen on MacOS

The Accept License screen on Windows XP

The Finish screen on MacOS


  • No need to build the installer into your deliverable, just link to the zip distribution via URL and configure the jnlp file
  • Optional license step, link directly to your license via URL
  • Configure header logo and icons (per platform)
  • Configure messages/i18n – easily translate or adapt all text in the installer by referencing a custom messages.properties via URL
  • Optional pre/post processing steps, like adding more options to the Finish screen, doing arbitrary work before/after the installation, adding new wizard panels.
  • Native look and feel, resembles the NetBeans installer slightly
  • Install multiple applications from same installer (only 250k), just supply different jnlp-files.
  • WebStartable, but keep the NetBeans module system intact


Just build your zip and configure the jnlp, optionally sign your own version of the installer jar and put on your webpage. The installation options are documented and rather self explanatory directly in the jnlp file.


The product should be considered alpha quality, though there are no known bugs. If there is any interest, I could add stuff like jnlp creation wizards etc. I would love to get your feedback!


Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}