Procédure pas à pas : déploiement d'une application Windows

Article
08/10/2011

La procédure pas à pas suivante décrit le processus de création du programme d'installation d'une application Windows qui lance le Bloc-notes. Dans cette procédure pas à pas, vous allez créer l'application Windows. Vous créerez ensuite un programme d'installation qui configure des raccourcis et des associations de fichiers, ajoute une entrée au Registre, affiche des boîtes de dialogue personnalisées et vérifie la version d'Internet Explorer pendant l'installation.

Vous n'êtes pas tenu de suivre l'intégralité de ces étapes lorsque vous créez vos propres programmes d'installation. Cette procédure pas à pas est destinée à vous présenter certaines fonctionnalités facultatives de déploiement que vous pourriez trouver utiles. Pour créer un programme d'installation de base, effectuez les quatre premières étapes de la procédure qui suit.

Notes

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Notes

Les instructions suivantes décrivent comment créer un projet de déploiement à l'aide d'un projet Visual Basic. Les principes généraux s'appliquent à tous les projets dans un langage de Visual Studio qui prennent en charge le déploiement des applications Windows.

Création et déploiement d'une application en Visual Basic

Pour créer une application Windows

Dans le menu Fichier, cliquez sur Nouveau projet.
Dans la boîte de dialogue Nouveau projet, sélectionnez Visual Basic dans le volet Types de projets, puis cliquez sur Application Windows dans le volet Modèles. Dans la zone Nom, tapez Mon Bloc-notes.
Cliquez sur OK pour fermer la boîte de dialogue.

Le projet est ajouté à l'Explorateur de solutions et le Concepteur Windows Forms s'ouvre.
Sélectionnez l'onglet Tous les Windows Forms de la boîte à outils, puis faites glisser un contrôle Button jusqu'au formulaire.
Double-cliquez sur le contrôle Button pour ajouter un gestionnaire d'événements pour le bouton. Dans le gestionnaire d'événements, ajoutez le code suivant :
```
Shell("Notepad.exe", AppWinStyle.NormalFocus)
```
Vous lancez ainsi Notepad.exe et lui donnez le focus.
Dans le menu Générer, cliquez sur Générer Mon Bloc-notes pour générer l'application.

Pour créer un projet de déploiement

Dans le menu Fichier, pointez sur Ajouter, puis cliquez sur Nouveau projet.
Dans la boîte de dialogue Ajouter un nouveau projet, dans le volet Types de projets, ouvrez le nœud Autres types de projets, puis cliquez sur Projets de configuration et de déploiement, Programme d'installation de Visual Studio et Projet d'installation. Dans la zone Nom, tapez Programme d'installation de Mon Bloc-notes.
Cliquez sur OK pour fermer la boîte de dialogue.

Le projet est ajouté à l'Explorateur de solutions et l'Éditeur du système de fichiers s'ouvre.
Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions. Dans la fenêtre Propriétés, sélectionnez la propriété ProductName et tapez Mon Bloc-notes.

Notes

La propriété NomProduit spécifie le nom de l'application qui s'affichera dans les noms de dossiers et dans la boîte de dialogue Ajouter ou supprimer des programmes.

Pour ajouter l'application Windows au programme d'installation

Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions. Dans l'Éditeur du système de fichiers, cliquez avec le bouton droit sur le nœud Dossier d'application.
Dans le menu Projet, pointez sur Ajouter, puis cliquez sur Sortie du projet.
Dans la boîte de dialogue Ajouter le groupe de sorties du projet, sélectionnez Mon Bloc-notes dans la liste Projet.
Sélectionnez le groupe Sortie principale dans la liste. Dans la zone Configuration, sélectionnez (Actif). Cliquez sur OK pour fermer la boîte de dialogue.
Dans le menu Générer, cliquez sur Générer Programme d'installation de Mon Bloc-notes.

Pour déployer l'application (programme d'installation de base)

Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions. Dans le menu Projet, cliquez sur Installer.

Cette action exécute le programme d'installation (Assistant Installation) et installe Mon Bloc-notes sur votre ordinateur de développement.

Notes

Vous devez avoir des autorisations d'installation sur l'ordinateur pour pouvoir exécuter le programme d'installation.

Fonctionnalités de déploiement facultatives

