GenerateBootstrapper — zadanie

  • Artykuł

Zapewnia zautomatyzowany sposób wykrywania, pobierania i instalowania aplikacji oraz jej wymagań wstępnych. Służy jako pojedynczy instalator, który integruje oddzielne instalatory dla wszystkich składników tworzących aplikację.

Parametry zadania

Poniżej opisano parametry GenerateBootstrapper zadania.

  • ApplicationFile

    Opcjonalny String parametr.

    Określa plik, który będzie używany przez program inicjatora do rozpoczęcia instalacji aplikacji po zainstalowaniu wszystkich wymagań wstępnych. Jeśli nie określono parametru ani parametru BootstrapperItemsApplicationFile , zostanie wyświetlony błąd kompilacji.

  • ApplicationName

    Opcjonalny String parametr.

    Określa nazwę aplikacji, która zostanie zainstalowana przez program inicjujący. Ta nazwa będzie wyświetlana w interfejsie użytkownika używanym przez program inicjerowy podczas instalacji.

  • ApplicationRequiresElevation

    Opcjonalny Boolean parametr.

    Jeśli trueskładnik jest uruchamiany z podwyższonym poziomem uprawnień, gdy jest zainstalowany na komputerze docelowym.

  • ApplicationUrl

    Opcjonalny String parametr.

    Określa lokalizację sieci Web, która hostuje instalator aplikacji.

  • BootstrapperComponentFiles

    Opcjonalny String[] parametr wyjściowy.

    Określa wbudowaną lokalizację plików pakietów programu inicjatora.

  • BootstrapperItems

    Opcjonalny ITaskItem[] parametr.

    Określa produkty do budowy w inicjatorze. Elementy przekazane do tego parametru powinny mieć następującą składnię:

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

    Atrybut Include reprezentuje nazwę wymagań wstępnych, które należy zainstalować. Metadane ProductName elementu są opcjonalne i będą używane przez aparat kompilacji jako przyjazną dla użytkownika nazwę, jeśli nie można odnaleźć pakietu. Te elementy nie są wymagane parametrów wejściowych MSBuild, chyba że nie ApplicationFile zostanie określony. Należy uwzględnić jeden element dla wszystkich wymagań wstępnych, które muszą być zainstalowane dla aplikacji.

    Jeśli nie określono parametru ani parametru BootstrapperItemsApplicationFile , zostanie wyświetlony błąd kompilacji.

  • BootstrapperKeyFile

    Opcjonalny String parametr wyjściowy.

    Określa wbudowaną lokalizację pliku setup.exe

  • ComponentsLocation

    Opcjonalny String parametr.

    Określa lokalizację programu inicjatora, aby wyszukać wymagania wstępne instalacji do zainstalowania. Ten parametr może mieć następujące wartości:

    • HomeSite: wskazuje, że wymagania wstępne są hostowane przez dostawcę składnika.

    • Relative: wskazuje, że wymagania wstępne są w tej samej lokalizacji aplikacji.

    • Absolute: wskazuje, że wszystkie składniki można znaleźć pod scentralizowanym adresem URL. Ta wartość powinna być używana w połączeniu z parametrem wejściowym ComponentsUrl .

      Jeśli ComponentsLocation nie zostanie określony, HomeSite jest używany domyślnie.

  • ComponentsUrl

    Opcjonalny String parametr.

    Określa adres URL zawierający wymagania wstępne instalacji.

  • CopyComponents

    Opcjonalny Boolean parametr.

    Jeśli trueprogram rozruchowy kopiuje wszystkie pliki wyjściowe do ścieżki określonej w parametrze OutputPath . Wartości parametru BootstrapperComponentFiles powinny być oparte na tej ścieżce. Jeśli falsepliki nie są kopiowane, a BootstrapperComponentFiles wartości są oparte na wartości parametru Path . Wartość domyślna tego parametru to true.

  • Culture

    Opcjonalny String parametr.

    Określa kulturę, która ma być używana dla interfejsu użytkownika programu inicjatora i wymagań wstępnych instalacji. Jeśli określona kultura jest niedostępna, zadanie używa wartości parametru FallbackCulture .

  • FallbackCulture

    Opcjonalny String parametr.

    Określa kulturę pomocniczą do użycia dla interfejsu użytkownika programu inicjatora i wymagań wstępnych instalacji.

  • OutputPath

    Opcjonalny String parametr.

    Określa lokalizację kopiowania pliku setup.exe i wszystkich plików pakietu.

  • Path

    Opcjonalny String parametr.

    Określa lokalizację wszystkich dostępnych pakietów wymagań wstępnych.

  • SupportUrl

    Opcjonalny String parametr.

    Określa adres URL, który ma być określony, jeśli instalacja programu inicjatora zakończy się niepowodzeniem.

  • Validate

    Opcjonalny Boolean parametr.

    Jeśli trueprogram inicjuje operację uruchamiania, przeprowadza walidację XSD na określonych elementach programu inicjjącego danych wejściowych. Wartość domyślna tego parametru to false.

Uwagi

Oprócz parametrów wymienionych powyżej to zadanie dziedziczy parametry z TaskExtension klasy, która sama dziedziczy z Task klasy. Aby uzyskać listę tych dodatkowych parametrów i ich opisy, zobacz TaskExtension, klasa bazowa.

Przykład

W poniższym przykładzie GenerateBootstrapper użyto zadania do zainstalowania aplikacji, która musi mieć zainstalowany program .NET Framework 2.0 jako wymaganie wstępne.

<Project xmlns="http://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>

Zobacz też