This tutorial will walk you, step-by-step, through creating your first installer using the InstallJammer Install Builder. The process is very easy and should take you no longer than a few minutes. You'll have your first installer up and running in no time!
Creating Your First Install
When InstallJammer first loads, you are presented with the Start Page that shows you a list of current installers you have built. Your first time out, this page will have no projects. So, let's create one!
New installs are created in InstallJammer using the Install Project Wizard. You can open up the wizard by either clicking the "New Install" button on the main toolbar or by opening up the File menu and clicking "New." By clicking either of these options, you should now be presented with the Install Project Wizard. InstallJammer uses the wizard to guide you through the rest of the new install process.
Step 1 - Project Information
Step 1 of the wizard asks you for some basic project information. This information is all internal to InstallJammer and tells it where you want to save your project and what you want to call the project.
This is what you want to call your project. This does not have to be the name of the application you are installing, but it would make sense.
This is the directory where you want to store this project. A new directory will be created to store your install. In InstallJammer, each project is stored in its own directory so that everything can be contained.
Step 2 - Application Strings
Step 2 of the wizard asks you some information about the product or program that you will be installing.
This is the name of your application or product.
Short Application Name
This is a shortened name for your application. This name is used on most UNIX systems as a directory, so it is usually all lowercase with no spaces.
This is the version of your product. This value is not used by InstallJammer for anything, it is there as a representation of your software to the person installing it.
This is the name of your company or organization.
Step 3 - Application Information
Step 3 of the wizard asks for a few more pieces of information about your application.
This version is used internally by InstallJammer as a way to track this version of your software against future versions. If you distribute new versions of your software with the version incremented in this field, InstallJammer can (based on your options) install only files that are of the newer version. More on this later.
Windows Application Executable
This is the name of the main executable for your application on Windows. This is the entry point into your program, and InstallJammer uses it to make shortcuts and launch your application from within the installer if needed.
UNIX Application Executable
This is the name of the main executable or script for your application in a UNIX environment. This is the entry point into your program, and InstallJammer uses it to make shortcuts and launch your application from within the installer if needed.
Step 4 - Application Location
Step 4 is a very simple step that asks for the directory that your application is in. By adding your directory here, your application will start with the entire contents of this directory and all of its subdirectories in the project.
You do not have to specify a directory now. You can wait until you get started building the rest of your install and add whatever files and directories you want later.
Step 5 - Theme Selection
Step 5 gives you a list of install themes to choose from. The default theme is the Modern Wizard theme.
Step 6 - Platform Selection
Step 6 presents you with a list of platforms supported by your installation of InstallJammer and asks you to pick which ones you plan to install on. You need only pick a single platform for your installer if your software is not multiplatform.
By default, only the platform you are building on is selected. Not selecting a platform here does not remove the platform from your installer, it only disables it. This is so that if you decide to add more platforms in the future, you can easily switch them on as needed without having to rebuild your install project.
Step 7 - Additional Features
Step 7 lets you select some additional features you might like to add to your installer. Most of the features are switched on by default, as they are common to most installers used today.
Allow users to select custom components in your install
If this feature is checked, InstallJammer will add two panes to your installer that allow a user to select a Custom install option and then select the custom components they wish to install from your product. This is only important if you have many components in your install and you want the user to be able to choose which parts they install.
Include an uninstaller
If this feature is checked, InstallJammer will add an action to your install actions to create an uninstaller when your application is installed.
Add the uninstaller to the Windows Add/Remove Programs register
If this feature is checked, InstallJammer will add an action to your install actions to create a registry entry in Windows' "Add/Remove Programs" registry. This means your customers will be able to uninstall your program from the main Windows Control Panel.
Add a Windows Program shortcut action for the uninstaller
If this feature is checked, InstallJammer will add an action to your installer to create a Windows shortcut in your application's Program Folder that points to the uninstaller for your application.
Add a Windows Program shortcut action for this application
If this feature is checked, InstallJammer will add an action to your installer to create a Windows shortcut in your application's Program Folder that points to your application. The Program Folder will automatically be created for your application if it does not already exist.
Add a View Readme checkbutton
If this feature is checked, InstallJammer will add a View Readme checkbutton to the Setup Complete pane of your installer to allow the user to view your README file before exiting the installer.
Add a Launch Application checkbutton
If this feature is checked, InstallJammer will add a checkbutton to the Setup Complete pane of your installer to allow the user to launch your application before exiting the installer.
Add a Create Desktop Shortcut checkbutton
If this feature is checked, InstallJammer will add a Create Desktop Shortcut checkbutton to the Setup Complete pane of your installer to allow the user to create a shortcut to your application on their desktop before exiting the installer.
Add a Create Quick Launch checkbutton
If this feature is checked, InstallJammer will add a Create Quick Launch Shortcut checkbutton to the Setup Complete pane of your installer to allow the user to create a shortcut to your application in their quick launch toolbar before exiting the installer.
Final Step - Create Install
Now that you have gone through all the steps, you're ready to create your install! Click the finish button, and InstallJammer will create your install and open it to get you started.
Building Your Install
Now you're ready to build your installer! Click the Build Install button on the toolbar or under the Build menu, and InstallJammer will build an installer for your application. If you entered all of your data correctly, you should end up with an installer that is ready to go!
Testing Your Installer
If your installer built successfully, you're ready to give it a test. Click the Test Install button on the toolbar or under the Build menu. Run through the installer, and your program should install in a default location. Make sure you don't change the destination directory when testing your installer. If you do, InstallJammer can't find your installed application to test the uninstaller.
Testing Your Uninstaller
Once you have your application installed, it's time to test your uninstaller. Click the Test Uninstall button on the toolbar or under the Build menu. InstallJammer will execute the uninstaller that was created when your application was installed. Run through the uninstaller to delete the test run you just installed.