Справочник по командной строке эмулятора устройства
Обновлен: Ноябрь 2007
Эмулятор устройства можно запустить из командной строки, используя следующий синтаксис: Параметр os_image_file_name является обязательным, если не используется параметр командной строки /s или @decfg_filename.
.gif "Примечание") Примечание. |
|---|
В некоторых пакетах SDK поддерживаются не все параметры. Дополнительные сведения см. в документации по используемому пакету 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]
Параметры
Параметр |
Описание |
|---|---|
os_image_file_name |
Указывает путь и имя файла (BIN или NB0), используемого эмулятором образа ядра. Можно запустить эмулятор устройства из образа ядра, из файла конфигурации эмулятора устройства или из файла сохраненного состояния с помощью параметра командной строки /s. |
@decfg_filename |
Указывает путь и имя используемого файла конфигурации (DECFG) эмулятора устройства. Можно запустить эмулятор устройства из образа ядра, из файла конфигурации эмулятора устройства или из файла сохраненного состояния с помощью параметра командной строки /s. |
Переключатели
Переключатель |
Описание |
|---|---|
/a |
Поддерживает положение окна эмулятора поверх других окон, даже если это окно не имеет фокуса. |
/battery |
Указывает, работает ли устройство от батареи. Если этот параметр отсутствует, эмулятор считается работающим по умолчанию от сети |
/batterycharge[n] |
Выражает уровень заряда батареи в процентном соотношении n от 0 до 100. Если этот параметр отсутствует, уровень заряда батареи считается равным 100%. |
/c |
Создает и показывает окно консоли для отображения выходных данных с последовательного порта отладки Windows CE, в который передаются нажатия клавиш пользователем. Это полезно для отслеживания выходных данных отладки и загрузки образов ядра из Platform Builder. |
/cpucore |
ARMv4 или ARMv5. По умолчанию: ARMv4. |
/cpuoptions |
Комбинация (T)humb, (D)ebug, (I)nternetworking, (M)Long Multiply, (e)DSP. Из них T, D и I всегда будут заданы. |
/defaultsave |
Используйте VMID в качестве имени сохраненного состояния и поместите файл сохраненного состояния в каталог пользователя. Примечание.
Нельзя указать одновременно /defaultsave и /s.
|
/funckey[value] |
Как правило, этот специальный переключатель имеет значение 193. Использование этого значения приведет к сопоставлению функциональных клавиш на клавиатуре (F1, F2 и т. д.) с программируемыми клавишами эмулятора устройства. |
/flash[flash_file_name] |
Включает эмуляцию флэш-памяти, где дополнительный параметр flash_file_name обозначает имя файла, который будет использоваться в качестве места хранения флэш-памяти. |
/h |
Задает маршрутизацию сетевых пакетов только в пределах самого узла. Влияет на обе сетевые карты: CS8900 и NE2000. |
/hostkeykeyname |
Указывает управляющую клавишу, не зависящее от регистра значение keyname может равняться None, Left-Alt или Right-Alt. |
/languageLangID |
Указывает язык пользовательского интерфейса, где LangID является четырехзначным десятичным числом. |
/memsizesize |
Задает размер эмулируемого ОЗУ, где значение size указывается в мегабайтах. Допустимые значения — от 64 до 256 включительно. Если допустимое значение не указано, значение size по умолчанию равно 64. |
/n[macaddress] |
Включает сетевой адаптер CS8900, где дополнительный параметр macaddress равен двенадцатизначному шестнадцатеричному числу, указывающему адаптер, к которому будет привязана карта. |
/nosecurityprompt |
Отключает запросы на включение сетевого подключения, последовательных портов и предоставления общего доступа к папкам, если эти функциональные возможности используются в файле сохранения состояния. .gif "Примечание о безопасности") Примечание о безопасности.
Любое использование функции совместного использования папок представляет угрозу для безопасности. Например, не включайте общий доступ к каталогам, которые содержат конфиденциальные сведения.
|
/p[macaddress] |
Включает сетевой адаптер NE2000 PCMCIA, где дополнительный параметр macaddress равен двенадцатизначному шестнадцатеричному числу, указывающему адаптер, к которому будет привязана карта. |
/rROM_address |
Указывает базовый адрес файла ПЗУ, где ROM_address может быть шестнадцатеричным или десятичным числом. |
/rotateangle |
Поворачивает экран по часовой стрелке на определенное количество градусов, где значение angle может быть 0, 90, 180 или 270. Допустимыми являются и другие целые числа, однако они округляются до ближайших 90 градусов. |
/sfilename |
Включает поддержку сохранения состояния, где filename является именем файла сохранения состояния. Примечание о безопасности.
Использование файлов сохранения состояния из ненадежных источников может создать угрозу безопасности.
Обратите внимание на приведенное ниже поведение, связанное с переключателем /s:
|
/sharedfolderdirectoryname |
Подключает каталог как общую папку, где параметр directoryname равен каталогу Windows. Каталог подключается как гостевой каталог "\Storage File", как будто он является картой памяти. |
/skinskin_file_name |
Загружает указанный файл обложки. Примечание.
Нельзя указать одновременно /skin и /video.
|
/tooltipson|off |
Включает или отключает подсказки, где параметр state равен значению ON или OFF. |
/u0serialport |
Сопоставляет гостевой последовательный порт 0 (порт эмулятора COM1) с serialport Windows. |
/u1serialport |
Сопоставляет гостевой последовательный порт 1 (порт выходных данных отладки в эмуляторе) с serialport Windows. |
/u2serialport |
Сопоставляет гостевой последовательный порт 2 (порт эмулятора COM3) с serialport Windows. |
/vfptrue|false |
Указывает наличие сопроцессора для вектора вычислений с плавающей запятой. Значение по умолчанию — false. |
/video<width>x<height>x<bit-depth> |
Указывает размер экрана и глубину цвета жидкокристаллического дисплея, где атрибуты width, height и bit-depth являются десятичными числами. Пример: 640x480x16. Примечание.
Нельзя указать одновременно /skin и /video.
|
/vmid{GUID} |
Указывает идентификатор VMID GUID для сопоставления с текущим экземпляром эмулятора. Как правило, не передается в изолированных сценариях. Если отсутствует идентификатор {GUID}, такой идентификатор создается для этого сеанса без уведомления. |
/vmnamename |
Указывает заголовок окна. Следует отметить следующее поведение:
|
/z |
Масштабирует экран (как обложку, так и ЖК-дисплей) до двукратного увеличения обычных размеров. |
/speakerphone[n] |
Указывает на наличие микрофона с громкоговорителем, головного телефона и автомобильного комплекта. n — это растровое число от 0 до 7, которое обозначает следующее:
|
Пример
В следующем примере запускается эмулятор Windows Mobile 5.0 Pocket PC:
| Примечание. |
|---|
Образ операционной системы эмулятора может находиться в другой папке на компьютере. |
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
Затем можно выбрать команду Сохранить состояние и закрыть в меню Файл и снова запустить эмулятор из файла сохранения состояния, используя указанную ниже команду:
DeviceEmulator.exe /s "d:\MyCustomEmulator.dess"
В следующем примере запускается эмулятор устройства из файла конфигурации эмулятора устройства. Дополнительные сведения см. в разделе Файлы конфигурации эмулятора устройства.
DeviceEmulator.exe "@c:\My Emulator.decfg"