GenerateBootstrapper – úloha

Poskytuje automatizovaný způsob, jak rozpoznat, stáhnout a nainstalovat aplikaci a její požadavky. Slouží jako jeden instalační program, který integruje samostatné instalační programy pro všechny komponenty, které tvoří aplikaci.

Parametry úkolu

Následující popis parametrů GenerateBootstrapper úlohy.

  • ApplicationFile

    Volitelný String parametr.

    Určuje soubor, který bude bootstrapper používat k zahájení instalace aplikace po instalaci všech požadavků. Pokud není zadaný ani parametr, ApplicationFile dojde k BootstrapperItems chybě sestavení.

  • ApplicationName

    Volitelný String parametr.

    Určuje název aplikace, kterou bude bootstrapper instalovat. Tento název se zobrazí v uživatelském rozhraní, které bootstrapper používá během instalace.

  • ApplicationRequiresElevation

    Volitelný Boolean parametr.

    Pokud truese komponenta spustí se zvýšenými oprávněními, když je nainstalovaná v cílovém počítači.

  • ApplicationUrl

    Volitelný String parametr.

    Určuje webové umístění, které je hostitelem instalačního programu aplikace.

  • BootstrapperComponentFiles

    Volitelný String[] výstupní parametr.

    Určuje vytvořené umístění souborů balíčku bootstrapperu.

  • BootstrapperItems

    Volitelný ITaskItem[] parametr.

    Určuje produkty, které se mají zabudovat do bootstrapperu. Položky předané tomuto parametru by měly mít následující syntaxi:

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

    Atribut Include představuje název předpokladu, který by měl být nainstalován. ProductName Metadata položky jsou volitelná a modul sestavení bude používat jako uživatelsky přívětivý název, pokud se balíček nenašel. Tyto položky nejsou povinné vstupní parametry nástroje MSBuild, pokud není zadán žádný ApplicationFile . Měli byste zahrnout jednu položku pro všechny předpoklady, které musí být nainstalovány pro vaši aplikaci.

    Pokud není zadaný ani parametr, ApplicationFile dojde k BootstrapperItems chybě sestavení.

  • BootstrapperKeyFile

    Volitelný String výstupní parametr.

    Určuje vytvořené umístění setup.exe

  • ComponentsLocation

    Volitelný String parametr.

    Určuje umístění, do které má bootstrapper vyhledat požadavky instalace, které se mají nainstalovat. Tento parametr může mít následující hodnoty:

    • HomeSite: Označuje, že předpoklad hostuje dodavatel komponenty.

    • Relative: Označuje, že předpoklad je ve stejném umístění aplikace.

    • Absolute: Označuje, že se všechny komponenty nacházejí na centralizované adrese URL. Tato hodnota by měla být použita ve spojení se vstupním parametrem ComponentsUrl .

      Pokud ComponentsLocation není zadán, HomeSite použije se ve výchozím nastavení.

  • ComponentsUrl

    Volitelný String parametr.

    Určuje adresu URL obsahující požadavky instalace.

  • CopyComponents

    Volitelný Boolean parametr.

    Pokud true, bootstrapper zkopíruje všechny výstupní soubory do cesty zadané v parametru OutputPath . Hodnoty parametru BootstrapperComponentFiles by měly být založeny na této cestě. Pokud falsese soubory nekopírují a BootstrapperComponentFiles hodnoty jsou založené na hodnotě parametru Path . Výchozí hodnota tohoto parametru je true.

  • Culture

    Volitelný String parametr.

    Určuje jazykovou verzi, která se má použít pro uživatelské rozhraní bootstrapperu a požadavky na instalaci. Pokud zadaná jazyková verze není k dispozici, úloha použije hodnotu parametru FallbackCulture .

  • FallbackCulture

    Volitelný String parametr.

    Určuje sekundární jazykovou verzi, která se má použít pro uživatelské rozhraní bootstrapperu a požadavky na instalaci.

  • OutputPath

    Volitelný String parametr.

    Určuje umístění pro kopírování setup.exe a všech souborů balíčků.

  • Path

    Volitelný String parametr.

    Určuje umístění všech dostupných požadovaných balíčků.

  • SupportUrl

    Volitelný String parametr.

    Určuje adresu URL, která se má zadat, pokud se instalace zaváděcího nástroje nezdaří.

  • Validate

    Volitelný Boolean parametr.

    Pokud truebootstrapper provede ověření XSD u zadaných vstupních položek bootstrapperu. Výchozí hodnota tohoto parametru je false.

Poznámky

Kromě výše uvedených parametrů tato úloha dědí parametry z TaskExtension třídy, která sama dědí z Task třídy. Seznam těchto dalších parametrů a jejich popisů naleznete v tématu TaskExtension základní třída.

Example

Následující příklad používá GenerateBootstrapper úlohu k instalaci aplikace, která musí mít nainstalované rozhraní .NET Framework 4.8 jako předpoklad.

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

Viz také

  • Last updated on