CyberInstaller - 3. Script di installazione

Un pacchetto CyberInstaller necessita di uno script di installazione per poter essere utilizzato. Tale script altro non è che un file di testo con estensione .dat, opportunamente compilato (con un qualsiasi editor come Blocco Note di Windows), che indica al motore di installazione (CyberInstaller) il comportamento da adottare in fase di installazione, quali file installare e registrare, l'interfaccia da visualizzare, i collegamenti da creare, e tutto ciò che serve per compiere l'installazione nel modo desiderato.

Un pacchetto, oltre che dallo script, è definito anche dalla struttura di cartelle.

N.B.: Per evitare di dover svolgere manualmente queste noiose operazioni, è altamente consigliato (anche se non indispensabile) utilizzare CyberInstaller Studio, che tramite una comoda interfaccia a schede, si occuperà di creare il pacchetto di installazione e di tutti i dettagli tecnici al posto nostro, in modo completamente automatico, trasparente, e soprattutto senza possibilità di errore. L'uso di CyberInstaller Studio è inoltre indispensabile per la creazione del pacchetto eseguibile autoestraente.

CyberInstaller - 3. Sintassi e descrizione sezioni

Lo script di installazione è il file INSTALL.DAT e deve trovarsi obbligatoriamente nella stessa cartella (allo stesso livello) in cui si trova Setup.exe (il file principale di CyberInstaller).

Per compilare adeguatamente lo script, è opportuno seguire le indicazioni contenute nello stesso file sottoforma di commenti (le righe precedute da ";"). Lo script è suddiviso in sezioni, quasi sempre corrispondenti ai passi di creazione pacchetto di CyberInstaller Studio, e ognuna si occupa di un ben preciso aspetto del processo di installazione. Modificando una sezione è necessario attenersi attentamente alle note presenti all'inizio di ognuna, dove sono elencati i possibili parametri da usare, eventuali comandi speciali, e codice di esempio.

NOTE:

Non cambiare le righe che indicano le sezioni, cioè quelle precedute da ">". Le righe precedute da ";" sono commenti, quindi possono essere modificate/rimosse/aggiunte a piacere in qualsiasi punto dello script, all'esterno e all'interno delle sezioni. L'unica limitazione consiste nel risiedere in righe a loro riservate, cioè non accanto a comandi. Il carattere "<" indica fine sezione e deve essere inserito.
L'ordine delle sezioni non è prefissato: può essere definito a piacere.

File e comandi possono essere aggiunti a piacere dopo la riga di sezione, con la dovuta attenzione e rispettando la sintassi (visibile nel commento che la precede).
I comandi racchiusi da "|" sono parole riservate e non vanno cambiate. Il loro significato è ben preciso e spiegato qui di seguito.
Usare i seguenti comandi per riferirsi ai percorsi speciali di sistema:

Generali (raccomandati):