Cette étape illustre des fonctionnalités de déploiement facultatives ; elle crée un raccourci vers votre application, lequel sera placé sur le bureau d'un ordinateur cible pendant l'installation.

Pour créer des raccourcis pour l'application Windows

Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions.
Dans l'Éditeur du système de fichiers, sélectionnez le nœud Sortie principale de Mon Bloc-notes.
Dans le menu Action, cliquez sur Créer un raccourci vers Sortie principale de Mon Bloc-notes.

Cette action ajoute un nœud appelé Raccourci vers Sortie principale de Mon Bloc-notes.
Renommez le raccourci en Raccourci vers Mon Bloc-notes.
Sélectionnez Raccourci vers Mon Bloc-notes et faites-le glisser vers le dossier Bureau de l'utilisateur dans le volet de gauche.

Création d'une association de fichier

Cette étape ajoute une association de fichier pour Mon Bloc-notes afin qu'un double-clic sur les fichiers .vbn ouvre l'application Mon Bloc-notes.

Pour créer des associations de fichiers pour l'application Windows

Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions. Dans le menu Affichage, pointez sur Éditeur et cliquez sur Types de fichiers. L'Éditeur des types de fichiers s'ouvre.
Dans l'Éditeur des types de fichiers, sélectionnez le nœud Types de fichiers sur l'ordinateur cible. Dans le menu Action, cliquez sur Ajouter un type de fichier.

Un nœud appelé Nouveau type de document n° 1 est ajouté et ouvert pour l'attribution d'un nouveau nom.
Renommez Nouveau type de document n° 1 en Vbn.doc.
Dans la fenêtre Propriétés, affectez à la propriété Extensions du type de fichier la valeur vbn.
Sélectionnez la propriété Command, puis cliquez sur le bouton de sélection (...). Dans la boîte de dialogue Sélectionner un élément dans le projet, naviguez jusqu'à Dossier d'application, puis sélectionnez Sortie principale de Mon Bloc-notes.
Cliquez sur OK pour fermer la boîte de dialogue.

Ajout d'une entrée du Registre

Cette étape ajoute une clé de Registre et une valeur au Registre. Vous pouvez faire référence à cette clé de Registre dans le code de votre application pour récupérer des informations spécifiques à l'utilisateur au moment de l'exécution.

Pour ajouter une entrée du Registre pour l'application Windows

Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions. Dans le menu Affichage, pointez sur Éditeur, puis cliquez sur Registre. L'Éditeur du Registre s'ouvre.
Dans l'Éditeur du Registre, sélectionnez le nœud HKEY_CURRENT_USER et développez-le, puis développez le nœud Software et sélectionnez le nœud [Manufacturer].

Notes

Le nœud [Manufacturer] est placé entre crochets droits pour indiquer qu'il s'agit d'une propriété. Il sera remplacé par la valeur entrée pour la propriété Manufacturer du projet de déploiement.
Dans le menu Action, pointez sur Nouveau, puis cliquez sur Clé.
Renommez la clé UserChoice et sélectionnez-la.
Dans le menu Action, pointez sur Nouveau, puis cliquez sur Valeur de chaîne.
Renommez la valeur de chaîne TextColor.
Dans la fenêtre Propriétés, sélectionnez la propriété Value et entrez Black.

Ajout d'une boîte de dialogue d'installation personnalisée

Cette étape ajoute et configure une boîte de dialogue personnalisée de l'interface utilisateur qui s'affichera au cours de l'installation.

Pour ajouter une boîte de dialogue d'installation personnalisée

Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions. Dans le menu Affichage, pointez sur Éditeur, puis cliquez sur Interface utilisateur. L'Éditeur muni d'une interface utilisateur s'ouvre.
Dans l'Éditeur muni d'une interface utilisateur, sélectionnez le nœud Début (sous le nœud Installer).
Dans le menu Action, cliquez sur Ajouter une boîte de dialogue.
Dans la boîte de dialogue Ajouter une boîte de dialogue, sélectionnez Cases à cocher (A).
Cliquez sur OK pour fermer la boîte de dialogue.
Cliquez avec le bouton droit sur la boîte de dialogue Cases à cocher (A) et sélectionnez deux fois Monter pour la positionner au-dessus de la boîte de dialogue Dossier d'installation.
Dans la fenêtre Propriétés, affectez à la propriété BannerText la valeur Exemples.
Affectez à la propriété BodyText les valeurs suivantes :

