Contrôle des appareils avec les API de connectivité Smart Device

  • Article

Mise à jour : novembre 2007

Microsoft Visual Studio intègre les API de connectivité Smart Device qui permettent aux développeurs de tirer parti de certaines fonctionnalités de connectivité principale dans leurs applications. La connectivité principale est une infrastructure de communications utilisée par des produits tels que Microsoft Visual Studio, Microsoft Visual Studio Remote Tools et Microsoft Platform Builder afin de déployer des fichiers, de démarrer des processus, de flasher des appareils et de déboguer des applications sur des appareils de type Smart Device.

En général, l'API de connectivité Smart Device est utilisée pour écrire des applications telles que Outils à distance pour les projets smart device. L'avantage est que les développeurs se concentrent davantage sur la logique de programmation car les détails concernant la connexion aux appareils et la gestion de ceux-ci sont soustraits. Les API de connectivité Smart Device permettent d'effectuer les tâches suivantes :

  • énumérer les plateformes et les appareils de type Smart Device disponibles ;

  • établir une connexion entre un ordinateur de bureau local et un appareil de type Smart Device cible ;

  • déployer des applications, des packages et des fichiers sur un appareil de type Smart Device cible ;

  • démarrer, arrêter et énumérer des processus sur un appareil de type Smart Device cible ;

  • échanger des données entre l'ordinateur de bureau et l'appareil de type Smart Device cible ;

utiliser des API de connectivité Smart Device pour écrire des outils de contrôle à distance et automatiser des tâches de gestion d'appareils de type Smart Device.

Architecture type d'applications de connectivité Smart Device

Pour comprendre l'API de connectivité Smart Device, le mieux est d'exécuter une application bureautique type qui utilise l'API de connectivité Smart Device.

  1. Pour utiliser l'espace de noms Microsoft.SmartDevice.Connectivity, l'application bureautique ajoute une référence à lecteur:\Program Files\Common Files\Microsoft Shared\CoreCon\1.0\Bin\Microsoft.Smartdevice.Connectivity.dll.

  2. L'application crée un DatastoreManager et l'utilise pour énumérer une collection d'objets Platform. Chaque Platform représente une plateforme, telle que Windows Mobile 5.0 Pocket PC, qui est installée dans le magasin de données de l'ordinateur de bureau.

  3. L'application utilise un Platform pour énumérer une collection d'objets Device. Chaque Device représente l'un des appareils ou émulateurs, tels que Windows Mobile 5.0 Pocket PC Emulator, qui appartient à la plateforme.

  4. L'application utilise Device pour accéder aux informations relatives à l'appareil de type Smart Device, configurer l'appareil et s'y connecter.

  5. Après la connexion à l'appareil, l'application utilise FileDeployer pour déployer des fichiers sur l'appareil ou RemoteProcess pour démarrer ou arrêter des processus sur l'appareil.

  6. Si l'application doit effectuer des tâches personnalisées qui ne sont pas disponibles dans FileDeployer, RemoteProcess ou Device, elle peut créer un RemoteAgent pour déployer un agent Smart Device sur l'appareil et échanger des données avec lui. Un agent Smart Device est une application Smart Device que vous créez et qui utilise l'espace de noms Microsoft.SmartDevice.DeviceAgentTransport (pour les agents Smart Device Visual C# ou Visual Basic) ou la bibliothèque DeviceAgentTransport.dll (agents Smart Device Visual C++). Pour être déployé par un RemoteAgent, un agent Smart Device doit être enregistré dans le magasin de données de l'ordinateur de bureau en tant que package de composants additionnels. Pour plus d'informations, consultez Vue d'ensemble des packages de composants additionnels. L'application effectue les étapes suivantes pour déployer un agent Smart Device et communiquer avec lui :

    1. L'application bureautique appelle RemoteAgent.Start pour déployer et démarrer l'agent Smart Device.

    2. Une fois qu'il s'exécute sur l'appareil, l'agent Smart Device appelle IDeviceAgentTransport.AcknowledgeLaunch pour valider la connexion.

    3. L'agent Smart Device appelle IDeviceAgentTransport.AcceptConnectionEx pour accepter une demande de flux de données émise par l'ordinateur de bureau.

    4. L'application bureautique appelle RemoteAgent.CreatePacketStream pour obtenir un DevicePacketStream pour le transfert de données.

    5. À partir de là, l'application distante et l'agent Smart Device échangent des données en lisant et en écrivant des objets Packet ou IPacket dans leurs flux de données de paquets d'appareil respectifs.

    L'agent Smart Device a un accès par programme complet pour rassembler les informations et manipuler l'appareil car il s'exécute sur celui-ci.

    Remarque :

    L'agent Smart Device décrit précédemment dans cette rubrique utilise Microsoft.SmartDevice.DeviceAgentTransport et le .NET Compact Framework. Vous pouvez également créer des agents Smart Device non managés à l'aide de l'API de connectivité des appareils de type Smart Device côté appareil non managée.

Pour obtenir un guide pas à pas expliquant comment créer ce type d'application, consultez Procédure pas à pas : échange de données entre des applications Smart Device et des applications de bureau.

Fichiers et espaces de noms dans l'API de connectivité Smart Device

L'API de connectivité Smart Device comprend les éléments suivants :

Qu'est-ce que le magasin de données ?

Le magasin de données est un jeu de fichiers XML sur votre ordinateur de bureau qui contient des informations sur les plateformes, les appareils, les émulateurs et les packages installés sur l'ordinateur. Le magasin de données fait partie de la connectivité principale et est installé avec Microsoft Visual Studio ou Microsoft Platform Builder. Le contenu du magasin de données est modifié toutes les fois que vous installez un Kit de développement logiciel (SDK) basé sur Windows CE tel que Windows Mobile.

Le magasin de données se trouve dans lecteur:\Users\All Users\Microsoft\corecon\1.0 (Windows Vista) ou lecteur:\Documents and Settings\All Users\Application Data\Microsoft\corecon\1.0 (Windows XP).

Remarque :

Sauvegardez le magasin de données avant toute modification des fichiers dans le dossier du magasin de données. Les fichiers incorrects endommageront le magasin de données et Visual Studio ne fonctionnera pas.

Vous devez modifier uniquement le dossier addons dans le magasin de données. Pour plus d'informations, consultez Vue d'ensemble des packages de composants additionnels.

Voir aussi

Autres ressources

Exemples d'API de connectivité Smart Device