用于 Visual Studio .NET 2003 的 Windows CE 实用工具的自述文件 v1.1

 

2003 年 5 月
2003 年 8 月更新

 

用于 Visual Studio .NET 2003 的 Windows CE 实用工具使开发人员能够部署和调试 Windows CE 平台的托管代码应用程序。

若要安装用于 Visual Studio .NET 2003 的 Windows CE 实用工具，计算机上必须装有 Visual Studio .NET 2003。

有关使用用于 Visual Studio .NET 2003 的 Windows CE 实用工具部署和调试应用程序的详细信息，请参见下面的常见问题解答。

注意：这些实用工具只有英文版。下面详细介绍如何使用这些实用工具，讲解中引用的用户界面均保留为英文。

使用 Visual Studio 进行调试对设备有什么要求？

如何在运行 Windows CE 且具有 ActiveSync 的设备上部署和调试应用程序？

如何在运行 Windows CE 且支持 TCP/IP 的设备上部署和调试应用程序？

如何在运行 Windows CE 的基于 x86 的设备上调试应用程序？

我卸载了 ActiveSync 然后又重新安装了它。现在我无法部署应用程序了。如何才能解决此问题？

我在具有快速内存的设备上进行调试时遇到了问题。如何才能解决此问题？

如何在装有 50 多个网络协议的计算机上部署应用程序？

我在部署或调试时 发现设备连接出现错误，但同一台计算机上其他的登录用户可以通过 Visual Studio .NET 与同一设备连接。 如何解决此问题？

在打开 SDK 模拟器时 出现缺少 skin 文件错误。如何解决此问题？

使用 Visual Studio 进行调试对设备有什么要求？

如果您在设备上使用 Visual Studio 进行调试时遇到了问题，请确保您的系统满足以下各项要求。

·         具有 ActiveSync 或以太网连接的设备

Visual Studio 可使用以上两种连接之一远程连接到设备。

·         设备上有文件 WCELOAD。

必须有此文件，才能在设备上安装 .NET Compact Framework 和其他从属模块。 在 Platform Builder 上，此文件是 CAB 文件安装程序/卸载程序组件的一部分。

注意   CAB 文件安装程序/卸载程序组件位于以下目录中：Core OS\Display Based Devices\Applications and Services Development\Applications–End User\。

·         设备上有文件 Toolhelp.dll。

此模块供调试器使用，它是设备上所必需的。

将 Toolhelp.dll 复制到设备上

1.     打开 Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\Toolhelp\WinCE410 中与您设备的 CPU 对应的文件夹。

2.     将 Toolhelp.dll 复制到设备的 \Windows 文件夹中。

返回页首

如何在运行 Windows CE 且具有 ActiveSync 的设备上部署和调试应用程序？

下面的过程详细介绍如何设置 Visual Studio .NET 2003 开发环境，才能在启用 ActiveSync 的自定义 Microsoft® Windows® CE .NET 设备上创建、调试和部署托管代码应用程序。

要求

·         Visual Studio .NET 2003

·         用于 Visual Studio .NET 2003 的 Windows CE 实用工具

·         基于 Windows CE .NET 4.1 或 Windows CE .NET 4.2 的设备

·         设备上装有 ActiveSync 组件（Repllog.exe、Rapisrv.exe）*

·         设备上装有 CAB 文件安装程序/卸载程序 (WCELoad.exe)*

·         设备上装有 ToolHelp.dll

·         桌面计算机上装有 ActiveSync

注意：   如果您使用的是 Windows CE .NET 4.1，则建议安装 ActiveSync 3.5。

·         RS232/USB 115k 串行连接

*如果您是独立软件开发商 (ISV)，没有这些组件，请与您的原始设备制造商 (OEM) 联系。Microsoft 无权分发这些组件。

使用 Select Windows CE Device CPU（选择 Windows CE 设备 CPU）实用工具

1.      在 Visual Studio .NET 中打开一个新的或以前保存的“智能设备”项目。

