Page Comparison

This tutorial is provides a step by step creation of an IzPack Installer. You will be creating a simple swing based application.

Object

...

1. Start Eclipse and create a new Java Project in it.
   
   1. File -> New -> Java Project.
   2. Name your project (for example: IzPackInstaller HelloWorldInstaller).
   3. JRE Settings in Eclipse should be intakt.

...

1. Make sure you're in your new created project folder.
2. Go to the source folder (src).
3. Create a Java Class (name used in tutorial: HelloWorld).
4. Paste the source code block down below (name: A Simple Swing Based HelloWorld Application) to your new created class. This source code is a simple swing based dialog with a PushButton.
5. Compile and run it.

import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JPanel;
import javax.swing.SwingUtilities;

public class HelloWorld extends JFrame {

    public HelloWorld() {
        initUI();
    }

    public final void initUI() {

       JPanel panel = new JPanel();
       getContentPane().add(panel);

       panel.setLayout(null);

       JButton quitButton = new JButton("Hello World");
       quitButton.setBounds(50, 60, 120, 30);
       quitButton.addActionListener(new ActionListener() {
           public void actionPerformed(ActionEvent event) {
               System.exit(0);
          }
       });

       panel.add(quitButton);

       setTitle("QuitHello buttonWorld");
       setSize(300, 200);
       setLocationRelativeTo(null);
       setDefaultCloseOperation(EXIT_ON_CLOSE);
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(new Runnable() {
            public void run() {
                HelloWorld ex = new HelloWorld();
                ex.setVisible(true);
            }
        });
    }
} 

This dialog should popup on the screen:

Image Added

Step 4. - Create An Ant Script

1. Highlight your project folder .Execute and execute the shortkey CTRL+N.
2. Go to XML folder and choose XML File.
3. Name this XML File (build.xml)
4. Paste the xml code down below to build.xml

...

1. Run the IzPack jar file (java -jar /path/to/IzPack/Jar)
2. Follow the installation instructions. Remember the directory where the IzPack Installer Framework has been installed (installation path used in tutorial: /home/user/Desktop/IzPack).
3. Create two directories. The first directory for the IzPack setting file for the creational process and the second directory for the created generated installer (used in tutorial: /home/user/Desktop/Files4Installer and /home/user/Desktop/HelloWorld).

...

In the Files4Installer directory create an xml file (name of the file has to be: install.xml) and a directory named images. In this directory you should put the images used by IzPack for the Istaller. In this tutorial two images were used. Download these two images here (Image 1, Image 2) and name it helloworld_image1.png and helloworld_image2.png or create your own and put them into the images derectory. If you create your own images the size for the image 1 and image 2 should be 500x200 and 125x400 pixels, respectively.

...

<?xml version="1.0" encoding="iso-8859-1" standalone="yes" ?>

<installation version="1.0">
    <info>
        <appname>Hello World Application</appname>
        <appversion>1.0</appversion>
        <authors>
            <author name="Your Givenname and Lastname" email="givenname.lastname@hello-world.org"/>
        </authors>
        <url>http://www.hello-world.de/</url>
    </info>

    <guiprefs width="640" height="480" resizable="yes"/>
 
   <locale>
        <langpack iso3="eng"/>
        <langpack iso3="deu"/>
   </locale>

   <resources>
		<res id="installer.langsel.img" src="images/helloworld_image1.png" />
		<res id="Installer.image" src="images/helloworld_image2.png" />
	    <res id="LicencePanel.licence" src="Licence.txt"/>
	    <res id="InfoPanel.info" src="Readme.txt"/>
   </resources>

   <panels>
        <panel classname="HelloPanel"/>
        <panel classname="InfoPanel"/>
        <panel classname="LicencePanel"/>
        <panel classname="TargetPanel"/>
        <panel classname="PacksPanel"/>
        <panel classname="InstallPanel"/>
        <panel classname="FinishPanel"/>
   </panels>

   <packs>
		<pack name="InspectITHelloWorld" required="yes">
			<description>Hello World Application Runnables</description>
			<file src="/home/user/workspace/IzPackInstallerHelloWorldInstaller/bin/HelloWorld.class" targetdir="$INSTALL_PATH"/>
			<file src="/home/user/workspace/IzPackInstallerHelloWorldInstaller/bin/HelloWorld$1.class" targetdir="$INSTALL_PATH"/>
			<file src="/home/user/workspace/IzPackInstallerHelloWorldInstaller/bin/HelloWorld$2.class" targetdir="$INSTALL_PATH"/>
		</pack>
   </packs>

</installation>

Next lines of xml code are the hearth of the creation of an installer with aid of IzPack Framework. Paste the xml code down below in the build.xml right after the build target.

...

Create two files in this directory /home/user/Desktop/Files4Installer.

• Licence.txt
• Readme.txt

These files can be empty for now or you put some content in it for better understanding.

Step 6. - Hello World

If you reached this section and done all the pastings and installations in the right order then right now you can build your first installer containing the compiled source code of the HelloWorld application. In the Ant View of Eclipse you can find the new created target named mk_installer and by executing it the following steps should be done one by one: source code compilation -> taking compiled source code and creating an installer by using a defined directory (used in tutorial: /home/user/Desktop/Files4Installer) -> placing the created jar file in a specified directory (used in tutorial: /home/user/Desktop/HelloWorld).

...