Mayo de 2003
Actualizado en agosto de 2003
El complemento Windows CE Utilities for Visual Studio .NET 2003 permite a los desarrolladores implementar y depurar aplicaciones de código administrado para plataformas Windows CE.
Para instalar el complemento Windows CE Utilities for Visual Studio .NET 2003, Visual Studio .NET 2003 debe estar instalado en el equipo.
Para obtener información detallada acerca de la implementación y depuración de aplicaciones mediante el complemento Windows CE Utilities for Visual Studio .NET 2003, consulte las preguntas más frecuentes que aparecen a continuación.
Nota: estas utilidades sólo están disponibles en inglés. La siguiente información describe el uso de las utilidades en las que todas las referencias a la interfaz de usuario están en inglés.
¿Qué necesita mi dispositivo para realizar operaciones de depuración con Visual Studio?
¿Cómo puedo depurar mi aplicación en un dispositivo basado en x86 en el que se ejecuta Windows CE?
¿Cómo puedo implementar mi aplicación con más de 50 protocolos de red instalados en el equipo?
¿Qué necesita mi dispositivo para realizar operaciones de depuración con Visual Studio?
Si tiene problemas con las operaciones de depuración ejecutadas en el dispositivo con Visual Studio, asegúrese de que tiene los siguientes componentes:
· Un dispositivo con ActiveSync o una conexión Ethernet.
Visual Studio puede utilizar cualquiera de las características anteriores para conectarse remotamente con el dispositivo.
· El archivo WCELOAD en el dispositivo.
Este archivo es necesario para instalar .NET Compact Framework y otros módulos dependientes en el dispositivo. En Platform Builder forma parte del componente CAB File Installer/Uninstaller.
Nota El componente CAB File Installer/Uninstaller se encuentra en el catálogo en la carpeta Core OS\Display Based Devices\Applications and Services Development\Applications–End User\.
· El archivo Toolhelp.dll en el dispositivo.
Este módulo lo utiliza el depurador y es necesario en el dispositivo.
Para copiar Toolhelp.dll en el dispositivo
1. Abra la carpeta correspondiente a la CPU del dispositivo que se encuentra en Archivos de programa\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\Toolhelp\WinCE410.
2. Copie el archivo Toolhelp.dll en la carpeta \Windows del dispositivo.
¿Cómo puedo implementar y depurar mi aplicación en un dispositivo en el que se ejecuta Windows CE con ActiveSync?
El siguiente procedimiento describe el modo de configurar el entorno de desarrollo de Visual Studio .NET 2003 para crear, depurar e implementar una aplicación de código administrado en un dispositivo Microsoft® Windows® CE .NET personal que cuenta con ActiveSync.
Requisitos
· Visual Studio .NET 2003
· Windows CE Utilities for Visual Studio .NET 2003
· Dispositivo basado en Windows CE .NET 4.1 o Windows CE .NET 4.2
· Componentes ActiveSync (Repllog.exe, Rapisrv.exe) instalados en el dispositivo*
· Componente CAB File Installer/Uninstaller (WCELoad.exe) instalado en el dispositivo*
· Archivo ToolHelp.dll instalado en el dispositivo
· ActiveSync instalado en el equipo de escritorio
Nota: se recomienda ActiveSync 3.5 si utiliza Windows CE .NET 4.1.
· Conexión serie RS232 o USB de 115 K
Para trabajar con la utilidad Select Windows CE Device CPU
1. Abra un proyecto nuevo o guardado Smart Device en Visual Studio .NET.
2. Para un dispositivo x86, importe el archivo WinCEx86Device.reg en la estación de trabajo en la que instaló VS .NET 2003 y el complemento Windows CE Utilities for Visual Studio .NET 2003.
3. Ejecute el archivo Repllog.exe en el dispositivo para establecer una conexión ActiveSync entre dicho dispositivo y el equipo de escritorio.
4. En el menú Herramientas, haga clic en Select Windows CE Device CPU.
5. En el cuadro desplegable, seleccione la CPU del dispositivo de destino y haga clic en Configure.
Nota Si selecciona ARMV4I, la herramienta lo convertirá automáticamente en ARMV4T, ya que Visual Studio .NET 2003 trata los dispositivos ARMV4I como ARMV4T.
6. Haga clic en Close.
7. Reinicie Visual Studio para aplicar la nueva configuración.
Ahora puede crear, depurar e implementar aplicaciones de código administrado para plataformas Windows CE .NET mediante Visual Studio .NET 2003.
¿Cómo puedo implementar y depurar mi aplicación en un dispositivo en el que se ejecuta Windows CE con compatibilidad TCP/IP?
El siguiente procedimiento describe el modo de configurar el entorno de desarrollo de Visual Studio .NET 2003 para crear, depurar e implementar una aplicación de código administrado en un dispositivo Microsoft® Windows® CE .NET personal que no cuenta con ActiveSync.
Requisitos
· Visual Studio .NET 2003
· Windows CE Utilities for Visual Studio .NET 2003
· Windows CE .NET 4.1 o Windows CE .NET 4.2
· Componentes para interconexión LAN o WLAN instalados en el dispositivo*
· Componente CAB File Installer/Uninstaller (WCELoad.exe) instalado en el dispositivo*
· Archivo Toolhelp.dll instalado en el dispositivo
· Archivo SDAuthUtilDevice.exe instalado en el dispositivo (se incluye en el complemento Windows CE Utilities for Visual Studio .NET 2003)
· Conexión Ethernet
Para trabajar con Smart Device Authentication Utility
1. Abra un proyecto nuevo o guardado Smart Device en Visual Studio .NET.
2. Ejecute Smart Device Authentication Utility en el dispositivo.
Para ejecutar Smart Device Authentication Utility en el dispositivo
a. Abra la carpeta correspondiente a la versión de Windows CE del dispositivo que se encuentra en Archivos de programa\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\Authentication Util.
b. Abra la carpeta correspondiente a la CPU del dispositivo.
c. Copie el archivo SDAuthUtilDevice.exe en el dispositivo.
d. Ejecute el archivo SDAuthUtilDevice.exe en el dispositivo.
e. Haga clic en Start.
Nota: se producirá una pausa mientras la estación de trabajo que ejecuta Visual Studio .NET se conecta al dispositivo a través de una conexión TCP/IP.
3. Ejecute Smart Device Authentication Utility en el equipo en el que está instalado Visual Studio .NET.
Para ejecutar Smart Device Authentication Utility en el equipo
a. En el menú Herramientas, haga clic en Smart Device Authentication Utility.
b. En el cuadro Device IP address, escriba la dirección IP del dispositivo.
c. Haga clic en Set Up Device.
4. Aplique la nueva configuración a Visual Studio tal y como se describe en el siguiente procedimiento.
Para aplicar la configuración a Visual Studio
a. En el menú Herramientas, haga clic en Opciones.
b. Haga clic en Herramientas de dispositivo y, a continuación, en Dispositivos.
c. En el cuadro Mostrar dispositivos para la plataforma, haga clic en el dispositivo al que desea conectarse.
d. Haga clic en Guardar como, escriba un nombre nuevo en el cuadro correspondiente y, por último, haga clic en Aceptar.
e. En el cuadro Transporte, haga clic en Transporte de conexión de TCP.
f. Haga clic en Configurar.
g. Haga clic en Usar una dirección IP específica y escriba la dirección IP del dispositivo.
h. Haga clic en Aceptar.
Ahora puede crear, depurar e implementar aplicaciones de código administrado para plataformas Windows CE .NET mediante Visual Studio .NET 2003.
¿Cómo puedo depurar mi aplicación en un dispositivo basado en x86 en el que se ejecuta Windows CE?
Problema: después de ejecutar el complemento Windows CE Device Configuration, el usuario puede realizar implementaciones sin depurar en un dispositivo basado en x86 en el que está instalado Windows CE y que está conectado al equipo de escritorio a través de ActiveSync.
Solución: modifique el Registro en el equipo de escritorio en el que está instalado Visual Studio para permitir la depuración en dispositivos basados en x86 en los que está instalado Windows CE. De esta forma se deshabilitará la depuración en el emulador de Windows CE hasta que se restaure el Registro.
Para permitir la depuración en dispositivos basados en x86 en los que se ejecuta Windows CE
· En el equipo de escritorio en el que está instalado Visual Studio, importe WinCEx86Device.reg al Registro.
Nota: el archivo WinCEx86Device.reg se encuentra de forma predeterminada en la carpeta Archivos de programa\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg.
Para restaurar la depuración en el emulador de Windows CE
1. Quite la clave del Registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows CE Services\ProxyPorts..
2. En el equipo de escritorio en el que está instalado Visual Studio, importe ProxyPorts.reg al Registro.
Nota: el archivo ProxyPorts.reg se encuentra de forma predeterminada en la carpeta Archivos de programa\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg.
Desinstalé ActiveSync y lo volví a instalar. Ahora no puedo implementar mi aplicación. ¿Cómo puedo solucionar este problema?
Problema: Después de desinstalar ActiveSync versión 3.5, 3.6, 3.7 o 3.71, al realizar operaciones de implementación, aparece el mensaje de error "Hay errores de implementación. ¿Desea continuar?” Este error normalmente aparece cuando se desinstala una versión de ActiveSync y se instala otra versión más actual.
Solución: la desinstalación de ActiveSync quita cierta configuración del Registro que es necesaria para realizar operaciones de implementación. Debe restaurar dicha configuración para habilitar la implementación.
Para restaurar la configuración del Registro
1. Importe ProxyPorts.reg. al Registro.
Nota: el archivo ProxyPorts.reg se encuentra de forma predeterminada en la carpeta Archivos de programa\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\WinCE Proxy Ports Reg.
2. Retire el dispositivo de la base y vuelva a colocarlo. Si la implementación sigue sin funcionar, reinicie el dispositivo.
Tengo problemas al realizar operaciones de depuración en un dispositivo con memoria flash. ¿Cómo puedo solucionar este problema?
Problema: la operación de implementación no funciona en algunos dispositivos con Windows CE 4.1 equipados con ciertos tipos de memoria flash.
Solución: algunas claves se almacenan parcialmente en el sistema de archivos del dispositivo y en la memoria flash. Al reiniciar el dispositivo, la mitad de la clave se borra y se interpreta como dañada. Ejecute el archivo DelCryptoKeys.exe para eliminar las claves dañadas almacenadas en el dispositivo.
Para ejecutar el archivo DelCryptoKeys.exe
1. Abra la carpeta correspondiente a la CPU del dispositivo que se encuentra en Archivos de programa\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelCryptoKey.
2. Copie DelCryptoKeys.exe en el dispositivo.
3. Ejecute DelCryptoKeys.exe.
El archivo DelCryptoKeys.exe se puede ejecutar de las formas siguientes.
|
Uso |
Resultado |
|
DelCryptoKeys |
Se ejecuta sin generar resultado alguno. |
|
DelCryptoKeys /out:UI |
Muestra el resultado en un cuadro de mensaje. |
|
DelCryptoKeys /out:nombre_de_archivo |
Guarda el resultado en el archivo nombre_de_archivo. |
Si hay algún contratiempo al ejecutar la herramienta, se devuelven los siguientes códigos de error:
|
Código de error |
Significado |
|
2 |
No se encontró la clave. Ya se puede haber eliminado o nunca fue un problema. |
|
5 |
Implementación realizada. Reinicie el dispositivo inténtelo de nuevo. |
¿Cómo puedo implementar mi aplicación con más de 50 protocolos de red instalados en el equipo?
Problema: un equipo en el que se ejecutan más de 50 protocolos de red no se puede implementar en un dispositivo. Al realizar operaciones de implementación, aparece el mensaje de error “Hay errores de implementación. ¿Desea continuar?”.
Solución: puede quitar los protocolos de red que no necesite o desinstalar aquellas aplicaciones que tienen protocolos instalados.
Para quitar protocolos de red
1. Haga clic en Inicio y, a continuación, en Panel de control.
2. Haga doble clic en Herramientas administrativas y, a continuación, en Administración de equipos.
3. En Herramientas del sistema, haga clic en Administrador de dispositivos.
4. En el panel ubicado a la derecha, expanda Adaptadores de red.
5. Quite aquellos adaptadores de red que no utilice.
Para desinstalar aplicaciones con protocolos instalados
1. Ejecute el archivo EnumProtocols.exe para ver las aplicaciones que tienen productos instalados.
Nota: el archivo EnumProtocols.exe se encuentra de forma predeterminada en la carpeta Archivos de programa\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\EnumProtocols.
2. Desinstale las aplicaciones que no necesite.
Al implementar o depurar, recibo un error de conexión del dispositivo y, sin embargo, otros usuarios que han iniciado una sesión en el mismo equipo pueden conectarse al mismo dispositivo con Visual Studio .NET. ¿Cómo puedo solucionar este problema?
Problema: Las operaciones de implementación en un dispositivo Pocket PC o Windows CE conectado con ActiveSync generan el mensaje de error “No se ha podido establecer una conexión con el dispositivo. Asegúrese de que el dispositivo está conectado y funciona correctamente”. Otros usuarios que han iniciado sesión en el mismo equipo pueden realizar operaciones de implementación y depuración utilizando el mismo dispositivo, ActiveSync funciona correctamente y el archivo \Windows\ConManClient.exe no se copia en el dispositivo al intentar realizar la implementación o depuración.
Solución: Estos síntomas indican que puede haber un contenedor de claves de seguridad dañado. En el equipo en el que está instalado Visual Studio .NET, ejecute DelDesktopCryptKey.exe desde el símbolo del sistema para borrar el contenedor de claves de seguridad del usuario actual.
Nota: el archivo DelDesktopCryptKey.exe se encuentra de forma predeterminada en la carpeta Archivos de programa\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelDesktopCryptKey.
Al abrir un emulador de SDK, recibo el error de que falta un archivo de máscara. ¿Cómo puedo solucionar este problema?
Problema: Si instala un emulador con un SDK creado por Platform Builder, al iniciar el emulador desde Visual Studio .NET 2003 puede aparecer un mensaje similar al siguiente:
El archivo de máscara XML especificado no se puede abrir. Compruebe que el nombre de archivo o la ruta de acceso especificados son válidos.
Solución: Puede corregir el error manualmente o ejecutar la utilidad DelEmuSkin para crear un nuevo archivo Windows Installer (.msi) para el SDK.
Para corregir el error manualmente
1. Abra el Registro y busque la clave del Registro HKEY_LOCAL_MACHINE\Software\Microsoft\Windows CE Tools\Managed Platforms.
La clave del Registro Managed Platforms debe contener una o varias subclaves identificadas mediante GUID. Cada subclave representa un emulador distinto instalado por un SDK y debe contener valores para PlatformName, Skins, etc. Busque los emuladores que producen el error de máscara. El valor Skins del Registro para esos emuladores debe ser un nombre de carpeta. Establezca el valor de Skins del Registro en la ruta de acceso completa del archivo XML de máscara.
2. Elimine el archivo sdkRollerDevice-<GUID> para aquellos emuladores que producen un error, donde <GUID> equivale al GUID del emulador.
Nota El archivo sdkRollerDevice-<GUID> se encuentra de forma predeterminada en la carpeta Documents and Settings\All Users\Application Data\Microsoft\VisualStudio\devices\addons.
Ahora puede iniciar Visual Studio .NET 2003 y utilizar los emuladores.
La utilidad DelEmuSkin quita todas las máscaras de los emuladores. Aunque pueda parecer un inconveniente, esta utilidad permite corregir de forma más sencilla y segura el error del archivo de máscara, sin tener que realizar cambios manuales en el Registro o eliminar archivos. Además, la utilidad DelEmuSkin genera un nuevo archivo .msi que se puede distribuir a otros usuarios para la instalación de SDK.
Para usar la utilidad DelEmuSkin
1. Ejecute DelEmuSkin.exe.
Sintaxis
|
DelEmuSkin NombreArchivoAntiguo NombreArchivoNuevo |
|
Parámetro |
Descripción |
|
NombreArchivoAntiguo |
El archivo .msi original del SDK. |
|
NombreArchivoNuevo |
El nombre con el que se va a guardar el archivo .msi nuevo. |
Nota: el archivo DelEmuSkin.exe se encuentra de forma predeterminada en la carpeta Archivos de programa\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\WinCE Utilities\DelEmuSkin\.
2. Si está instalado el SDK, quítelo mediante la opción Añadir o quitar programas del Panel de control.
3. Inicie Visual Studio .NET 2003 y abra un proyecto Smart Device. Confirme que los emuladores instalados por el SDK ya no figuran en la lista de dispositivos.
4. Instale el SDK con el archivo .msi generado por DelEmuSkin.
Ahora puede iniciar Visual Studio .NET 2003 y utilizar los emuladores.