2.      对于 x86 设备，在安装了 VS .NET 2003 并安装了 Visual Studio .NET 2003 的 Windows CE 实用工具的工作站上，导入文件 WinCEx86Device.reg。

3.      通过运行设备上的 Repllog.exe，在设备和桌面计算机之间建立 ActiveSync 连接。

4.      在“Tools”（工具）菜单上，单击“Select Windows CE Device CPU”（选择 Windows CE 设备 CPU）。

5.      从下拉框中选择目标设备的 CPU，然后单击“Configure”（配置）。

注意   如果选择 ARMV4I，该工具会自动将其转换为 ARMV4T，原因是 Visual Studio .NET 2003 将 ARMV4I 设备视为 ARMV4T。

6.      单击“Close”（关闭）。

7.      重新启动 Visual Studio 以应用新设置。

现在您就可以使用 Visual Studio .NET 2003 创建、调试和部署适用于 Windows CE .NET 平台的托管代码应用程序了。

返回页首

如何在运行 Windows CE 且支持 TCP/IP 的设备上部署和调试应用程序？

下面的过程详细介绍如何设置 Visual Studio .NET 2003 开发环境，才能在未启用 ActiveSync 的自定义 Microsoft® Windows® CE .NET 设备上创建、调试和部署托管代码应用程序。

要求

·         Visual Studio .NET 2003

·         用于 Visual Studio .NET 2003 的 Windows CE 实用工具

·         Windows CE .NET 4.1 或 Windows CE .NET 4.2

·         设备上有 LAN/WLAN 联网组件*

·         设备上有 CAB 文件安装程序/卸载程序 (WCELoad.exe)*

·         设备上有 Toolhelp.dll

·         设备上有 SDAuthUtilDevice.exe，它包含在用于 Visual Studio .NET 2003 的 Windows CE 实用工具中

·         以太网连接

*如果您是独立软件开发商 (ISV)，没有这些组件，请与您的原始设备制造商 (OEM) 联系。Microsoft 无权分发这些组件。

使用 Smart Device Authentication Utility（智能设备身份验证实用工具）

1.      在 Visual Studio .NET 中打开一个新的或以前保存的“智能设备”项目。

2.      在设备上运行 Smart Device Authentication Utility（智能设备身份验证实用工具）。

在设备上运行 Smart Device Authentication Utility（智能设备身份验证实用工具）

a.      打开 Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\Authentication Util 中与您设备上的 Windows CE 版本对应的文件夹。

b.      打开与您设备的 CPU 对应的文件夹。

c.      将文件 SDAuthUtilDevice.exe 复制到您的设备上。

d.      在设备上运行 SDAuthUtilDevice.exe。

e.      单击“Start”（开始）。

注意：   当运行 Visual Studio .NET 的工作站通过 TCP/IP 连接与设备相连时，会有一段停顿时间。

3.      在运行 Visual Studio .NET 的计算机上运行 Smart Device Authentication Utility（智能设备身份验证实用工具）。

在计算机上运行 Smart Device Authentication Utility（智能设备身份验证实用工具）

a.      在“Tools”（工具）菜单上，单击“Smart Device Authentication Utility”（智能设备身份验证实用工具）。

b.      在“Device IP address”（设备 IP 地址）框中，输入设备的 IP 地址。

c.      单击“Set Up Device”（设置设备）。

4.      按照下面介绍的过程将新设置应用到 Visual Studio。

将设置应用于 Visual Studio

a.      在“Tools”（工具）菜单中，单击“Options”（选项）。

b.      单击“Device Tools”（设备工具），然后单击“Devices”（设备）。

c.      在“Show devices for platform”（显示用于以下平台的设备）框中，单击要连接到的设备。

d.      单击“Save As”（另存为），在框中键入新名称，然后单击“OK”（确定）。

e.      在“Transport”（传输）框中，单击“TCP Connect Transport”（TCP 连接传输）。

f.       单击“Configure”（配置）。

