{"id":442,"date":"2012-08-08T09:27:16","date_gmt":"2012-08-08T07:27:16","guid":{"rendered":"http:\/\/www.pellissier.co.za\/hermien\/?p=442"},"modified":"2013-02-10T08:54:05","modified_gmt":"2013-02-10T06:54:05","slug":"migrating-my-mind-to-maven-part-6-customising-the-installers","status":"publish","type":"post","link":"https:\/\/www.pellissier.co.za\/hermien\/?p=442","title":{"rendered":"Migrating my Mind to Maven (Part 6) – Customising the Installers"},"content":{"rendered":"

The nbm:build-installers Maven goal allows you to build the platform application installers using Maven, as I wrote about in an earlier blog post<\/a>. Yesterday I decided to investigate how to configure the installer when building it using that goal.<\/p>\n

The first thing that can be customised is which platform(s) to create installers for. This can be configured in the IDE from the application project’s properties, under the Build > Installer category. I chose to build an installer only for Windows. And when I looked at the pom.xml for the application project, I found the following:<\/p>\n

[xml]\n org.codehaus.mojo<\/groupId>
\n nbm-maven-plugin<\/artifactId>
\n
\n false<\/installerOsLinux>
\n false<\/installerOsMacosx>
\n false<\/installerOsSolaris>
\n <\/configuration>\n<\/plugin>[\/xml]<\/p>\n

Looking at [1] (see Useful References below), we see that there are a number of other properties that can be set in addition to those now set by the IDE. This includes the parameters that get passed to the template.xml file via the userSettings property. To understand what this actually means, run the nbm:build-installers goal and have a look at the target folder of the application. In the folder targetinstallernbistub you will see the file template.xml. It is the ant script that will get executed during the process of building the installer. And that is the script that the properties get passed to.<\/p>\n

The first useful thing is setting the icon that is displayed in the installer when it is running (see also [2]). After adding the icon, the same section in the pom.xml now looks like this:<\/p>\n

[xml]\n org.codehaus.mojo<\/groupId>
\n nbm-maven-plugin<\/artifactId>
\n
\n false<\/installerOsSolaris>
\n false<\/installerOsMacosx>
\n false<\/installerOsLinux>
\n
\n ${basedir}\/src\/resources\/icon.png<\/nbi.icon.file>
\n <\/userSettings>
\n <\/configuration>\n<\/plugin>[\/xml]<\/p>\n

However you will most likely not want to stop at the icon, but also change all the other images in the installer (see [4]). The template.xml provided with NetBeans 7.2 does not allow this out of the box. But the changes are simple (see [3] for some info towards the bottom of the page and also [5] as an example of a template.xml). First lets add a new property called nbi.instleftcorner.file that will specify the location of the image to be displayed at the top left of most of the installer wizard pages.<\/p>\n

[xml]\n org.codehaus.mojo<\/groupId>
\n nbm-maven-plugin<\/artifactId>
\n
\n false<\/installerOsSolaris>
\n false<\/installerOsMacosx>
\n false<\/installerOsLinux>
\n
\n ${basedir}\/src\/resources\/icon.png<\/nbi.icon.file>
\n ${basedir}\/src\/resources\/left.png<\/nbi.instleftcorner.file>
\n <\/userSettings>
\n <\/configuration>\n<\/plugin>[\/xml]<\/p>\n

Then we create a copy of the template.xml file and specify the templateFile property in the pom.xml:<\/p>\n

[xml]\n org.codehaus.mojo<\/groupId>
\n nbm-maven-plugin<\/artifactId>
\n
\n false<\/installerOsSolaris>
\n false<\/installerOsMacosx>
\n false<\/installerOsLinux>
\n ${basedir}\/src\/resources\/template.xml<\/templateFile>
\n
\n ${basedir}\/src\/resources\/icon.png<\/nbi.icon.file>
\n ${basedir}\/src\/resources\/left.png<\/nbi.instleftcorner.file>
\n <\/userSettings>
\n <\/configuration>\n<\/plugin>[\/xml]<\/p>\n

The final part of the puzzle is changing the template.xml file to also copy the new file (see [5] again for a more complete example). As a quick fix, I just added the following<\/p>\n

[xml][\/xml]<\/p>\n

to the -prepare-icon target. Now when the nbm:build-installers goal is executed, the custom template.xml is copied including this change and the wizard-description-background-left.png image will be replaced before the installer gets built. The same can be done for any of the images. \ud83d\ude42<\/p>\n

Useful References<\/b><\/p>\n

    \n
  1. NBM Maven Plugin documentation<\/a><\/li>\n
  2. Developers FAQ Create Installers<\/a><\/li>\n
  3. JIRA Build installers goal proposal<\/a><\/li>\n
  4. Geertjan’s Blog: Customizing the NetBeans Platform Installer<\/a><\/li>\n
  5. template.xml from osm2garmin<\/a><\/li>\n<\/ol>\n

    Edit (4 October 2012):<\/strong> Another useful resource:<\/p>\n