Procédure pas à pas : génération de fichiers CAB personnalisés pour les projets smart device

Article
04/11/2008

Dans cette procédure pas à pas, vous générez un fichier CAB personnalisé en fonction des besoins spécifiques de votre utilisateur. La procédure pas à pas fournit un scénario complet en vous guidant tout au long des tâches suivantes :

Création d'une application Pocket PC simple avec Visual Basic .NET ou Visual C#
Génération automatique d'un fichier CAB pour fournir un modèle CAB
Modification du fichier d'informations (.inf) généré automatiquement
Génération d'un fichier CAB personnalisé à partir du fichier .inf modifié
Installation du fichier CAB personnalisé sur l'émulateur ou sur un périphérique physique

Pour réduire au minimum les problèmes de chemin d'accès, cette procédure pas à pas utilise le chemin d'accès que Visual Studio .NET assigne par défaut à ses projets, Mes documents\Visual Studio Projects. Si vous souhaitez utiliser un emplacement différent pour vos fichiers de projet, faites les modifications appropriées dans les instructions de la procédure pas à pas.

La procédure pas à pas suppose en outre que le .NET Compact Framework n'est pas installé sur le périphérique physique. Si l'est, vous pouvez sauter la procédure d'installation.

Choix d'un périphérique cible

Vous pouvez effectuer cette procédure pas à pas en choisissant l'émulateur ou un périphérique physique comme cible. Vous pouvez même aller et venir entre eux durant la procédure pas à pas. La procédure suivante permet d'afficher un message vous invitant à sélectionner un périphérique chaque fois que vous déployez votre solution.

Pour être invité à sélectionner le périphérique cible au moment du déploiement

Dans le menu Outils, cliquez sur Options, puis sur Outils de périphérique.
Activez la case à cocher Afficher les choix de périphériques avant de déployer un projet smart device.

Création de l'application

Vous commencez par générer une application Windows Forms simple que vous testez à l'aide de l'émulateur Pocket PC. Vous utiliserez cette application ultérieurement pour générer et personnaliser un fichier CAB pour la distribution.

Cette section comporte cinq tâches principales :

Création d'un projet smart device qui utilise les Windows Forms
Ajout d'un contrôle au formulaire
Ajout d'une gestion d'événement au contrôle
Sélection de l'émulateur comme périphérique sur lequel exécuter le projet
Génération et déploiement de l'application vers l'émulateur

Pour créer un projet smart device qui utilise les Windows Forms

Dans le menu Fichier de Visual Studio .NET, pointez sur Nouveau, puis cliquez sur Projet.
Dans la boîte de dialogue Nouveau projet, sous Types de projets, cliquez sur Projets Visual Basic ou Projets Visual C#.

Vous pouvez effectuer cette procédure pas à pas en utilisant l'un ou l'autre de ces deux langages.
Dans la zone Nom, tapez CustomCABSample.
Sous Modèles, double-cliquez sur Application Smart Device.
Dans l'Assistant Application Smart Device, cliquez dans le volet supérieur sur Pocket PC et dans le volet inférieur sur Application Windows.

Pour ajouter un contrôle au formulaire

Si le Concepteur Windows Forms n'est pas affiché, dans le menu Affichage, cliquez sur Concepteur.
À partir de la Boîte à outils, faites glisser un contrôle Button jusqu'au formulaire.
Cliquez avec le bouton droit sur le contrôle Button et cliquez sur Propriétés.
Dans la fenêtre Propriétés, tapez Say Hello et appuyez sur ENTRÉE pour définir la propriété Text.

Pour ajouter une gestion d'événement pour le contrôle Button

Double-cliquez sur le contrôle Button dans le formulaire.

L'éditeur de code s'ouvre et affiche le point d'insertion dans le gestionnaire d'événements.
Insérez le code Visual Basic suivant :
```
MessageBox.Show ("Hello, World!")
```
– ou –

Insérez le code C# suivant :
```
MessageBox.Show ("Hello, World!");
```