La case à cocher Installer les exemples détermine si les fichiers d'exemple sont installés ou non. Si cette case à cocher n'est pas activée, les exemples ne seront pas installés.
Affectez la valeur Installer les exemples à la propriété CheckBox1Label.
Affectez la valeur False aux propriétés Checkbox2Visible, Checkbox3Visible et Checkbox4Visible. Cela a pour effet de masquer les cases à cocher supplémentaires.

Utilisation d'exemples

Cette étape crée un sous-dossier Exemples qui sera installé sous le dossier Application.

Pour ajouter un dossier Exemples

Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions. Dans le menu Affichage, pointez sur Éditeur et cliquez sur Système de fichiers. Sélectionnez Dossier d'application si ce n'est pas encore fait.
Cliquez avec le bouton droit sur Dossier d'application, pointez sur Ajouter, puis cliquez sur Dossier.
Renommez **Nouveau dossier n° 1 ** en Exemples.

Cette étape crée deux exemples de fichiers texte qui seront installés si l'utilisateur choisit l'option Installer les exemples de la boîte de dialogue personnalisée.

Pour créer des fichiers d'exemple pour l'application

À l'aide du Bloc-notes ou d'un autre éditeur de texte, créez un fichier texte qui contient le texte Ceci est rules.vbn. Enregistrez-le sous le nom Rules.vbn.

Notes

Pour empêcher le Bloc-notes d'ajouter automatiquement une extension .txt, sélectionnez Tous les fichiers dans la liste Types de fichiers.
Créez un autre fichier texte qui contient le texte Ceci est memo.vbn. Enregistrez-le sous le nom Memo.vbn.

Cette étape ajoute les fichiers d'exemple au dossier Exemples, et définit une condition qui détermine si ces fichiers doivent être installés.

Pour ajouter les exemples au programme d'installation

Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions. Dans le menu Affichage, pointez sur Éditeur puis sur Système de fichiers et sélectionnez le dossier Exemples.
Dans le menu Action, pointez sur Ajouter, puis cliquez sur Fichier. Ajoutez les fichiers Rules.vbn et Memo.vbn au dossier Exemples.
Sélectionnez le fichier Rules.vbn dans l'Éditeur du système de fichiers.
Dans la fenêtre Propriétés, affectez à la propriété Condition la valeur CHECKBOXA1=1. Lorsque le programme d'installation sera exécuté, le fichier Rules.vbn ne sera installé que si la case à cocher personnalisée est activée.
Dans l'Éditeur du système de fichiers, sélectionnez le fichier Memo.vbn.
Dans la fenêtre Propriétés, affectez à la propriété Condition la valeur CHECKBOXA1=1. Lorsque le programme d'installation sera exécuté, le fichier Memo.vbn ne sera installé que si la case à cocher personnalisée est activée.

Ajout de conditions de lancement

Cette étape vérifie si Internet Explorer 5.0 ou version ultérieure est installé sur un ordinateur cible, et arrête l'installation si tel n'est pas le cas.

Pour ajouter une condition de lancement destinée à vérifier la version de Microsoft Internet Explorer

Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions. Dans le menu Affichage, pointez sur Éditeur et cliquez sur Conditions de lancement.

Notes

Cette étape est uniquement destinée à illustrer le concept de conditions de lancement ; l'application Mon Bloc-notes n'a pas de véritable dépendance sur Internet Explorer.
Dans l'Éditeur des conditions de lancement, sélectionnez le nœud Configuration requise pour l'ordinateur cible.
Dans le menu Action, cliquez sur Ajouter une condition de lancement de fichier.

Un nœud Recherche de Fichier1 est ajouté sous le nœud Recherche de l'ordinateur cible et un nœud Condition1 est ajouté sous le nœud Conditions de lancement.
Renommez Recherche de Fichier1 en Recherche d'Internet Explorer.
Dans la fenêtre Propriétés, affectez la valeur Iexplore.exe à la propriété FileName, la valeur [ProgramFilesFolder] à la propriété Folder, la valeur 2 à la propriété Depth et la valeur 5.00 à la propriété MinVersion.
Sélectionnez le nœud Condition1.
Affectez à la propriété Message les valeurs suivantes :

