Utilisation de l'exemple de programme d'amorçage Setup.exe avec une application

Article
08/21/2008

Mise à jour : novembre 2007

Les opérations exécutées par l'exemple de programme d'amorçage Setup.exe (en anglais) sont automatiques. Toutefois, pour permettre à Setup.exe d'utiliser votre application, vous devez créer un fichier Settings.ini personnalisé incluant les informations requises au sujet de votre application. En outre, nous vous recommandons de déployer votre programme d'installation avec un fichier readme qui indiquera aux utilisateurs la configuration minimale requise pour installer votre application et Dotnetfx.exe. Pour plus d'informations sur la création des fichiers Settings.ini et readme, consultez les sections suivantes :

Création d'un fichier Settings.ini
Création d'un fichier Readme pour le programme d'installation

Création d'un fichier Settings.ini

L'exemple de programme d'amorçage Setup.exe utilise le fichier externe Settings.ini pour déterminer les points suivants :

Emplacement de Dotnetfx.exe et de l'application hôte.
Version linguistique du .NET Framework à rechercher.
Chaînes personnalisées à utiliser avec les boîtes de dialogue Setup.exe.

Par défaut, Settings.ini est placé dans le même répertoire que Setup.exe. Il vous incombe de créer un fichier Settings.ini qui permette à l'exemple de programme d'amorçage Setup.exe de fonctionner avec votre application. Vous pouvez copier le fichier Settings.ini fourni avec l'exemple de programme d'amorçage Setup.exe et l'éditer le cas échéant pour spécifier les valeurs requises pour votre application.

Spécification de l'emplacement de Dotnetfx.exe et de l'application hôte

L'exemple de programme d'amorçage Setup.exe requiert que Dotnetfx.exe et l'application .NET Framework hôte soient dans un emplacement connu, relatif à Setup.exe. L'exemple de programme d'amorçage Setup.exe utilise le fichier externe Settings.ini pour déterminer l'emplacement de Dotnetfx.exe et de l'application hôte. Vous pouvez copier le fichier Settings.ini fourni avec l'exemple, puis le modifier pour pointer vers les emplacements de votre application hôte .NET Framework et de Dotnetfx.exe.

Les exemples de fichiers Settings.ini suivants montrent comment pointer vers un package Windows Installer pour une application hôte .NET Framework (mySetup.msi) et pour Dotnetfx.exe à différents emplacements relatifs à l'emplacement de Setup.exe.

Dans le fichier exemple Settings.ini suivant, mySetup.msi et Dotnetfx.exe se trouvent dans le même dossier que Setup.exe. Une apostrophe « ' » est utilisée pour mettre en commentaire les lignes qui ne sont pas personnalisées.

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

Dans le fichier exemple Settings.ini suivant, mySetup.msi et Dotnetfx.exe se trouvent sur un partage réseau, à l'écart de Setup.exe.

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

Dans le fichier exemple Settings.ini suivant, mySetup.msi et Dotnetfx.exe se trouvent sur le même ordinateur que Setup.exe, mais dans des dossiers différents.

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

Dans le fichier exemple Settings.ini suivant, mySetup.msi et Dotnetfx.exe se trouvent sur le même CD que Setup.exe, mais dans des dossiers différents.

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

Spécification de la version linguistique

Si vous voulez que Setup.exe recherche un numéro de build et une version linguistique du .NET Framework, vous devez spécifier le nom de culture de la langue à rechercher dans le fichier Settings.ini. Si vous ne spécifiez pas de nom de culture, Setup.exe recherche la version linguistique anglaise par défaut.

Le tableau suivant répertorie les versions linguistiques disponibles et les noms de cultures correspondants à spécifier dans le fichier Settings.ini. Les noms ne respectent pas la casse.

Langue	Nom de la culture
Chinois (Simplifié)	chs
Chinois (Traditionnel)	cht
Français	fr
Allemand	de
Italien	it
Japonais	ja
Coréen	ko
Espagnol	es

L'exemple de fichier Settings.ini suivant indique à Setup.exe de rechercher la version linguistique française de Dotnetfx.exe.

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

Personnalisation des chaînes pour les boîtes de dialogue Setup.exe

Vous pouvez modifier les variables suivantes du fichier Settings.ini pour personnaliser les chaînes affichées dans les boîtes de dialogue Setup.exe.

ProductName indique le nom de l'application .NET Framework que Setup.exe va installer. Le nom de produit que vous indiquez permet de personnaliser le texte de la boîte de dialogue qui s'affiche après le lancement de Setup.exe. Par exemple, si vous spécifiez Mon application en tant que ProductName, le texte de la boîte de dialogue est "Pour démarrer l'installation de Mon application, cliquez sur OK. Pour quitter sans installer, cliquez sur Annuler.".

Si vous ne personnalisez pas la variable CaptionText, ProductName est aussi utilisé pour personnaliser la barre de titre de la boîte de dialogue qui s'affiche après le lancement de Setup.exe. Par exemple, si vous spécifiez Mon application en tant que ProductName, la barre de titre affiche "Installation de Mon application". Si vous personnalisez à la fois ProductName et CaptionText, CaptionText est utilisé pour personnaliser la barre de titre de cette boîte de dialogue.

ProductName est également utilisé pour personnaliser le texte de la barre de titre dans la boîte de dialogue qui s'affiche à la fin de l'installation pour indiquer que celle-ci a réussi. Si vous ne personnalisez pas ProductName, le texte par défaut, "Application Setup" s'affiche.
DialogText indique le texte personnalisé à afficher dans la boîte de dialogue qui s'affiche après le lancement de Setup.exe. Si vous ne personnalisez pas DialogText, le texte par défaut, "Pour démarrer l'installation de l'application, cliquez sur OK" s'affiche. Pour quitter sans installer, cliquez sur Annuler." s'affiche.
CaptionText indique le texte personnalisé à afficher dans la barre de titre de la boîte de dialogue qui s'affiche après le lancement de Setup.exe. Si vous ne personnalisez pas CaptionText, ProductName s'affiche. Si ProductName n'est pas personnalisé, le texte par défaut, "Application Setup", s'affiche.
ErrorCaptionText indique le texte personnalisé à afficher dans la barre de titre des boîtes de dialogue d'erreur de Setup.exe. Si vous ne personnalisez pas ErrorCaptionText, le texte par défaut, "Application Setup Error" s'affiche.

Création d'un fichier Readme pour le programme d'installation

Nous vous recommandons de distribuer votre programme d'installation en l'accompagnant d'un fichier readme qui indiquera la configuration minimale requise pour l'ordinateur afin que le programme d'installation s'exécute avec succès. Au minimum, indiquez Microsoft Windows 98 ou version ultérieure avec Internet Explorer 5.01 ou version ultérieure comme condition préalable requise pour l'installation. Vous devez également indiquer Microsoft Data Access Components (MDAC) 2.6 ou version ultérieure en précisant qu'il n'est pas requis pour l'installation, mais qu'il l'est pour les applications .NET Framework qui incluent un accès aux données. Pour plus d'informations sur la configuration minimale requise pour l'installation de Dotnetfx.exe, consultez Configuration minimale requise.