Controllo dei dispositivi mediante l'API di connettività per Smart Device

Aggiornamento: novembre 2007

Microsoft Visual Studio include le API di connettività Smart Device che consentono agli sviluppatori di trarre vantaggio da alcune funzioni di connettività principale nelle applicazioni. La connettività principale è un framework di comunicazioni utilizzato da prodotti quali Microsoft Visual Studio, Microsoft Visual Studio Remote Tools e Microsoft Platform Builder per distribuire file, avviare processi, aggiornare dispositivi ed eseguire il debug di applicazioni in dispositivi Smart Device.

In genere, l'API di connettività Smart Device viene utilizzata per scrivere applicazioni ad esempio Strumenti remoti per progetti per dispositivi. Il vantaggio è che gli sviluppatori si concentrano maggiormente sulla programmazione logica perché i dettagli sulla connessione e la gestione dei dispositivi sono esclusi. Le API di connettività Smart Device consentono le seguenti attività:

• Elenco di piattaforme e dispositivi disponibili.

• Definizione di una connessione tra un computer desktop locale e un dispositivo di destinazione.

• Distribuzione di applicazioni, package e file a un dispositivo di destinazione.

• Avvio, arresto ed enumerazione di processi in un dispositivo di destinazione.

• Scambio di dati tra il desktop e il dispositivo di destinazione.

Utilizzando le API di connettività Smart Device, è possibile scrivere strumenti remoti e automatizzare le attività di gestione dei dispositivi.

Architettura tipica delle applicazioni per la connettività Smart Device

Il modo migliore per comprendere l'API di connettività Smart Device è eseguire un'applicazione desktop tipica che la utilizza.

1. Per utilizzare lo spazio dei nomi Microsoft.SmartDevice.Connectivity l'applicazione desktop aggiunge un riferimento all'unità:\Programmi\File comuni\Microsoft Shared\CoreCon\1.0\Bin\Microsoft.Smartdevice.Connectivity.dll.

2. L'applicazione crea un DatastoreManager e lo utilizza per enumerare un insieme di oggetti Platform. Ogni Platform rappresenta una piattaforma, ad esempio Windows Mobile 5.0 Pocket PC, installata nell'Archivio dati del computer desktop.

3. L'applicazione utilizza una Platform per enumerare un insieme di oggetti Device. Ogni Device rappresenta uno dei dispositivi o emulatori, ad esempio un emulatore di Windows Mobile 5.0 Pocket PC che appartiene alla piattaforma.

4. L'applicazione utilizza Device per accedere a informazioni sul dispositivo, effettuare il provisioning del dispositivo e connettersi al dispositivo.

5. Dopo la connessione, l'applicazione utilizza FileDeployer per la distribuzione di file al dispositivo o RemoteProcess per avviare o arrestare i processi nel dispositivo.

6. Se l'applicazione deve eseguire attività personalizzate non disponibili in FileDeployer, RemoteProcess o Device, può creare un RemoteAgent per distribuire un agente di dispositivo al dispositivo e scambiare dati con esso. Un agente di dispositivo è un'applicazione per Smart Device creata dagli sviluppatori che utilizza lo spazio dei nomi Microsoft.SmartDevice.DeviceAgentTransport (per Visual C# o gli agenti di dispositivo di Visual Basic) o la libreria DeviceAgentTransport.dll (agenti di dispositivo di Visual C++). Per essere distribuito da un RemoteAgent, un agente di dispositivo deve essere registrato nell'Archivio dati del computer desktop come package aggiuntivo. Per ulteriori informazioni, vedere Cenni preliminari sui package aggiuntivi. L'applicazione esegue i passaggi seguenti per distribuire e comunicare con un agente di dispositivo:

   1. L'applicazione desktop chiama RemoteAgent.Start per distribuire e avviare l'agente di dispositivo.

   2. Una volta che l'agente di dispositivo è in esecuzione sul dispositivo, chiama IDeviceAgentTransport.AcknowledgeLaunch per confermare la connessione.

   3. L'agente di dispositivo chiama IDeviceAgentTransport.AcceptConnectionEx per accettare una richiesta del flusso di pacchetti dal desktop.

   4. L'applicazione desktop chiama RemoteAgent.CreatePacketStream per ottenere un DevicePacketStream per il trasferimento dei dati.

   5. Da tale posizione, l'applicazione remota e l'agente di dispositivo scambiano dati mediante la lettura e la scrittura di oggetti Packet o IPacket nei rispettivi flussi di pacchetti del dispositivo.

   L'agente di dispositivo ha accesso completo a livello di codice per raccogliere informazioni e gestire il dispositivo perché è in esecuzione nel dispositivo stesso.

   Nota:
   L'agente di dispositivo descritto più indietro in questo argomento utilizza Microsoft.SmartDevice.DeviceAgentTransport e .NET Compact Framework. In alternativa, è possibile creare agenti di dispositivo non gestiti utilizzando API di connettività per Smart Device non gestite sul dispositivo.

Per una guida dettagliata sulla procedura di creazione di questo tipo di applicazione, vedere Procedura dettagliata: scambio di dati tra applicazioni desktop e applicazioni per dispositivi.

File e spazi dei nomi nell'API di connettività Smart Device

L'API di connettività Smart Device consiste di:

• Spazio dei nomi Microsoft.SmartDevice.Connectivity da utilizzare nelle applicazioni desktop ((unità:\Programmi\File comuni\Microsoft Shared\CoreCon\1.0\Bin\Microsoft.Smartdevice.Connectivity.dll).

• Lo spazio dei nomi Microsoft.SmartDevice.DeviceAgentTransport per la creazione di applicazioni di agente di dispositivo di Visual C# o Visual Basic (unità:\Programmi\File comuni\Microsoft Shared\CoreCon\1.0\Target\Microsoft.Smartdevice.DeviceAgentTransport.dll).

• API di connettività per Smart Device non gestite sul dispositivo per la creazione di applicazioni di agente di dispositivo di Visual C++ (unità:\Programmi\File comuni\Microsoft Shared\CoreCon\1.0\Target\wce400\cpu\DeviceAgentTransport.dll)

Definizione di Archivio dati

Archivio dati è un insieme di file XML nel computer desktop contenente informazioni sulle piattaforme, sui dispositivi, sugli emulatori e sui package installati nel computer. L'archivio dati fa parte della connettività di base e viene installato con Microsoft Visual Studio o Microsoft Platform Builder. Il contenuto di Archivio dati viene modificato quando si installa un'applicazione SDK basata su Windows CE ad esempio Windows Mobile.

Archivio dati si trova in unità:\Users\All Users\Microsoft\corecon\1.0 (Windows Vista) o unità:\Documents e Settings\All Users\Dati Applicazioni\Microsoft\corecon\1.0 (Windows XP).

Nota:
Eseguire il backup dell'archivio dati prima di modificare qualsiasi file nella cartella di archivio dati. I file in formato non valido danneggiano l'archivio dati e comportano il mancato funzionamento di Visual Studio.

È necessario modificare solo la cartella addons nell'archivio dati. Per ulteriori informazioni, vedere Cenni preliminari sui package aggiuntivi.

Vedere anche

Altre risorse

Esempi di API di connettività Smart Device