GenerateBootstrapper-uppgift

Ger ett automatiserat sätt att identifiera, ladda ned och installera ett program och dess förutsättningar. Det fungerar som ett enda installationsprogram som integrerar de separata installationsprogrammet för alla komponenter som utgör ett program.

Aktivitetsparametrar

Följande beskriver parametrarna för GenerateBootstrapper uppgiften.

• ApplicationFile

  Valfri String parameter.

  Anger den fil som bootstrappern ska använda för att påbörja installationen av programmet när alla krav har installerats. Ett byggfel uppstår om varken parametern BootstrapperItems eller parametern ApplicationFile har angetts.

• ApplicationName

  Valfri String parameter.

  Anger namnet på programmet som bootstrappern ska installera. Det här namnet visas i användargränssnittet som bootstrappern använder under installationen.

• ApplicationRequiresElevation

  Valfri Boolean parameter.

  Om truekörs komponenten med förhöjd behörighet när den är installerad på en måldator.

• ApplicationUrl

  Valfri String parameter.

  Anger den webbplats som är värd för programmets installationsprogram.

• BootstrapperComponentFiles

  Valfri utdataparameter String[] .

  Anger den inbyggda platsen för bootstrapper-paketfiler.

• BootstrapperItems

  Valfri ITaskItem[] parameter.

  Anger de produkter som ska byggas in i bootstrappern. Objekten som skickas till den här parametern bör ha följande syntax:

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

  Attributet Include representerar namnet på en förutsättning som ska installeras. Objektmetadata ProductName är valfria och används av byggmotorn som ett användarvänligt namn om paketet inte kan hittas. Dessa objekt krävs inte MSBuild-indataparametrar, såvida inte inget ApplicationFile anges. Du bör inkludera ett objekt för varje förutsättning som måste installeras för ditt program.

  Ett byggfel uppstår om varken parametern BootstrapperItems eller parametern ApplicationFile har angetts.

• BootstrapperKeyFile

  Valfri utdataparameter String .

  Anger den inbyggda platsen försetup.exe

• ComponentsLocation

  Valfri String parameter.

  Anger en plats där bootstrappern ska söka efter installationskraven för installation. Den här parametern kan ha följande värden:

  • HomeSite: Anger att förutsättningen hanteras av komponentleverantören.

  • Relative: Anger att förutsättningen finns på samma plats för programmet.

  • Absolute: Anger att alla komponenter finns på en centraliserad URL. Det här värdet ska användas tillsammans med ComponentsUrl indataparametern.

    Om ComponentsLocation inte anges HomeSite används som standard.

• ComponentsUrl

  Valfri String parameter.

  Anger den URL som innehåller installationskraven.

• CopyComponents

  Valfri Boolean parameter.

  Om truekopierar bootstrappern alla utdatafiler till sökvägen som anges i parametern OutputPath . Värdena för parametern BootstrapperComponentFiles bör alla baseras på den här sökvägen. Om falsekopieras inte filerna och BootstrapperComponentFiles värdena baseras på parameterns Path värde. Standardvärdet för den här parametern är true.

• Culture

  Valfri String parameter.

  Anger vilken kultur som ska användas för bootstrapper-användargränssnittet och installationskraven. Om den angivna kulturen inte är tillgänglig använder aktiviteten värdet för parametern FallbackCulture .

• FallbackCulture

  Valfri String parameter.

  Anger den sekundära kultur som ska användas för bootstrapper-användargränssnittet och installationskraven.

• OutputPath

  Valfri String parameter.

  Anger platsen där du vill kopiera setup.exe och alla paketfiler.

• Path

  Valfri String parameter.

  Anger platsen för alla tillgängliga nödvändiga paket.

• SupportUrl

  Valfri String parameter.

  Anger url:en som ska anges om bootstrapper-installationen misslyckas.

• Validate

  Valfri Boolean parameter.

  Om trueutför bootstrapper XSD-valideringen på angivna bootstrapper-objekt för indata. Standardvärdet för den här parametern är false.

Anmärkningar

Förutom de parametrar som anges ovan ärver den här aktiviteten parametrar från TaskExtension klassen, som i sig ärver från Task klassen. En lista över dessa ytterligare parametrar och deras beskrivningar finns i TaskExtension-basklassen.

Example

I följande exempel används uppgiften GenerateBootstrapper för att installera ett program som måste ha .NET Framework 4.8 installerat som en förutsättning.

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

Se även

• Uppgifter
• Uppgiftsreferens