Fichier Readme du composant Windows CE Utilities for Visual Studio .NET 2003 v1.1

Mai 2003
Mise à jour : Août 2003

Le composant Windows CE Utilities for Visual Studio .NET 2003 permet aux développeurs de déployer et de déboguer des applications en code managé pour des plates-formes Windows CE.

Pour installer le composant Windows CE Utilities for Visual Studio .NET 2003, Visual Studio .NET 2003 doit être installé sur votre ordinateur.

Pour obtenir des informations détaillées sur le déploiement et le débogage d'une application à l'aide du composant Windows CE Utilities for Visual Studio .NET 2003, consultez les questions fréquemment posées suivantes.

Remarque : Ces utilitaires sont disponibles uniquement en anglais. Dans les informations ci-dessous, qui décrivent en détail l'utilisation des utilitaires, toutes les références à l'interface utilisateur sont laissées en anglais.

De quels éléments mon périphérique a-t-il besoin pour effectuer le débogage avec Visual Studio ?

Comment déployer et déboguer une application sur un périphérique exécutant Windows CE avec ActiveSync ?

Comment déployer et déboguer une application sur un périphérique exécutant Windows CE avec la prise en charge de TCP/IP ?

Comment déboguer une application sur un périphérique x86 exécutant Windows CE ?

J'ai désinstallé ActiveSync, puis je l'ai réinstallé. À présent, je ne peux pas déployer mon application. Comment résoudre ce problème ?

Je ne parviens pas à effectuer un débogage sur un périphérique disposant d'une mémoire flash. Comment résoudre ce problème ?

Comment déployer une application lorsque plus de 50 protocoles réseau sont installés sur l'ordinateur ?

Une erreur de connexion au périphérique s'affiche lors du déploiement ou du débogage, mais les autres utilisateurs ouvrant une session sur le même ordinateur peuvent se connecter au même périphérique avec Visual Studio .NET. Comment régler ce problème ?

Une erreur relative à un fichier d'apparence manquant s'affiche lors de l'ouverture d'un émulateur SDK. Comment régler le problème ?

De quels éléments mon périphérique a-t-il besoin pour effectuer le débogage avec Visual Studio ?

Si vous rencontrez des problèmes lors du débogage sur votre périphérique avec Visual Studio, assurez-vous que vous disposez des éléments suivants.

· Un périphérique utilisant ActiveSync ou une connexion Ethernet.

Visual Studio peut utiliser l'un ou l'autre pour établir à distance une connexion avec le périphérique.

· Le fichier WCELOAD sur le périphérique.

Ce fichier est requis pour installer le .NET Compact Framework et d'autres modules dépendants sur le périphérique. Dans Platform Builder, il fait partie du composant CAB File Installer/Uninstaller.

Remarque Le composant CAB File Installer/Uninstaller se trouve dans le catalogue à l'emplacement Core OS\Display Based Devices\Applications and Services Development\Applications–End User\.

· Le fichier Toolhelp.dll sur le périphérique.

Ce module est utilisé par le débogueur et est requis sur le périphérique.

Pour copier Toolhelp.dll sur le périphérique

1. Ouvrez le dossier correspondant à l'unité centrale de votre périphérique dans Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\Toolhelp\WinCE410.

2. Copiez Toolhelp.dll dans le dossier \Windows du périphérique.

Retour au début

Comment déployer et déboguer une application sur un périphérique exécutant Windows CE avec ActiveSync ?

La procédure suivante explique en détail comment configurer un environnement de développement Visual Studio .NET 2003 pour créer, déboguer et déployer une application en code managé sur un périphérique Microsoft® Windows® CE .NET personnalisé prenant en charge ActiveSync.

Configuration requise

· Visual Studio .NET 2003

· Windows CE Utilities for Visual Studio .NET 2003

· Périphérique Windows CE .NET 4.1 ou Windows CE .NET 4.2

· Composants ActiveSync (Repllog.exe, Rapisrv.exe) installés sur le périphérique*

· Composant CAB File Installer/Uninstaller (WCELoad.exe) installé sur le périphérique*

· ToolHelp.dll installé sur le périphérique

· ActiveSync installé sur l'ordinateur de bureau

Remarque ActiveSync 3.5 est recommandé si vous utilisez Windows CE .NET 4.1.

· Connexion série RS232/USB 115 k

*Si vous êtes éditeur de logiciels et que vous ne disposez pas de ces composants, contactez votre constructeur OEM. Microsoft ne peut pas distribuer ces composants.

Pour utiliser l'utilitaire Select Windows CE Device CPU

1. Ouvrez un projet Smart Device nouveau ou enregistré dans Visual Studio .NET.

2. Pour un dispositif x86, importez le fichier WinCEx86Device.reg sur la station de travail sur laquelle vous avez installé VS .NET 2003 et le composant Windows CE Utilities for Visual Studio .NET 2003.

3. Établissez une connexion ActiveSync entre votre périphérique et l'ordinateur de bureau en exécutant Repllog.exe sur votre périphérique.

4. Dans le menu Outils, cliquez sur Select Windows CE Device CPU.

Remarque Si vous sélectionnez ARMV4I, l'outil le convertira automatiquement en ARMV4T car Visual Studio .NET 2003 traite les périphériques ARMV4I et ARMV4T de la même manière.

5. Sélectionnez l'unité centrale de votre périphérique cible à partir de la liste déroulante, puis cliquez sur Configure.

6. Cliquez sur Close.

7. Redémarrez Visual Studio pour appliquer les nouveaux paramètres.

Vous pouvez à présent créer, déboguer et déployer des applications en code managé pour des plates-formes Windows CE .NET à l'aide de Visual Studio .NET 2003.

Retour au début

Comment déployer et déboguer une application sur un périphérique exécutant Windows CE avec la prise en charge de TCP/IP ?

Configuration requise

· Visual Studio .NET 2003

· Windows CE Utilities for Visual Studio .NET 2003

· Windows CE .NET 4.1 ou Windows CE .NET 4.2

· Composants réseau local/réseau sans fil sur le périphérique*

· Composant CAB File Installer/Uninstaller (WCELoad.exe) sur le périphérique*

· ToolHelp.dll sur le périphérique

· SDAuthUtilDevice.exe sur le périphérique, inclus dans le composant Windows CE Utilities for Visual Studio .NET 2003

· Connexion Ethernet

*Si vous êtes éditeur de logiciels et que vous ne disposez pas de ces composants, contactez votre constructeur OEM. Microsoft ne peut pas distribuer ces composants.

Pour utiliser Smart Device Authentication Utility

1. Ouvrez un projet Smart Device nouveau ou enregistré dans Visual Studio .NET.

2. Exécutez Smart Device Authentication Utility sur le périphérique.

Pour exécuter Smart Device Authentication Utility sur le périphérique

a. Ouvrez le dossier correspondant à la version de Windows CE installée sur votre périphérique dans Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\Authentication Util.

b. Ouvrez le dossier correspondant à l'unité centrale de votre périphérique.

c. Copiez le fichier SDAuthUtilDevice.exe sur votre périphérique.

d. Exécutez SDAuthUtilDevice.exe sur votre périphérique.

e. Cliquez sur Start.

Remarque Il y aura une pause pendant que la station de travail exécutant Visual Studio .NET se connectera au périphérique via une connexion TCP/IP.

3. Exécutez Smart Device Authentication Utility sur l'ordinateur exécutant Visual Studio .NET.

Pour exécuter Smart Device Authentication Utility sur l'ordinateur

a. Dans le menu Outils, cliquez sur Smart Device Authentication Utility.

b. Dans la zone Device IP Address, entrez l'adresse IP du périphérique.

c. Cliquez sur Set Up Device.

4. Appliquez le nouveau paramètre à Visual Studio comme indiqué dans la procédure suivante.

Pour appliquer les paramètres à Visual Studio

a. Dans le menu Outils, cliquez sur Options.

b. Cliquez sur Outils du périphérique, puis sur Périphériques.

c. Dans la zone Afficher les périphériques pour la plate-forme, cliquez sur le périphérique auquel vous voulez vous connecter.

d. Cliquez sur Enregistrer sous, tapez un nouveau nom dans la zone, puis cliquez sur OK.

e. Dans la zone Transport, cliquez sur Transport TCP Connect.

f. Cliquez sur Configurer.

g. Cliquez sur Utiliser une adresse IP spécifique, puis entrez l'adresse IP du périphérique.

h. Cliquez sur OK.

Vous pouvez à présent créer, déboguer et déployer des applications en code managé pour des plates-formes Windows CE .NET à l'aide de Visual Studio .NET 2003.

Retour au début

Comment déboguer une application sur un périphérique x86 exécutant Windows CE ?

Problème : Après avoir exécuté le module complémentaire Windows CE Device Configuration, l'utilisateur peut effectuer un déploiement sans débogage sur un périphérique x86 exécutant Windows CE et connecté à l'ordinateur de bureau via ActiveSync.

