Mai 2003
Aktualisiert im August 2003
Mit den Windows CE-Dienstprogrammen für Visual Studio .NET 2003 können Entwickler Anwendungen mit verwaltetem Code für Windows CE-Plattformen weitergeben und debuggen.
Um die Windows CE-Dienstprogramme für Visual Studio .NET 2003 installieren zu können, muss auf dem Computer Visual Studio .NET 2003 installiert sein.
Weitere Informationen zur Weitergabe und zum Debuggen einer Anwendung mit den Windows CE-Dienstprogrammen für Visual Studio .NET 2003 finden Sie in den folgenden häufig gestellten Fragen.
Hinweis: Diese Dienstprogramme sind nur auf Englisch verfügbar. Die unten stehenden Informationen beschreiben die Verwendung der Dienstprogramme im Detail, wobei Verweise auf die Benutzeroberfläche auf Englisch gelassen wurden.
Was benötigt mein Gerät zum Debuggen mit Visual Studio?
Wie debugge ich meine Anwendung auf einem x86-basierten Gerät, auf dem Windows CE ausgeführt wird?
Wie gebe ich meine Anwendung bei über 50 auf dem Computer installierten Netzwerkprotokollen weiter?
Was benötigt mein Gerät zum Debuggen mit Visual Studio?
Wenn Sie auf dem Gerät Probleme beim Debuggen mit Visual Studio haben, stellen Sie sicher, dass die folgenden Elemente vorhanden sind.
· Ein Gerät mit ActiveSync- oder Ethernet-Verbindung
Visual Studio kann über eine der beiden Verbindungen eine Remoteverbindung mit dem Gerät herstellen.
· Die Datei WCELOAD auf dem Gerät
Diese Datei wird zur Installation von .NET Compact Framework und anderer untergeordneter Module auf dem Gerät benötigt. In Platform Builder ist es Teil der Komponente CAB File Installer/Uninstaller.
Hinweis Die Komponente CAB File Installer/Uninstaller befindet sich im Katalog in Core OS\Display Based Devices\Applications and Services Development\Applications–End User\.
· Die Datei Toolhelp.dll auf dem Gerät.
Dieses Modul wird vom Debugger verwendet und auf dem Gerät benötigt.
So kopieren Sie "Toolhelp.dll" auf das Gerät
1. Öffnen Sie den Ordner, der der CPU des Geräts entspricht, unter Programme\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\Toolhelp\WinCE410.
2. Kopieren Sie Toolhelp.dll in den Ordner \Windows auf dem Gerät.
Wie gebe ich meine Anwendung auf einem Gerät, auf dem Windows CE mit ActiveSync ausgeführt wird, weiter bzw. debugge sie?
Im Folgenden wird genau erläutert, wie eine Visual Studio .NET 2003-Entwicklungsumgebung zum Erstellen, Debuggen und Weitergeben einer Anwendung mit verwaltetem Code auf einem benutzerdefinierten Microsoft® Windows® CE .NET-Gerät eingerichtet wird, auf dem ActiveSync aktiviert ist.
Voraussetzungen
· Visual Studio .NET 2003
· Windows CE-Dienstprogramme für Visual Studio .NET 2003
· Windows CE .NET 4.1- oder Windows CE .NET 4.2-basiertes Gerät
· ActiveSync-Komponenten (Repllog.exe, Rapisrv.exe) auf dem Gerät*
· CAB File Installer/Uninstaller (WCELoad.exe) auf dem Gerät*
· ToolHelp.dll auf dem Gerät
· ActiveSync auf dem Desktop
Hinweis: ActiveSync 3.5 wird empfohlen, wenn Sie Windows CE .NET 4.1 verwenden.
· Serielle Verbindung über RS232/USB 115k
So verwenden Sie das Dienstprogramm "Select Windows CE Device CPU"
1. Öffnen Sie ein neues oder gespeichertes Smart Device-Projekt in Visual Studio .NET.
2. Importieren Sie für ein x86-Gerät die Datei WinCEx86Device.reg auf die Arbeitsstation, auf der VS .NET 2003 und die Windows CE-Dienstprogramme für Visual Studio .NET 2003 installiert sind.
3. Stellen Sie eine ActiveSync-Verbindung zwischen dem Gerät und dem Desktopcomputer her, indem Sie Repllog.exe auf dem Gerät ausführen.
4. Klicken Sie im Menü Tools auf Select Windows CE Device CPU.
5. Wählen Sie die CPU des Zielgeräts aus dem Dropdownfeld aus, und klicken Sie auf
Hinweis Wenn Sie
6. Klicken Sie auf Close.
7. Starten Sie Visual Studio neu, um diese neuen Einstellungen anzuwenden.
Sie können jetzt Anwendungen mit verwaltetem Code für Windows CE .NET-Plattformen mit Visual Studio .NET 2003 erstellen, debuggen und weitergeben.
Wie gebe ich meine Anwendung auf einem Gerät, auf dem Windows CE mit TCP/IP-Unterstützung ausgeführt wird, weiter bzw. debugge sie?
Im folgenden Vorgang wird genau erläutert, wie eine Visual Studio .NET 2003-Entwicklungsumgebung zum Erstellen, Debuggen und Weitergeben einer Anwendung mit verwaltetem Code auf dem benutzerdefinierten Microsoft® Windows® CE .NET-Gerät eingerichtet wird, auf dem ActiveSync nicht aktiviert ist.
Voraussetzungen
· Visual Studio .NET 2003
· Windows CE-Dienstprogramme für Visual Studio .NET 2003
· Windows CE .NET 4.1 oder Windows CE .NET 4.2
· LAN/WLAN-Netzwerkkomponenten auf dem Gerät*
· CAB File Installer/Uninstaller (WCELoad.exe) auf dem Gerät*
· ToolHelp.dll auf dem Gerät
· SDAuthUtilDevice.exe auf dem Gerät (in den Windows CE-Dienstprogrammen für Visual Studio .NET 2003 enthalten)
· Ethernet-Verbindung
So verwenden Sie das Dienstprogramm "Smart Device Authentication Utility"
1. Öffnen Sie ein neues oder gespeichertes Smart Device-Projekt in Visual Studio .NET.
2. Führen Sie das Dienstprogramm Smart Device Authentication Utility auf dem Gerät aus.
So führen Sie das Dienstprogramm "Smart Device Authentication Utility" auf dem Gerät aus
a. Öffnen Sie den Ordner, der der Windows CE-Version auf dem Gerät entspricht, unter Programme\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\Authentication Util.
b. Öffnen Sie den Ordner, der der CPU des Geräts entspricht.
c. Kopieren Sie die Datei SDAuthUtilDevice.exe auf das Gerät.
d. Führen Sie SDAuthUtilDevice.exe auf dem Gerät aus.
e. Klicken Sie auf Start.
Hinweis: Es entsteht eine Pause, während die Arbeitsstation, auf der Visual Studio .NET ausgeführt wird, eine Verbindung zum Gerät über eine TCP/IP-Verbindung herstellt.
3. Führen Sie das Dienstprogramm Smart Device Authentication Utility auf dem Computer aus, auf dem Visual Studio .NET ausgeführt wird.
So führen Sie das Dienstprogramm "Smart Device Authentication Utility" auf dem Computer aus
a. Klicken Sie im Menü Tools auf Smart Device Authentication Utility.
b. Geben Sie im Feld Device IP address die IP-Adresse des Geräts ein.
c. Klicken Sie auf Set Up Device.
4. Weisen Sie wie im Folgenden beschrieben Visual Studio die neue Einstellung zu.
So weisen Sie Visual Studio die Einstellungen zu
a. Klicken Sie im Menü Tools auf Options.
b. Klicken Sie auf Gerätetools und dann auf Geräte.
c. Klicken Sie im Feld Geräte für Plattform anzeigen auf das Gerät, mit dem eine Verbindung hergestellt werden soll.
d. Klicken Sie auf Speichern unter, geben Sie im Feld einen neuen Namen ein, und klicken Sie auf OK.
e. Klicken Sie im Feld Transport auf TCP-Transportverbindung.
f. Klicken Sie auf Konfigurieren.
g. Klicken Sie auf Spezielle IP-Adresse verwenden, und geben Sie die IP-Adresse des Geräts ein.
h. Klicken Sie auf OK.
Sie können jetzt Anwendungen mit verwaltetem Code für Windows CE .NET-Plattformen mit Visual Studio .NET 2003 erstellen, debuggen und weitergeben.
Wie debugge ich meine Anwendung auf einem x86-basierten Gerät, auf dem Windows CE ausgeführt wird?
Problem: Nach dem Ausführen des Add-Ins Windows CE Device Configuration kann der Benutzer ohne Debuggen Anwendungen auf ein x86-basiertes Gerät weitergeben, das Windows CE ausführt und über ActiveSync mit einem Desktopcomputer verbunden ist.
Lösung: Ändern Sie die Registrierung des Desktopcomputers, auf dem Visual Studio ausgeführt wird, um das Debuggen auf x86-basierten Geräten unter Windows CE zu ermöglichen. Dadurch wird das Debuggen im Windows CE-Emulator verhindert, bis die Registrierung wiederhergestellt ist.
So ermöglichen Sie das Debuggen auf x86-basierten Geräten unter Windows CE
· Importieren Sie WinCEx86Device.reg in die Registrierung des Desktopcomputers, auf dem Visual Studio ausgeführt wird.
Hinweis Die Datei WinCEx86Device.reg befindet sich im Verzeichnis Programme\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg.
So stellen Sie das Debuggen auf einem Windows CE-Emulator wieder her
1. Entfernen Sie den Registrierungsschlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows CE Services\ProxyPorts.
2. Importieren Sie ProxyPorts.reg in die Registrierung des Desktopcomputers, auf dem Visual Studio ausgeführt wird.
Hinweis Die Datei WinCEx86Device.reg befindet sich im Verzeichnis Programme\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg.
Ich habe ActiveSync deinstalliert und erneut installiert. Jetzt kann ich meine Anwendung nicht weitergeben. Wie behebe ich dieses Problem?
Problem: Nach der Deinstallation vonActiveSync, Version 3.5, 3.6, 3.7 oder 3.71, schlägt die Bereitstellung fehl mit der Fehlermeldung "Fehler bei der Weitergabe. Möchten Sie trotzdem fortfahren?" Dies ist in der Regel der Fall, wenn eine Version von ActiveSync deinstalliert und eine aktuellere Version installiert wird.
Lösung: Bei der Deinstallation von ActiveSync werden einige Registrierungseinstellungen entfernt, die für die Weitergabe erforderlich sind. Damit die Weitergabe möglich ist, müssen Sie diese Registrierungseinstellungen wiederherstellen.
So stellen Sie die Registrierungseinstellungen wieder her
1. Importieren Sie die Datei ProxyPorts.reg in die Registrierung.
Hinweis Die Datei ProxyPorts.reg befindet sich im Verzeichnis Programme\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg.
2. Nehmen Sie das Gerät aus der Halterung, und setzen Sie es erneut in die Halterung. Falls die Weitergabe immer noch nicht ausgeführt wird, führen Sie einen Warmstart des Geräts durch.
Ich habe ein Problem beim Debuggen auf einem Gerät mit Flash-Speicher. Wie behebe ich dieses Problem?
Problem: Auf manchen Geräten, auf denen Windows CE 4.1 ausgeführt wird und die mit bestimmten Arten von Flash-Speicher ausgerüstet sind, funktioniert die Weitergabe nicht.
Lösung: Manche Schlüssel werden teils im Dateisystem des Geräts und teils im Flash-Speicher gespeichert. Wenn das Gerät zurückgesetzt wird, wird die Hälfte des Schlüssels gelöscht und der Schlüssel wird als fehlerhaft erkannt. Führen Sie DelCryptoKeys.exe aus, um die beschädigten Schlüssel, die im Gerät gespeichert sind, zu löschen.
So führen Sie "DelCryptoKeys.exe" aus
1. Öffnen Sie den Ordner, der der CPU des Geräts entspricht, unter Programme\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelCryptoKey.
2. Kopieren Sie die Datei DelCryptoKeys.exe auf das Gerät.
3. Führen Sie DelCryptoKeys.exe aus.
DelCryptoKey.exe kann in folgenden Modi ausgeführt werden.
|
Verwendung |
Ausgabe |
|
DelCryptoKeys |
Es erfolgt keine Ausgabe. |
|
DelCryptoKeys /out:UI |
Ergebnisse werden in einem Meldungsfeld angezeigt. |
|
DelCryptoKeys /out:Dateiname |
Ergebnisse werden in der Datei Dateiname gespeichert. |
Falls es beim Ausführen des Tools zu Problemen kommt, werden folgende Fehlercodes zurückgegeben.
|
Fehlercode |
Bedeutung |
|
2 |
Der Schlüssel wurde nicht gefunden. Möglicherweise wurde er bereits gelöscht, oder es gab nie ein Problem. |
|
5 |
Die Weitergabe wurde bereits durchgeführt. Starten Sie das Gerät neu, und versuchen Sie es erneut. |
Wie gebe ich meine Anwendung bei über 50 auf dem Computer installierten Netzwerkprotokollen weiter?
Problem: Von einem Computer, auf dem mehr als 50 Netzwerkprotokolle ausgeführt werden, können keine Anwendungen auf ein Gerät weitergegeben werden. Beim Versuch, Anwendungen weiterzugeben, erscheint die Fehlermeldung "Fehler bei der Weitergabe. Möchten Sie trotzdem fortfahren?"
Lösung: Sie können entweder nicht benötigte Netzwerkprotokolle oder Anwendungen deinstallieren, mit denen Protokolle installiert sind.
So deinstallieren Sie Netzwerkprotokolle
1. Klicken Sie auf Start und dann auf Systemsteuerung.
2. Doppelklicken Sie auf Verwaltung und dann auf Computerverwaltung.
3. Klicken Sie unter System auf Geräte-Manager.
4. Erweitern Sie im rechten Bereich Netzwerkadapter.
5. Deinstallieren Sie nicht benötigte Netzwerkadapter.
So deinstallieren Sie Anwendungen mit installierten Netzwerkprotokollen
1. Führen Sie EnumProtocols.exe aus, um festzustellen, mit welchen Anwendungen Protokolle installiert sind.
Hinweis Die Datei EnumProtocols.exe befindet sich im Verzeichnis Programme\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\EnumProtocols.
2. Deinstallieren Sie die Anwendungen, die Sie nicht benötigen.
Bei der Weitergabe bzw. beim Debuggen erhalte ich einen Geräteverbindungsfehler, andere an demselben Computer angemeldete Benutzer können jedoch mit Visual Studio .NET eine Verbindung mit dem Gerät herstellen. Wie behebe ich dieses Problem?
Problem: Bei derWeitergabe auf einen Pocket PC oder ein Windows CE-Gerät, das über ActiveSync verbunden ist, erscheint die Fehlermeldung "Keine Verbindung mit dem Gerät möglich. Stellen Sie sicher, dass das Gerät angeschlossen ist und ordnungsgemäß funktioniert." Andere an demselben Computer angemeldete Benutzer können möglicherweise Anwendungen mit eben diesem Gerät weitergeben und debuggen. ActiveSync funktioniert wie vorgesehen, und die Datei \Windows\ConManClient.exe wird nicht auf das Gerät kopiert, wenn Sie versuchen, eine Anwendung weiterzugeben oder zu debuggen.
Lösung: Diese Sympome weisen auf einen möglicherweise beschädigten Container für Sicherheitsschlüssel hin. Führen Sie auf dem Computer, auf dem Visual Studio .NET ausgeführt wird, die Datei DelDesktopCryptKey.exe an der Eingabeaufforderung aus, um den Container für Sicherheitsschlüssel für den aktuellen Benutzer zu bereinigen.
Hinweis Die Datei DelDesktopCryptKey.exe befindet sich im Verzeichnis Programme\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelDesktopCryptKey.
Ich erhalte beim Öffnen einer SDK-Emulation eine Fehlermeldung über eine fehlende Designdatei. Wie behebe ich dieses Problem?
Problem: Wenn Sie eine Emulation mit einem mit Platform Builder erstellten SDK installieren, wird beim Starten der Emulation in Visual Studio .NET 2003 möglicherweise die folgende Fehlermeldung angezeigt:
Die angegebene XML-Designdatei konnte nicht geöffnet werden. Stellen Sie sicher, dass der angegebene Dateiname oder Pfad gültig ist.
Lösung: Sie können den Fehler entweder manuell beheben oder das Dienstprogramm DelEmuSkin ausführen, um eine neue Windows Installer-Datei (.msi) für das SDK zu erstellen.
So beheben Sie den Fehler manuell
1. Öffnen Sie die Registrierung, und suchen Sie den Registrierungsschlüssel HKEY_LOCAL_MACHINE\Software\Microsoft\Windows CE Tools\Managed Platforms.
Der Registrierungsschlüssel Managed Platforms sollte mindestens einen Unterschlüssel enthalten, die mit GUIDs gekennzeichnet sind. Jeder Unterschlüssel repräsentiert eine eigene mit einem SDK installierte Emulation und sollte Werte für PlatformName, Skins usw. aufweisen. Suchen Sie die Emulationen, die den Designfehler verursachen. Der Registrierungseintrag für Skins sollte für diese Emulationen einem Ordnernamen entsprechen. Legen Sie als Registrierungswert für Skins den vollständigen Pfad zur XML-Datei für das Design fest.
2. Löschen Sie die Datei sdkRollerDevice-<GUID> für jede Emulation, die einen Fehler verursacht. <GUID> entspricht hierbei der GUID für diese Emulation.
Hinweis Die Datei sdkRollerDevice-<GUID> befindet sich im Verzeichnis Documents and Settings\All Users\Application Data\Microsoft\VisualStudio\devices\addons.
Sie können nun Visual Studio .NET 2003 starten und die Emulationen verwenden.
Das Dienstprogramm DelEmuSkin entfernt alle Designs aus den Emulationen. Dies erscheint möglicherweise auf den ersten Blick als Nachteil, ermöglicht jedoch die einfache und sichere Behebung des Designdateifehlers, da keine manuellen Registrierungsänderungen oder Dateilöschungen erforderlich sind. Außerdem wird mit dem Dienstprogramm DelEmuSkin eine neue MSI-Datei erzeugt, die an andere zur SDK-Installation verteilt werden kann.
So verwenden Sie das Dienstprogramm "DelEmuSkin"
1. Führen Sie DelEmuSkin.exe aus.
Syntax
|
DelEmuSkin AlterDateiname NeuerDateiname |
|
Parameter |
Beschreibung |
|
AlterDateiname |
Die ursprüngliche MSI-Datei für das SDK. |
|
NeuerDateiname |
Der Name, mit dem die neue MSI-Datei gespeichert werden soll. |
Hinweis Die Datei DelEmuSkin.exe befindet sich im Verzeichnis \Programme\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelEmuSkin\.
2. Falls das SDK bereits installiert ist, entfernen Sie es über die Option Software in der Systemsteuerung.
3. Starten Sie Visual Studio .NET 2003, und öffnen Sie ein Smart Device-Projekt. Überprüfen Sie, dass die mit dem SDK installierten Emulationen nicht mehr in der Geräteliste aufgeführt werden.
4. Installieren Sie das SDK mit der von DelEmuSkin erzeugten MSI-Datei.
Sie können nun Visual Studio .NET 2003 starten und die Emulationen verwenden.