g.      单击“Use specific IP address”（使用特定 IP 地址），然后输入设备的 IP 地址。

h.      单击“OK”（确定）。

现在您就可以使用 Visual Studio .NET 2003 创建、调试和部署适用于 Windows CE .NET 平台的托管代码应用程序了。

返回页首

如何在运行 Windows CE 的基于 x86 的设备上调试应用程序？

问题：在运行 Windows CE 设备配置外接程序后，用户在运行 Windows CE 的基于 x86 的设备（通过 ActiveSync 连接到桌面计算机）上可以部署应用程序，但不能进行调试。

解决方案：修改运行 Visual Studio 的桌面计算机上的注册表，以允许在运行 Windows CE 的基于 x86 的设备上进行调试。这将禁止在 Windows CE 模拟器上进行调试，直到还原注册表设置后才允许执行此操作。

在运行 Windows CE 的基于 x86 的设备上启用调试

·         在运行 Visual Studio 的桌面计算机上，将 WinCEx86Device.reg 导入注册表中。

注意   WinCEx86Device.reg 的默认位置为 Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg 中。

在 Windows CE 模拟器上恢复调试

1.      删除注册表项 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows CE Services\ProxyPorts。

2.      在运行 Visual Studio 的桌面计算机上，将 ProxyPorts.reg 导入注册表中。

注意   ProxyPorts.reg 的默认位置为 Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg 中。

返回页首

我卸载了 ActiveSync 然后又重新安装了它。现在我无法部署应用程序了。如何才能解决此问题？

问题：卸载 ActiveSync 版本 3.5、3.6、3.7 或 3.71后部署失败，出现错误信息：“出现部署错误。是否继续？”此错误通常发生在卸载某种版本的 ActiveSync 后又安装了较新版本的 ActiveSync 的情况下。

解决方案：卸载 ActiveSync 的这些版本将移除部署过程所需要的某些注册表设置。您必须还原这些注册表设置，然后才能进行部署。

还原注册表设置

1.      将 ProxyPorts.reg 导入注册表中。

注意   ProxyPorts.reg 的默认位置为 Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg 中。

2.      从支架中取下设备，然后再将其重新放回支架中。如果仍然不能部署，请软重启该设备。

返回页首

我在具有快速内存的设备上进行调试时遇到了问题。如何才能解决此问题？

问题：在运行 Windows CE 4.1 的某些设备上，如果配备有特定类型的快速内存，则不能部署应用程序。

解决方案：某些注册表项的一部分存储在设备文件系统中，一部分存储在快速内存中。当重置设备时，会将项的一半删除，因而该项将被认为已损坏。应运行 DelCryptoKeys.exe 来删除设备上存储的所有已损坏的项。

运行 DelCryptoKeys.exe

1.      打开 Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelCryptoKey 中与您设备的 CPU 对应的文件夹。

2.      将 DelCryptoKeys.exe 复制到设备中。

3.      运行 DelCryptoKeys.exe。

可以用以下模式运行 DelCryptoKeys.exe。

 

用法

输出

DelCryptoKeys

运行但不产生输出。

DelCryptoKeys /out:UI

在消息框中显示结果。

DelCryptoKeys /out:filename

将结果保存到文件 filename 中。

 

如果在运行此工具时出现问题，将返回以下错误代码。

 

错误代码

含义

2

未找到该项。可能是该项已删除，也可能不是问题。

5

已执行了部署过程。请重新启动设备并重试。

 

返回页首

如何在装有 50 多个网络协议的计算机上部署应用程序？

问题：运行 50 多个网络协议的计算机不能部署到设备。如尝试进行部署，将导致出现以下错误信息：“出现部署错误。是否继续？”

解决方案：或者移除不需要的任何网络协议，或者卸载一些安装了协议的应用程序。

移除网络协议

1.      单击“开始”，然后单击“控制面板”。

2.      双击“管理工具”，然后双击“计算机管理”。

3.      在“系统工具”下，单击“设备管理器”。