Solution : Modifiez le registre sur l'ordinateur de bureau exécutant Visual Studio pour permettre le débogage sur des périphériques x86 exécutant Windows CE. Cela désactivera le débogage sur l'émulateur Windows CE jusqu'à la restauration du registre.

Pour activer le débogage sur les périphériques x86 exécutant Windows CE

· Sur l'ordinateur de bureau exécutant Visual Studio, importez WinCEx86Device.reg dans le registre.

Remarque WinCEx86Device.reg se trouve par défaut dans Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg.

Pour restaurer le débogage sur l'émulateur Windows CE

1. Supprimez la clé de registre HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows CE Services\ProxyPorts.

2. Sur l'ordinateur de bureau exécutant Visual Studio, importez ProxyPorts.reg dans le registre.

Remarque ProxyPorts.reg se trouve par défaut dans Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg.

Retour au début

J'ai désinstallé ActiveSync, puis je l'ai réinstallé. À présent, je ne peux pas déployer mon application. Comment résoudre ce problème ?

Problème : Après avoir désinstallé ActiveSync version 3.5, 3.6, 3.7 ou 3.71, le déploiement génère le message d'erreur « Erreurs de déploiement. Voulez-vous continuer ? ». Cela se produit généralement lorsqu'une version d'ActiveSync est désinstallée et qu'une version plus récente est installée.

Solution : La désinstallation de ces versions d'ActiveSync supprime certains paramètres de registre requis pour le déploiement. Vous devez restaurer ces paramètres de registre pour permettre le déploiement.

Pour restaurer les paramètres de registre

1. Importez ProxyPorts.reg dans le registre.

Remarque ProxyPorts.reg se trouve par défaut dans Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg.

2. Retirez le périphérique de la station d'accueil, puis remettez-le en place. Si le déploiement ne fonctionne toujours pas, redémarrez le périphérique.

Retour au début

Je ne parviens pas à effectuer un débogage sur un périphérique disposant d'une mémoire flash. Comment résoudre ce problème ?

Problème : Le déploiement ne fonctionne pas avec certains périphériques exécutant Windows CE 4.1 équipés de certains types de mémoire flash.

Solution : Certaines clés sont stockées en partie dans le système de fichiers du périphérique et en partie dans la mémoire flash. Lorsque le périphérique est réinitialisé, la moitié de la clé est supprimée, et la clé est perçue comme endommagée. Exécutez DelCryptoKeys.exe pour supprimer toutes les clés endommagées stockées sur le périphérique.

Pour exécuter DelCryptoKeys.exe

1. Ouvrez le dossier correspondant à l'unité centrale de votre périphérique dans Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelCryptoKeys.

2. Copiez DelCryptoKeyss.exe sur le périphérique.

3. Exécutez DelCryptoKeys.exe.

Il est possible d'exécuter DelCryptoKeys.exe des différentes manières suivantes.

Utilisation	Résultat
DelCryptoKeys	Ne génère pas de données de sortie.
DelCryptoKeys /out:UI	Affiche les résultats dans un message.
DelCryptoKeys /out:nom_fichier	Enregistre les résultats dans le fichier nom_fichier.

Les codes d'erreur suivants sont retournés si un problème survient lors de l'exécution de l'outil.

Code d'erreur	Signification
2	La clé est introuvable. Elle a peut-être déjà été supprimée ou n'a jamais posé problème.
5	Le déploiement a déjà été effectué. Redémarrez le périphérique, puis recommencez.

Retour au début

Comment déployer une application lorsque plus de 50 protocoles réseau sont installés sur l'ordinateur ?

Problème : Un ordinateur exécutant plus de 50 protocoles réseau ne peut pas effectuer un déploiement sur un périphérique. Si vous tentez une telle opération, le message d'erreur suivant s'affiche : « Erreurs de déploiement. Voulez-vous continuer ? ».

Solution : Vous pouvez soit supprimer tous les protocoles réseau qui ne sont pas nécessaires, soit désinstaller toutes les applications pour lesquelles des protocoles sont installés.

Pour supprimer des protocoles réseau

1. Cliquez sur Démarrer, puis sur Panneau de configuration.

2. Double-cliquez sur Outils d'administration, puis sur Gestion de l'ordinateur.

3. Sous Outils système, cliquez sur Gestionnaire de périphériques.

4. Dans le volet de droite, développez Cartes réseau.

5. Supprimez toutes les cartes réseau non utilisées.

