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 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
maupunApplicationFile
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 metadataProductName
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 adaApplicationFile
yang ditentukan. Anda harus menyertakan satu item untuk setiap prasyarat yang harus diinstal untuk aplikasi Anda.Kesalahan build akan mengakibatkan parameter
BootstrapperItems
maupunApplicationFile
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 inputComponentsUrl
.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 parameterOutputPath
. Nilai parameterBootstrapperComponentFiles
semuanya harus didasarkan pada jalur ini. Jikafalse
, file tidak disalin, dan nilaiBootstrapperComponentFiles
didasarkan pada nilai parameterPath
. Nilai default dari parameter ini adalahtrue
.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 adalahfalse
.
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>