Практическое руководство. Создание манифеста продукта

Статья
08/11/2011

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

Дополнительные сведения о манифестах продуктов см. в разделе Практическое руководство. Создание манифеста пакета.

Создание манифеста продукта

Процедура создания манифеста продукта

Создайте каталог для пакета загрузчика. В данном примере используется каталог "C:\package".
В Visual Studio создайте новый XML-файл product.xml и сохраните его в папке "C:\package".
Чтобы описать пространство имен XML и код продукта для пакета, добавьте следующий XML-код. Вместо кода продукта укажите уникальный идентификатор пакета.
```
<Product
xmlns="https://schemas.microsoft.com/developer/2004/01/bootstrapper" 
ProductCode="Custom.Bootstrapper.Package">
```
Чтобы указать, что пакет имеет зависимость, добавьте следующий XML-код. В этом примере кода показана зависимость от установщика Microsoft Windows 3.1.
```
    <RelatedProducts>
        <DependsOnProduct Code="Microsoft.Windows.Installer.3.1" />
      </RelatedProducts>
```
Чтобы указать файлы, содержащиеся в пакете загрузчика, добавьте следующий XML-код. В этом примере в качестве имени файла пакета используется CorePackage.msi.
```
    <PackageFiles>
        <PackageFile Name="CorePackage.msi"/>
    </PackageFiles>
```
Скопируйте или переместите файл CorePackage.msi в папку "C:\package".
Чтобы установить пакет с помощью команд загрузчика, добавьте следующий XML-код. Загрузчик автоматически добавляет флаг /qn в MSI-файл, который будет установлен в автоматическом режиме. Если файл является исполняемым (EXE-файл), загрузчик запускает его с помощью оболочки. В следующем примере XML-кода для файла CorePackage.msi не заданы аргументы, однако в атрибут Arguments можно добавить аргумент командной строки.
```
    <Commands>
        <Command PackageFile="CorePackage.msi" Arguments="">
```
Чтобы проверить, установлен ли пакет загрузчика, добавьте следующий XML-код. Вместо кода продукта укажите GUID распространяемого компонента.
```
        <InstallChecks>
            <MsiProductCheck 
                Property="IsMsiInstalled" 
                Product="{XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}"/>
        </InstallChecks>
```
Чтобы изменить поведение загрузчика в зависимости от того, установлен ли компонент загрузчика, добавьте следующий XML-код. Если компонент установлен, пакет загрузчика не запустится. В следующем примере XML-кода выполняется проверка, является ли текущий пользователь администратором, поскольку для работы этого компонента требуются права администратора.
```
        <InstallConditions>
            <BypassIf 
               Property="IsMsiInstalled" 
               Compare="ValueGreaterThan" Value="0"/>
            <FailIf Property="AdminUser" 
                Compare="ValueNotEqualTo" Value="True"
                String="NotAnAdmin"/>
        </InstallConditions>
```
Чтобы добавить коды выхода при успешной установке и при необходимости перезагрузки, добавьте следующий XML-код. В этом примере XML-кода показаны коды выхода Fail и FailReboot, которые указывают, что загрузчик не будет продолжать установку пакетов.
```
        <ExitCodes>
            <ExitCode Value="0" Result="Success"/>
            <ExitCode Value="1641" Result="SuccessReboot"/>
            <ExitCode Value="3010" Result="SuccessReboot"/>
            <DefaultExitCode Result="Fail" String="GeneralFailure"/>
        </ExitCodes>
```
Чтобы завершить раздел команд загрузчика добавьте следующий XML-код.
```
        </Command>
    </Commands>
```
Переместите папку "C:\package" в каталог загрузчика Visual Studio. Каталог загрузчика в Visual Studio 2010: \Program Files\Microsoft SDKs\Windows\v7.0A\Bootstrapper\Packages.

Пример

Манифест продукта содержит инструкции по установке необходимых компонентов при выборочной установке.

<?xml version="1.0" encoding="utf-8" ?>
<Product
  xmlns="https://schemas.microsoft.com/developer/2004/01/bootstrapper"
  ProductCode="Custom.Bootstrapper.Package">

  <RelatedProducts>
    <DependsOnProduct Code="Microsoft.Windows.Installer.3.1" />
  </RelatedProducts>

  <PackageFiles>
    <PackageFile Name="CorePackage.msi"/>
  </PackageFiles>

  <InstallChecks>
    <MsiProductCheck Product="IsMsiInstalled" 
      Property="{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}"/>
  </InstallChecks>

  <Commands>
    <Command PackageFile="CorePackage.msi" Arguments="">

      <InstallConditions>
        <BypassIf Property="IsMsiInstalled"
          Compare="ValueGreaterThan" Value="0"/>
        <FailIf Property="AdminUser" 
          Compare="ValueNotEqualTo" Value="True"
         String="NotAnAdmin"/>
      </InstallConditions>

      <ExitCodes>
        <ExitCode Value="0" Result="Success"/>
        <ExitCode Value="1641" Result="SuccessReboot"/>
        <ExitCode Value="3010" Result="SuccessReboot"/>
        <DefaultExitCode Result="Fail" String="GeneralFailure"/>
      </ExitCodes>
    </Command>
  </Commands>
</Product>

См. также

Ссылки

Справочные сведения о схеме пакетов и продуктов

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