Partager via

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

  • Article

Les opérations effectuées par l'exemple de programme d'amorçage Setup.exe 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 rubriques 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 impose que Dotnetfx.exe et l'application hôte .NET Framework soient placés à un emplacement connu par rapport à Setup.exe. Il 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 l'éditer pour pointer vers l'emplacement de votre application hôte .NET Framework et de Dotnetfx.exe.

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

L'exemple de fichier Settings.ini suivant pointe vers le package Windows Installer pour une application hôte .NET Framework mySetup.msi et pour Dotnetfx.exe, tous deux situés 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\

L'exemple de fichier Settings.ini suivant pointe vers le package Windows Installer pour une application hôte .NET Framework mySetup.msi et pour Dotnetfx.exe, tous deux situés sur un partage réseau distinct de Setup.exe.

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

L'exemple de fichier Settings.ini suivant pointe vers le package Windows Installer pour une application hôte .NET Framework mySetup.msi et pour Dotnetfx.exe, tous deux situés sur le même ordinateur que Setup.exe, mais dans des dossiers distincts.

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

L'exemple de fichier Settings.ini suivant pointe vers le package Windows Installer pour une application hôte .NET Framework mySetup.msi et pour Dotnetfx.exe, tous deux situés 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 spécifiez est utilisé pour personnaliser le texte de la boîte de dialogue qui s'affiche lorsque vous lancez Setup.exe. Par exemple, si vous spécifiez Mon application comme ProductName, la boîte de dialogue affiche le texte "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 également 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 comme ProductName, la barre de titre indique "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" est affiché.

  • 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, "To start Application Setup, click OK. Pour quitter sans installer, cliquez sur Annuler." est affiché.

  • 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" est affiché.

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

Il est recommandé 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 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.

Voir aussi

Concepts

Création d'un unique projet d'installation pour installer une application .NET Framework et Dotnetfx.exe
Opérations de l'exemple de programme d'amorçage Setup.exe
Configuration minimale requise

Autres ressources

Redistribution du .NET Framework