4.      在右侧窗格中，展开“网络适配器”。

5.      移除任何不再使用的网络适配器。

卸载安装了协议的应用程序

1.      运行 EnumProtocols.exe，查看都有哪些应用程序安装了协议。

注意   EnumProtocols.exe 的默认位置为 Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\EnumProtocols 中。

2.      卸载任何不需要的应用程序。

返回页首

我在部署或调试时 发现设备连接出现错误，但同一台计算机上其他的登录用户可以通过 Visual Studio .NET 与同一设备连接。 如何解决此问题？

问题：部署到 与 ActiveSync 连接的 Pocket PC 或 Windows CE 设备时失败，出现错误信息：“无法建立与该设备的连接。 请确保该设备已连接好并运行正常。”同一台计算机上其他的登录用户可能可以使用同一设备进行部署和调试、ActiveSync 运行正常， 且在尝试部署或调试时，文件 \Windows\ConManClient.exe 未复制到设备中。

解决方案：这些现象 表明，安全密钥容器可能已损坏。在运行 Visual Studio .NET 的计算机上，从命令提示符处运行 DelDesktopCryptKey.exe，为当前用户清理安全密钥容器。

注意   DelDesktopCryptKey.exe 的默认位置为 Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelDesktopCryptKey。

返回页首

在打开 SDK 模拟器时 出现缺少 skin 文件错误。如何解决此问题？

问题： 如果是用由 Platform Builder 生成的 SDK 安装的模拟器，并且是从 Visual Studio .NET 2003 启动的模拟器， 则可能出现以下信息：

无法打开指定的 XML Skin 文件。请验证指定的文件名或路径是有效的。

解决方案： 您可以手动更正此错误，也可以运行 DelEmuSkin 实用工具，为 SDK 创建新的 Windows 安装引导程序 (.msi) 文件。

若要手动更正此错误

1.      打开注册表并找到 注册表项 HKEY_LOCAL_MACHINE\Software\Microsoft\Windows CE Tools\Managed Platforms。

Managed Platforms 注册表项应包含 一个或多个用 GUID 标识的子项。每个子项代表一个由 SDK 安装的不同的模拟器，并且应该有 PlatformName 和 Skins 的值等。 找到产生 skin 错误的模拟器，这些模拟器在注册表中的 Skins 值应该是文件夹名称。 将 Skins 的注册表值设置为 skin 的 XML 文件的完整路径。

2.       对于 每一个产生错误的模拟器，请删除文件 sdkRollerDevice-<GUID>，其中 <GUID> 对应该模拟器的 GUID。

注意    sdkRollerDevice-<GUID> 文件的默认位置为 Documents and Settings\All Users\Application Data\Microsoft\VisualStudio\devices\addons。

现在即可启动 Visual Studio .NET 2003 并使用模拟器。

使用 DelEmuSkin 实用工具从模拟器中移除所有 skin。虽然此实用工具可能还有缺点，但它 确实可以更方便和安全地更正 skin 文件错误，省去了手动更改注册表或删除文件的麻烦。此外，DelEmuSkin 实用工具 会生成一个新的 .msi 文件，可以将其分发给其他用户以用于 SDK 的安装。

若要使用 DelEmuSkin 实用工具

1.       运行 DelEmuSkin.exe。

语法

DelEmuSkin OldFileName NewFileName

 

参数

说明

OldFileName

SDK 的原 .msi 文件。

NewFileName

新 .msi 文件的另存为名称。

 

注意   DelEmuSkin.exe 的默认位置为 \Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelEmuSkin\。

2.       如果 已安装 SDK，请通过“控制面板”中的“添加/删除程序”选项将其移除。

3.       启动 Visual Studio .NET 2003 并打开智能设备项目。确认由 SDK 安装的模拟器不再出现在设备列表中。

4.       用由 DelEmuSkin 生成的 .msi 文件安装 SDK。

现在即可启动 Visual Studio .NET 2003 并使用模拟器。

返回页首