Fabriquer un jeu d'installation pour une application Visual Basic .NET utilisant une base Access
Introduction
Ce tutorial explique comment fabriquer un CD d'installation d'une application Visual Basic .Net utilisant une base Access. Ce CD permettra d'installer l'application sur n'importe quel poste, en installant automatiquement le Framework .Net s'il ne figure pas sur le poste, et le RunTime Access ce qui fera que l'application fonctionne sans qu'Access soit installé sur le poste.
Procédure
- Lancer Visual Studio
- Effectuer la commande [Fichier - Nouveau - Projet]
- Dans la partie "Types de projets", dérouler "Autres types de projets", puis cliquer sur "Configuration et Déploiement"
- Dans la partie droite, choisir "Assistant Installation"
- Dans l'assistant, sur l'écran permettant d'ajouter des fichiers supplémentaires, ajouter la base Access
- Une fois l'assistant terminé :
- Dans la fenêtre "Explorateur de solutions", effectuer un clic droit sur la solution (si la solution n'apparait pas, faire la commande [Outils - Options], et cocher "Toujours afficher la solution", dans la branche "Projets et solutions\Général").
- Choisir la commande [Ajouter - Projet existant], et choisir le fichier .vbproj de l'application.
- Le projet de l'application apparaît alors dans la fenêtre "Explorateur de solutions" :
- Effectuer un clic droit sur le projet de déploiement, toujours dans la fenêtre "Explorateur de solutions", et choisir la commande [Ajouter - Sortie de projet]. Le nom du projet de l'application figure dans la liste déroulante "Projet". Cliquer sur "Ok".
- Après avoir fait cette action, le framework .Net apparaît dans la branche "Dépendances détectées" du projet de déploiement, ceci toujours dans l'Explorateur de Solutions.
- Effectuer un nouveau clic droit sur le projet de déploiement, toujours dans la fenêtre "Explorateur de solutions" et choisir "Propriétés". Cliquer sur le bouton "Composants requis".
- Le framework .Net est déjà coché. Cocher "Microsoft Data Access Components" puisque l'application utilise une base Access.
- A propos de l'inclusion du composant "Microsoft Data Access Components" :
Noter que sous Visual Studio 2008, ce dernier composant n'apparaît pas. Le Framework 3.5, proposé sous Visual Studio 2008, semble l'inclure, car l'accès aux bases de données Access fonctionne une fois l'application installée.
Noter également que la base de données Access NE DOIT PAS ÊTRE AU FORMAT ACCESS 2007 OU SUPÉRIEUR. En effet, le moteur d'accès aux bases au format Access 2007 n'est pas inclus dans le Framework .Net, et ne figure pas dans la liste des composants requis. Ce qui oblige à installer ce pilote avant l'exécution du jeu d'installation sur les machines cibles Þ Pour une application devant être commercialisée, mieux vaut travailler avec une base au format antérieur au format Access 2007.
- A propos de l'inclusion du framework .Net :
Sous Visual Studio 2008, sur cette boîte de dialogue "Composants requis", on a une zone "Spécifier l'emplacement d'installation des composants requis" au bas de la fenêtre, dans laquelle le choix "Télécharger les composants requis à partir du site web du fournisseur de composants" est positionné par défaut. L'inconvénient de ce choix est que l'installation de l'application nécessite une connexion à Internet. On peut, pour éviter cet inconvénient, choisir "Télécharger les composants requis à partir de l'emplacement de mon application". On aura alors, dans le jeu d'installation généré, dans le dossier "Debug" contenant les fichiers "setup.exe" et "setup.msi", un sous-dossier nommé "DotNetFX" contenant le framework.
- Définir l'emplacement d'installation de l'application
* Effectuer un clic droit sur le projet de déploiement, toujours dans la fenêtre "Explorateur de solutions", et choisir la commande [Affichage - Système de fichiers]
* Sur l'onglet "Système de fichiers", cliquer sur "Dossier d'application"
Dans la fenêtre "Propriétés", la propriété DefaultLocation précise le dossier d'installation de l'application. Cette propriété est renseignée par défaut avec : [ProgramFilesFolder] [Manufacturer] - - - -
==> L'application s'installera dans le dossier \Program Files\nom-de-l'utilisateur-spécifié-à-l'installation-de-Visual-Studio.
On peut changer ce chemin. On peut mettre par ex [ProgramFilesFolder]\MonRépertoire. (Attention à ne pas mettre "MonRépertoire" entre crochets, les crochets étant réservés aux mots-clés tels que ProgramFilesFolder ou Manufacturer.
Mettre également la propriété "Always Create" à True.
- Si on désire que le raccourci de lancement de l'application ne soit pas directement dans le menu "Programmes", mais dans un groupe de programmes du menu "Programmes" (cas le plus fréquent)
Toujours sur l'onglet "Système de fichiers", effectuer un clic droit sur "Menu Programmes de l'utilisateur", puis choisir [Ajouter - Dossier]. Donner comme nom à ce dossier le nom que l'on désire pour le groupe de programmes. Mettre la propriété "AlwaysCreate" de ce dossier à "True".
- Créer le raccourci de lancement de l'application, qui apparaîtra dans le menu "Programmes", soit directement, soit dans un groupe de programmes
* Toujours sur l'onglet "Système de fichiers", cliquer sur "Dossier d'application"
* Effectuer un clic droit sur "Sortie principale de nom-application", puis choisir "Créer un raccourci vers Sortie principale de nom-application". Donner le nom désiré à ce raccourci.
* Faire en sorte que la propriété "Folder" de ce raccourci pointe sur le dossier "Menu Programmes de l'utilisateur", ou sur son sous-dossier créé précédemment, sous-dossier corespondant au groupe de programmes souhaité.
- Si on désire associer un icône au raccourci de lancement de l'application
* Toujours sur l'onglet "Système de fichiers", cliquer sur ce raccourci
* Dans la fenêtre "Propriétés", renseigner la propriété "Icon"
- Si on désire que le raccourci de lancement de l'application soit également sur le bureau de l'utilisateur
* Créer un deuxième raccourci de lancement, comme fait précédemment pour le raccourci devant apparaître dans le menu "Programmes", avec le même nom.
* Cliquer sur ce deuxième raccourci
* Dans la fenêtre "Propriétés", renseigner la propriété "Folder" avec "Bureau de l'utilisateur"
Génération du jeu d'installation de l'application
- Dans le menu général, effectuer la commande [Générer - Générer nom-projet-de-déploiement]
- Il ne restera plus qu'à graver le jeu d'installation sur un CD
Dépannage : Erreur "Framework non trouvé" lors de l'exécution de l'application une fois cette dernière installée :
Cause de l'erreur :
Se produit généralement lorsque le projet a commencé à être développé sous une version de Visual Studio plus ancienne, puis converti ensuite sous une version plus récente. La version du framework utilisé par l'application n'est pas la même que celle du framework inclus lors de la génération du jeu d'installation.
Exemple :
Un projet commencé à être développé sous Visual Stusio 2008 utilise le Framework 3.5. Si on continue son développement sous Visual Studio 2010, lors de la génération du jeu d'installation, cette deuxième version de Visual Studio va inclure la version 4 du Framework dans le jeu dinstallation.
Solution :
Avant la génération du jeu d'installation, modifier la version du Framework utilisé de façon à ce que le projet utilise la version qui va être incluse lors de cette génération : Commande [Projet - Propriétés], rubrique "Compiler", bouton "Options avancées de compilation" et liste déroulante "Framework cible".