Share via

Informazioni di riferimento sulla riga di comando dell'emulatore di dispositivo

  • Articolo

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.

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.

Nota:

Non è possibile specificare sia /defaultsave che /s.

/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à.

Nota sulla sicurezza:

Qualsiasi utilizzo della funzionalità di condivisione delle cartelle rappresenta un possibile rischio per la protezione. Evitare, ad esempio, di attivare la condivisione delle directory che contengono informazioni riservate o personali.

/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.

Nota sulla sicurezza:

L'utilizzo di file contenenti lo stato salvato provenienti da fonti non attendibili può rappresentare un rischio per la protezione.

Si noti il comportamento seguente dell'opzione /s:

  • Se viene specificato il nome di un file di immagine della ROM ma non viene specificato alcun oggetto /sfilename, l'emulatore viene avviato a freddo dall'immagine della ROM e il supporto dello stato salvato viene disattivato.

  • Se vengono specificati sia il nome di un file di immagine della ROM sia l'oggetto /sfilename, l'emulatore viene avviato a freddo dall'immagine della ROM e alla sua chiusura viene attivato il supporto dello stato salvato, che salva lo stato nel file specificato.

  • Se non viene specificata alcuna immagine della ROM, è necessario specificare un oggetto filename/s. L'emulatore utilizza il file dello stato salvato specificato. Alla chiusura dell'emulatore, il nuovo stato viene salvato nel file contenente lo stato salvato.

    Nota:

    Non è possibile specificare sia /defaultsave che /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.

Nota:

Non è possibile specificare sia /skin che /video.

/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.

Nota:

Non è possibile specificare sia /skin che /video.

/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:

  • Se non viene specificata alcuna opzione /vmid ma viene specificata l'opzione /skin, il titolo della finestra viene fornito dall'interfaccia.

  • Se non viene specificata né l'opzione /vmid né l'opzione /skin, il titolo della finestra sarà Emulatore di dispositivo.

/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:

  • 0 - nessun dispositivo presente

  • 1 - kit per auto

  • 2 - cuffia auricolare

  • 3 - cuffia auricolare, kit per auto

  • 4 - viva voce

  • 5 - viva voce, kit per auto

  • 6 - viva voce, cuffia auricolare

  • 7 - viva voce, cuffia auricolare, kit per auto

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"

Vedere anche

Altre risorse

Riferimenti all'emulatore di dispositivi