Freigeben über


GenerateBootstrapper-Aufgabe

Bietet eine Möglichkeit zur Automatisierung von Erkennung, Download und Installation einer Anwendung und der erforderlichen Komponenten.Diese Aufgabe dient als einzelner Installer, der die separaten Installer für alle Komponenten einer Anwendung integriert.

Aufgabenparameter

In der folgenden Tabelle werden die Parameter der GenerateBootstrapper-Aufgabe beschrieben.

Parameter

Beschreibung

ApplicationFile

Optionaler String-Parameter.

Gibt die Datei an, mit der der Bootstrapper die Installation der Anwendung nach der Installation aller Vorbedingungen begonnen wird.Ein Buildfehler ergibt sich, wenn weder der BootstrapperItems-Parameter noch der ApplicationFile-Parameter angegeben wird.

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.

Bei true wird die Komponente nach der Installation auf einem Zielcomputer mit erweiterten Berechtigungen ausgeführt.

ApplicationUrl

Optionaler String-Parameter.

Gibt den Webspeicherort an, an dem sich der Installer der Anwendung befindet.

BootstrapperComponentFiles

Optionaler String[]-Ausgabeparameter.

Gibt den erstellten Speicherort für 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 haben:

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

Das Include-Attribut wird verwendet, um den Namen einer Vorbedingung darzustellen, die installiert werden sollte.Die Metadaten des ProductName-Elements sind optional und werden vom Buildmodul als benutzerfreundlicher Name für den Fall verwendet, dass das Paket nicht gefunden werden kann.Diese Elemente sind keine erforderlichen MSBuild-Eingabeparameter, sofern ein ApplicationFile angegeben wird.Sie sollten ein Element für jede Vorbedingung einschließen, die für die Anwendung installiert werden muss.

Ein Buildfehler ergibt sich, wenn weder der BootstrapperItems-Parameter noch der ApplicationFile-Parameter angegeben wird.

BootstrapperKeyFile

Optionaler String-Ausgabeparameter.

Gibt den erstellten Speicherort von setup.exe an

ComponentsLocation

Optionaler String-Parameter.

Gibt einen Speicherort an, an dem der Bootstrapper nach zu installierenden Installationsvorbedingungen sucht.Dieser Parameter kann die folgenden Werte aufweisen:

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

  • Relative: Gibt an, dass die Vorbedingung sich am Speicherort der Anwendung befindet.

  • Absolute: Gibt an, dass sich alle Komponenten bei einer zentralisierten URL befinden.Dieser Wert sollte in Verbindung mit dem ComponentsUrl-Eingabeparameter verwendet werden.

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

ComponentsUrl

Optionaler String-Parameter.

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

CopyComponents

Optionaler Boolean-Parameter.

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

Culture

Optionaler String-Parameter.

Gibt die Kultur an, die für die Bootstrapper-Benutzeroberfläche und die Installationsvorbedingungen 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-Benutzeroberfläche und die Installationsvorbedingungen verwendet werden soll.

OutputPath

Optionaler String-Parameter.

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

Path

Optionaler String-Parameter.

Gibt den Speicherort für alle verfügbaren Vorbedingungspakete an.

SupportUrl

Optionaler String-Parameter.

Gibt die URL an, die ausgegeben werden soll, wenn die Installation des Bootstrappers fehlschlägt.

Validate

Optionaler Boolean-Parameter.

Bei true führt der Bootstrapper XSD-Validierung für die angegebenen Eingabe-Bootstrapperelemente aus.Der Standardwert dieses Parameters ist false.

Hinweise

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 mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter TaskExtension-Basisklasse.

Beispiel

Das folgende Beispiel installiert mit der GenerateBootstrapper-Aufgabe eine Anwendung, für die als Vorbedingung .NET Framework 2.0 installiert sein muss.

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

Siehe auch

Konzepte

MSBuild-Aufgaben

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben