Introduction 'Setup' Page 'Dir' Page 'Files' Page 'Icons' Page 'INI' Page 'Registry' Page 'Run' Page 'Delete' Page 'Spanning' Page 'Finish' Page 'Listing' Page 'Options' Page Reusing Scripts

ScriptMaker Tutorial

The [Initial Setup] Page



ScriptMaker's "Initial Setup" page allows us to set some options for the whole installation package. The first thing we will do is to enter the name and version number of the project - in the Application Name field, type name of your application, and in the Version No. field, type the application version number, for example "1.12". These two pieces of information will appear at various points when the user installs your application. The table below sets out how and where they are normally used:

StageName
Only
Name
plus
Version
Initial Prompt
Tick
Setup Background
Tick
Setup Wizard - Page 1
Tick
Tick
Setup Wizard - Page 3
Tick
Setup Wizard - Page 5
Tick
Setup Completed
Tick
Add/Remove Programs
Tick
Uninstall Completed
Tick

Version Formatting

You can, if you wish, get ScriptMaker to format the version number automatically based on the version information contained in the main executable. The executable file must contain the version information in the standard VERSION_INFO format which normally consists of four numbers (e.g. 1.2.3.4). These four numbers can be represented in the version format by the constants %m = Major version, %n = Minor version, %s = Sub version, %b = Build (sub-sub version). For example, if you type "Version %m.%n"" in the Version No. field, and the main executable is version 2.6, ScriptMaker will automatically insert "Version 2.6" in the Version No. field. If you want to use letters instead of numbers in part of the version format, use capital letters instead of lowercase letters (%M, %N, %S or %B). Another example: the main executable contains a VERSION_INFO script which has the ProductVersion entry as "1.2.14.3", and you have typed in the Version No. field the format "%m.%n.%s%B". ScriptMaker will interpret this as "1.2.14c". Note that version formatting is an option - you don't have to use it if you prefer not to. A similar type of formatting can be used in the Setup Filename field on the [Finish] page.

To the right of the Version No. field is a set of radio buttons which allow you, if you want, to reverse the way in which the version number is used. Normally AppVerName is selected in which case the version number is used as shown in the previous table. Selecting AppName reverses the usage.

'Attach Version No.' panel

Next, we come to the Copyright field. If you have used ScriptMaker before, the field will already contain the last copyright message you used. You can, of course, alter this if you wish. The text will normally be something along the lines of "Copyright TaFWeb Software 1999". Instead of entering the copyright year directly, you can also specify it as "{yyyy}" (without the quotes), for example "Copyright TaFWeb Software {yyyy}". In this case the current year will be automatically inserted whenever you load a script. The codes {yy} and {y} are also accepted; the first will be replaced with the last two digits of the year, the second by the final digit of the year.

The Password field allows you to password-protect the installation file. You should note, however, that the password is not encrypted in any way and so only provides a low level of security. However, it should be good enough to prevent the casual unauthorised user from installing the program.

Inno Setup does not, at present, have the ability to ask the user if they want to run the application immediately after installation. ScriptMaker overcomes this by bundling a small application (called SMRunApp.exe) which will be included in the project and run automatically after installation if the Run App after install checkbox is checked. Note that the file which is to be run must be marked using the Is Main Exe File checkbox on the [Files] page. This is not the most elegant solution but works as a stopgap until such time as Inno Setup includes this option.

