Tutorial alluso di

INNO SETUP
Installer di Jordan Russell

Enzo Iorio 2006

www.vbscuola.it

Tutorial su INNO SETUP www.vbscuola.it

Generalit di Inno Setup

Inno Setup, giunto alla versione 5, un installer per le proprie applicazioni completamente
freeware.
Usato da molteplici programmatori per distribuire pacchetti di installazione delle loro
applicazioni, scaricabile dal sito del suo ideatore Jordan Russell all'indirizzo www.jrsoftware.org
Inno Setup , attraverso un file di script, completamente programmabile in un linguaggio simile
al Turbo Pascal per Ms Dos (evolutosi poi nel Delphi per Windows).
Lo script di Inno Setup un vero e proprio linguaggio di programmazione, con tanto di strutture
decisionali, strutture cicliche, funzioni o procedure e direttive per il compilatore del setup.
Ammette luso di variabili e funzioni tipiche di un linguaggio visuale come ad esempio il
message box, insomma un linguaggio di programmazione, le funzioni sulla risoluzione dello
schermo, molto utili se si desidera bloccare linstallazione se la risoluzione video inferiore a quella
voluta.

Questo tutorial non un manuale di spiegazioni completo all'uso di Inno Setup, ma solo una serie di
indicazioni per l'uso di Inno Setup per ottenere un setup di installazione per la propria applicazione, in
poco tempo.

Pagina 2 di 13

Tutorial su INNO SETUP www.vbscuola.it

Installazione di Inno Setup

Una volta scaricato Inno Setup, bene scaricare anche, attraverso il link sulle Inno Setup
Translations, il linguaggio italiano chiamato Italian.isl. tradotto da un programmatore italiano, che
come tanti in tutto il mondo hanno contribuito alla diffusione di Inno Setup, come programmi
addizionali di terze parti quali InnoScript, di cui si accenner in seguito.
Il translators scaricato, non consente di ottenere i men o i vari messaggi di funzionamento di Inno
Setup in italiano, ma serve per ottenere un setup di installazione della propria applicazione in italiano.
Una volta installato Inno Setup sul proprio computer, nella cartella Languages va inserito il file di
translator in italiano. Infatti nella cartella principale di Inno Setup presente il file translator di default,
in lingua inglese, chiamato default.isl.

Linstaller creato con Inno Setup ha un aspetto decisamente professionale, come mostrano le figure
seguenti, che riportano la schermata iniziale di una installazione:

Pagina 3 di 13

Tutorial su INNO SETUP www.vbscuola.it

Le schermate della nostra Installazione

Quando si lancia il nostro setup creato con Inno Setup, vengono mostrate una serie notizie e opzioni
per linstallazione, in schermate sequenziali:
Al lancio del setup viene mostrata, in posizione verticale e a sinistra,
un'immagine, da noi scelta o costruita.
Alla destra dellimmagine viene indicato in caratteri grandi, il
messaggio di benvenuto allinstallazione seguito dal nome del
programma da installare, e poi in caratteri pi piccoli di nuovo il
nome del programma comprensivo della versione e lindicazione di
chiusura delle applicazioni eventualmente aperte.
La schermata successiva, contiene una piccola immagine nell'angolo in alto a destra, che sar

mantenuta per tutta la durata dellinstallazione.

Nella finestra scorrevole tramite la barra di scorrimento verticale,
vengono riportati i termini della licenza d'uso del programma che si
sta installando (questa schermata facoltativa, non compare se non
si specifica la descrizione dei termini della licenza duso).
Se non si accettano i termini di licenza, cio se non si esegue il click
sull'opzione 'accetto i termini di licenza', il pulsante di avanzamento
dell'installazione non viene attivato.
Accettati i termini della licenza, compare la richiesta della password
di accesso per poter proseguire con l'installazione.
Inserita la password si prosegue nella schermata successiva. Anche
questa schermata con luso della password facoltativa.

Nella
finestra
scorrevole,
attraverso la barra di scorrimento, viene visualizzato un messaggio
dell'autore del programma prima che avvenga l'installazione
contenente notizie varie sul programma, o altro.
Anche questo messaggio (e relativa finestra) facoltativo.

Pagina 4 di 13

Tutorial su INNO SETUP www.vbscuola.it

A questo punto ha inizio la vera e propria procedura di installazione,

infatti viene indicata la cartella (o directory per gli amanti del Ms
Dos) dove installare il nostro programma, e lo spazio richiesto dalla
nostro programma, compreso di tutti i files di supporto che abbiamo
abbinato al nostro programma.
E data la possibilit di rinominare la cartella o il percorso
digitandolo direttamente nel campo, oppure possibile selezionare
una nuova cartella, attraverso il tasto sfoglia.

Viene indicata la cartella del men Start di Windows ove inserire

licona tramite la quale viene lanciato il nostro programma.
Oppure, attraverso il pulsante sfoglia, possibile inserire tale icona
in un gruppo di programmi.

A questo punto si sceglie se si vuole inserire licona di lancio del

nostro programma sul desktop e/o posizionare la stessa icona
direttamente sulla barra delle applicazioni di Windows, inserendo un
segno di spunta sulle rispettive voci.

Proseguendo, vengono mostrate le informazioni relative ai percorsi

di installazione dei vari files e cartelle di supporto al nostro
programma

Nella
finestra
scorrevole,
attraverso la barra di scorrimento, viene visualizzato un ultimo
messaggio
dell'autore
del
programma, il messaggio dopo
linstallazione, con notizie varie a
posteriori
dellinstallazione.
Anche questo messaggio e
relativa finestra facoltativo.
Alla fine viene indicato il messaggio di completamento
dellinstallazione del nostro programma con lopzione di esecuzione
dello stesso alluscita della procedura di installazione.

Pagina 5 di 13

Tutorial su INNO SETUP www.vbscuola.it

Al termine dellinstallazione, il nostro programma mantiene licona imposta per la sua creazione,
nellesempio il programma chiamato Codice fiscale possiede licona della bandiera italiana.
Questo programma una volta installato, si presenter come segue:
sulla barra delle applicazioni,

sul desktop.

nelle ramificazioni del men Avvio/Start di

Windows.

Da notare la cartella finale, oltre a contenere

il programma (icona bandiera italiana),
presenta anche un link Web che carica il
Browser di navigazione in Internet,
collegandosi direttamente ad una pagina web
da noi impostata.
Inoltre presenta anche il programma di
disinstallazione del nostro programma.

Pagina 6 di 13

Tutorial su INNO SETUP www.vbscuola.it

Creazione di un setup guidato (ScripWizard)

Inno Setup, consente di creare un pacchetto di installazione del proprio programma tramite la
creazione guidata del pacchetto stesso, e al termine della creazione, viene generato lo script di setup,
cio viene descritto nel linguaggio di Inno Setup in che modo creare il pacchetto di installazione.
Caricato Inno Setup, viene
proposta la schermata, in cui
si pu scegliere se eseguire il
pacchetto tramite la guida o
passare direttamente alleditor
dello script
Selezioniamo la scelta della guida
(Script Wizard), e saltiamo il
messaggio di benvenuto.

Pianifichiamo il lavoro per semplificare la creazione del

pacchetto di installazione (Setup)
- La struttura del programma

Supponiamo di voler creare un pacchetto di installazione del programma chiamato Codice Fiscale
la cui versione la numero 1.8.
Supponiamo ancora che questo programma necessita di un file addizionale chiamato
Procedure.bas, che deve necessariamente risiedere nella stessa cartella in cui risiede il programma
Codice fiscale.
Inoltre Il nostro programma necessita ancora di una cartella, posta anchessa nella cartella ove
risiede il programma codice fiscale, che contiene vari file dati, a supporto del programma stesso e
deve chiamarsi FilesVari.
- Tre messaggi di testo da visualizzare