Pour générer et tester l'application

Dans le menu Déboguer, cliquez sur Démarrer.
Dans la boîte de dialogue Déployer, sélectionnez Émulateur Pocket PC, puis cliquez sur Déployer.

Remarque La boîte de dialogue Déployer ne s'ouvre pas si vous avez déjà sélectionné un périphérique cible et désactivé la case à cocher Afficher cette boîte de dialogue à chaque déploiement de l'application. La case à cocher Afficher cette boite de dialogue à chaque déploiement de l’application doit être activée pour cette procédure pas à pas.

Des messages d'avancement apparaissent dans la fenêtre Sortie, sur la barre d'état et sur l'écran de l'émulateur.
Lorsque l'application s'exécute sur l'émulateur, cliquez sur le bouton Say Hello pour vérifier que « Hello, World! » apparaît, puis fermez l'application.
Fermez l'émulateur avant de passer à la section suivante de cette procédure pas à pas.
En réponse à l'invite de la boîte de dialogue Arrêter de l'émulateur, sélectionnez Désactiver l'émulateur et cliquez sur OK dans le message indiquant que la connexion distante a été perdue.

Génération automatique du fichier CAB qui servira de modèle

Chaque fois qu'un projet smart device est ouvert, Visual Studio .NET fournit une commande de menu permettant de générer des fichiers CAB. Vous n'avez donc pas besoin de créer un projet de déploiement Visual Studio séparé. Dans la présente section, vous générez un fichier CAB avec les valeurs par défaut fournies par Visual Studio, puis vous fermez la solution pour préparer la personnalisation du fichier .inf utilisé par l'Assistant CAB (Cabwiz.exe).

Pour générer un fichier CAB pour votre solution