|$AppPath$| | destinazione applicazione da installare (quella confermata dall'utente)
|$AppsToRunPath$| | cartella contenente le applicazioni da eseguire prima/dopo l'installazione
|$CommonPath$| | cartella File Comuni (di solito C:\Programmi\File Comuni o Common Files)
|$FontsPath$| | cartella dei fonts
|$ProgramsPath$| | cartella Programmi (di solito C:\Programmi oppure C:\Program Files)
|$SystemPath$| | System (di solito C:\WINDOWS\SYSTEM o C:\WINNT\SYSTEM32)
|$WinPath$| | Windows (di solito C:\WINDOWS o C:\WINNT)

N.B.: attenzione alle differenza tra gli utenti per i seguenti comandi!!! Se si usano i comandi relativi all'utente corrente o a tutti gli utenti il valore della sezione ChooseUserSpecialPath non verrà preso in considerazione (non raccomandato).

Relativi all'utente selezionato in fase di installazione (raccomandati). Percorsi speciali in base alla sezione ChooseUserSpecialPath o alla scelta dell'utente (si consiglia di usare questi comandi, in modo da dare all'utente un maggiore controllo sull' installazione):

|$AppDataPath$| | dati applicazioni
|$AutoExecPath$| | gruppo Esecuzione Automatica nel menu avvio
|$DesktopPath$| | desktop
|$DocumentsPath$| | documenti
|$ModelsPath$| | modelli documento
|$StartMenuPath$| | menu avvio
|$StartProgPath$| | gruppo Programmi nel menu avvio
|$UserMenuFolder$| | cartella di gruppo nel Menu Avvio scelta dall'utente
|$UserPatternPath_001$| | cartella destinazione extra, percorso specificato dall'utente o letto da registro durante l'installazione

Utente corrente (qualsiasi sia l'utente selezionato in fase di installazione) (non consigliati):

|$CU_AppDataPath$| | dati applicazioni
|$CU_AutoExecPath$| | gruppo Esecuzione Automatica nel menu avvio
|$CU_CookiesPath$| | cookies
|$CU_DesktopPath$| | desktop
|$CU_DocumentsPath$| | documenti
|$CU_FavoritesPath$| | preferiti
|$CU_ModelsPath$| | modelli documento
|$CU_PrintersPath$| | risorse di stampa
|$CU_SendToPath$| | invia a
|$CU_StartMenuPath$| | menu avvio
|$CU_StartProgPath$| | gruppo Programmi nel menu avvio
|$CU_UserMenuFolder$| | cartella di gruppo nel menu avvio scelta dall'utente
|$CU_WebCachePath$| | cache internet

Tutti gli utenti (qualsiasi sia l'utente selezionato in fase di installazione) (non consigliati):

|$All_AppDataPath$| | dati applicazioni
|$All_AutoExecPath$| | gruppo Esecuzione Automatica nel menu avvio
|$All_DesktopPath$| | desktop
|$All_DocumentsPath$| | documenti
|$All_ModelsPath$| | modelli documento
|$All_StartMenuPath$| | menu avvio
|$All_StartProgPath$| | gruppo Programmi nel menu avvio
|$All_UserMenuFolder$| | cartella di gruppo nel menu avvio scelta dall'utente

Altri comandi speciali:

|%CreateRemovalLink%| | da utilizzare nella sezione LinksToCreate per creare automaticamente un collegamento nel Menu Avvio (nel gruppo indicato dal'utente) per lanciare le rimozione dell'applicazione
|%CurrentUser%| | da utilizzare nella sezione ChooseUserSpecialPath per selezionare i percorsi speciali relativi all'utente correntemente loggato
|%AllUsers%| | da utilizzare nella sezione ChooseUserSpecialPath per selezionare i percorsi speciali relativi a tutti gli utenti abilitati nel sistema
|%Locked%| | da utilizzare nella sezione ChooseUserSpecialPath per evitare che l'utente modifichi il settaggio durante l'installazione
|%AutoConfirmation%| | da utilizzare nella sezione Components per specificare che non venga chiesta conferma all'utente prima di sovrascrivere un componente già installato nel sistema, ma la decisione verrà presa automaticamente in base alle versioni dei file (il componente già installato verrà sovrascritto solo se meno recente di quello che si sta installando)
|%AlwaysOverwrite%| | da utilizzare nella sezione Components per specificare che un eventuale file con lo stesso nome presente nel percorso destinazione deve essere sovrascritto
|%NeverOverwrite%| | da utilizzare nella sezione Components per specificare che un eventuale file con lo stesso nome presente nel percorso destinazione non deve essere mai sovrascritto, in nessun caso
|%DEFAULT_VALUE%| | da utilizzare nella sezione RegKeys come nome di un valore per indicare che il valore specificato è quello predefinito per la chiave corrente
|%BLOCKING%| | da utilizzare nella sezione MinimumRequirements per marcare un requisito come bloccante e non permettere così il proseguio dell'installazione
|%AskConfirm%| | da utilizzare nelle sezioni LinksToCreate e ExtensionsToAssociate per chiedere conferma all'utente prima di procedere

Comandi per identificare il sistema operativo (da usare solo nelle sezioni che li ammettono):

|%OS_Win3%| | sistema operativo Windows 3.1 + estensioni Win32s
|%OS_Win95%| | sistema operativo Windows 95
|%OS_Win95_OSR2%| | sistema operativo Windows 95 OSR2
|%OS_Win98%| | sistema operativo Windows 98
|%OS_Win98_SE%| | sistema operativo Windows 98 SE
|%OS_WinME%| | sistema operativo Windows ME
|%OS_WinNT3%| | sistema operativo Windows NT3
|%OS_WinNT31%| | sistema operativo Windows NT31
|%OS_WinNT35%| | sistema operativo Windows NT35
|%OS_WinNT4%| | sistema operativo Windows NT4
|%OS_Win2000%| | sistema operativo Windows 2000
|%OS_WinXP%| | sistema operativo Windows XP
|%OS_WinXP_SP2%| | sistema operativo Windows XP con Service Pack 2
|%OS_Win2003Server%| | sistema operativo Windows Server 2003
|%OS_WinVista%| | sistema operativo Windows Vista
|%OS_Unknown%| | sistema operativo non riconosciuto/non rilevabile

Tutti i comandi, così come i nomi delle sezioni, sono case-sensitive. Devono cioè essere inseriti nello script rispettando l'esatta sequenza di maiuscole/minuscole, perché siano riconosciuti correttamente.

Sezione: Look&Feel - Personalizzazione di CyberInstaller

(corrisponde al passo CyberInstaller Studio: 2)

Separare il nome dei parametri dal comando con un uguale [=] senza spazi.
Elenco parametri:

- TransparentForms = <TRUE|FALSE>: abilita/disabilita le trasparenze per le finestre non in primo piano. Settarlo a TRUE per avere la massima flessibilità e il gradevole effetto, a FALSE per ottenere la massima velocità di visualizzazione o in caso si verificassero blocchi di CyberInstaller. Scelta consigliata: FALSE.
- MoveableForms = <TRUE|FALSE>: abilita/disabilita la possibilità di muovere le finestre trascinando la barra del titolo. Settarlo a TRUE per avere la massima flessibilità e la stessa modalità di utilizzo dell'interfaccia standard di Windows, a FALSE per evitare che l'utente possa muovere le finestre di CyberInstaller. Scelta consigliata: TRUE.
- ShowBackground = <TRUE|FALSE>: abilita/disabilita la visualizzazione dello sfondo. Settarlo a TRUE per visualizzare lo sfondo che coprirà così il desktop di Windows e le altre applicazioni eventualmente aperte, ma consentirà di visualizzare nome dell'applicazione, produttore e logo, a FALSE per rendere l'interfaccia meno invasiva possibile, ma senza la possibilità di visualizzare il logo (se impostato). Scelta consigliata: TRUE.
- TransparentBackground = <TRUE|FALSE>: abilita/disabilita la trasparenza dello sfondo. ATTENZIONE: viene preso in considerazione solo se TransparentForms=TRUE e ShowBackground=TRUE. E' utile se si desidera mantenere uno sfondo non trasparente (settaggio a FALSE) pur abilitando le trasparenze delle finestre. Settarlo invece a TRUE per ottenere un gradevole effetto di oscuramento del dekstop di Windows. Scelta consigliata: FALSE.
- ShowBackgroundTitles = <TRUE|FALSE>: abilita/disabilita la visualizzazione delle scritte sullo sfondo. ATTENZIONE: viene preso in considerazione solo se ShowBackground=TRUE. Settarlo a TRUE per visualizzare nome dell'applicazione da installare e autore, nonchè un eventuale logo, sullo sfondo; a FALSE per avere lo sfondo più gradevole, come in caso di sfondo trasparente. Scelta consigliata: TRUE.
- BackgroundAppTitleFontSize = <TRUE|FALSE>: imposta la dimensione del font con cui è scritto il nome dell'applicazione da installare sullo sfondo. ATTENZIONE: viene preso in considerazione solo se ShowBackground=TRUE e ShowBackgroundTitles=TRUE. Scelta consigliata: 24.
- BackgroundCompanyTitleSize = <TRUE|FALSE>: imposta la dimensione del font con cui è scritto il nome dell'autore dell'applicazione da installare sullo sfondo. ATTENZIONE: viene preso in considerazione solo se ShowBackground=TRUE e ShowBackgroundTitles=TRUE. Scelta consigliata: 12.
- BackgroundColor = <codice colore>: colore da dare allo sfondo. E' possibile utilizzare qualsiasi colore.
- BackgroundTitlesColor = <codice colore>: colore dei titoli sullo sfondo. E' possibile utilizzare qualsiasi colore.
- TitleImageFile = <nome file .jpg .gif, .bmp nella cartella contenente Setup.exe>: immagine che verrà visualizzata sulla barra del titolo della finestra principale. E' necessario inserire solamente il nome del file, senza percorso, poichè il file dovrà essere inserito allo stesso livello di Setup.exe e non si potrà fare riferimento a nessun'altra cartella. Se non inserito o il file non esiste l'immagine non verrà visualizzata. Dimensioni massime (LxA) = 150 x 50 pixel.
- TitleImagePosition = <|TOP_SX|,|TOP_DX|>: posizione del logo sulla barra del titolo della finestra principale.
- WelcomeImageFile = <nome file .jpg .gif, .bmp nella cartella contenente Setup.exe>: immagine che verrà visualizzata sulla barra del titolo della finestra principale. E' necessario inserire solamente il nome del file, senza percorso, poichè il file dovrà essere inserito allo stesso livello di Setup.exe e non si potrà fare riferimento a nessun'altra cartella. Se non inserito o il file non esiste l'immagine non verrà visualizzata. Dimensioni massime (LxA) = 162 x 312 pixel.

Sezione: MinimumRequirements - Requistiti minimi

(corrisponde al passo CyberInstaller Studio: 14)

Separare il nome dei parametri dal comando con un uguale [=] senza spazi.
Elenco parametri:

- OSVersion = <pattern identificativo SO>/<pattern identificativo SO>/...: indica la versione del sistema operativo minimo per poter procedere con l'installazione
  es.: OSVersion=|%OS_WinXP_SP2%|/|%OS_WinXP%|/|%OS_Win2000%|/|%BLOCKING%| -> (Windows XP SP2 + WinXP + Win2000, bloccante)
- MinPhysicalRAM = <da 0 a 922337203685477>: indica la quantità minima di RAM per poter procedere con l'installazione
  es.: MinPhysicalRam=268435456/|%BLOCKING%| -> (256 MB di RAM fisica, bloccante)

- MinDestDiskSpace = <da 0 a 922337203685477>...: indica la quantità minima di spazio sul disco per poter procedere con l'installazione
  es.: MinDestDiskSpace=20971520/|%BLOCKING%| -> (20 MB di spazio nella partizione di installazione, bloccante)

- MinWinDiskSpace = <da 0 a 922337203685477>: indica la quantità minima di spazio sul disco sulla partizione in cui è installato windows, per poter procedere con l'installazione
  es.: MinWinDiskSpace=536870912/|%BLOCKING%| -> (512 MB di spazio nella partizione di Windows, bloccante)

- MinCPUSpeed = <da 0 a 32767>: indica la velocità del processore (MHz) per poter procedere con l'installazione
  es.: MinCPUSpeed=1200/|%BLOCKING%| -> (1/2 GHz velocità processore, bloccante)
- LoggedUserName = <nome utente connesso>: indica l'utente connesso
  es.: LoggedUserName=Administrator/|%BLOCKING%| -> (l'utente connesso deve essere l'amministratore, bloccante)
- MinVideoResolution = <da 0 a 32767>x<da 0 a 32767>: indica la risoluzione video
  es.: MinVideoResolution=1024x768/|%BLOCKING%| -> (risoluzione minima 1024x768, bloccante)
- MinVideoColorDepth = <da 0 a 32767>: indica la profondita di colore (bit - di solito i valori sono: 8/ 16/ 24/ 32)
  es.: MinVideoColorDepth=16/|%BLOCKING%| -> (la profondita di colore deve essere minimo a 16 bit, bloccante)

Sezione: ReadOnlyInstall - Eseguire un'installazione a sola lettura, cioè senza che l'utente possa modificare niente? <TRUE|FALSE>

(corrisponde al passo CyberInstaller Studio: 1)

- specificando TRUE all'utente non verrà data la possibilità di modificare i parametri dell'installazione, nemmeno quelli di base (es. la cartella di destinazione, ecc.) per completare l'installazione, ma verranno usati solamente i dati letti da questo script di installazione. Verranno comunque visualizzati eventuali file readme e la licenza, così come il riepilogo e il monitor di installazione.
- specificando TRUE la decisione sul sovrascrivere eventuali componenti già presenti nel sistema verrà presa automaticamente in base alla versione del file (il file verrà sovrascritto solamente se meno recente di quello che si sta installando) e all'utente non verrà chiesta conferma
  specificando FALSE all'utente verrà data la possibilità di modificare alcuni parametri di installazione (come la cartella di destinazione) fondamentali ATTENZIONE: se SilentInstall=TRUE alcuni parametri non saranno comunque modificabili dall'utente.
- specificando FALSE verrà chiesta conferma all'utente in caso di sovrascrittura di un componente già esistente, se non specificato diversamente nella sezione COMPONENTS. ATTENZIONE: viene preso in considerazione solo se SilentInstall = FALSE il default, in caso non venga specificato alcun comando (TRUE|FALSE) è FALSE.

Sezione: SilentInstall - Eseguire un'installazione silente, cioè senza richiedere informazioni all'utente? <TRUE|FALSE>

(corrisponde al passo CyberInstaller Studio: 1)

- specificando TRUE all'utente non verrà chiesta alcuna informazione (es. la cartella di destinazione, ecc.) per completare l'installazione, ma verranno usati solamente i dati letti da questo script di installazione. Verranno comunque visualizzati eventuali file readme e la licenza, così come il monitor di installazione.
- specificando TRUE la decisione sul sovrascrivere eventuali componenti già presenti nel sistema verrà presa automaticamente in base alla versione del file (il file verrà sovrascritto solamente se meno recente di quello che si sta installando) e all'utente non verrà chiesta conferma.
- specificando FALSE all'utente verrà data la possibilità di modificare alcuni parametri di installazione (come la cartella di destinazione) fondamentali. ATTENZIONE: viene preso in considerazione solo se ReadOnlyInstall=FALSE, in caso contrario i parametri verranno solo visualizzati, ma non saranno modificabili.
- specificando FALSE verrà chiesta conferma all'utente in caso di sovrascrittura di un componente già esistente, se non specificato diversamente nella sezione COMPONENTS. ATTENZIONE: viene preso in considerazione solo se ReadOnlyInstall = FALSE.
- il default, in caso non venga specificato alcun comando (TRUE|FALSE) è FALSE.

Sezione: MinimumInteractionInstall - Eseguire un'installazione a interazione minima, cioè minimizzando le richieste all'utente? <TRUE|FALSE>

(corrisponde al passo CyberInstaller Studio: 1)

- specificando TRUE all'utente verranno proposti solo i passi strettamente necessari a completare l'installazione: note di pre-installazione (se presenti), licenza da accettare (se presente) e cartella destinazione. Dopodichè inizierà il processo di installazione vera e propria, che verrà portato a termine unicamente in base alle impostazioni di questo stesso script.
- specificando TRUE la decisione sul sovrascrivere eventuali componenti già presenti nel sistema verrà presa automaticamente in base alla versione del file (il file verrà sovrascritto solamente se meno recente di quello che si sta installando) e all'utente non verrà chiesta conferma.
- specificando TRUE l'impostazione nella sezione per nascondere i dettagli (HideDetails) verrà bypassata (i dettagli verranno sempre nascosti).
- specificando FALSE all'utente verranno visualizzati tutti i passi per raggiungere il maggior numero di personalizzazione del processo di installazione.
- l'installazione silente ha la priorità su questa impostazione.

Sezione: UpdateInstall - Eseguire un aggiornamento anzicchè un'installazione completa del pacchetto? <TRUE|FALSE>

(corrisponde al passo CyberInstaller Studio: 1)

- specificando TRUE verrà eseguito un semplice aggiornamento del software anzicchè un'installazione completa, questo implica che come cartella destinazione verrà utilizzata la stessa usata in precedenza (alla prima installazione), e non verrà aggiunto un nuovo riferimento in Pannello di Controllo/Installazione applicazioni. Inoltre verranno aggiunte le informazioni relative all'aggiornamento alla rimozione del pacchetto principale, cosìcchè rimuovendo questo verranno anche rimosse anche tutte le modifiche effettuate al sistema dall'aggiornamento.
- specificando TRUE il Roll-Back verrà disattivato e non sarà possibile selezionare una cartella di gruppo per i collegamenti (verrà utilizzata quella di default).
- specificando FALSE verrà eseguita una nuova installazione.

Sezione: Rollback - Attivare il sistema di roll-back? <TRUE|FALSE>

(corrisponde al passo CyberInstaller Studio: 1)

- specificando TRUE il sistema di roll-back sarà di default attivato.
- specificando FALSE il sistema di roll-back sarà di default disattivato.
- l'utente ha comunque la facoltà di scegliere se attivare o meno quest'opzione.
- il default, in caso non venga specificato alcun comando (TRUE|FALSE) è FALSE.

Sezione: HideDetails - Nascondere i dettagli di installazione? <TRUE|FALSE>

(corrisponde al passo CyberInstaller Studio: 1)

- specidicando TRUE il riepilogo di installazione non verrà visualizzato
- specificando TRUE il monitor di installazione verrà visualizzato solo a richiesta
- il default è FALSE.

Sezione: AppToInstallTitle - Nome dell'applicazione da installare

(corrisponde al passo CyberInstaller Studio: 1)

Sezione: CompanyName - Casa produttrice o autore dell'applicazione

(corrisponde al passo CyberInstaller Studio: 1)

- è possibile ometterla se non si vuole che appaia.
- inserendo il pattern "[*]" alla fine della casa produttrice non verranno visualizzate.
- le informazioni sull'autore di CyberInstaller (il pattern non verrà visualizzato).

Sezione: Credits - Crediti autore pacchetto (verranno visualizzati in una finestra separata cliccando su "?")

(corrisponde al passo CyberInstaller Studio: 3)

Verranno presi in considerazione solo se è presente il pattern "[*]" alla fine della casa produttrice nella sezione "CompanyName".
Elenco parametri (N.B.: gli esempi sono da considerarsi senza virgolette):

- UseCustomCredits = <TRUE|FALSE>: se TRUE indica che bisogna utilizzare i crediti personalizzati (parametri successivi). Se FALSE ma è presente il pattern "[*]" alla fine della casa produttrice nella sezione "CompanyName", il pulsante "?" non verrà visualizzato. Preso in considerazione solo se è presente tale pattern.
- LogoImage = <nome file .jpg .gif, .bmp nella cartella contenente Setup.exe>: immagine che verrà visualizzata in alto nella finestra dei crediti. E' necessario inserire solamente il nome del file, senza percorso, poichè il file dovrà essere inserito allo stesso livello di Setup.exe e non si potrà fare riferimento a nessun'altra cartella. Dimensioni (LxA): 393x53 pixel. Se non inserito o il file non esiste l'immagine non verrà visualizzata.
  Es.: "SS.jpg".
- MainTitle = <stringa>: titolo principale (di solito il nome del pacchetto) visualizzata in grassetto sotto l'immagine del logo.
  Es.: "CyberInstaller 3.0".
- Copyright = <stringa>: testo del copyright, visualizzato sotto il titolo principale.
  Es.: "Copyright SilverCyberTech 2003-2006. Tutti i diritti riservati.".
- WebDescr = <stringa>: testo descrittivo prima del sito web.
  Es.: "Sito web:".
- Web = <indirizzo cliccabile>: indirizzo del sito web su cui l'utente potrà cliccare per navigare immediatamente verso il sito.
  Es.: "http://www.silvercybertech.com".
- EMailDescr = <stringa>: testo descrittivo prima dell'indirizzo email.
  Es.: "Supporto tecnico:".
- EMailAddress = <indirizzo cliccabile>: indirizzo email su cui l'utente potrà cliccare per inviare immediatamente una email.
  Es.: "support@silvercybertech.com".
- EMailSubj = <oggetto del messaggio email>: oggetto di default da impostare automaticamente per il messaggio email da inviare se lasciato vuoto conterrà il nome del pacchetto (sezione "AppToInstallTitle").
  Es.: "Richiesta di Aiuto per CyberInstaller".
- EMailBody = <testo del messaggio email>: testo di default da impostare automaticamente per il messaggio email da inviare.
  Es.: "Sono entrato in possesso del vostro software e vorrei un aiuto a riguardo."
- Notes = <stringa>: testo note aggiuntive visualizzate in piccolo in basso.
  Es.: "CyberInstaller in edizione Free è distribuito gratuitamente."

Sezione: Logo - File contenente il logo dell'applicazione

(corrisponde al passo CyberInstaller Studio: 2)

- ImageFile=<nome file .jpg .gif, .bmp nella cartella contenente Setup.exe>: immagine che verrà visualizzata sullo sfondo. E' necessario inserire solamente il nome del file, senza percorso, poichè il file dovrà essere inserito allo stesso livello di Setup.exe e non si potrà fare riferimento a nessun'altra cartella.
  Se non inserito o il file non esiste l'immagine non verrà visualizzata.
  es.: "SS.gif"

- Position=<|TOP_SX|,|TOP_DX|,|BOTTOM_SX|,|BOTTOM_DX|,|CENTER|>: posizione del logo sullo sfondo.
  es.: |TOP_DX|

Sezione: License - File contenente la licenza, da visualizzare prima dell'installazione

(corrisponde al passo CyberInstaller Studio: 3)

- deve essere contenuto nella cartella DATA (non si può fare riferimento a nessun'altra)

Es.:
Licenza.txt

Sezione: ReadmeFileBefore - File contenente note di preinstallazione, da visualizzare prima dell'installazione

(corrisponde al passo CyberInstaller Studio: 3)

- deve essere presente nella cartella DATA (non si può fare riferimento a nessun'altra)

Es.:
Note.txt

Sezione: DefaultDestinationFolder - Cartella di destinazione di default
<percorso>/[<percorso letto da registro: chiave\nome valore>]

(corrisponde al passo CyberInstaller Studio: 5)

- non è necessario che esista o che venga aggiunta nella sezione FoldersToCreate, verrà creata automaticamente.
- viene anche usata (l'ultima parte) per la cartella di gruppo di default da creare nel menu avvio (se l'utente non specifica diversamente).
- si può specificare una chiave di registro da cui leggere la cartella che verrà usata come destinazione, in questo caso lasciare vuoto il parametro <percorso>, in caso alternativo (se sono presenti entrambi i valori), la chiave di registro verrà ignorata

Es.:
|ProgramsPath|\CyberInstaller Suite
/HKEY_CURRENT_USER\Software\Corel\Paint Shop Pro\10\Browser\BrowseDir

Sezione: ExtraDestinationFolder - Cartella destinazione extra da assegnare al pattern personalizzato "|$UserPatternPath_001$|"
<descrizione>/<cartella (percorso assoluto o pattern)>/[<chiave registro\nome valore>]/<visibile TRUE|FALSE>/[<sola lettura TRUE|FALSE>]

(corrisponde al passo CyberInstaller Studio: 5)

- utile per creare un proprio pattern personalizzato da utilizzare come percorso nelle altre sezioni dello script
- non è necessario che esista o che venga aggiunta nella sezione FoldersToCreate, verrà creata automaticamente
- il pattern a cui il percorso sarà assegnato sarà sempre "|$UserPatternPath_001$|"
- la cartella associata al pattern sarà selezionabile dall'utente oppure leggibile da una chiave del registro
- è possibile impostare a TRUE il parametro opzionale "sola lettura" per non fare modificare la cartella all'utente
- la descrizione non può contenere il carattere "/", usato come separatore parametri
- se presente il parametro "cartella" può non essere presente "chiave registro"
- se presente il parametro "chiave registro" può non essere presente "cartella" in questo caso verrà usato il parametro "chiave registro" come "cartella"
- se presenti entrambi i parametri "cartella" e "chiave registro" sarà preso in considerazione e visualizzato all'utente (se "visibile" è TRUE) il primo
- se sia il parametro "cartella" che "chiave registro" non restituissero percorsi esistenti sul sistema destinazione, il campo apparirà vuoto all'utente

Es.:
Cartella del server:/G:\USER_FOLDER\Test//TRUE
Cartella del server://HKEY_LOCAL_MACHINE\Software\SilverCyberTech\DBPath/TRUE/FALSE
Cartella del server:/G:\USER_FOLDER\Test/HKEY_LOCAL_MACHINE\Software\SilverCyberTech\DBPath/TRUE/FALSE
Cartella del server://HKEY_CURRENT_USER\Software\Corel\Paint Shop Pro\10\Browser\BrowseDir/TRUE/FALSE

Sezione: FoldersToCreate - Cartelle/directories da creare (in caso non esistano già)
<path completo>

(corrisponde al passo CyberInstaller Studio: 5)

- utilizzare questa sezione per creare cartelle al di fuori della cartella di destinazione: tutte le cartelle e sotto-cartelle presenti nella cartella DATA verranno ricreate fedelmente rispettando la struttura gerarchica se contengono almeno un file. Se la cartella DATA contiene cartelle che a loro volta contengono esclusivamente altre sotto-cartelle (e nessun file), è necessario creare tramite questa sezione tali
  cartelle senza file.
- inserire qui anche eventuali le cartelle particolari che si desidera creare nel Menu Avvio

Es.:
se la cartella DATA contiene una sotto-cartella AddIns che a sua volta contiene solo cartelle
(e nessun file), oppure è completamente vuota, è necessario farla creare:
|AppPath|\AddIns
per assicurarsi che la cartella "Dao" esista alla sua posizione consueta e
in caso negativo crearla, inserire queste quattro linee:
|ProgramsPath|
|CommonPath|
|CommonPath|\Microsoft Shared
|CommonPath|\Microsoft Shared\Dao
per creare la cartella "Strumenti" nel Menu Avvio inserire:
|StartMenuPath|\Strumenti
per creare la cartella "Strumenti" nella cartella Programmi del Menu Avvio inserire:
|StartProgPath|\Strumenti
per creare la cartella "Strumenti" nella cartella di gruppo del Menu Avvio scelta dall'utente (dovunque essa sia) inserire:
|UserMenuFolder|\Strumenti

Sezione: AppsToRunBefore - Applicazioni da eseguire prima dell'installazione vera e propria
<descrizione estesa>/<riga di comando: eseguibile |{parametri}|>/<sincrona TRUE|FALSE>/<conferma esecuzione TRUE|FALSE>/|<condizione>|

(corrisponde al passo CyberInstaller Studio: 8)

- Si può usare il pattern |$AppsToRunPath$| per eseguire applicazioni esistenti nella cartella APPS del supporto di distribuzione.
- La riga di comando comprende il percorso completo dell'eseguibile + eventuali parametri da passare. Tali parametri devono essere racchiusi tra parentesi graffe e possono contenere pattern di sistema.
- Impostando il 3° parametro a TRUE le applicazioni verranno eseguite in modo sincrono cioè prima di lanciare un'applicazione CyberInstaller attenderà la fine di quella precedente e in più non sarà possibile continuare l'installazione se prima non viene chiusa l'applicazione con il flag a TRUE. Viceversa con il 3° parametro a FALSE le applicazioni verranno sì eseguite in sequenza, ma senza attendere la fine dell'esecuzione precedente e si potrà anche continuare l'installazione mentre queste girano in background.
- Impostando il 4° parametro a TRUE verrà chiesta conferma all'utente prima di avviare l'applicazione e ne verrà mostrata una finestra indicandone eseguibile ed eventuali parametri.
- L'ultima parametro può essere una cartella, un file, una chiave o un valore del registro, la cui esistenza, se verificata, NON farà eseguire l'applicazione relativa.
  In caso invece in cui l'elemento non esistesse, l'applicazione verrà eseguita normalmente. Se quest'ultimo parametro viene omesso l'applicazione verrà eseguita
  comunque.
- L'ultimo parametro può anche essere un'identificativo di sistema operativo. In questo modo l'applicazione specificata verrà eseguita solamente se il sistema operativo in uso è quello indicato (vedi note all'inizio di questo file per gli identificativi validi).

Es.:
EasyBudget 1.7/|$AppsToRunPath$|\EasyBudget\EasyBudget.exe/FALSE/TRUE
Microsoft MDAC 3.5/|$AppsToRunPath$|\MDAC.exe/TRUE/FALSE/HKEY_LOCAL_MACHINE\SOFTWARE\Classes\MDACVer.Version\CurVer
Blocco Appunti/|$WinPath$|\Notepad.exe/TRUE/TRUE
Setup DirectX/|$AppsToRunPath$|\DX\Setup.exe/TRUE/FALSE/|SystemPath$|\DirectX
Driver XP/|$AppsToRunPath$|\Drivers\WinXP\Setup.exe/TRUE/TRUE/|%OS_WinXP%|
Setup DirectX/|$AppsToRunPath$|\DX\Setup.exe {/silent /c -copy |$AppPath$|}/TRUE/FALSE/|SystemPath$|\DirectX
Blocco Note/|$WinPath$|\Notepad.exe/TRUE/FALSE/|%OS_WinXP%|
Blocco Note/|$WinPath$|\Notepad.exe {|$WinPath$|\dasetup.log}/TRUE/FALSE
Blocco Note/|$WinPath$|\Notepad.exe {|$WinPath$|\dasetup.log}/TRUE/FALSE/|%OS_WinXP%|

Sezione: Components - Lista dati pacchetto (componenti) da copiare nella cartella specificata
<nome file>/<percorso destinazione>/<da registrare: (su una riga) <nome file>/<percorso destinazione>/<da registrare: TRUE|FALSE>/<modalità di copia: [|%AutoConfirmation%|][|%AlwaysOverwrite%|][|%NeverOverwrite%|]>/
<Side-by-Side: TRUE|FALSE>/<eseguibile associato alla Side-by-Side>/<categoria>/rimozione: TRUE|FALSE>

(corrisponde al passo CyberInstaller Studio: 6)

- la cartella destinazione deve esistere (in caso crearla nella sezione apposita).
- la cartella di origine è COMPONENTS (non si può fare riferimento a nessun'altra).
- se il file non necessita registrazione e il flag viene posto comunque a TRUE, verrà generato un errore.
- modalità di copia: il comando |%AutoConfirmation%| farà in modo che non venga chiesta conferma all'utente prima di sovrascrivere un componente già installato nel sistema, ma la decisione verrà presa automaticamente in base alle versioni dei file (il componente già installato verrà sovrascritto solo se meno recente di quello che si sta installando). Se presente il comando |%AlwaysOverwrite%| un eventuale file con lo stesso nome nel percorso destinazione sarà sovrascritto sempre e in ogni caso. Se presente il comando |%NeverOverwrite%| un eventuale file con lo stesso nome nel percorso destinazione sarà mantenuto (non sarà sovrascritto in nessun caso). Se non presente alcun comando, all'utente verrà chiesta conferma tramite una finestra di dialogo con informazioni dettagliate relative ai due file, in modo che l'utente possa decidere il da farsi. Attenzione: quest'ultimo parametro viene preso in considerazione solo se la sezione SilentInstallation contiene il valore FALSE, se TRUE la conferma automatica verrà eseguita su ogni componente senza possibilità di intervento.
- Side-by-Side: modalità di installazione speciale che permette di installare il componente nella stessa cartella dell'eseguibile (|$AppPath$|) senza interferire con eventuali altre versioni (inferiori/superiori) eventualmente già presenti in cartelle condivise di sistema. Funziona solo su sistemi Win98SE o superiori.
- eseguibile associato alla Side-by-Side: file .exe associato al componente. Si presume che tale eseguibile utilizzerà il componente in questione. Il componente verrà installato nella stessa cartella di tale eseguibile. Se il parametro <Side-by-Side> è FALSE questo parametro non verrà preso in considerazione.
- categoria: gruppo di installazione di appartenenza del componente (per installazioni personalizzate).
- rimozione: se TRUE il componenete verrà disinstallato con la rimozione del software, altrimenti resterà sul sistema destinazione.

Es.:
Dao360.dll/|$CommonPath$|\Microsoft Shared\Dao/TRUE/|%AutoConfirmation%|/FALSE//default/TRUE
MSVBVM60.DLL/|$SystemPath$|/FALSE/|%AutoConfirmation%|/FALSE//default/TRUE
tahoma.ttf/|$FontsPath$|/FALSE/|%AutoConfirmation%|/FALSE//default/TRUE
mylibrary.dll/|$AppPath$|/TRUE/|%AlwaysOverwrite%|/TRUE/|$AppPath$|\MyExecutable.exe/default/TRUE

Sezione: Fonts - Lista font da installare
<nome font>/<nome file>

- i font verranno installati nella cartella Fonts di sistema.
- non è richiesto nessun riavvio del sistema a fine installazione.
- i font saranno immediatamente disponibili alle applicazioni e al sistema a fine installazione

Es.:
Arial Italic (TrueType)/ARIALI.TTF
Courier New (TrueType)/COUR.TTF
MS Sans Serif 8,10,12,14,18,24 (VGA res)/SSERIFE.FON

Sezione: RegKeys - Chiavi/valori da creare nel registro di Windows
<chiave>/[<nome valore>]/[<valore>]

(corrisponde al passo CyberInstaller Studio: 10)

- se si omettono i parametri <nome valore> e <valore> verrà creata una sezione (sottochiave)
- nel caso in cui si voglia creare un valore, è necessario creare prima la sezione
- nel caso in cui si voglia creare una sezione (sottochiave), la chiave di livello precedente deve già esistere. In caso negativo, crearla come descritto nella prima nota
- si può modificare il valore di default di una chiave creando prima la chiave e subito dopo un valore con <nome valore> = |DEFAULT_VALUE|
- è possibile inserire i pattern di sistema (|$AppPath$|, |$WinPath$|, ecc.)
- è possibile inserire il codice seriale immesso dall'utente tramite il comando |%SERIALCODE_VALUE%| inserito come valore
- è possibile inserire il percorso di avvio di Setup.exe (drive + percorso completo + nome file.exe) tramite il comando |%SETUP_PATH%| inserito come valore

Es.:
creazione del valore 5000 chiamato "Altezza Form" nella chiave ...\Test:
HKEY_CURRENT_USER\Software\Test
HKEY_CURRENT_USER\Software\Test/Altezza Form/5000
Es.: creazione della sottochiave Utenti nella chiave HKEY_CURRENT_USER\Software
HKEY_CURRENT_USER\Software\Utenti
Es.: creazione della sottochiave Amministratore nella chiave Utenti (creata in precedenza):
HKEY_CURRENT_USER\Software\Utenti\Amministratore
Es.: creazione chiave Test con valore di default "ABC"
HKEY_CURRENT_USER\Software\Test
HKEY_CURRENT_USER\Software\Test/|%DEFAULT_VALUE%|/ABC
Es.: memorizzazione come valore della cartella destinazione selezionata dall'utente:
HKEY_CURRENT_USER\Software\Test/Destinazione/|$AppPath$|
Es.: memorizzazione del codice seriale inserito dall'utente:
HKEY_CURRENT_USER\Software\Test/Seriale utente/|%SERIALCODE_VALUE%|
Es.: memorizzazione del percorso completo di avvio di Setup.exe:
HKEY_CURRENT_USER\Software\Test/Setup path/|%SETUP_PATH%|

Sezione: ExtensionsToAssociate - Estensioni da associare
<estensione>/<nome completo file eseguibile a cui associare l'estensione>/[<conferma>]

(corrisponde al passo CyberInstaller Studio: 11)

- se presente il parametro opzionale "|%AskConfirm%|" verrà chiesta conferma all'utente prima che l'estensione venga associata

Es.:

associa l'estensione .EBB all'applicazione "EasyBudget":
EBB/|$AppPath$|\EasyBudget.exe
associa l'estensione .CSP all'applicazione "CyberInstaller Studio":
CSP/|$AppPath$|\CyberInstaller Studio.exe
associa l'estensione .BMP all'applicazione "NewPaint" chiedendo conferma all'utente:
BMP/|$AppPath$|\NewPaint.exe/|%AskConfirm%|

Sezione: AttribsToSet - Attributi da impostare
<nome completo file/cartella>/<N(normale)|H(nascosto)|S(sistema)|R(sola lettura)|A(archivio)>

(corrisponde al passo CyberInstaller Studio: 12)

- l'attributo N (normale) resetta ogni altro attributo impostato
- gli attributi si possono solo aggiungere. E' possibile comunque aggirare questa limitazione impostando prima l'attributo Normale ed eventualmente aggiungendo in seguito solo gli attributi che interessano
- non ha senso impostare più di 4 attributi per volta, quindi eventuali altri caratteri saranno ignorati

Es.:
|AppPath|\EasyBudget.exe/N
|AppPath|\Init.ini/HRSA
|AppPath|/HR

Sezione: ChooseUserSpecialPath - Selezione utenti a cui si riferiscono i percorsi speciali:
<comando selezione utente>/[|Locked|]

(corrisponde al passo CyberInstaller Studio: 1)

I valori consentiti sono due:
- |%CurrentUser%| per selezionare i path dell'utente correntemente loggato
- |%AllUsers%| per selezionare i path di tutti gli utenti abilitati nel sistema
Nel caso venga inserito il comando |%Locked%| l'utente non potrà modificare questo valore durante l'installazione.
Il default, in caso non venga specificato, è: |%CurrentUser%|.

Nel caso di installazione su sistemi configurati come monoutente il settaggio verrà bypassato, utilizzando sempre e solo il menu avvio dell'utente corrente.

Sezione: LinksToCreate - Collegamenti da creare:
<destinazione>/<nome collegamento>/<nome completo file puntato>/[<{riga di comando}>]/[<conferma creazione>]

(corrisponde al passo CyberInstaller Studio: 11)

- la destinazione può essere un qualsiasi percorso esistente sul disco. Solitamente si creano i collegamenti sul desktop, o nel menu avvio. Usare i comandi speciali per stabilire la destinazione:
  |$CU_...$| per l'utente corrente (si bypassa la scelta dell'utente)
  |$All_...$| per tutti gli utenti (si bypassa la scelta dell'utente)
  |$...$| per utilizzare il percorso dell'utente selezionato nella sezione ChooseUserSpecialPath o in base alle scelte in fase di installazione
- se non si usa il comando |$UserMenuFolder$| la destinazione è fissa è l'utente non potrà cambiarla.
- se si desidera inserire il collegamento in una cartella particolare (non di sistema, che probabilmente non esiste nel sistema destinazione) è necessario farla creare utilizzando la sezione FoldersToCreate. Notare che utilizzando cartelle particolari, però, i link verranno creati obbligatoriamente in questa cartella senza possibilità di intervento da parte dell'utente.
- inserire il percorso completo per il file puntato
- non è necessario inserire un collegamento per la rimozione, il comando |%CreateRemovalLink%| lo creerà automaticamente.
- è possibile utilizzare il comando |%AskConfirm%| per chiedere conferma all'utente prima di creare il collegamento; si consiglia si chiedere conferma per tutti i collegamenti tranne quelli da creare nel Menu Avvio, dove possono essere creati automaticamente

Es.:
|$DesktopPath$|/CyberInstaller Studio/|$AppPath$|\Studio\CyberInstallerStudio.exe//|%AskConfirm%|
|$UserMenuFolder$|/Aggiornamenti on-line/|$AppPath$|\Updater\CISUpdater.exe
|$UserMenuFolder$|/CyberInstaller Studio/|$AppPath$|\Studio\CyberInstallerStudio.exe
|$UserMenuFolder$|\Documentazione/Edizioni - Licenze/|$AppPath$|\Documentazione\Edizioni - Licenze.txt
|$UserMenuFolder$|\Documentazione/Licenza/|$AppPath$|\Documentazione\CyberInstaller Suite - Licenza.txt
|$UserMenuFolder$|\Documentazione/Manuale in linea/|$AppPath$|\Help\0001.htm
|$UserMenuFolder$|\Documentazione/Manuale sintetico (aggiornato)/|$AppPath$|\Documentazione\CyberInstaller Suite - Manuale sintetico.txt
|$UserMenuFolder$|\Documentazione/Note di rilascio/|$AppPath$|\Documentazione\CyberInstaller Suite - Note di rilascio.txt
|$UserMenuFolder$|\Documentazione/Leggimi/|$AppPath$|\Documentazione\CyberInstaller Suite - Leggimi.txt
|$UserMenuFolder$|\Risorse Web/CyberBlog/|$AppPath$|\Documentazione\Risorse Web\CyberBlog.url
|$UserMenuFolder$|\Risorse Web/CyberInstaller su VB-T&T/|$AppPath$|\Documentazione\Risorse Web\CyberInstaller su VisualBasicT&T.it.url
|$UserMenuFolder$|\Risorse Web/Forum ufficiale/|$AppPath$|\Documentazione\Risorse Web\Forum ufficiale.url
|$UserMenuFolder$|\Risorse Web/SilverCyberTech (sito ufficiale)/|$AppPath$|\Documentazione\Risorse Web\SilverCyberTech (sito ufficiale).url
|%CreateRemovalLink%|

Sezione: ReadmeFileAfter - File contenente le note di rilascio, da visualizzare al termine dell'installazione

(corrisponde al passo CyberInstaller Studio: 3)
Deve essere contenuto nella cartella DATA (non si può fare riferimento a nessun'altra)

Es.:
Leggimi.txt

Sezione: AppsToRunAfter - Applicazioni da eseguire dopo l'installazione vera e propria:
<descrizione estesa>/<riga di comando: eseguibile |{parametri}|>/<sincrona TRUE|FALSE>/<conferma esecuzione TRUE|FALSE>/|<condizione>|

(corrisponde al passo CyberInstaller Studio: 8)

- Si può usare il pattern |$AppsToRunPath$| per eseguire applicazioni esistenti nella cartella APPS del supporto di distribuzione.
- La riga di comando comprende il percorso completo dell'eseguibile + eventuali parametri da passare. Tali parametri devono essere racchiusi tra parentesi graffe e possono contenere pattern di sistema.
- Impostando il 3° parametro a TRUE le applicazioni verranno eseguite in modo sincrono cioè prima di lanciare un'applicazione CyberInstaller attenderà la fine di quella precedente e in più non sarà possibile continuare l'installazione se prima non viene chiusa l'applicazione con il flag a TRUE. Viceversa con il 3° parametro a FALSE le applicazioni verranno sì eseguite in sequenza, ma senza attendere la fine dell'esecuzione precedente e si potrà anche continuare l'installazione mentre queste girano in background.
- Impostando il 4° parametro a TRUE verrà chiesta conferma all'utente prima di avviare
  l'applicazione e ne verrà mostrata una finestra indicandone eseguibile ed eventuali parametri.
- L'ultimo parametro può essere una cartella, un file, una chiave o un valore del registro, la cui esistenza, se verificata, NON farà eseguire l'applicazione relativa.
  In caso invece in cui l'elemento non esistesse, l'applicazione verrà eseguita normalmente. Se quest'ultimo parametro viene omesso l'applicazione verrà eseguita
  comunque.
- L'ultimo parametro può anche essere un'identificativo di sistema operativo. In questo modo l'applicazione specificata verrà eseguita solamente se il sistema operativo in uso è quello indicato (vedi note all'inizio di questo file per gli identificativi validi).

Es.:
EasyBudget 1.7/|$AppsToRunPath$|\EasyBudget\EasyBudget.exe/FALSE/TRUE
Microsoft MDAC 3.5/|$AppsToRunPath$|\MDAC.exe/TRUE/FALSE/HKEY_LOCAL_MACHINE\SOFTWARE\Classes\MDACVer.Version\CurVer
Blocco Appunti/|$WinPath$|\Notepad.exe/TRUE/TRUE
Setup DirectX/|$AppsToRunPath$|\DX\Setup.exe/TRUE/FALSE/|SystemPath$|\DirectX
Driver XP/|$AppsToRunPath$|\Drivers\WinXP\Setup.exe/TRUE/TRUE/|%OS_WinXP%|
Setup DirectX/|$AppsToRunPath$|\DX\Setup.exe {/silent /c -copy |$AppPath$|}/TRUE/FALSE/|SystemPath$|\DirectX
Blocco Note/|$WinPath$|\Notepad.exe/TRUE/FALSE/|%OS_WinXP%|
Blocco Note/|$WinPath$|\Notepad.exe {|$WinPath$|\dasetup.log}/TRUE/FALSE
Blocco Note/|$WinPath$|\Notepad.exe {|$WinPath$|\dasetup.log}/TRUE/FALSE/|%OS_WinXP%|

Sezione: RebootWindows - Riavviare il computer al termine dell'installazione? <TRUE|FALSE>

(corrisponde al passo CyberInstaller Studio: 1)
Il default, in caso non venga specificato alcun comando (TRUE|FALSE) è FALSE.

Vedi anche...

CyberInstaller Studio
Editor integrato
CyberInstaller - file principali e struttura cartelle
Passi di creazione pacchetto
Passo 1: Parametri generali
Passo 2: Interfaccia CyberInstaller

Passo 3: Documentazione

Passo 4: Dati applicazione

Passo 5: Cartelle

Passo 6: Dettagli file

Passo 7: Font

Passo 8: Applicazioni esterne

Passo 9 Pacchetti MSI/MSM

Passo 10: Chiavi e valori di registro

Passo 11: Associazione estensioni

Passo 12: Attributi file e cartelle

Passo 13: Collegamenti

Passo 14: Requisiti minimi

Passo 15: Numeri seriali

Passo 16: Lingue

Passo 17: Media Output

Passo 18: Eseguibile

Passo 19: Creazione pacchetto

Passo Extra: Note pacchetto