Diamo un tocco di professionalit al nostro pacchetto, facendogli visualizzare i termini di licenza

del programma, una nota informativa prima di proseguire con linstallazione e una nota
informativa da visualizzare al termine dellinstallazione stessa.
Quindi prepariamo 3 file di testo (formato ascii) scritti magari con il NotePad a corredo di
Windows, e li chiamiamo rispettivamente Licenza.Txt, MsgPrima.Txt e MsgDopo.Txt
Pagina 7 di 13

Tutorial su INNO SETUP www.vbscuola.it

- Link al sito Web

Se abbiamo un sito WEB da pubblicizzare appuntiamo il suo indirizzo per poi inserirlo nel
pacchetto di installazione.

- La grafica

Inno Setup gestisce due files grafici di default, in formato BitMap (estensione BMP).
Il primo grafico, quello pi grande, rettangolare, che misura 164x314 a 256
colori (24 bit), chiamato WizModernImage.Bmp, mentre Il secondo file
grafico pi piccolo e quadrato chiamato WizModernSmallImage.Bmp che misura
55x55 a 256 colori (24 bit).

In alternativa, a corredo con Inno Setup sono forniti altri due file dalla
grafica pi aggiornata: WizModernimage-is.Bmp e WizModernSmallImageis.Bmp
Possiamo comunque, rispettando i parametri indicati, costruirci dei files grafici
personalizzati per il nostro pacchetto di installazione.
Per riepilogare la nostra applicazione, dispone della ramificazione
Cartella: FILESVARI

Files
vari

File: CODICE
FISCALE
File: PROCEDURE

A questo punto proseguiamo con le schermate presentate da Inno Setup

- Seconda schermata:
Proseguendo con Inno Setup avremo la schermata seguente, dove dobbiamo indicare nei campi:
Application Name

Nome del Programma, che sar visualizzalo nella finestra di

benvenuto e che verr poi riportato nel men di Avvio/Start di
Windows
Application name including version

Nome esteso del programma con la sua versione, e che sar

visualizzato solo in fase di installazione, nella finestra di benvenuto,
sotto application Name

Pagina 8 di 13

Tutorial su INNO SETUP www.vbscuola.it

Application Publisher (opzionale)

Nome che viene inserito, dopo linstallazione, sotto licona del programma installato, insieme al nome
del programma stesso
Application Website (opzionale)

E il nome del sito Web Viene inserito un collegamento al sito indicato, direttamente nella cartella
del programma installato, sotto Avvio/Start Programmi - <nome programma>

- Terza schermata:
Application destination base directory

Lasciare Program files directory, che crea in automatico la cartella

dove inserire i programmi.
Application directory name

Nome della cartella di destinazione dove installare il programma

C:\Programmi\<Application directory name> nel nostro esempio la
chiameremo Codice fiscale di vbscuola.
Lasciare i flag di default, in particolare il flag Allow user to change
the app consente in fase di installazione di cambiare la directory
di installazione.
- Quarta schermata:
Application main executable file

Selezionare il programma eseguibile da installare (il nostro

programma), tramite il pulsante Browse
Other application files (opzionale)

Selezionare ogni singolo file di cui fa uso il programma (file wave,

grafici, Database ecc) premendo il pulsante Add file(s) saranno
inseriti in <Application directory
name>. Oppure selezionare una
directory e tutti i suoi files saranno
inseriti in <Application directory name> Per variare la cartella di
destinazione, selezionarla e premere il pulsante Edit indicando una
cartella diversa di destinazione, nel nostro esempio la cartella, si
chiama FilesVari.
Nel caso in cui qualche file di cui fa uso il nostro programma deve
essere inserito in qualche cartella di Windows (come quella di
sistema), allora lo si seleziona, si preme il tasto edit e si sceglie la Destination base directory ove
installare il file.

