GenerateBootstrapper-Aufgabe

Bietet eine automatisierte Möglichkeit zum Erkennen, Herunterladen und Installieren einer Anwendung und der erforderlichen Komponenten. Es dient als einzelnes Installationsprogramm, das die separaten Installationsprogramme für alle Komponenten integriert, die eine Anwendung bilden.

Vorgangsparameter

Im Folgenden werden die Parameter des GenerateBootstrapper Vorgangs beschrieben.

• ApplicationFile

  Optionaler String Parameter.

  Gibt die Datei an, die der Bootstrapper verwendet, um die Installation der Anwendung zu starten, nachdem alle erforderlichen Komponenten installiert wurden. Ein Buildfehler führt dazu, dass weder der BootstrapperItems Parameter noch der ApplicationFile Parameter angegeben werden.

• ApplicationName

  Optionaler String Parameter.

  Gibt den Namen der Anwendung an, die der Bootstrapper installiert. Dieser Name wird in der Benutzeroberfläche angezeigt, die der Bootstrapper während der Installation verwendet.

• ApplicationRequiresElevation

  Optionaler Boolean Parameter.

  Wenn truedie Komponente mit erhöhten Berechtigungen ausgeführt wird, wenn sie auf einem Zielcomputer installiert ist.

• ApplicationUrl

  Optionaler String Parameter.

  Gibt den Webspeicherort an, der das Installationsprogramm der Anwendung hosten soll.

• BootstrapperComponentFiles

  Optionaler String[] Ausgabeparameter.

  Gibt den integrierten Speicherort der Bootstrapper-Paketdateien an.

• BootstrapperItems

  Optionaler ITaskItem[] Parameter.

  Gibt die Produkte an, die in den Bootstrapper integriert werden sollen. Die an diesen Parameter übergebenen Elemente sollten die folgende Syntax aufweisen:

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

  Das Include Attribut stellt den Namen einer Voraussetzung dar, die installiert werden soll. Die ProductName Elementmetadaten sind optional und werden vom Buildmodul als benutzerfreundlicher Name verwendet, wenn das Paket nicht gefunden werden kann. Diese Elemente sind keine MSBuild-Eingabeparameter erforderlich, es sei denn, es wird kein ApplicationFile Wert angegeben. Sie sollten ein Element für jede Voraussetzung einschließen, die für Ihre Anwendung installiert werden muss.

  Ein Buildfehler führt dazu, dass weder der BootstrapperItems Parameter noch der ApplicationFile Parameter angegeben werden.

• BootstrapperKeyFile

  Optionaler String Ausgabeparameter.

  Gibt den integrierten Speicherort von setup.exe

• ComponentsLocation

  Optionaler String Parameter.

  Gibt einen Speicherort für den Bootstrapper an, der nach installationsvoraussetzungen für die Installation sucht. Dieser Parameter kann die folgenden Werte aufweisen:

  • HomeSite: Gibt an, dass die Voraussetzung vom Komponentenanbieter gehostet wird.

  • Relative: Gibt an, dass sich die Voraussetzung an demselben Speicherort der Anwendung befindet.

  • Absolute: Gibt an, dass alle Komponenten in einer zentralen URL gefunden werden sollen. Dieser Wert sollte in Verbindung mit dem ComponentsUrl Eingabeparameter verwendet werden.

    Wenn ComponentsLocation nicht angegeben, HomeSite wird standardmäßig verwendet.

• ComponentsUrl

  Optionaler String Parameter.

  Gibt die URL an, die die Installationsvoraussetzungen enthält.

• CopyComponents

  Optionaler Boolean Parameter.

  Wenn true, kopiert der Bootstrapper alle Ausgabedateien in den im OutputPath Parameter angegebenen Pfad. Die Werte des BootstrapperComponentFiles Parameters sollten alle auf diesem Pfad basieren. Wenn falsedie Dateien nicht kopiert werden und die BootstrapperComponentFiles Werte auf dem Wert des Path Parameters basieren. Der Standardwert dieses Parameters ist true.

• Culture

  Optionaler String Parameter.

  Gibt die Kultur an, die für die Bootstrapper-UI und installationsvoraussetzungen verwendet werden soll. Wenn die angegebene Kultur nicht verfügbar ist, verwendet die Aufgabe den Wert des FallbackCulture Parameters.

• FallbackCulture

  Optionaler String Parameter.

  Gibt die sekundäre Kultur an, die für die Bootstrapper-UI und installationsvoraussetzungen verwendet werden soll.

• OutputPath

  Optionaler String Parameter.

  Gibt den Speicherort an, der setup.exe und alle Paketdateien kopiert werden soll.

• Path

  Optionaler String Parameter.

  Gibt den Speicherort aller verfügbaren erforderlichen Pakete an.

• SupportUrl

  Optionaler String Parameter.

  Gibt die URL an, die angegeben werden soll, wenn die Bootstrapper-Installation fehlschlägt.

• Validate

  Optionaler Boolean Parameter.

  Wenn trueder Bootstrapper die XSD-Überprüfung für die angegebenen Eingabe-Bootstrapper-Elemente durchführt. Der Standardwert dieses Parameters ist false.

Bemerkungen

Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der TaskExtension Klasse, die selbst von der Task Klasse erbt. Eine Liste dieser zusätzlichen Parameter und deren Beschreibungen finden Sie unter TaskExtension-Basisklasse.

Example

Im folgenden Beispiel wird die GenerateBootstrapper Aufgabe verwendet, um eine Anwendung zu installieren, für die .NET Framework 4.8 als Voraussetzung installiert sein muss.

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

Siehe auch

• Aufgaben
• Aufgabenreferenz