Informazioni di riferimento sulla riga di comando dell'emulatore di dispositivo
Aggiornamento: novembre 2007
Avviare l'emulatore di dispositivo dalla riga di comando utilizzando la sintassi indicata di seguito. L'uso di os_image_file_name è obbligatorio se non si utilizza l'opzione della riga di comando /s o @decfg_filename.
.gif "Nota") Nota: |
|---|
Alcuni kit SDK non supportano tutte le opzioni. Per ulteriori informazioni, vedere la documentazione del kit 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]
Parametri
Parametro |
Descrizione |
|---|---|
os_image_file_name |
Specifica il percorso e il nome file (*.bin o *.nb0) dell'immagine del kernel che deve essere utilizzata dall'emulatore. È possibile avviare l'emulatore di dispositivo da un'immagine del kernel, da un file di configurazione dell'emulatore di dispositivo o da un file dello stato salvato, utilizzando l'opzione della riga di comando /s. |
@decfg_filename |
Specifica il nome e il percorso del file di configurazione dell'emulatore di dispositivo (*.decfg) da utilizzare. È possibile avviare l'emulatore di dispositivo da un'immagine del kernel, da un file di configurazione dell'emulatore di dispositivo o da un file dello stato salvato, utilizzando l'opzione della riga di comando /s. |
Opzioni
Opzione |
Descrizione |
||||
|---|---|---|---|---|---|
/a |
Mantiene la finestra dell'emulatore sempre in primo piano, anche quando non ha lo stato attivo. |
||||
/battery |
Specifica l'alimentazione a batteria. Se l'opzione non è presente, l'impostazione predefinita è l'alimentazione di rete. |
||||
/batterycharge[n] |
Specifica lo stato di carica della batteria come n percentuale, compreso tra 0 e 100. Se l'opzione non è presente, il valore predefinito è 100%. |
||||
/c |
Crea e visualizza una finestra della console per visualizzare l'output della porta seriale di debug di Windows CE, dove vengono trasmessi i tasti premuti dall'utente. Questa tecnica è utile per controllare l'output del debug e scaricare immagini del kernel da Platform Builder. |
||||
/cpucore |
ARMv4 o ARMv5. L'impostazione predefinita è ARMv4. |
||||
/cpuoptions |
Combinazione di (T)humb, (D)ebug, (I)nternetworking, (M)Long Multiply, (e)DSP. Le opzioni T, D, I sono sempre impostate. |
||||
/defaultsave |
Utilizzare VMID come nome dello stato salvato e posizionare il file dello stato salvato nella directory per utente.
|
||||
/funckey[value] |
Opzione speciale che ha generalmente un valore di 193. Tale valore consente l'esecuzione del mapping dei tasti funzione della tastiera (F1, F2 e così via) ai tasti softkey di un emulatore di dispositivo. |
||||
/flash[flash_file_name] |
Attiva l'emulazione della memoria flash, dove il parametro facoltativo flash_file_name specifica il nome del file da utilizzare come archivio della memoria flash. |
||||
/h |
Imposta il routing solo su host per i pacchetti di rete. Interessa le schede CS8900 e NE2000. |
||||
/hostkeykeyname |
Specifica il tasto host, dove il parametro keyname, per cui non è rilevante la distinzione tra maiuscole e minuscole, può essere None, Left-Alt o Right-Alt. |
||||
/languageLangID |
Specifica la lingua dell'interfaccia utente, dove LangID è un numero decimale di quattro cifre. |
||||
/memsizesize |
Imposta le dimensioni della RAM emulate, dove size è espresso in MB. I valori validi sono da 64 a 256 inclusi. Se non viene specificato un valore valido, per impostazione predefinita per size viene utilizzato 64. |
||||
/n[macaddress] |
Attiva la scheda di rete CS8900, dove il parametro facoltativo macaddress è un numero decimale di dodici cifre che specifica a quale adattatore host verrà associato la scheda. |
||||
/nosecurityprompt |
Disattiva le richieste relative all'attivazione della connettività di rete, delle porte seriali e della condivisione delle cartelle quando il file contenente lo stato salvato utilizza queste funzionalità.
|
||||
/p[macaddress] |
Attiva la scheda di rete NE2000 PCMCIA, dove il parametro facoltativo macaddress è un numero decimale di dodici cifre che specifica a quale adattatore host verrà associato la scheda. |
||||
/rROM_address |
Specifica l'indirizzo di base del file della ROM, dove ROM_address può essere un valore esadecimale o decimale. |
||||
/rotateangle |
Ruota la visualizzazione in senso orario in base ai gradi specificati, dove angle può essere 0, 90, 180 o 270. È possibile specificare altri valori integer, che tuttavia verranno arrotondati per difetto al multiplo di 90 più prossimo. |
||||
/sfilename |
Attiva il supporto per lo stato salvato, dove filename è il nome del file contenente lo stato salvato.
Si noti il comportamento seguente dell'opzione /s:
|
||||
/sharedfolderdirectoryname |
Collega una directory come cartella condivisa, dove directoryname è una directory di Windows. La directory viene collegato come "\Storage File" guest, come se fosse una scheda di archiviazione. |
||||
/skinskin_file_name |
Carica il file di interfaccia specificato.
|
||||
/tooltipson|off |
Attiva o disattiva le descrizioni comandi, in cui state è ON o OFF. |
||||
/u0serialport |
Mappa la porta seriale guest 0 (emulatore COM1) a serialport di Windows. |
||||
/u1serialport |
Mappa la porta seriale guest 1 (emulatore output di debug) a serialport di Windows. |
||||
/u2serialport |
Mappa la porta seriale guest 2 (emulatore COM3) a serialport di Windows. |
||||
/vfptrue|false |
Specifica la presenza del coprocessore VFP (Vector Floating Point). L'impostazione predefinita è false. |
||||
/video<width>x<height>x<bit-depth> |
Specifica le dimensioni dello schermo e la profondità in bit della finestra LCD, dove width, height e bit-depth sono decimali. Esempio: 640x480x16.
|
||||
/vmid{GUID} |
Specifica il GUID VMID da associare all'istanza corrente dell'emulatore. Non viene comunemente passato negli scenari autonomi. Se non viene specificato alcun valore per {GUID}, per la sessione ne verrà creato uno automaticamente. |
||||
/vmnamename |
Specifica il titolo della finestra. Tenere presente quanto segue:
|
||||
/z |
Ingrandisce la visualizzazione (sia dell'interfaccia che della finestra LCD) di due volte rispetto alle dimensioni normali. |
||||
/speakerphone[n] |
Specifica la presenza di viva voce, cuffia auricolare e/o kit per auto. n è un numero bitmap compreso tra 0 e 7 che indica:
|
.gif "Nota sulla sicurezza")
Nota sulla sicurezza:Esempio
Nell'esempio riportato di seguito viene avviato l'emulatore di Windows Mobile 5.0 Pocket PC:
| Nota: |
|---|
L'immagine del sistema operativo dell'emulatore potrebbe trovarsi in una cartella diversa nel computer in uso. |
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
È quindi possibile scegliere Salva stato ed esci dal menu File e avviare nuovamente l'emulatore dal file dello stato salvato utilizzando il comando seguente:
DeviceEmulator.exe /s "d:\MyCustomEmulator.dess"
Nell'esempio riportato di seguito viene avviato l'emulatore di dispositivo da un file di configurazione dell'emulatore di dispositivo. Per ulteriori informazioni, vedere File di configurazione dell'emulatore di dispositivo.
DeviceEmulator.exe "@c:\My Emulator.decfg"