Tugas GenerateBootstrapper

  • Artikel

Menyediakan cara otomatis untuk mendeteksi, mengunduh, dan menginstal aplikasi dan prasyaratnya. Ini berfungsi sebagai alat penginstal tunggal yang mengintegrasikan alat penginstal terpisah untuk semua komponen yang membentuk aplikasi.

Parameter tugas

Berikut ini menjelaskan parameter tugas GenerateBootstrapper.

  • ApplicationFile

    Parameter String opsional.

    Menentukan file yang akan digunakan bootstrapper untuk memulai penginstalan aplikasi setelah semua prasyarat terinstal. Kesalahan build akan mengakibatkan parameter BootstrapperItems maupun ApplicationFile yang ditentukan.

  • ApplicationName

    Parameter String opsional.

    Menentukan nama aplikasi yang akan diinstal bootstrapper. Nama ini akan muncul di UI yang digunakan bootstrapper selama penginstalan.

  • ApplicationRequiresElevation

    Parameter Boolean opsional.

    Jika true, komponen berjalan dengan izin yang ditingkatkan saat diinstal pada komputer target.

  • ApplicationUrl

    Parameter String opsional.

    Menentukan lokasi Web yang menghosting alat penginstal aplikasi.

  • BootstrapperComponentFiles

    Parameter output String[] opsional.

    Menentukan lokasi bawaan file paket bootstrapper.

  • BootstrapperItems

    Parameter ITaskItem[] opsional.

    Menentukan produk yang akan dibangun ke dalam bootstrapper. Item yang diteruskan ke parameter ini harus memiliki sintaks berikut:

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

    Atribut Include mewakili nama prasyarat yang harus diinstal. Item metadata ProductName bersifat opsional, dan akan digunakan oleh mesin build sebagai nama yang mudah digunakan jika paket tidak dapat ditemukan. Item ini tidak diperlukan parameter input MSBuild, kecuali tidak ada ApplicationFile yang ditentukan. Anda harus menyertakan satu item untuk setiap prasyarat yang harus diinstal untuk aplikasi Anda.

    Kesalahan build akan mengakibatkan parameter BootstrapperItems maupun ApplicationFile yang ditentukan.

  • BootstrapperKeyFile

    Parameter output String opsional.

    Menentukan lokasi setup.exe bawaan

  • ComponentsLocation

    Parameter String opsional.

    Menentukan lokasi untuk bootstrapper untuk mencari prasyarat penginstalan yang akan diinstal. Parameter ini dapat memiliki nilai berikut:

    • HomeSite: Menunjukkan bahwa prasyarat sedang dihosting oleh vendor komponen.

    • Relative: Menunjukkan bahwa prasyarat berada di lokasi aplikasi yang sama.

    • Absolute: Menunjukkan bahwa semua komponen harus ditemukan di URL terpusat. Nilai ini harus digunakan bersama dengan parameter input ComponentsUrl.

      Jika ComponentsLocation tidak ditentukan, HomeSite digunakan secara default.

  • ComponentsUrl

    Parameter String opsional.

    Menentukan URL yang berisi prasyarat penginstalan.

  • CopyComponents

    Parameter Boolean opsional.

    Jika true, bootstrapper menyalin semua file output ke jalur yang ditentukan dalam parameter OutputPath. Nilai parameter BootstrapperComponentFiles semuanya harus didasarkan pada jalur ini. Jika false, file tidak disalin, dan nilai BootstrapperComponentFiles didasarkan pada nilai parameter Path. Nilai default dari parameter ini adalah true.

  • Culture

    Parameter String opsional.

    Menentukan kultur yang akan digunakan untuk UI bootstrapper dan prasyarat penginstalan. Jika kultur yang ditentukan tidak tersedia, tugas menggunakan nilai parameter FallbackCulture.

  • FallbackCulture

    Parameter String opsional.

    Menentukan kultur sekunder yang akan digunakan untuk UI bootstrapper dan prasyarat penginstalan.

  • OutputPath

    Parameter String opsional.

    Menentukan lokasi untuk menyalin setup.exe dan semua file paket.

  • Path

    Parameter String opsional.

    Menentukan lokasi semua paket prasyarat yang tersedia.

  • SupportUrl

    Parameter String opsional.

    Menentukan URL yang akan disediakan jika penginstalan bootstrapper gagal.

  • Validate

    Parameter Boolean opsional.

    Jika true, bootstrapper melakukan validasi XSD pada item bootstrapper input yang ditentukan. Nilai default dari parameter ini adalah false.

Keterangan

Selain parameter yang tercantum di atas, tugas ini mewarisi parameter dari kelas TaskExtension, yang mewarisi sendiri dari kelas Task. Untuk daftar parameter tambahan ini dan deskripsinya, lihat kelas dasar TaskExtension.

Contoh

Contoh berikut menggunakan tugas GenerateBootstrapper untuk menginstal aplikasi yang harus diinstal oleh .NET Framework 2.0 sebagai prasyarat.

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

Baca juga