Referencia de la línea de comandos del emulador de dispositivos
Actualización: noviembre 2007
Inicie el emulador de dispositivos desde la línea de comandos con la siguiente sintaxis. El parámetro os_image_file_name es obligatorio a menos que use la opción de la línea de comandos /s o @decfg_filename.
.gif "Nota") Nota: |
|---|
Algunos SDK no admiten todas las opciones. Para obtener más información, consulte la documentación del SDK. |
DeviceEmulator os_image_file_name [/a] [/c] [/f [featurevalue]]
[/flash [flash_file_name]] [/h] [/hostkey keyname]
[/language LangID] [/memsize size] [/n [macaddress]]
[/nosecurityprompt] [/p [macaddress]] [/r ROM_address]
[/rotate angle] [/s save-state_file_name]
[/sharedfolder directoryname] [/skin skin_file_name] [/tooltips
state] [/u0 serialport] [/u1 serialport] [/u2 serialport]
[/video <width>x<height>x<bit depth>] [/vmid {GUID}]
[/vmname name] [/z]
Parámetros
Parámetro |
Descripción |
|---|---|
os_image_file_name |
Especifica la ruta de acceso y el nombre de archivo (*.bin o *.nb0) de la imagen del kernel que va a utilizar el emulador. Puede iniciar el emulador de dispositivos desde una imagen del kernel, un archivo de configuración del emulador de dispositivos o un archivo de estado guardado mediante la opción de la línea de comandos /s. |
@decfg_filename |
Especifica la ruta de acceso y el nombre del archivo de configuración (*.decfg) del emulador de dispositivos que se va a usar. Puede iniciar el emulador de dispositivos desde una imagen del kernel, un archivo de configuración del emulador de dispositivos o un archivo de estado guardado mediante la opción de la línea de comandos /s. |
Modificadores
Modificador |
Descripción |
|---|---|
/a |
Mantiene la ventana del emulador siempre visible, aunque no tenga el foco. |
/battery |
Especifica alimentación por batería. Si la opción no se especifica, el emulador usa la alimentación de corriente alterna como valor predeterminado. |
/batterycharge[n] |
Especifica la carga de la batería en forma de porcentaje n de 0-100. Si la opción no se especifica, se usa una carga del 100% como valor predeterminado. |
/c |
Crea y muestra una ventana de consola para mostrar la salida del puerto serie de depuración de Windows CE, donde se transmiten las pulsaciones de tecla del usuario. Esta técnica es útil para examinar los resultados de la depuración y descargar las imágenes del kernel de Platform Builder. |
/cpucore |
ARMv4 o ARMv5. El valor predeterminado es ARMv4. |
/cpuoptions |
Una combinación de (T)humb, (D)ebug, (I)nternetworking, (M)Long Multiply, (e)DSP. De éstos, T, D e I se establecerán siempre. |
/defaultsave |
Use VMID como nombre de estado guardado y coloque el archivo de estado guardado en el directorio de cada usuario. Nota:
No puede especificar /defaultsave y /s simultáneamente.
|
/funckey[value] |
Se trata de un modificador especial que normalmente tiene un valor de 193. El uso de este valor asigna las teclas de función (F1, F2, etc.) a las teclas programables de un emulador de dispositivos. |
/flash[flash_file_name] |
Habilita la emulación de memoria flash, donde el valor opcional flash_file_name especifica el nombre del archivo que se utilizará como almacenamiento de la memoria flash. |
/h |
Establece el enrutamiento sólo host para paquetes de red. Afecta a las tarjetas CS8900 y NE2000. |
/hostkeykeyname |
Especifica la tecla del host, donde el valor keyname, sin distinción entre mayúsculas y minúsculas, puede ser None, Left-Alt o Right-Alt. |
/languageLangID |
Especifica el idioma de la interfaz de usuario, donde el valor LangID es un decimal de cuatro dígitos. |
/memsizesize |
Establece el tamaño de la RAM emulada, donde el valor size se expresa en megabytes. Los valores válidos son del 64 al 256, ambos inclusive. Si no se especifica un valor válido, el valor predeterminado de size es 64. |
/n[macaddress] |
Habilita el adaptador de red CS8900, donde el valor opcional macaddress es un número hexadecimal de doce dígitos que especifica con qué adaptador de host se enlazará la tarjeta. |
/nosecurityprompt |
Deshabilita los indicadores para habilitar la conectividad de red, los puertos serie y el uso compartido de carpetas cuando el archivo de estado guardado utiliza estas características. .gif "Nota de seguridad") Nota de seguridad:
Cualquier uso de la característica de uso compartido de carpetas implica un riesgo potencial para la seguridad. Por ejemplo, no habilite el uso compartido de directorios que contengan información confidencial.
|
/p[macaddress] |
Habilita el adaptador de red NE2000 PCMCIA, donde el valor opcional macaddress es un número hexadecimal de doce dígitos que especifica con qué adaptador de host se enlazará la tarjeta. |
/rROM_address |
Especifica la dirección base del archivo de ROM, donde el valor ROM_address puede ser hexadecimal o decimal. |
/rotateangle |
Gira la presentación en el sentido de las agujas del reloj por grados, donde el valor angle puede ser 0, 90, 180 ó 270. Se permiten otros valores enteros, pero se redondean a la baja hasta el múltiplo de 90 más cercano. |
/sfilename |
Habilita la compatibilidad de estado guardado, donde el valor filename es el nombre del archivo de estado guardado. Nota de seguridad:
Los archivos de estado guardado procedentes de fuentes que no sean de confianza pueden suponer un riesgo para la seguridad.
Tenga en cuenta el comportamiento siguiente del modificador /s:
|
/sharedfolderdirectoryname |
Monta un directorio como carpeta compartida, donde el valor directoryname es un directorio de Windows. El directorio se monta como "\Archivo de almacenamiento" invitado, como si fuera una tarjeta de almacenamiento. |
/skinskin_file_name |
Carga el archivo de máscara especificado. Nota:
No puede especificar /skin y /video simultáneamente.
|
/tooltipson|off |
Habilita o deshabilita la información sobre herramientas, donde el valor state es ON u OFF. |
/u0serialport |
Asigna el puerto serie con calidad de invitado 0 (emulador COM1) a serialport de Windows |
/u1serialport |
Asigna el puerto serie con calidad de invitado 1 (resultados de depuración del emulador) a serialport de Windows |
/u2serialport |
Asigna el puerto serie con calidad de invitado 2 (emulador COM3) a serialport de Windows |
/vfptrue|false |
Especifica la presencia del coprocesador de punto flotante vectorial. El valor predeterminado es false. |
/video<width>x<height>x<bit-depth> |
Especifica el tamaño de pantalla y la profundidad de color de la ventana LCD, donde los valores width, height y bit-depth son decimales. Ejemplo: 640x480x16. Nota:
No puede especificar /skin y /video simultáneamente.
|
/vmid{GUID} |
Especifica el GUID de VMID que se asociará a la instancia actual del emulador. No se usa habitualmente para pasar escenarios independientes. Si no hay ningún {GUID} presente, se crea una automáticamente para la sesión. |
/vmnamename |
Especifica el título de la ventana. Tenga en cuenta el comportamiento siguiente:
|
/z |
Amplía la presentación (tanto la máscara como la ventana LCD) al doble del tamaño normal. |
/speakerphone[n] |
Especifica la presencia de altavoz, auriculares con micrófono y/o kit de automóvil. n es un número de mapa de bits entre 0-7, que significa:
|
Ejemplo
El ejemplo siguiente inicia el emulador de Windows Mobile 5.0 Pocket PC:
| Nota: |
|---|
La imagen del sistema operativo del emulador puede estar en una carpeta diferente en su equipo. |
DeviceEmulator.exe "c:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC
\Deviceemulation\0409\PPC_USA.BIN" /a /battery /batterycharge 40
/cpucore ARMv5 /memsize 256 /s "d:\MyCustomEmulator.dess" /skin
"c:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC\Deviceemulation\
Pocket_pc\Pocket_PC.xml" /tooltips ON /vfp false
/vmname "My Custom Emulator" /z /speakerphone 7
Puede elegir a continuación Guardar estado y Salir en el menú Archivo e iniciar de nuevo el emulador desde el archivo de estado guardado mediante el comando siguiente:
DeviceEmulator.exe /s "d:\MyCustomEmulator.dess"
El ejemplo siguiente inicia el emulador de dispositivos desde un archivo de configuración del emulador de dispositivos. Para obtener más información, vea Archivos de configuración del emulador de dispositivos.
DeviceEmulator.exe "@c:\My Emulator.decfg"