I. Introduction▲
Comme vous le savez, lorsque vous effectuez le déploiement d'une application développée avec Visual Studio, le poste où va s'exécuter l'application doit disposer du .NET Framework. Le but de cet article est d'expliquer comment inclure le .NET Framework dans vos applications que vous développez avec Visual Studio 2003 afin que celui-ci s'installe directement dans le cas où il n'est pas présent sur le poste de travail. Le .NET Framework est contenu dans le fichier dotnetfx.exe.
Pour redistribuer le .NET Framework vous avez quatre solutions :
- installer le plugin bootstrapper sur votre ordinateur de développement et utiliser un projet de déploiement (setup) ;
- donner les instructions manuelles à l'utilisateur pour que celui-ci installe lui-même le .NET Framework ;
- utiliser le Setup.exe de l'exemple de Bootstrapper pour installer le Dotnetfx.exe puis lancer le setup de votre application ;
- demander à votre administrateur système d'utiliser un outil de distribution (voir Redistribuate the .NET Framework).
Dans cet article, nous ne nous intéresserons uniquement au premier cas. Je considère que vous pour effectuer ce tutoriel, vous disposez d'un projet (type HelloWorld).
II. Projet de déploiement▲
Pour utiliser le plugin Bootstrapper et installer le Framework ainsi que le MDAC, vous devez disposer d'un projet « Setup ».
Pour ajouter un projet « setup » à votre application vous devez cliquer sur « Fichier » -> « Nouveau » -> « Projet » -> « Projet de configuration et de déploiement » -> « Projet de configuration ».
III. Déploiement d'une application avec le plug-in bootstrapper▲
Les projets « setup » de Visual Studio .NET 2003 peuvent être utilisés pour installer le .NET Framework avec votre application, mais ceci uniquement si vous avez au préalable installé le Plug-in bootstrapper sur votre ordinateur de développement. Vous pouvez télécharger le plug-in ici. Si votre application a besoin d'un accès aux données, vous pouvez également installer le MDAC (Microsoft Data Access Components) avec votre setup comme nous le verrons plus bas.
III-A. Vérification que le plug-in Bootstrapper est installé▲
1. Depuis le panneau de configuration, cliquer sur « ajout/suppression de programme ».
2. Dans la liste des programmes installés, vous devez voir « Microsoft Visual Studio .NET 2003 Bootstrapper Plug-in ». Si ce n'est pas le cas, télécharger et installer le Plug-in depuis le lien suivant : Plug-in Bootstrapper.
III-B. Installation du .NET Framework avec un setup▲
1. Assurez-vous avec la précédente étape que le Plug-in est bien installé.
2. Sélectionnez votre projet setup dans l'explorateur de solutions. Puis, effectuez un clic droit sur le projet puis « propriétés ».
3. Dans la section « Programme d'amorçage », sélectionnez « Programme d'amorçage de Windows Installer ». À cette étape, le .NET Framework sera encapsulé dans le répertoire de votre « Setup.exe ».
4. Assurez-vous également que la condition de lancement du .NET Framework est activée. Pour cela, sélectionnez votre projet « Setup » puis allez sur « Affichage », « Editeur », « Conditions de lancement ». Si dans les conditions de lancement, le .NET Framework est présent, vous n'avez rien à faire. Si ce n'est pas le cas, faites un clic droit sur « configuration requise pour l'ordinateur cible » puis « Ajouter une condition de lancement du .NET Framework ».
5. Par défaut la propriété « InstallUrl » pointe sur le site de Microsoft. De ce fait lorsque vous allez lancer l'application, si le .Net Framework n'est pas installé sur le poste, le setup proposera d'aller sur le site pour le télécharger. Par contre, vous pouvez vouloir exécuter le dotnetfx.exe qui se trouve dans le répertoire de votre « setup ». Dans ce cas, dans « InstallUrl » indiquez simplement « dotnetfx.exe ». Pour modifier cette propriété, il faut aller sur « Affichage » -> « Editeur » -> « Conditions de lancement » -> « .NET Framework » -> touche « F4 »
6. Ajoutez le fichier binaire de votre application dans le projet « Setup » en faisant un clic droit sur le projet « Setup » puis « Ajouter » puis « Fichier ».
7. Générez votre projet « Setup ».
III-C. Installation du MDAC avec un projet setup▲
1. Assurez-vous que le Plug-in bootstrapper est installé.
2. Sélectionnez voter projet « setup » puis allez dans le menu « Affichage », « éditeur », « conditions de lancement ».
3. Sélectionnez « configuration requise pour l'ordinateur cible » puis « ajouter une condition de lancement du registre » avec le bouton droit de la souris.
4. Sélectionnez « recherche de registreEntry1 ». Puis dans la fenêtre de propriétés, sélectionnez « RegKey » puis ajoutez « Software\Microsoft\DataAccess ».
5. Sélectionnez propriété « Root » et sélectionnez « vsdrrHKLM ».
6. Sélectionnez propriété « value » et indiquez « FullInstallVer ».
7. Sélectionnez la propriété « Property » et tapez « MDACSEARCH ».
8. Dans la section « Conditions de lancement », sélectionnez « Condition1 », puis dans les propriétés, sélectionnez « Condition » puis « MDACSEARCH ».
9. Sélectionnez votre projet « setup », puis affichez les propriétés.
10. Indiquez si ce n'est pas le cas pour le « Programme d'amorçage », « Programme d'amorçage de Windows Installer ».
11. Générez votre projet « Setup »
À cette étape, normalement le .NET Framework et le MDAC seront encapsulés dans le répertoire de votre projet « Setup ».
IV. Gestion des langues▲
Le .NET Framework est disponible en 22 langues. Les versions de dotnetfx.exe sont les mêmes, la seule différence entre les 22 versions est la langue utilisée durant l'installation. Par exemple lorsque vous installez une version japonaise du dotnetfx.exe sur une machine française, tous les dialogues de l'installation sont en japonais. De ce fait si vous voulez voir les dialogues de l'installation dans une langue particulière, vous devez installer le dotnetfx.exe correspondant à la langue.
Il y a 21 langages disponibles avec le .NET Framework 1.1 et les 21 langages peuvent être installés sur le même ordinateur. Cependant il n'y a pas de pack pour la langue anglaise qui est la langue par défaut.
Voici la procédure pour installer une langue particulière dans votre projet « setup »
- Assurez-vous que la bonne version du Plug-in bootstrapper est installée sur votre machine. Par exemple si vous souhaitez installer votre application avec la langue japonaise, il vous faut télécharger et installer la version japonaise du Plug-in.
- Sélectionnez votre projet « setup » dans VS .NET puis « Propriétés » avec la touche « F4 »
- Sélectionnez la propriété « Localisation » puis sélectionnez la langue que vous désirez.
- Sélectionnez pour le « programme d'amorçage », « Programme d'amorçage de Windows Installer ».
Note : assurez-vous également que la condition de lancement du .NET Framework est activée. Voir Chapitre 2 - B – 4.
V. Exemple d'un répertoire avec le Framework et le MDAC▲
Voici les fichiers que vous devriez trouver dans le répertoire release de votre projet :
- Config.ini ;
- dotnetfx.exe ;
- langpack.exe ;
- mdac_typ.exe ;
- Settings.ini ;
- Setup.exe ;
- SetupMyApplication.msi .
VI. Configuration minimale requise▲
Pour installer le dotnetfx.exe, vous devez disposer d'un des systèmes suivants :
- Microsoft Windows 98 ;
- Microsoft Windows 98 Second Edition ;
- Microsoft Windows Millennium Edition (Windows Me) ;
- Microsoft Windows NT 4 (Workstation or Server) avec Service Pack 6a ;
- Microsoft Windows 2000 (Professional, Server, or Advanced Server) avec le dernier service pack de Windows et les MAJ critiques ;
- Microsoft Windows XP (Home or Professional) ;
- Microsoft Windows Server 2003 family.
VII. Conclusion?▲
Nous venons de voir comment ajouter simplement le .NET Framework ainsi que le MDAC dans nos applications. Cela permet de faire des Setup professionnels qui contiennent le framework et le nécessaire pour accéder aux bases de données. Ceci grâce à un logiciel que Microsoft met gratuitement à la disposition des développeurs.