Ce programme requiert Microsoft Internet Explorer 5.0 ou version ultérieure. Installez Internet Explorer, puis réexécutez le programme d'installation du Bloc-notes.

Définition des propriétés pour les composants requis

Cette étape définit une propriété permettant d'installer automatiquement le .NET Framework si la version appropriée ne se trouve pas sur l'ordinateur cible. Notez que le package .NET Framework 2.0 installe également les fichiers de Windows Installer 2.0.

Lorsque les propriétés des composants requis sont définies comme suit, le fait de cliquer sur setup.exe installe automatiquement le .NET Framework avant l'exécution du fichier .msi (comportement défini par défaut). Pour plus d'informations sur la définition des composants requis, consultez Composants requis, boîte de dialogue.

Pour définir des propriétés facultatives du projet de déploiement

Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions. Dans le menu Affichage, cliquez sur Pages de propriétés.
Dans la boîte de dialogue Pages de propriétés du programme d'installation de Mon Bloc-notes, dans URL d'installation, spécifiez l'URL d'un serveur ou d'un site Web à partir de laquelle l'application et/ou les composants requis seront installés. Cliquez sur le bouton Composants requis.
Dans la boîte de dialogue Composants requis, sous Choisir les composants requis à installer, vérifiez que .NET Framework est sélectionné (il s'agit de la sélection par défaut). Sous Spécifier l'emplacement d'installation des composants requis, acceptez l'emplacement par défaut.
Dans le menu Générer, cliquez sur Générer Programme d'installation de Mon Bloc-notes.

Installation sur votre ordinateur de développement

Cette étape exécute le programme d'installation et installe Mon Bloc-notes sur votre ordinateur de développement.

Pour installer Mon Bloc-notes sur votre ordinateur de développement

Sélectionnez le projet Programme d'installation de Mon Bloc-notes dans l'Explorateur de solutions. Dans le menu Projet, cliquez sur Installer.

Notes

Vous devez avoir des autorisations d'installation sur l'ordinateur pour pouvoir exécuter le programme d'installation.

Déploiement vers un autre ordinateur

Cette étape exécute le programme d'installation et installe Mon Bloc-notes sur un autre ordinateur.

Pour déployer Mon Bloc-notes vers un autre ordinateur

Dans l'Explorateur Windows, naviguez jusqu'à votre répertoire de projet et recherchez le programme d'installation généré. Le chemin d'accès par défaut est \Documents and Settings\VotreNomDeConnexionMes Documents\Visual Studio 9.0\Projects\Nom du dossier de solution\Programme d'installation de mon Bloc-notes\configuration de projet\Programme d'installation de mon Bloc-notes.msi. (La configuration de projet par défaut est Debug ou Release.)
Copiez les fichiers Programme d'installation de Mon Bloc-notes.msi et Setup.exe, ainsi que tous les autres fichiers et sous-répertoires du répertoire sur un autre ordinateur.

Notes

Pour effectuer l'installation sur un ordinateur ne se trouvant pas sur un réseau, copiez les fichiers sur des médias traditionnels, tels que des CD-ROM.
Sur l'ordinateur cible, double-cliquez sur le fichier Setup.exe pour exécuter le programme d'installation.

Notes

Vous devez avoir des autorisations d'installation sur l'ordinateur cible pour pouvoir exécuter le programme d'installation.

Test

Cette étape teste le démarrage de l'application à partir d'un raccourci du Bureau et teste également sa désinstallation.

Pour tester l'installation

Vérifiez que le raccourci est installé sur le Bureau et qu'il lance correctement l'application Mon Bloc-notes.
Désinstallez l'application à l'aide de l'option Ajout/Suppression de programmes du Panneau de configuration. Dans Ajout/Suppression de programmes, sélectionnez Mon Bloc-notes, puis cliquez sur le bouton Supprimer.

Notes

Pour désinstaller l'application de votre ordinateur de développement, dans le menu Projet, cliquez sur Désinstaller.
L'icône doit alors être supprimée du Bureau et les dossiers et fichiers d'applications installés doivent être supprimés de votre ordinateur.