Votre projet étant ouvert, cliquez dans le menu Générer sur Générer le fichier .cab (ou cliquez dans la barre d'outils Périphérique sur le bouton Générer le fichier .cab).

La fenêtre Sortie affiche diverses informations sur le processus : les messages de génération, le répertoire où est stocké votre fichier CAB ainsi que les fichiers CAB dépendants et leurs emplacements.
Fermez la solution CustomCABSample.

Modification du fichier .inf

Vous allez maintenant rechercher et modifier le fichier .inf que Cabwiz.exe a utilisé pour générer le fichier CAB par défaut pour votre solution. Plus tard, vous réexécuterez Cabwiz.exe en utilisant le fichier .inf que vous allez personnaliser dans la présente section. Bien que peu importantes, les modifications que vous allez apporter au fichier .inf suffisent pour montrer comment modifier profondément les fichiers CAB que vous distribuez. Pour plus d'informations, consultez Fichiers CAB personnalisés pour les périphériques.

Vous pouvez modifier le fichier .inf dans n'importe quel éditeur de texte. Dans cette procédure pas à pas, vous utilisez l'éditeur de code et de texte de l'environnement de développement intégré (IDE) Visual Studio.

Pour modifier le fichier .inf

Dans le menu Fichier, pointez sur Ouvrir, puis cliquez sur Fichier.
Dans la boîte de dialogue Ouvrir un fichier, naviguez jusqu'à \Mes documents\Visual Studio Projects\CustomCABSample\obj\Debug.
Ouvrez le fichier solution CustomCABSample_PPC.inf.

Le fichier .inf s'ouvre dans l'éditeur de code et de texte de Visual Studio.
Dans la dernière section (intitulée [Shortcuts]), remplacez le premier argument (CustomCABSample) par Woodgrove Bank.

Il s'agit de la chaîne qui apparaîtra sous Programmes sur le périphérique.

Cette section doit maintenant avoir l'aspect suivant :
```
[Shortcuts]
Woodgrove Bank,0,CustomCABSample.exe
```
Enregistrez le fichier modifié sous un nouveau nom en cliquant dans le menu Fichier sur Enregistrer CustomCABSample_PPC.inf sous et en attribuant au nouveau fichier le nom WoodgroveBank_PPC.inf dans la boîte de dialogue Enregistrer le fichier sous.

Pour faciliter l'identification des fichiers d'informations destinés à la plate-forme Pocket PC, il est d'usage d'ajouter _PPC à la fin de leur nom.
Dans le menu Fichier, cliquez sur Fermer pour fermer le fichier WoodgroveBank_PPC.inf.

Il est toujours conseillé de sauvegarder tous les fichiers .inf personnalisés que vous créez, même si cela n'est pas nécessaire dans le cadre de cette procédure pas à pas.

Génération du fichier CAB modifié

Vous pouvez maintenant exécuter Cabwiz.exe à partir de la ligne de commande Windows pour générer des fichiers CAB personnalisés (un fichier CAB distinct est généré pour chaque processeur pris en charge) à l'aide du fichier .inf que vous venez de modifier. Au lieu de taper la commande sur la ligne de commande, vous copiez, modifiez et exécutez le fichier batch que Visual Studio a utilisé pour générer automatiquement le fichier CAB. Pour plus d'informations sur la syntaxe de Cabwiz.exe, consultez Fichier Cabwiz.exe pour les périphériques.

Pour modifier le fichier batch

Dans le menu Fichier, pointez sur Ouvrir, puis cliquez sur Fichier.
Dans la boîte de dialogue Ouvrir un fichier, naviguez jusqu'à \Mes documents\Visual Studio Projects\CustomCABSample\obj\Debug.
Ouvrez le fichier BuildCab.bat.

Le fichier batch s'ouvre dans l'éditeur de code et de texte de Visual Studio.
Dans l'argument de ligne de commande qui spécifie le fichier .inf à utiliser, attribuez au fichier .inf CustomCABSample_PPC.inf le nouveau nom WoodgroveBank_PPC.inf.
Enregistrez le fichier modifié sous un nouveau nom en cliquant dans le menu Fichier sur Enregistrer BuildCab.bat sous et en attribuant au nouveau fichier le nom BuildWoodgroveBankCab.bat dans la boîte de dialogue Enregistrer le fichier sous.
Dans le menu Fichier, cliquez sur Fermer pour fermer le fichier BuildWoodroveBankCab.bat.
Dans l'Explorateur Windows, naviguez jusqu'à Mes documents\Visual Studio Projects\CustomCABSample\obj\debug.
Double-cliquez sur BuildWoodgroveBankCAB.bat.

Les fichiers CAB WoodgroveBank_PPC pour plusieurs processeurs apparaissent dans Mes documents\Visual Studio Projects\CustomCABSample\cab\debug.

Installation du fichier CAB sur le périphérique cible

Que vous ayez choisi l'émulateur ou un périphérique physique comme cible, la série de tâches à effectuer pour installer une application est la même. Le processus peut se résumer de la façon suivante :

S'il n'est pas installé, installez le .NET Compact Framework sur le périphérique.
Copiez le fichier CAB de l'application vers la cible.

La façon de copier le fichier, qui varie selon que la cible est l'émulateur ou un périphérique physique, est décrite en détail plus loin dans cette section.
Ouvrez les fichiers CAB, ce qui déclenche l'extraction de leur contenu vers les zones de stockage spécifiées dans leurs fichiers .inf respectifs.
Ouvrez l'application.

Les procédures suivantes vous guideront lors de l'installation sur l'émulateur ou un périphérique physique.

Pour appliquer cette procédure pas à pas en installant les fichiers CAB sur un périphérique physique, vous devez connaître le type du processeur afin de pouvoir sélectionner le fichier CAB généré pour ce processeur. Cette procédure pas à pas utilise des fichiers CAB pour le processeur SH3 à titre d'exemple. Si votre périphérique utilise un processeur MIPS ou ARM, sélectionnez-le à la place du processeur SH3 et continuez la procédure pas à pas.

Si vous n'êtes pas sûr du processeur de votre périphérique, il est souvent possible d'extraire cette information du périphérique. La procédure à suivre est susceptible de varier selon le constructeur. Vous pouvez procéder de la façon suivante pour le Pocket PC. Dans le menu Démarrer, cliquez sur Paramètres. Sous l'onglet Système, cliquez sur À propos de. Sous l'onglet Version, consultez les informations affichées.
Pour appliquer cette procédure pas à pas en effectuant l'installation sur l'émulateur, consultez « Copie de fichiers vers l'émulateur » plus loin dans cette section.

Copie de fichiers vers un périphérique physique

Vous pouvez maintenant copier le fichier CAB personnalisé que vous avez généré vers le périphérique connecté à votre ordinateur de développement. Le périphérique et l'ordinateur de développement doivent avoir des liens de partenariat établis avec ActiveSync. Si le .NET Compact Framework n'est pas encore installé sur le périphérique, vous pouvez copier un fichier CAB pour l'installer.

Pour copier les fichiers requis vers un périphérique physique

À l'aide de l'Explorateur Windows, copiez le fichier WoodgroveBank_PPC.SH3.CAB (ou le fichier CAB approprié pour votre périphérique) depuis Mes documents\Visual Studio Projects\CustomCABSample\cab\Debug vers Mobile Device\My Pocket PC\Temp. Si le processeur du périphérique n'est pas un SH3, sélectionnez le fichier CAB adéquat.
Si ActiveSync affiche un message concernant une conversion de fichier, cliquez sur OK.
Si le .NET Compact Framework n'est pas encore installé sur le périphérique, copiez Compact FrameworkSDK\V1.0.5000\Windows CE\wce300\sh3\netcf.core.ppc3.sh3.cab depuis le répertoire d'installation de Visual Studio vers Mobile Device\Pocket PC\Temp. Si le processeur du périphérique n'est pas un SH3, sélectionnez le fichier CAB adéquat dans les dossiers situés sous \wce300.

Pour extraire le contenu des fichiers CAB et installer l'application

Dans le menu Démarrer du périphérique, cliquez sur Programmes, puis sur Explorateur de fichiers.
Dans la barre de menus du périphérique, en haut, naviguez jusqu'à Mon Pocket PC\Temp.

Les fichiers WoodgroveBank_PPC.X86 et Netcf.core.ppc3.x86 CAB doivent apparaître.

Pour des raisons de commodité, cette procédure pas à pas utilise le dossier Temp du périphérique pour télécharger les fichiers CAB, mais vous pouvez utiliser n'importe quel dossier dans la pratique. Les fichiers CAB extraient leur contenu vers les zones de stockage déjà spécifiées par le fichier .inf, puis sont supprimés automatiquement.
Cliquez sur le fichier Netcf.core.ppc3.x86.cab pour installer le .NET Compact Framework.

Il est essentiel d'effectuer cette extraction avant d'essayer d'extraire votre application. Si le .NET Compact Framework est déjà installé sur votre périphérique, vous pouvez sauter cette étape.

Un message apparaît pour indiquer que le Framework est en cours d'installation.
Cliquez sur le fichier CAB WoodgroveBank_PPC.X86 pour installer votre application.

Un message d'avancement analogue apparaît.
Sur le périphérique, sous Programmes, cliquez sur Woodgrove Bank pour vérifier que l'application a été installée convenablement.

Copie de fichiers vers l'émulateur

Vous pouvez maintenant copier le fichier CAB personnalisé et le fichier CAB qui contient le .NET Compact Framework vers l'émulateur. Comme l'émulateur n'existe qu'en mémoire, la copie des fichiers CAB vers l'émulateur n'est pas aussi simple que vers un périphérique physique.

Dans la pratique, lorsque vous développerez une application, vous l'installerez sur l'émulateur en la déployant directement, sans utiliser de fichier CAB. Toutefois, en générant un fichier CAB et en le copiant vers l'émulateur avant de le distribuer à un client, vous pouvez utiliser l'émulateur pour tester les modifications que vous avez apportées au fichier CAB pour le personnaliser.

Pour préparer l'ordinateur de développement à la copie

Créez un dossier partagé appelé WoodgroveBankTest.
Copiez votre fichier CAB personnalisé (Mes documents\Visual Studio Projects\CustomCABSample\cab\Debug\WoodgroveBank_PPC.X86.CAB) dans ce partage.
Copiez le fichier CAB .NET Compact Framework approprié (CompactFrameworkSDK\v1.0.5000\Windows CE\wce300\x86\netcf.core.ppc3.x86.cab) dans le partage.

Pour copier les fichiers CAB vers l'émulateur

Dans le menu Outils, cliquez sur Se connecter au périphérique.
Sélectionnez Émulateur Pocket PC et cliquez sur Connecter pour ouvrir l'émulateur.
Dans le menu Démarrer de l'émulateur, cliquez sur Programmes, puis sur Explorateur de fichiers.
Cliquez sur l'icône Partage réseau en bas de l'écran de l'émulateur.
Dans la boîte de dialogue Ouvrir, tapez le nom de votre ordinateur de développement, puis cliquez sur OK.

Un message apparaît pour indiquer que l'émulateur est en train de se connecter au serveur.

Remarque Si vous recevez un message vous informant qu'un périphérique de même nom existe déjà sur le réseau, vous devez modifier l'identificateur de périphérique de l'émulateur. Dans le menu Démarrer de l'émulateur, cliquez sur Paramètres. Sous l'onglet Système, cliquez sur À propos de. Sous l'onglet ID de périphérique, changez le nom du périphérique et essayez à nouveau de vous connecter au dossier partagé.
Dans la boîte de dialogue Connexion au réseau, tapez votre nom d'utilisateur, votre mot de passe et, s'il y a lieu, le domaine de votre ordinateur, puis cliquez sur OK.
Cliquez sur le dossier partagé WoodgroveBankTest.
Cliquez sur le fichier WoodgroveBank_PPC.X86, puis maintenez la touche CTRL enfoncée tout en cliquant sur le fichier Netcf.core.ppc3.x86 de façon à sélectionner les deux fichiers.
Cliquez et maintenez le bouton de la souris enfoncé au-dessus de la zone sélectionnée jusqu'à ce que l'animation des points rouges se termine et qu'un menu apparaisse, puis cliquez sur Copier.

Pour coller les fichiers CAB dans le répertoire Temp du périphérique

Cliquez sur l'icône Mon Pocket PC en bas de l'écran de l'émulateur.
Dans la barre de menus du périphérique, en haut, naviguez jusqu'à Mon Pocket PC\Temp.
Dans le menu Edition, cliquez sur Coller.

Les fichiers WoodgroveBank_PPC.X86 et Netcf.core.ppc3.x86 CAB doivent maintenant apparaître dans le dossier Temp.

Cette procédure pas à pas utilise le dossier Temp pour télécharger les fichiers CAB, mais vous pouvez utiliser n'importe quel dossier dans la pratique. Les fichiers CAB extraient leur contenu vers les destinations déjà spécifiées par le fichier .inf, puis sont supprimés automatiquement.

Pour extraire le contenu des fichiers CAB

Cliquez sur le fichier Netcf.core.ppc3.x86.cab pour installer le .NET Compact Framework. Il est essentiel d'effectuer cette extraction avant d'essayer d'extraire votre application.

Un message apparaît pour indiquer que le .NET Compact Framework est en cours d'installation.
Cliquez sur le fichier CAB WoodgroveBank_PPC.X86 pour installer votre application.

Un message d'avancement analogue apparaît.
Sur le périphérique, sous Programmes, cliquez sur Woodgrove Bank pour vérifier que l'application a été installée convenablement.

Voir aussi

Distribution d'applications smart device | Génération automatique d'un fichier CAB |Fichiers .inf pour les périphériques | Procédures pas à pas relatives aux projets smart device | Copie de fichiers vers le périphérique cible | Installation de l'application sur le périphérique