Procédure pas à pas : empaquetage d'une solution Smart Device pour le déploiement
Mise à jour : novembre 2007
Cette procédure pas à pas montre comment utiliser Visual Studio pour empaqueter votre application et ses ressources dans un fichier CAB afin que ce dernier puisse être déployé sur l'appareil de type Smart Device d'un utilisateur final.
.gif "Remarque") Remarque : |
|---|
Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur 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. |
Dans cette procédure pas à pas, vous commencez par toute solution Smart Device écrite en Visual Basic, Visual C# ou Visual C++. Pour plus d'informations, consultez Procédure pas à pas : création d'applications Windows Forms pour un appareil.
La procédure pas à pas montre comment effectuer les actions suivantes :
Ajouter un projet CAB à la solution.
Modifier le nom de produit.
Modifier le chemin de sortie.
Remplir le fichier CAB en utilisant la sortie principale de l'application.
Ajouter les dépendances nécessaires.
Créer un raccourci vers l'application.
Déplacer le raccourci vers le dossier Menu Démarrer ou Programmes.
Modifier une entrée du Registre.
Composants requis
Une solution Smart Device existante. Pour cette procédure pas à pas, pensez à créer et à générer un projet simple, tel que le projet décrit dans Procédure pas à pas : création d'applications Windows Forms pour un appareil.
Installation du projet CAB
Pour ajouter un projet CAB Smart Device à la solution
Ouvrez le projet Smart Device existant et assurez-vous que l'Explorateur de solutions est visible.
Dans le menu Fichier, pointez sur Ajouter, puis cliquez sur Nouveau projet.
La boîte de dialogue Ajouter un nouveau projet s'affiche.
Dans le volet Types de projets,développez Autres types de projets, puis cliquez sur Configuration et déploiement.
Dans le volet Modèles, cliquez sur Projet CAB Smart Device.
C'est le seul type de projet CAB valide pour les applications Smart Device. Les autres types de projets sont uniquement destinés aux solutions bureautiques.
Dans la zone Nom, tapez ProjetCAB, puis cliquez sur OK.
Le projet CAB est ajouté à votre solution et est visible dans l'Explorateur de solutions. Les deux volets de l'Éditeur du système de fichiers sont maintenant affichés.
Personnalisation du projet CAB
Pour modifier le nom de produit et d'autres propriétés de projet
Dans l'Explorateur de solutions, cliquez sur ProjetCAB s'il n'est pas déjà sélectionné.
Dans le menu Affichage, cliquez sur Fenêtre propriétés pour ouvrir la fenêtre Propriétés.
Dans le champ ProductName de la grille de propriétés, modifiez la valeur en MyProduct.
La valeur de la propriété ProductName détermine le nom qui s'affiche pour l'application dans les noms de dossiers et dans la boîte de dialogue Ajouter ou supprimer des programmes.
Vous pouvez également utiliser cette fenêtre pour modifier le nom du fabricant et spécifier les versions minimum et maximum du système d'exploitation.
Vous pouvez affecter à la propriété OSVersionMin la valeur 4.21 pour indiquer que votre application Pocket PC prend en charge l'orientation de l'écran. Toutefois, en affectant cette valeur à la propriété, l'application ne peut pas être installée sur les Pocket PC avec Windows Mobile 2003 et versions antérieures. Pour autoriser l'installation sur ces appareils et indiquer également la prise en charge de l'orientation de l'écran pour les appareils les plus récents, vous devez modifier manuellement le fichier .inf pour choisir l'une des valeurs suivantes pour la propriété BuildMax :
0xA0000000 pour indiquer que l'application prend en charge les écrans carrés (240x240 pixels)
0xC0000000 pour indiquer que l'application prend en charge la rotation
- ou -
0xE0000000 pour indiquer que l'application prend en charge les écrans carrés et la rotation d'écran.
Pour plus d'informations, consultez l'article Développement d'applications sensibles à l'orientation de l'écran sur MSDN.
Pour les solutions Pocket PC basées sur Windows Mobile 2003 SE et versions antérieures, la propriété Compress et la propriété de déploiement d'appareil NoUninstall doivent avoir la valeur False. Notez que cette option peut avoir la valeur true pour les appareils équipés du Compact Framework 2.0. Pour plus d'informations, consultez Fenêtre Propriétés, Projet CAB Smart Device.
Si vous utilisez une DLL de configuration Windows CE, utilisez cette grille de propriétés pour spécifier le nom et l'emplacement du fichier. Pour plus d'informations sur l'installation des DLL de configuration Windows CE, consultez la documentation de Pocket PC ou le Kit de développement logiciel Smartphone.
Pour modifier le nom du fichier CAB et ajouter l'authentification
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur ProjetCAB, puis cliquez sur Propriétés.
La boîte de dialogue Pages de propriétés de votre projet CAB apparaît. Dans la zone Nom du fichier de sortie, remplacez le nom du fichier CAB et son chemin d'accès par Debug\MyApp.cab, puis cliquez sur OK.
Vous pouvez également utiliser cette page de propriétés pour ajouter l'authentification à votre projet. L'authentification est requise pour les solutions Smartphone et n'est pas prise en charge sur les solutions Pocket PC basées sur Windows Mobile 2003 et versions antérieures. Pour plus d'informations, consultez Sécurité dans les projets Smart Device.
Pour ajouter l'application du projet Smart Device au projet CAB
Dans le volet gauche de l'Éditeur du système de fichiers, cliquez sur Dossier d'application pour spécifier que les fichiers que vous sélectionnez dans les étapes suivantes doivent être installés dans ce dossier sur l'appareil cible.
Si l'Éditeur du système de fichiers n'est pas visible, cliquez avec le bouton droit sur le nom du projet CAB dans l'Explorateur de solutions, et cliquez sur Afficher, puis sur Système de fichiers.
Dans le menu Action de Visual Studio, pointez sur Ajouter, puis cliquez sur Sortie de projet.
Dans la boîte de dialogue Ajouter le groupe de sorties du projet, choisissez votre projet Smart Device dans la liste déroulante Projet.
Dans la liste des sorties, sélectionnez Sortie principale, puis cliquez sur OK.
| Remarque : |
|---|
Lors de la création d'un projet CAB Smart Device pour une application écrite en C++, vous devez ajouter manuellement toutes les dépendances, telles que atl90.dll, mfc90U.dll et/ou msvcr.dll, au projet CAB si vous effectuez une liaison dynamique à ces DLL. Toutefois, la liaison statique est fortement recommandée pour réduire les dépendances avec les DLL MFC/ATL. Si vous effectuez une liaison statique, les DLL ne doivent pas être redistribuées avec votre application. S'il s'agit d'une liaison dynamique, et que vous devez redistribuer les DLL dans le CAB, n'installez pas les DLL dans un répertoire système, comme \windows, sur l'appareil. Au lieu de cela, installez les DLL dans le répertoire d'application local. Si vous redistribuez une suite d'applications, lesquelles sont toutes dynamiquement liées aux runtimes ATL/MFC, installez toutes les applications et les DLL runtime dans un répertoire d'application unique et fournissez des raccourcis vers les applications qui pourront être placées dans leurs propres dossiers. Cela économisera de l'espace et évitera que les DLL contenues dans le répertoire système soient remplacées ultérieurement et que les applications qui y sont dynamiquement liées s'arrêtent. |
Pour ajouter des dépendances au projet CAB (projets C++ uniquement)
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet CAB, et cliquez sur Ajouter, puis sur Fichier.
Naviguez vers Dossier d'installation de Visual Studio\VC\ce\dll\plateforme.
Sélectionnez les fichiers à ajouter.
Pour un projet MFC, appuyez sur CTRL et cliquez sur MFC90U.DLL, atl90.dll et msvcr90.dll. Vous devrez également cliquer sur une ou plusieurs DLL spécifiques à la langue si votre application requiert des ressources MFC spécifiques à la langue.
Pour un projet ATL, appuyez sur CTRL, puis cliquez sur atl90.dll et msvcr90.dll. Si votre solution ATL prend en charge MFC, cliquez également sur MFC90U.DLL.
Pour un projet Win32, cliquez sur msvcr90.dll.
Cliquez sur Ouvrir dans la boîte de dialogue Ajouter des fichiers pour ajouter les fichiers à votre projet CAB.
Dans le volet gauche de l'Éditeur du système de fichiers, cliquez avec le bouton droit sur Système de fichiersdel'ordinateur cible.
Cliquez sur Ajouter un dossier spécial, puis cliquez sur Dossier Windows.
Dans le volet gauche de l'Éditeur du système de fichiers, cliquez sur le dossier qui contient votre sortie principale. Les DLL ont été ajoutées par défaut au même dossier que votre sortie principale. Pour les déplacer dans le dossier Windows, sélectionnez les fichiers dans le volet central de l'Éditeur du système de fichiers, puis faites-les glisser dans l'icône Dossier Windows.
Utilisez la même procédure pour ajouter toutes les autres dépendances requises par votre solution. Vous pouvez ajouter des dépendances dans n'importe quel dossier ; il n'est pas nécessaire de les ajouter au dossier Windows.
Pour créer un raccourci pour l'application du projet Smart Device
Dans le volet droit de l'Éditeur du système de fichiers, sélectionnez Sortie principale de <nom de projet de votre application>.
Dans le menu Action, cliquez sur Créer un raccourci vers Sortie principale de <nom de projet de votre application>.
Cette commande ajoute un élément Raccourci sous l'élément Sortie.
Cliquez avec le bouton droit sur l'élément Raccourci, cliquez sur Renommer et renommez le raccourci avec un nom approprié.
Pour déplacer le raccourci vers le dossier Menu Démarrer ou Programmes
Dans le volet de gauche de l'Éditeur du système de fichiers, cliquez avec le bouton droit sur Système de fichiers de l'ordinateur cible, pointez sur Ajouter un dossier spécial, puis cliquez sur Dossier Menu Démarrer ou sur Dossier Programmes.
Faites glisser le raccourci du dossier d'application vers le dossier Menu Démarrer ou le dossier Programmes.
Pour ajouter une entrée du Registre
Dans l'Explorateur de solutions, cliquez sur le projet CAB.
Dans le menu Affichage, pointez sur Éditeur, puis cliquez sur Registre.
Dans l'Éditeur du Registre, cliquez avec le bouton droit sur HKEY_CURRENT_USER, puis cliquez sur Nouvelle clé dans le menu contextuel.
Lorsque l'entrée Nouvelle clé s'affiche dans l'Éditeur du Registre, renommez-la SOFTWARE.
Cliquez avec le bouton droit sur cette nouvelle clé, pointez sur Nouveau, puis cliquez sur Clé.
Lorsque l'entrée Nouvelle clé s'affiche dans l'Éditeur du Registre, renommez-la MaSociété.
Cliquez avec le bouton droit sur l'entrée MaSociété, puis cliquez sur Fenêtre Propriétés.
La valeur Nom a été remplacée par MaSociété.
Construction et déploiement du fichier CAB
Pour générer le fichier CAB
Dans le menu Générer, cliquez sur Générer ProjetCAB.
- ou -
Cliquez avec le bouton droit sur ProjetCAB dans l'Explorateur de solutions, puis cliquez sur Générer.
Dans le menu Fichier, cliquez sur Enregistrer tout.
Les fichiers CAB pour les solutions Smartphone doivent être signés numériquement avant de les déployer sur l'appareil d'un utilisateur final. La signature numérique n'est pas prise en charge sur les solutions Pocket PC basées sur Windows Mobile 2003 SE et versions antérieures. Pour plus d'informations, consultez Comment : signer un fichier CAB (smart devices).
Pour déployer le fichier CAB sur l'appareil
Dans l'Explorateur Windows, naviguez jusqu'au dossier qui contient cette solution. Le fichier CAB se trouve dans le dossier ProjetCAB\Release de votre solution.
Copiez le fichier CAB sur un appareil connecté avec ActiveSync 4.0 ou toute version ultérieure.
Lorsqu'un utilisateur clique sur le nom du fichier CAB dans l'Explorateur de fichiers de l'appareil, Windows CE décompacte le fichier CAB et installe l'application sur l'appareil.
Pour plus d'informations, consultez la documentation du Kit de développement logiciel Smartphone ou Pocket PC.
Voir aussi
Référence
Empaquetage (Comment faire dans les projets Smart Device)