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

Задача GenerateBootstrapper

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

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

Ниже описаны параметры GenerateBootstrapper задачи.

  • ApplicationFile

    Необязательный String параметр.

    Указывает файл, который будет использоваться загрузчиком, чтобы начать установку приложения после установки всех необходимых компонентов. Ошибка сборки приведет к тому, что BootstrapperItemsApplicationFile ни параметр не указан.

  • ApplicationName

    Необязательный String параметр.

    Указывает имя приложения, которое установит загрузчик. Это имя появится в пользовательском интерфейсе начального загрузчика, который используется во время установки.

  • ApplicationRequiresElevation

    Необязательный Boolean параметр.

    Если trueкомпонент запускается с повышенными разрешениями при установке на целевом компьютере.

  • ApplicationUrl

    Необязательный String параметр.

    Указывает веб-расположение, в котором размещается установщик приложения.

  • BootstrapperComponentFiles

    Необязательный выходной String[] параметр.

    Указывает встроенное расположение файлов пакетов начальной загрузки.

  • BootstrapperItems

    Необязательный ITaskItem[] параметр.

    Указывает продукты для сборки в загрузчик. Элементы, переданные этому параметру, должны иметь следующий синтаксис:

    <BootstrapperItem
    Include="ProductCode">
    <ProductName>
        ProductName
    </ProductName>
</BootstrapperItem>

    Атрибут Include представляет имя необходимого условия, которое должно быть установлено. Метаданные ProductName элемента являются необязательными и будут использоваться подсистемой сборки в качестве понятного имени, если пакет не найден. Эти элементы не являются обязательными входными параметрами MSBuild, если не указано.ApplicationFile Необходимо включить один элемент для каждого необходимого компонента, который должен быть установлен для приложения.

    Ошибка сборки приведет к тому, что BootstrapperItemsApplicationFile ни параметр не указан.

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

Example

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

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

<Target Name="CustomBootstrapper">
  <GenerateBootstrapper
    ApplicationFile="MyApp.exe"
    BootstrapperItems="@(BootstrapperFile)"
    OutputPath="$(OutputPath)"
    ComponentsLocation="Relative" />
</Target>

См. также

  • Last updated on