Задача GenerateBootstrapper

Обеспечение автоматического обнаружения, загрузки и установки приложения и необходимых для него компонентов. Служит единым установщиком, объединяющим отдельные установщики для всех компонентов, образующих приложение.

Параметры задачи

В следующей таблице описаны параметры задачи GenerateBootstrapper.

Параметр	Описание
ApplicationFile	Необязательный параметр типа String. Задает файл, который будет использоваться загрузчиком для начала установки приложения после установки всех его обязательных компонентов. Если не задан ни один из параметров BootstrapperItems и ApplicationFile, произойдет ошибка построения.
ApplicationName	Необязательный параметр типа String. Задается имя приложения, которое будет установлено загрузчиком. Это имя будет отображаться в пользовательском интерфейсе загрузчика во время установки.
ApplicationRequiresElevation	Необязательный параметр типа Boolean. Если true, компонент выполняется с повышенным уровнем разрешений при установке на целевом компьютере.
ApplicationUrl	Необязательный параметр типа String. Задает расположение установщика приложения в Интернете.
BootstrapperComponentFiles	Необязательный выходной параметр String[]. Задает расположение собранных файлов пакетов загрузчика.
BootstrapperItems	Необязательный параметр ITaskItem[] . Задает продукты, встраиваемые в загрузчик. Элементы, передаваемые этому параметру, должны иметь следующий синтаксис: <BootstrapperItem Include="ProductCode"> <ProductName> ProductName </ProductName> </BootstrapperItem> Атрибут Include представляет имя обязательного компонента, который должен быть установлен. Метаданные элемента ProductName указывать не обязательно. Они будут использоваться сборочным ядром в качестве понятного для пользователя имени в случае, если найти пакет не удастся. Данные элементы не являются обязательными входными параметрами MSBuild, если не задан параметр ApplicationFile. Необходимо указать по одному элементу на каждый обязательный компонент, который должен быть установлен для приложения. Если не задан ни один из параметров BootstrapperItems и ApplicationFile, произойдет ошибка построения.
BootstrapperKeyFile	Необязательный выходной параметр String. Задает расположение собранного файла setup.exe.
ComponentsLocation	Необязательный параметр типа String. Задает расположение, в котором загрузчик будет искать обязательные компоненты для установки. Этот параметр может иметь следующие значения: HomeSite: указывает, что обязательный компонент располагается у поставщика компонента. Relative: указывает, что обязательный компонент располагается в том же месте, что и приложение. Absolute: указывает, что все компоненты располагаются по единому URL-адресу. Это значение следует использовать в связке с входным параметром ComponentsUrl. Если параметр ComponentsLocation не задан, по умолчанию используется значение HomeSite.
ComponentsUrl	Необязательный параметр типа String. Задает URL-адрес, по которому располагаются обязательные компоненты для установки.
CopyComponents	Необязательный параметр типа Boolean. Если этот параметр равен true, загрузчик копирует все выходные файлы в место, задаваемое параметром OutputPath. Все значения параметра BootstrapperComponentFiles должны основываться на этом пути. Если этот параметр равен false, файлы не копируются, и значения BootstrapperComponentFiles основываются на значении параметра Path. По умолчанию этот параметр имеет значение true.
Culture	Необязательный параметр типа String. Задает язык и региональные параметры, которые следует использовать для пользовательского интерфейса загрузчика и обязательных компонентов установки. Если заданные язык и региональные параметры недоступны, задача использует значение параметра FallbackCulture.
FallbackCulture	Необязательный параметр типа String. Задает дополнительные язык и региональные параметры, которые следует использовать для пользовательского интерфейса загрузчика и обязательных компонентов установки.
OutputPath	Необязательный параметр типа String. Задает расположение, в которое следует копировать файл setup.exe и все файлы пакетов.
Path	Необязательный параметр типа String. Задает расположение всех имеющихся обязательных пакетов.
SupportUrl	Необязательный параметр типа String. Задает URL-адрес, который следует отобразить при сбое установки загрузчика.
Validate	Необязательный параметр типа Boolean. Если этот параметр равен true, загрузчик производит проверку XSD для заданных входных элементов загрузчика. По умолчанию этот параметр имеет значение false.

Заметки

Помимо параметров, которые перечислены выше, эта задача наследует параметры от класса TaskExtension, который наследует от класса Task. Чтобы получить список этих доп параметров и их описаний, см. Базовый класс TaskExtension.

Пример

В следующем примере используется задача GenerateBootstrapper для установки приложения, требующего установки .NET Framework 2.0 в качестве обязательного компонента.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <BootstrapperFile Include="Microsoft.Net.Framework.2.0">
            <ProductName>Microsoft .NET Framework 2.0</ProductName>
        </BootstrapperFile>
    </ItemGroup>

    <Target Name="BuildBootstrapper">
        <GenerateBootstrapper
            ApplicationFile="WindowsApplication1.application"
            ApplicationName="WindowsApplication1"
            ApplicationUrl="http://mycomputer"
            BootstrapperItems="@(BootstrapperFile)"
            OutputPath="C:\output" />
    </Target>

</Project>

См. также

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

Задачи MSBuild

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

Справочные сведения о задачах MSBuild