Tugas GenerateBootstrapper

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 GenerateBootstrapper tugas.

  • ApplicationFile

    Parameter opsional String .

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

  • ApplicationName

    Parameter opsional String .

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

  • ApplicationRequiresElevation

    Parameter opsional Boolean .

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

  • ApplicationUrl

    Parameter opsional String .

    Menentukan lokasi Web yang menghosting alat penginstal aplikasi.

  • BootstrapperComponentFiles

    Parameter output opsional String[] .

    Menentukan lokasi bawaan file paket bootstrapper.

  • BootstrapperItems

    Parameter opsional ITaskItem[] .

    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. Metadata ProductName item 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 ApplicationFile ditentukan. Anda harus menyertakan satu item untuk setiap prasyarat yang harus diinstal untuk aplikasi Anda.

    Kesalahan build akan mengakibatkan BootstrapperItems tidak ada parameter maupun ApplicationFile yang ditentukan.

  • BootstrapperKeyFile

    Parameter output opsional String .

    Menentukan lokasi bawaansetup.exe

  • ComponentsLocation

    Parameter opsional String .

    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 ComponentsUrl parameter input.

      Jika ComponentsLocation tidak ditentukan, HomeSite digunakan secara default.

  • ComponentsUrl

    Parameter opsional String .

    Menentukan URL yang berisi prasyarat penginstalan.

  • CopyComponents

    Parameter opsional Boolean .

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

  • Culture

    Parameter opsional String .

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

  • FallbackCulture

    Parameter opsional String .

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

  • OutputPath

    Parameter opsional String .

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

  • Path

    Parameter opsional String .

    Menentukan lokasi semua paket prasyarat yang tersedia.

  • SupportUrl

    Parameter opsional String .

    Menentukan URL yang akan disediakan jika penginstalan bootstrapper gagal.

  • Validate

    Parameter opsional Boolean .

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

Komentar

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

Example

Contoh berikut menggunakan GenerateBootstrapper tugas untuk menginstal aplikasi yang harus menginstal .NET Framework 4.8 sebagai prasyarat.

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

Lihat juga

  • Last updated on