Pagina 9 di 13

Tutorial su INNO SETUP www.vbscuola.it

- Quinta schermata:
Application Start Menu Folder Name

E il nome che prender la ramificazione (contenente il programma

chiamato <Application Name> allinterno del menu Programmi del
pulsante Avvio/Start di Windows. I flag sono:
Allow user to change the
Inserisce il collegamento al programma in Avvio/Start di Windows
Allow user to disable Start
Da la possibilit di non inserire il collegamento al programma in
Avvio/Start di Windows
Create an Internet shortcut
Inserisce il link al sito web indicato nella seconda schermata
Create an unistall Icon in the start menu folder
Inserisce lutility di disinstallazione del programma che si sta installando
Allow use to create a desktop icon
Inserisce licona del programma da installare sul desktop
Allow use to create a Quick:
Inserisce licona programma da installare anche sulla barra delle applicazioni di Windows

- Sesta schermata:
Se si desidera selezionare i tre file di testo con le notifiche
allinstallazione, allora occorre selezionare:
Licenze File (opzionale)

E il file di testo con i termini di licenza, che devono essere accettati

per poter proseguire con linstallazione. Nellesempio il file
Licenza.txt
File Information file show before installation (opzionale)

E il file di testo con le notizie da visualizzare prima di dare inizio

allistallazione. Nellesempio il file MsgPrima.Txt
File Information file show after installation (opzionale)

E il file di testo con le notizie da visualizzare dopo aver eseguito linstallazione. Nellesempio il file
MsgPrima.Txt

- Settima schermata:
Selezionare la lingua nella quale vengono indicati tutti i messaggi durante linstallazione del nostro
programma.

Pagina 10 di 13

Tutorial su INNO SETUP www.vbscuola.it

- Ottava schermata:
Compiler destination base directory

E la cartella dove risieder il file di setup del nostro pacchetto di

installazione, e sar un unico file.
Compiler output base file name

E il nome che prender il file contenente il pacchetto di

installazione, residente nella cartella menzionata prima.
Custom setup icon (opzionale)

E un file contenente una serie di icone, tra cui scegliere licona che
possieder il file del pacchetto di installazione e richiede le definizioni del compilatore.
Setup Password E la Password richiesta dal nostro pacchetto di

installazione.
Proseguire fino alla fine delle altre due schermate e terminare
premendo il pulsante Finish.
Inno Setup crea il linguaggio script per poter compilare il nostro
pacchetto di installazione, con le condizioni inserite.
Questo file script lo si pu salvare o modificare, per poi compilarlo
successivamente.
Ad ogni modo compare il messaggio: Would you like compile the new script now? Premendo Si, viene
eseguita la compilazione dello script e creato il file di installazione.

Pagina 11 di 13

Tutorial su INNO SETUP www.vbscuola.it

Il file script generato

Per brevit si riportano semplicemente alcune modifiche al file script, senza commentare il codice, in
quanto per buona parte facilmente intuibile e comunque per le particolarit si rimanda allhelp in
linea di Inno Setup, che risulta piuttosto dettagliato.
; Script generated by the Inno Setup Script Wizard.
; SEE THE DOCUMENTATION FOR DETAILS ON CREATING INNO SETUP SCRIPT FILES!
#define
#define
#define
#define
#define
#define

MyAppName "Codice fiscale"

MyAppVerName "Codice fiscale 1.8"
MyAppPublisher "(vbScuola)"
MyAppURL "www.vbscuola.it"
MyAppExeName "CodiceFiscale2.exe"
MyAppUrlName "CodiceFiscale2.url"

[Setup]
AppName={#MyAppName}
AppVerName={#MyAppVerName}
AppPublisher={#MyAppPublisher}
AppPublisherURL={#MyAppURL}
AppSupportURL={#MyAppURL}
AppUpdatesURL={#MyAppURL}
DefaultDirName={pf}\Codice fiscale di vbScuola
DefaultGroupName={#MyAppName}
LicenseFile=H:\Prg\Licenza.txt
InfoBeforeFile=H:\Prg\MsgPrima.txt
InfoAfterFile=H:\Prg\MsgDopo.txt
OutputDir=e:\compilazione
OutputBaseFilename=SetupCodFisc
Password=chicca
Compression=lzma
SolidCompression=yes

Nella sezione del setup possiamo aggiungere le due righe di codice che caricano i grafici, senza usare
quelli di default
WizardImageFile=C:\Documenti\GraficoGrande.BMP
WizardSmallImageFile=C:\Documenti\GraficoiPiccolo.BMP
[Languages]
Name: "italian"; MessagesFile: "compiler:Languages\Italian.isl"
[Tasks]
Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription:
"{cm:AdditionalIcons}"; Flags: unchecked
Name: "quicklaunchicon"; Description: "{cm:CreateQuickLaunchIcon}"; GroupDescription:
"{cm:AdditionalIcons}"; Flags: unchecked

[Files]
Source: "H:\Prg\CodiceFiscale2.exe"; DestDir: "{app}"; Flags: ignoreversion
Source: "H:\Prg\Procedure.bas"; DestDir: "{app}"; Flags: ignoreversion
Source: "H:\Prg\Supporto\*"; DestDir: "{app}\FilesVari"; Flags: ignoreversion recursesubdirs
createallsubdirs
; NOTE: Don't use "Flags: ignoreversion" on any shared system files

Pagina 12 di 13

Tutorial su INNO SETUP www.vbscuola.it

In questa sezione, dovendo inserire una DLL nella directory System e registrarla :
Source: E:\MSRD2X35.DLL; DestDir: {sys}; CopyMode: alwaysskipifsameorolder; Flags:
restartreplace sharedfile regserver

mentre per un OCX o DLL nella directory System senza la sua registrazione:
Source: E:\MSREPL35.DLL; DestDir: {sys}; Flags: ConfirmOverWrite

[INI]
Filename: "{app}\{#MyAppUrlName}"; Section: "InternetShortcut"; Key: "URL"; String:
"{#MyAppURL}"
[Icons]
Name: "{group}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"
Name: "{group}\{cm:ProgramOnTheWeb,{#MyAppName}}"; Filename: "{app}\{#MyAppUrlName}"
Name: "{group}\{cm:UninstallProgram,{#MyAppName}}"; Filename: "{uninstallexe}"
Name: "{userdesktop}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"; Tasks: desktopicon
Name: "{userappdata}\Microsoft\Internet Explorer\Quick Launch\{#MyAppName}"; Filename:
"{app}\{#MyAppExeName}"; Tasks: quicklaunchicon
[Run]
Filename: "{app}\{#MyAppExeName}"; Description: "{cm:LaunchProgram,{#MyAppName}}"; Flags:
nowait postinstall skipifsilent
[UninstallDelete]
Type: files; Name: "{app}\{#MyAppUrlName}"

Per creare uno script molto particolareggiato si pu usare un programma freeware scaricabile dalla rete,
che consente di settare il pacchetto applicativo nelle sue molteplici parti.
Il programma in questione ScriptMaker, che attraverso varie schermate e impostazioni, in grado di
generare uno script molto efficiente per creare i nostri pacchetti di installazione. Lo si scarica
allindirizzo http://www.hisoft2000.de il cui link si ritrova anche sul sito di Jordan Russell
Un altro programma, pi semplice da usare, ISTool , anchesso freeware, molto simile a ScriptMaker
prelevabile allindirizzo www.istool.org
Per trovare la soluzione alle condizioni poste per i propri pacchetti di installazione, visitare gli
innumerevoli forum in rete.

Pagina 13 di 13