Maggio 2003
Aggiornato nel mese di agosto 2003
Il componente aggiuntivo Windows CE Utilities for Visual Studio .NET 2003 consente agli sviluppatori di eseguire la distribuzione e il debug di applicazioni in codice gestito per le piattaforme Windows CE.
Per installare Windows CE Utilities for Visual Studio .NET 2003, è necessario che Visual Studio .NET 2003 sia installato nel computer.
Per informazioni dettagliate sulla distribuzione e il debug di applicazioni tramite Windows CE Utilities for Visual Studio .NET 2003, vedere le domande frequenti riportate di seguito.
Nota: queste utilità sono disponibili solo in lingua inglese. Nelle seguenti informazioni dettagliate relative all'impiego di tali utilità, tutti i riferimenti all'interfaccia utente sono pertanto in lingua inglese.
Quali sono i requisiti necessari per i dispositivi per l'esecuzione del debug con Visual Studio?
Come è possibile risolvere i problemi di debug su un dispositivo con memoria flash?
Quali sono i requisiti necessari per i dispositivi per
l'esecuzione del debug con Visual Studio?
In caso di problemi durante il debug sul dispositivo con Visual Studio, assicurarsi che siano soddisfatti i seguenti requisiti.
· Dispositivo con ActiveSync o connessione Ethernet
La connessione remota di Visual Studio può essere effettuata sia con ActiveSync sia tramite connessione Ethernet.
· File WCELOAD installato nel dispositivo.
Tale file è necessario per l'installazione di .NET Compact Framework e di altri moduli dipendenti sul dispositivo. In Platform Builder è incluso nel componente CAB File Installer/Uninstaller.
Nota Il componente CAB File
Installer/Uninstaller si trova nel catalogo in Core
OS\Display Based Devices\Applications and Services Development\Applications–End
User\.
· File Toolhelp.dll installato nel dispositivo.
Tale modulo viene utilizzato dal debugger e deve essere presente nel dispositivo.
Per copiare Toolhelp.dll nel dispositivo
1. Aprire la cartella corrispondente alla CPU del dispositivo in Programmi\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\Toolhelp\WinCE410.
2. Copiare Toolhelp.dll nella cartella \Windows del dispositivo.
Come si eseguono la distribuzione e il debug di
un'applicazione su un dispositivo che esegue Windows CE con ActiveSync?
Nella procedura che segue viene descritto come configurare un ambiente di sviluppo Visual Studio .NET 2003 per la creazione, il debug e la distribuzione di un'applicazione in codice gestito in un dispositivo Microsoft® Windows® CE .NET personalizzato con supporto di ActiveSync.
Requisiti
· Visual Studio .NET 2003
· Windows CE Utilities for Visual Studio .NET 2003
· Dispositivo con Windows CE .NET 4.1 o Windows CE .NET 4.2
· Componenti ActiveSync (Repllog.exe, Rapisrv.exe) installati nel dispositivo*
· CAB File Installer/Uninstaller (WCELoad.exe) installato nel dispositivo*
· ToolHelp.dll installato nel dispositivo
· ActiveSync installato nel computer desktop
Nota: ActiveSync 3.5 è consigliato per i computer con Windows CE .NET 4.1.
· Connessione seriale RS232/USB 115k
Per utilizzare l'utilità Select Windows CE Device CPU
1. Aprire un progetto per dispositivi Smart Device nuovo o già esistente in Visual Studio .NET.
2. Per un dispositivo con processore x86, importare il file WinCEx86Device.reg nella workstation in cui sono installati Visual Studio .NET 2003 e Windows CE Utilities for Visual Studio .NET 2003.
3. Stabilire una connessione ActiveSync tra il dispositivo e il computer desktop eseguendo Repllog.exe sul dispositivo.
4. Scegliere Select Windows CE Device CPU dal menu Strumenti.
5. Dalla casella di riepilogo a discesa selezionare la CPU del dispositivo di destinazione, quindi fare clic su Configure.
Nota Se si seleziona ARMV4I, lo strumento effettuerà la conversione automatica a ARMV4T perché Visual Studio .NET 2003 considera i dispositivi ARMV4I come ARMV4T.
6. Fare clic su Close.
7. Riavviare Visual Studio per applicare le nuove impostazioni.
È ora possibile creare, eseguire il debug e distribuire applicazioni in codice gestito per piattaforme Windows CE .NET con Visual Studio .NET 2003.
Come si eseguono la distribuzione e il debug di
un'applicazione su un dispositivo che esegue Windows CE con il supporto TCP/IP?
Nella procedura che segue viene descritto come configurare un ambiente di sviluppo Visual Studio .NET 2003 per la creazione, il debug e la distribuzione di un'applicazione in codice gestito in un dispositivo Microsoft® Windows® CE .NET personalizzato senza supporto di ActiveSync.
Requisiti
· Visual Studio .NET 2003
· Windows CE Utilities for Visual Studio .NET 2003
· Windows CE .NET 4.1 o Windows CE .NET 4.2
· Componenti di rete LAN/WLAN installati nel dispositivo*
· CAB File Installer/Uninstaller (WCELoad.exe) installato nel dispositivo*
· Toolhelp.dll installato nel dispositivo
· SDAuthUtilDevice.exe installato nel dispositivo, incluso in Windows CE Utilities for Visual Studio .NET 2003
· Connessione Ethernet
Per utilizzare Smart Device Authentication Utility
1. Aprire un progetto per dispositivi Smart Device nuovo o già esistente in Visual Studio .NET.
2. Eseguire Smart Device Authentication Utility sul dispositivo.
Per eseguire Smart Device Authentication Utility sul dispositivo
a. Aprire la cartella corrispondente alla versione di Windows CE sul dispositivo in Programmi\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\Authentication Util.
b. Aprire la cartella corrispondente alla CPU del dispositivo.
c. Copiare il file SDAuthUtilDevice.exe nel dispositivo.
d. Eseguire SDAuthUtilDevice.exe nel dispositivo.
e. Fare clic sul pulsante Start.
Nota: sarà necessario attendere che la workstation con Visual Studio .NET si connetta al dispositivo tramite una connessione TCP/IP.
3. Eseguire Smart Device Authentication Utility nel computer in cui è installato Visual Studio .NET.
Per eseguire Smart Device Authentication Utility nel computer
a. Scegliere Smart Device Authentication Utility dal menu Strumenti.
b. Nella casella Device IP address immettere l'indirizzo IP del dispositivo.
c. Fare clic su Set Up Device.
4. Applicare la nuova impostazione a Visual Studio attenendosi alla procedura che segue.
Per applicare le impostazioni a Visual Studio
a. Scegliere Opzioni dal menu Strumenti.
b. Selezionare Strumenti dispositivo, quindi Dispositivi.
c. Nella casella Mostra dispositivi per la piattaforma selezionare il dispositivo a cui si desidera connettersi.
d. Fare clic su Salva con nome, digitare un nuovo nome nella casella, quindi scegliere OK.
e. Nella casella Trasporto selezionare Trasporto di connessione TCP.
f. Fare clic su Configura.
g. Selezionare Usa indirizzo IP specifico e immettere l'indirizzo IP del dispositivo.
h. Scegliere OK.
È ora possibile creare, eseguire il debug e distribuire applicazioni in
codice gestito per piattaforme Windows CE .NET con Visual Studio
.NET 2003.
Problema: dopo l'esecuzione di Windows CE Device Configuration Add-In, l'utente può eseguire la distribuzione senza effettuare il debug su un dispositivo con processore x86 in cui è installato Windows CE connesso al computer
desktop tramite ActiveSync.
Soluzione: modificare il Registro di sistema del computer desktop che esegue Visual Studio in modo da consentire il debug su dispositivi con processore x86 che eseguono Windows CE. Il debug nell'emulatore di Windows CE verrà disattivato finché le impostazioni del Registro di sistema non verranno ripristinate.
Per attivare il debug su dispositivi con processore x86 che eseguono Windows CE
·
Nel computer
desktop che esegue Visual Studio importare WinCEx86Device.reg nel Registro di
sistema.
Nota WinCEx86Device.reg è memorizzato, in base all'impostazione predefinita, in Programmi\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg.
Per ripristinare il debug nell'emulatore di Windows CE
1.
Rimuovere la chiave del Registro di sistema HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
CE Services\ProxyPorts.
2.
Nel computer desktop in cui è installato Visual Studio importare
ProxyPorts.reg nel Registro di sistema.
Nota ProxyPorts.reg
è memorizzato, in base all'impostazione predefinita, in Programmi\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE
Utilities\WinCE Proxy Ports Reg.
Dopo la disinstallazione e la
reinstallazione di ActiveSync, non è più possibile distribuire l'applicazione.
Come è possibile risolvere il problema?
Problema: Dopo la disinstallazione di ActiveSync versione 3.5, 3.6, 3.7 o 3.71, durante la
distribuzione viene visualizzato il messaggio di errore "Errori di distribuzione. Continuare?”.
Questo problema si verifica in genere quando si disinstalla una versione di ActiveSync e se ne installa una più
recente.
Soluzione: con la disinstallazione di queste versioni di ActiveSync vengono rimosse alcune impostazioni del Registro di sistema necessarie per la distribuzione. Tali impostazioni dovranno essere ripristinate per consentire la distribuzione.
Per ripristinare le impostazioni del Registro di sistema
1.
Importare ProxyPorts.reg nel Registro di sistema.
Note ProxyPorts.reg è memorizzato, in base all'impostazione predefinita, in Programmi\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg.
2.
Rimuovere il dispositivo dall'alloggiamento e
sostituirlo. Se la distribuzione risulta ancora impossibile, eseguire un
riavvio software del dispositivo.
Come è possibile risolvere i problemi di debug su un dispositivo con memoria flash?
Problema: non è
possibile eseguire la distribuzione con alcuni dispositivi in cui sono installati
Windows CE 4.1 e determinati tipi di memoria flash.
Soluzione: alcune chiavi sono memorizzate in parte nel file system del dispositivo e in parte
nella memoria flash. Quando il dispositivo viene riavviato, la parte della
chiave memorizzata nel dispositivo viene eliminata e la chiave viene pertanto
considerata danneggiata. Eseguire DelCryptoKey.exe per eliminare le chiavi
danneggiate memorizzate nel dispositivo.
Per eseguire DelCryptoKeys.exe
1. Aprire la cartella corrispondente alla CPU del dispositivo in Programmi\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelCryptoKey.
2. Copiare DelCryptoKeys.exe nel dispositivo.
3. Eseguire DelCryptoKeys.exe.
DelCryptoKeys.exe
può essere eseguito nelle seguenti modalità.
|
Utilizzo |
Output |
|
DelCryptoKeys |
Esecuzione senza output. |
|
DelCryptoKeys /out:UI |
Risultati visualizzati in una finestra di messaggio. |
|
DelCryptoKeys /out:nomefile |
Risultati salvati nel file nomefile. |
In caso di problemi nell'esecuzione dello strumento, vengono restituiti i seguenti codici di errore.
|
Codice di errore |
Significato |
|
2 |
Chiave non trovata. Potrebbe essere già stata eliminata oppure non ha mai costituito un problema. |
|
5 |
Distribuzione già eseguita. Riavviare il dispositivo e riprovare. |
Problema: un computer
in cui sono installati oltre 50 protocolli di rete non è in grado di eseguire
la distribuzione in un dispositivo. Se si tenta di effettuare tale operazione,
viene visualizzato il messaggio di errore “Errori di distribuzione. Continuare?”.
Soluzione: è possibile disinstallare i protocolli di rete non necessari oppure disinstallare le applicazioni in cui sono installati dei protocolli.
Per disinstallare i protocolli di rete
1. Fare clic sul pulsante Start, quindi scegliere Pannello di controllo.
2. Fare doppio clic su Strumenti di amministrazione, quindi su Gestione computer.
3. In Utilità di sistema selezionare Gestione periferiche.
4. Nel riquadro destro espandere Schede di rete.
5. Disinstallare le schede di rete non utilizzate.
Per disinstallare le applicazioni con protocolli installati
1. Eseguire EnumProtocols.exe per individuare le applicazioni in cui sono installati protocolli.
Note EnumProtocols.exe è memorizzato, in base all'impostazione predefinita, in Programmi\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\EnumProtocols.
2. Disinstallare le applicazioni non necessarie.
Come è possibile risolvere il problema nel caso in cui si verifichi un errore di connessione al dispositivo durante la distribuzione e il debug, mentre altri utenti connessi allo stesso computer sono comunque in grado di connettersi allo stesso dispositivo mediante Visual Studio .NET?
Problema: la distribuzione
in un Pocket PC o in un dispositivo Windows CE connesso tramite ActiveSync non viene effettuata
e viene visualizzato il messaggio di errore che indica che è impossibile stabilire una connessione con il dispositivo e di assicurarsi che tale dispositivo sia connesso e che funzioni correttamente. Altri utenti connessi
allo stesso computer possono essere in grado di effettuare la distribuzione e il debug mediante lo stesso dispositivo, ActiveSync funziona correttamente e il file \Windows\ConManClient.exe non viene copiato nel dispositivo
durante il tentativo di distribuzione o debug.
Soluzione: questi sintomi indicano un contenitore di chiavi di protezione probabilmente danneggiato. Nel computer in cui è installato Visual Studio .NET eseguire DelDesktopCryptKey.exe dal prompt dei comandi per eliminare quanto incluso nel contenitore di chiavi di protezione per l'utente corrente.
Note DelDesktopCryptKey.exe è memorizzato, in base all'impostazione predefinita, in Programmi\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelDesktopCryptKey.
Si è verificato un errore relativo a un file di interfaccia mancante durante l'apertura di un emulatore SDK. Come è possibile risolvere il problema?
Problema: se si installa un emulatore con un SDK incorporato da Platform Builder, l'avvio dell'emulatore da Visual Studio .NET 2003 potrebbe portare alla visualizzazione di un messaggio analogo al seguente:
Impossibile aprire il file di interfaccia XML specificato. Verificare che il nome o il percorso del file siano validi.
Soluzione:
è possibile correggere l'errore manualmente o eseguire l'utilità DelEmuSkin per creare un nuovo file
Windows Installer (.msi) per l'SDK.
Per correggere manualmente l'errore
1.
Aprire il Registro di sistema
e individuare la chiave di registro HKEY_LOCAL_MACHINE\Software\Microsoft\Windows
CE Tools\Managed Platforms.
La chiave di registro Managed Platforms deve contenere una o più
sottochiavi identificate con i GUID. Ciascuna sottochiave
rappresenta un emulatore diverso installato da un SDK e deve includere valori per
PlatformName, Skins
e così via. Individuare gli emulatori che causano l'errore relativo all'interfaccia. Il valore Skins del Registro di sistema per tali emulatori deve essere il nome
di una cartella. Impostare il valore di registro relativo a Skins sul
percorso completo del file XML di interfaccia.
2. Eliminare il file sdkRollerDevice-<GUID> per ogni emulatore che causa
un errore, in cui <GUID> corrisponde al GUID per tale
emulatore.
Nota Il file
sdkRollerDevice-<GUID>
si trova, in base all'impostazione predefinita, in Documents and Settings\All Users\Dati
applicazioni\Microsoft\VisualStudio\devices\addons.
Sarà quindi possibile avviare Visual Studio .NET 2003 e utilizzare gli
emulatori.
L'utilizzo di DelEmuSkin consente di rimuovere l'interfaccia dagli emulatori. Nonostante tale fattore possa sembrare uno svantaggio, l'utilità in realtà semplifica e rende più sicura la correzione dei file di interfaccia eliminando la necessità di apportare manualmente le modifiche al Registro di sistema o di eliminare i file. L'utilità DelEmuSkin inoltre genera un nuovo file .msi che può essere distribuito ad altri utenti per l'installazione di SDK.
Per utilizzare DelEmuSkin
1.
Eseguire DelEmuSkin.exe.
Sintassi
|
DelEmuSkin Nomefileprecedente Nomefilenuovo |
|
Parametro |
Descrizione |
|
Nomefileprecedente |
Il file .msi originale per l'SDK. |
|
Nomefilenuovo |
Il nome del nuovo file .msi. |
Note DelEmuSkin.exe
è memorizzato, in base all'impostazione predefinita, in \Programmi\Microsoft Visual Studio .NET
2003\CompactFrameworkSDK\WinCE Utilities\DelEmuSkin\.
2. Se
l'SDK è installato, rimuoverlo mediante l'opzione Installazione applicazioni del Pannello di controllo.
3. Avviare
Visual Studio .NET 2003 e aprire un progetto relativo al dispositivo. Controllare che gli
emulatori installati nell'SDK non siano più presenti nell'elenco di dispositivi.
4. Installare
l'SDK con il file .msi generato da DelEmuSkin.
Sarà quindi possibile avviare Visual Studio .NET 2003 e utilizzare gli
emulatori.