The background colour (or 'color' for our trans-atlantic friends - please don't e-mail me about my incorrect spelling :-) is normally filled with a colour gradient varying from blue at the top to black at the bottom. You can change both colours by clicking the appropriate coloured square and then selecting from the normal colour dialog. You can also, if you want, have a plain coloured background by checking the Solid Background checkbox. The colour gradient normally runs from top to bottom of the screen, but can be changed to run from left to right using the Direction combo below the colour panels.

You can test how the selected colours will look by clicking the Check Appearance button. This will show you a full-scale picture of the Setup background in the chosen colours, and also allow you to test other colours.

The four checkboxes at the bottom of the Background Window section allow you to make various choices about how the background window appears when the user runs the Setup. The checkboxes are checked by default. Unchecking the Window Resizable checkbox stops the user resizing the background window when it isn't maximized. The illustrations below show the effect of the other buttons:

All checkboxes checked
All checkboxes checked (default)

Show Caption unchecked
Show Caption unchecked

Start Maximized unchecked
Start Maximized unchecked

Window Visible unchecked
Window Visible unchecked

Setup Wizard default imageVersion 1.12.3 of Inno Setup introduced the ability to change the picture used in the Setup Wizard (the illustration on the right shows the default image). This can be any bitmap image and must contain no more than 16 colours. The maximum size for the image is 117 x 231 pixels. The image to be used can be chosen in the Wizard Image field (using the "browse" button or by typing into the field). Leave this field blank if you want to use the default image. The Image Background Colour panel also allows the choice of colour for the image background - click the panel to choose a colour. As with the choice of background colour in the previous paragraph, you can use the Check Appearance button to see how the chosen image will look in the finished setup. The Edit Image button is provided so that you can quickly edit a chosen Wizard image. Clicking the button will start your default bitmap-editing application and load the current Wizard image into it.

The Compression Level affects how compressed the final setup file will be. Level 7 is the default level which gives good compression together with a reasonable compile time. The lowest level is level 1 (virtually no compression). Level 9 gives the highest compression but is not appreciably better than level 7. Note that level 0 (no compression) is available only in Inno Setup version 1.12.3 onwards. The table below gives some idea of the relationship between compression level and actual setup file size (this may vary, of course, from one project to another and will also depend upon the speed of your computer):

Compression
Level
Final
File Size (KB)
Compilation
Time (Secs)
1 944.9 14.8
2 934.3 14.9
3 925.1 16.6
4 910.9 17.6
5 902.6 20.1
6 898.5 25.9
7 897.5 29.4
8 896.5 40.8
9 896.3 48.0

These tests should be taken as comparative only, and you will probably get a much faster compilation time as the tests were deliberately carried out on an old, slow computer. The tests also showed that compressing the executable file with a program like ASPack reduced both the final file size, the compile time and the difference between the various levels of compression. Overall the choice of level 7 as the optimum seems sensible.

Having chosen a compression level we now have to decide whether the files should be Uninstallable. This checkbox is checked by default, but for the odd occasion when you don't want the file to be uninstallable, clear this checkbox.

The next choice we have to make is the Min. Windows Version - the lowest version of Windows with which the executable will work. The default setting is Windows 95 and Windows NT 4 (or Windows 3.1 and NT 3 for a 16-bit setup). Don't choose N/A for both choices or the setup will not install at all!

If you check the Admin. Privileges Required checkbox, Setup will give an error message at startup if the user doesn't have administrative privileges.

If you wish, you can also make a choice from the Only install if below list. By using this and the Min. Windows Version you can select a "range" of operating systems. The same choices can be made for individual files, directories and icons on the appropriate pages.

The final essential choice on this page is the Inno Setup Version. Unless there is a good reason to do otherwise it is best to choose the latest version (1.2 at present). Versions 1.10, 1.11, 1.12 and 1.2 can be chosen if necessary, but some options may not then be available.

The Inno Setup Language (ISL) Files

Inno Setup version 1.12 introduced .isl files - text files which allow easy translation of Setup's messages into languages other than English. In ScriptMaker you can choose which file is to be used for a particular project by selecting the filename in the ISL Filename field. The Edit .ISL File button lets you easily edit an ISL file, but you should be aware that at present these files may be subject to change.

We are now ready to move on to the Setup page.

Member of
International Freeware Authors Association
International Freeware
Authors Association
Site Created with TaFWeb Software's PageBuilder




Back - IntroductionNext - 'Setup' Page



Copyright © 2005

Last major revision: 5 May 2000 at 14:44 BST Minor revisions: 4 February 2005 at 14:52 BST
This page URL: http://www.tafwebsoftware.co.uk/smtut2.html