Pour désinstaller les applications pour lesquelles des protocoles sont installés

1. Exécutez EnumProtocols.exe afin de voir pour quelles applications des protocoles sont installés.

Remarque EnumProtocols.exe se trouve par défaut dans Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\EnumProtocols.

2. Désinstallez toutes les applications inutiles.

Retour au début

Problème : Le déploiement vers un Pocket PC ou un périphérique Windows CE connecté avec ActiveSync génère le message d'erreur « Impossible d'établir une connexion à ce périphérique. Vérifiez que le périphérique est connecté et fonctionne correctement. ». Les autres utilisateurs ouvrant une session sur l'ordinateur peuvent éventuellement procéder au déploiement et au débogage avec ce même périphérique, ActiveSync fonctionne correctement et le fichier \Windows\ConManClient.exe n'est pas copié sur le périphérique lors de la tentative de déploiement ou de débogage.

Solution : Il se peut qu'un conteneur de clés de sécurité soit endommagé. Sur l'ordinateur exécutant Visual Studio .NET, exécutez DelDesktopCryptKey.exe à partir de l'invite de commandes pour nettoyer le conteneur de clés de sécurité de l'utilisateur actuel.

Remarque DelDesktopCryptKey.exe se trouve par défaut dans Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelDesktopCryptKey.

Retour au début

Une erreur relative à un fichier d'apparence manquant s'affiche lors de l'ouverture d'un émulateur SDK. Comment régler le problème ?

Problème : Si vous installez un émulateur avec un SDK conçu avec Platform Builder, il se peut que le message d'erreur suivant s'affiche lors de l'ouverture de l'émulateur à partir de Visual Studio .NET 2003 :

Impossible d'ouvrir le fichier d'apparence XML spécifié. Vérifiez que le nom ou le chemin d'accès du fichier spécifié est correct.

Solution : Vous pouvez corriger l'erreur manuellement ou exécuter l'utilitaire DelEmuSkin pour créer un nouveau fichier Windows Installer (.msi) pour le SDK.

Pour corriger l'erreur manuellement

1. Ouvrez le Registre et recherchez la clé HKEY_LOCAL_MACHINE\Software\Microsoft\Windows CE Tools\Managed Platforms.

La clé de Registre Managed Platforms doit contenir une ou plusieurs sous-clés identifiées par des GUID. Chaque sous-clé représente un émulateur distinct installé par un SDK et doit avoir une valeur pour PlatformName, Skins, etc. Repérez les émulateurs générant l'erreur d'apparence. La valeur de Registre Skins pour ces émulateurs doit correspondre à un nom de dossier. Précisez le chemin d'accès complet vers le fichier XML d'apparence comme valeur de Registre de Skins.

2. Supprimez le fichier sdkRollerDevice-<GUID> pour chaque émulateur générant une erreur, où <GUID> correspond au GUID de l'émulateur en question.

Remarque Le fichier sdkRollerDevice-<GUID> se trouve par défaut dans Documents and Settings\All Users\Application Data\Microsoft\VisualStudio\devices\addons.

Vous pouvez démarrer Visual Studio .NET 2003 et utiliser les émulateurs.

L'utilitaire DelEmuSkin supprime toutes les apparences des émulateurs. Même si son utilisation semble être un inconvénient, cet utilitaire corrige les erreurs de fichier d'apparence de façon plus simple et plus sûre que la suppression manuelle de fichiers ou la modification manuelle du Registre. De plus, DelEmuSkin génère un nouveau fichier .msi que vous pouvez distribué aux autres installations SDK.

Pour utiliser DelEmuSkin

1. Exécutez DelEmuSkin.exe.

Syntaxe

DelEmuSkin AncienNomFichier NouveauNomFichier

Paramètre	Description
AncienNomFichier	Fichier .msi d'origine du SDK.
NouveauNomFichier	Nom sous lequel enregistrer le nouveau fichier .msi

Remarque DelEmuSkin.exe se trouve par défaut dans \Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelEmuSkin\.

2. Si le SDK est installé, supprimez-le à l'aide de l'option Ajout/Suppression de programmes du Panneau de configuration.

3. Démarrez Visual Studio .NET 2003 et ouvrez un projet de périphérique actif. Vérifiez que les émulateurs installés par le SDK n'apparaissent plus dans la liste des périphériques.

4. Installez le SDK à l'aide du fichier .msi généré par DelEmuSkin.

Vous pouvez démarrer Visual Studio .NET 2003 et utiliser les émulateurs.