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