Utilizzo dell'esempio del programma di avvio automatico dell'installazione con un'applicazione

Articolo
09/12/2008

Aggiornamento: novembre 2007

Le operazioni eseguite con l'esempio di programma di avvio automatico dell'installazione sono automatiche. Tuttavia, per consentire all'installazione di utilizzare l'applicazione, è necessario creare un file Settings.ini personalizzato che includa le informazioni richieste relative all'applicazione. Inoltre, è consigliabile distribuire il programma di installazione con un file Readme che fornisca all'utente i requisiti minimi di configurazione per l'installazione dell'applicazione e di Dotnetfx.exe. Nelle sezioni seguenti vengono fornite informazioni dettagliate sulla creazione dei file Settings.ini e Readme:

Creazione di un file Settings.ini
Creazione di un file Readme per il programma di installazione

Creazione di un file Settings.ini

L'esempio del programma di avvio automatico dell'installazione utilizza il file esterno, Settings.ini, per determinare quanto segue:

Il percorso di Dotnetfx.exe e dell'applicazione host.
La versione di lingua di .NET Framework da verificare.
Le stringhe personalizzate da utilizzare per le finestre di dialogo dell'installazione.

Settings.ini si trova nella stessa cartella del programma di installazione. All'utente spetta la creazione di un file Settings.ini che consenta al programma di avvio automatico dell'installazione di esempio di utilizzare l'applicazione. È possibile copiare il file Settings.ini fornito con l'esempio del programma di avvio automatico dell'installazione, quindi modificare il file nella misura necessaria per specificare i valori corretti per l'applicazione.

Impostazione del percorso di Dotnetfx.exe e dell'applicazione host

L'esempio di programma di avvio automatico dell'installazione richiede che Dotnetfx.exe e l'applicazione .NET Framework si trovino in un percorso noto relativo a Setup.exe. Nell'esempio viene utilizzato il file esterno Settings.ini per determinare il percorso di Dotnetfx.exe e dell'applicazione host: È possibile copiare il file Settings.ini fornito con l'esempio e modificarlo affinché venga indirizzato ai percorsi dell'applicazione host .NET Framework e di Dotnetfx.exe.

Negli esempi riportati di seguito dei fileSettings.ini viene illustrato come un'applicazione host .NET Framework (mySetup.msi) e Dotnetfx.exe possano indirizzarsi a un package di Windows Installer (file con estensione MSI) in diversi percorsi relativi al percorso del programma di installazione.

Nel file Settings.ini di esempio seguente mySetup.msi e Dotnetfx.exe si trovano nella stessa cartella di Setup.exe. Per impostare come commento le righe non personalizzate viene utilizzato un apostrofo (').

[Bootstrap]
Msi=mySetup.msi
'LanguageDirectory=
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

Nel file Settings.ini di esempio seguente mySetup.msi e Dotnetfx.exe si trovano in una condivisione di rete, separata da Setup.exe.

[Bootstrap]
Msi=\\myNetworkShare\myProjectFolder\mySetup.msi
'LanguageDirectory=
ProductName=My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=\\myNetworkShare\myProjectFolder\

Nel file Settings.ini di esempio seguente mySetup.msi e Dotnetfx.exe si trovano nello stesso computer di Setup.exe, ma in cartelle diverse.

[Bootstrap]
Msi=c:\myInstallerFiles\mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myExecutables\

Nel file Settings.ini di esempio seguente mySetup.msi e Dotnetfx.exe si trovano nello stesso CD di Setup.exe, ma in cartelle diverse.

[Bootstrap]
Msi=myInstallerFiles/mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=myExecutables/

Impostazione della lingua

Se si desidera verificare un numero di build e la lingua di .NET Framework, è necessario specificare nel file Settings.ini il nome delle impostazioni cultura da controllare. In caso contrario, verrà controllata la lingua inglese, per impostazione predefinita.

Nella tabella che segue sono elencate le versioni di lingua disponibili e i corrispondenti nomi di impostazioni cultura da specificare nel file Settings.ini. I nomi delle impostazioni cultura non distinguono tra lettere maiuscole e minuscole.

Lingua	Nome delle impostazioni cultura
Cinese (semplificato)	chs
Cinese (tradizionale)	cht
Francese	fr
Tedesco	de
Italiano	it
Giapponese	ja
Coreano	ko
Spagnolo	es

Nel seguente file Settings.ini di esempio il programma di installazione viene istruito a verificare la versione in lingua francese di Dotnetfx.exe.

[Bootstrap]
Msi=mySetup.msi
LanguageDirectory=fr
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

Personalizzazione delle stringhe per le finestre di dialogo del programma di installazione

È possibile modificare le variabili che seguono presenti nel file Settings.ini per personalizzare le stringhe visualizzate nelle finestre di dialogo del programma di installazione.

ProductName specifica il nome dell'applicazione .NET Framework che verrà installata. Il nome di prodotto specificato viene utilizzato per personalizzare il testo della finestra di dialogo visualizzata dopo l'avvio di Setup.exe. Ad esempio, se si specifica My Application come ProductName, nel testo della finestra di dialogo verrà visualizzato un messaggio simile al seguente "Per avviare il programma di installazione di My Application, scegliere OK.. Per uscire dall'installazione, scegliere Annulla".

Se la variabile CaptionText non viene personalizzata, ProductName viene utilizzato anche per personalizzare la barra del titolo della finestra di dialogo che viene visualizzata dopo l'avvio di Setup.exe. Ad esempio, se si specifica My Application come ProductName, sulla barra del titolo verrà visualizzato "Installazione di My Application". Se si personalizzano sia ProductName che CaptionText, CaptionText viene utilizzato per personalizzare il testo sulla barra del titolo di questa finestra di dialogo.

ProductName consente anche di personalizzare il testo sulla barra del titolo della finestra di dialogo che viene visualizzata al termine dell'installazione dell'applicazione. Se non si personalizza ProductName, verrà visualizzato il testo predefinito, "Installazione di nomeapplicazione".
DialogText specifica il testo personalizzato da visualizzare nella finestra di dialogo che si apre dopo l'avvio di Setup.exe. Se non si personalizza DialogText, verrà visualizzato il testo predefinito, simile al seguente, "Per avviare l'installazione di nomeapplicazione, scegliere OK. Per uscire dall'installazione, scegliere Annulla".
CaptionText specifica il testo personalizzato da visualizzare sulla barra del titolo della finestra di dialogo che si apre dopo l'avvio di Setup.exe. Se non si personalizza CaptionText, verrà visualizzato ProductName. Se ProductName non è personalizzato, verrà visualizzato il testo predefinito, "Installazione di nomeapplicazione".
ErrorCaptionText specifica il testo personalizzato da visualizzare sulla barra del titolo delle finestre di dialogo relative agli errori di installazione. Se non si personalizza ErrorCaptionText, verrà visualizzato il testo predefinito, "Errore del programma di installazione di nomeapplicazione".

Creazione di un file Readme per il programma di installazione

Si consiglia di distribuire il programma di installazione con un file Readme in cui vengano elencati i requisiti minimi di configurazione del computer in cui verrà eseguita l'installazione. Come requisito minimo prima di eseguire l'installazione, indicare che sia installato Microsoft Windows 98 o versioni successive con Internet Explorer 5.01 o versioni successive. Indicare anche Microsoft Data Access Components (MDAC) 2.6 o versione successiva, segnalando che l'applicazione non è necessaria per l'installazione, bensì per le applicazioni .NET Framework che includono l'accesso ai dati. Per ulteriori informazioni sui requisiti minimi di configurazione per l'installazione di Dotnetfx.exe, vedere Requisiti minimi di configurazione.