Поделиться через

Справочник по схеме XML пакета надстройки

  • Статья

Обновлен: Ноябрь 2007

Пакеты надстройки используются в RemoteAgent и DownloadPackage для копирования файлов на устройство и, дополнительно, для запуска исполняемого файла. Общие сведения см. в разделе Общие сведения о пакетах надстроек. Используйте следующий пример в качестве руководства по созданию пакетов надстройки.

Код

<?xml version="1.0" standalone="no"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:template match="/">
    <ADDONCONTAINER>
      <ADDON>
        <PACKAGECONTAINER>
          <PACKAGE ID="F85E57BA-5AE9-4FF7-8433-6AB7D991D033" NAME="Example">
            <PROPERTYCONTAINER />
            <PACKAGETYPECONTAINER>
              <PACKAGETYPE Name="ARMV4I" ID="ARMV4I" Protected="True">
                <PROPERTYCONTAINER>
                  <PROPERTY ID="RemotePath" Protected="True">%CSIDL_WINDOWS%</PROPERTY>
                  <PROPERTY ID="RootPath" Protected="True"> %CSIDL_PROGRAM_FILES% </PROPERTY>
                  <PROPERTY ID="CommandLine" Protected="True">/ServiceIds:F85E57BA-5AE9-4FF7-8433-6AB7D991D033</PROPERTY>
                  <PROPERTY ID="Host" Protected="True">Trial1.exe</PROPERTY>
                </PROPERTYCONTAINER>
                <FILECONTAINER>
                  <FILE ID="Trial1.exe" />
                  <FILE ID="Trial2.exe" />
                </FILECONTAINER>
              </PACKAGETYPE>
            </PACKAGETYPECONTAINER>
          </PACKAGE>
        </PACKAGECONTAINER>
      </ADDON>
    </ADDONCONTAINER>
  </xsl:template>
</xsl:stylesheet>
<?xml version="1.0" encoding="ISO-8859-1"?>

Примечания

В этом примере создается пакет надстройки с именем "Example". В следующей таблице описан каждый элемент из предыдущего примера.

Теги

Описание

<ADDONCONATINER>

Содержит один тег addon.

<ADDON>

Содержит один тег PackageContainer.

<PACKAGECONTAINER>

Содержит один или несколько пакетов.

<PACKAGE ID="F85E57BA-5AE9-4FF7-8433-6AB7D991D033" NAME="Example">

Определяет пакет и указывает имя и идентификатор пакета. Идентификатор — это идентификатор GUID.

<PACKAGETYPECONTAINER>

Содержит один или несколько типов пакета. Каждый тип пакета определяет различную архитектуру процессора, на которой может работать приложение устройства.

<PACKAGETYPECONTAINER>

PACKAGETYPE Name="ARMV4I" ID="ARMV4I" Protected="True">

Определяет тип пакета и указывает тип процессора, поддерживаемого этим типом пакета. Ниже приведены допустимые типы процессоров:

  • ARMV4

  • ARMV4I

  • SH4

  • MIPSII

  • MIPSII_FP

  • MIPSIV

  • MIPSIV_FP

  • X86

<PROPERTY ID="RemotePath" Protected="True">%CSIDL_WINDOWS%</PROPERTY>

Задает одно из следующих свойств:

  • RootPath — папка для файлов, которые будут развернуты на устройстве. Все файлы, которые будут развернуты как часть этого пакета, должны находиться в этой папке на настольном ПК. Путь может содержать макросы CSIDL.

    Bb513827.alert_note(ru-ru,VS.90).gifПримечание.
    Значения CSIDL предоставляют уникальный, не зависящий от системы способ идентификации специальных папок, которые часто используются приложениями, но могут не иметь того же имени или расположения в разных системах.

  • RemotePath — папка на устройстве, где будут развернуты файлы. Путь может содержать макросы CSIDL.

  • Host — исполняемый объект, который запускается после развертывания всех файлов из пакета с настольного ПК на устройстве.

  • CommandLine — аргументы командной строки, которые должны быть переданы в исполняемый объект на устройстве. Это свойство является необязательным.

<FILECONTAINER>

Содержит один или несколько тегов файла.

<FILE ID="Trial1.exe" />

Указывает файл, который должен быть развернут. Атрибут идентификатора указывает имя файла. Файл развертывается из папки RootPath на настольном ПК в папку RemotePath на устройстве.

При развертывании пакета с помощью Start или DownloadPackage интерфейс API подключения к смарт-устройствам копирует trial1.exe и trial2.exe из папки Program Files на настольном компьютере в папку Windows на устройстве. Затем на устройстве запускается файл trial1.exe /ServiceIds:F85E57BA-5AE9-4FF7-8433-6AB7D991D033.

См. также

Основные понятия

Общие сведения о пакетах надстроек

Другие ресурсы

Примеры использования API подключения смарт-устройств