Tugas GenerateDeploymentManifest

  • Artikel

Hasilkan manifes penyebaran ClickOnce. Manifes penyebaran ClickOnce menjelaskan penyebaran aplikasi dengan mendefinisikan identitas unik untuk penyebaran, mengidentifikasi sifat penyebaran seperti mode instal atau daring, menentukan pengaturan pembaruan aplikasi dan lokasi pembaruan, dan menunjukkan manifes aplikasi ClickOnce yang sesuai.

Parameter

Tabel berikut menjelaskan parameter untuk tugas tersebut GenerateDeploymentManifest.

Parameter Deskripsi
AssemblyName Parameter String opsional.

Menentukan Name bidang identitas perakitan untuk manifes yang dihasilkan. Jika parameter ini tidak ditentukan, nama disimpulkan EntryPoint dari parameter atau InputManifest. Jika nama tidak dapat disimpulkan, tugas akan menampilkan kesalahan.
AssemblyVersion Parameter String opsional.

Menentukan Version bidang identitas perakitan untuk manifes yang dihasilkan. Jika parameter ini tidak ditentukan, tugas menggunakan nilai “1.0.0.0”.
CreateDesktopShortcut Parameter Boolean opsional.

Jika true, ikon dibuat di desktop selama penginstalan aplikasi ClickOnce.
DeploymentUrl Parameter String opsional.

Menentukan lokasi pembaruan untuk aplikasi. Jika parameter ini tidak ditentukan, tidak ada lokasi pembaruan yang ditentukan untuk aplikasi. Namun, jika UpdateEnabled parameternya adalah true, lokasi pembaruan harus ditentukan. Nilai yang ditentukan harus berupa URL yang sepenuhnya memenuhi syarat atau jalur UNC.
Description Parameter String opsional.

Menentukan deskripsi opsional untuk aplikasi.
DisallowUrlActivation Parameter Boolean opsional.

Menentukan apakah aplikasi harus dijalankan secara otomatis saat dibuka melalui URL. Jika parameter ini adalah true, aplikasi hanya dapat dimulai dari menu Mulai. Nilai default dari parameter ini adalah false. Input ini hanya berlaku ketika Install nilai parameter adalah true.
EntryPoint Parameter ITaskItem[] opsional.

Menunjukkan titik masuk untuk perakitan manifes yang dihasilkan. Untuk manifes penyebaran ClickOnce, input ini menentukan manifes aplikasi ClickOnce.

EntryPoint Jika parameter tugas tidak ditentukan, <customHostSpecified> tag disisipkan sebagai anak dari <entryPoint> tag, misalnya:

<entryPoint xmlns="urn:schemas-microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

Anda dapat menambahkan dependensi DLL ke manifes aplikasi dengan menggunakan langkah-langkah berikut:

1. Selesaikan referensi rakitan dengan panggilan ke ResolveAssemblyReference.
2. Berikan output tugas sebelumnya dan rakitan itu sendiri ke ResolveManifestFiles.
3. Berikan dependensi dengan menggunakan Dependencies parameter ke GenerateApplicationManifest.
ErrorReportUrl Parameter System.String opsional.

Menentukan URL halaman web yang ditampilkan dalam kotak dialog selama laporan kesalahan dalam penginstalan ClickOnce.
InputManifest Parameter ITaskItem opsional.

Menunjukkan dokumen XML input untuk berfungsi sebagai basis untuk generator manifes. Ini memungkinkan data terstruktur, seperti definisi manifes kustom, untuk tercermin dalam manifes output. Elemen akar dalam dokumen XML harus merupakan simpul rakitan di namespace asmv1.
Install Parameter Boolean opsional.

Menentukan apakah aplikasi adalah aplikasi yang diinstal atau aplikasi daring-saja. Jika parameter ini adalah true, aplikasi akan diinstal pada menu Mulai pengguna, dan dapat dihapus dengan menggunakan kotak dialog Tambahkan atau Hapus Program. Jika parameter ini adalah false, aplikasi ditujukan untuk penggunaan daring dari halaman web. Nilai default dari parameter ini adalah true.
MapFileExtensions Parameter Boolean opsional.

Menentukan apakah pemetaan ekstensi nama file .deploy digunakan. Jika parameter ini adalah true, setiap file program diterbitkan dengan ekstensi nama file .deploy. Opsi ini berguna untuk keamanan server web untuk membatasi jumlah ekstensi nama file yang harus dibuka blokirnya untuk mengaktifkan penyebaran aplikasi ClickOnce. Nilai default dari parameter ini adalah false.
MaxTargetPath Parameter String opsional.

Menentukan panjang maksimum jalur file yang diizinkan dalam penyebaran aplikasi ClickOnce. Jika nilai ini ditentukan, panjang setiap jalur file dalam aplikasi diperiksa sesuai batas ini. Item apa pun yang melebihi batas akan dinaikkan ke peringatan build. Jika input ini tidak ditentukan atau nol, maka tidak ada pemeriksaan yang dilakukan.
MinimumRequiredVersion Parameter String opsional.

Menentukan apakah pengguna dapat melewati pembaruan. Jika pengguna memiliki versi yang kurang dari minimum yang diperlukan, ia tidak akan memiliki opsi untuk melewati pembaruan. Input ini hanya berlaku ketika nilai Install parameter adalah true.
OutputManifest Parameter ITaskItem opsional.

Menentukan nama file manifes output yang dihasilkan. Jika parameter ini tidak ditentukan, nama file output disimpulkan dari identitas manifes yang dihasilkan.
Platform Parameter String opsional.

Menentukan platform target aplikasi. Parameter ini dapat memiliki nilai berikut:

- AnyCPU
- x86
- x64
- Itanium

Nilai defaultnya adalah AnyCPU.
Product Parameter String opsional.

Menentukan nama aplikasi. Jika parameter ini tidak ditentukan, nama disimpulkan dari identitas manifes yang dihasilkan. Nama ini digunakan untuk nama pintasan pada menu Mulai dan merupakan bagian dari nama yang muncul dalam kotak dialog Tambahkan atau Hapus Program.
Publisher Parameter String opsional.

Menentukan penerbit aplikasi. Jika parameter ini tidak ditentukan, nama disimpulkan dari pengguna terdaftar atau identitas manifes yang dihasilkan. Nama ini digunakan untuk nama folder pada menu Mulai dan merupakan bagian dari nama yang muncul dalam kotak dialog Tambahkan atau Hapus Program.
SuiteNamel Parameter String opsional.

Menentukan nama folder pada menu Mulai tempat aplikasi berada setelah penyebaran ClickOnce.
SupportUrl Parameter String opsional.

Menentukan tautan yang muncul di Tambah atau Hapus Program untuk aplikasi ClickOnce. Nilai yang ditentukan harus berupa URL yang sepenuhnya memenuhi syarat atau jalur UNC.
TargetCulture Parameter String opsional.

Mengidentifikasi budaya aplikasi dan menentukan Language bidang identitas perakitan untuk manifes yang dihasilkan. Jika parameter ini tidak ditentukan, diasumsikan bahwa aplikasi tersebut invarian budaya.
TrustUrlParameters Parameter Boolean opsional.

Menentukan apakah parameter string kueri URL harus tersedia untuk aplikasi. Nilai default parameter ini adalah false, yang menunjukkan bahwa parameter tidak akan tersedia untuk aplikasi.
UpdateEnabled Parameter Boolean opsional.

Menunjukkan apakah aplikasi diaktifkan untuk pembaruan. Nilai default dari parameter ini adalah false. Input ini hanya berlaku ketika nilai Install parameter adalah true.
UpdateInterval Parameter Int32 opsional.

Menentukan lokasi pembaruan untuk aplikasi. Nilai default dari parameter ini adalah nol. Parameter ini hanya berlaku ketika nilai Install parameter dan UpdateEnabled keduanya trueadalah.
UpdateMode Parameter String opsional.

Menentukan apakah pembaruan harus diperiksa di latar depan sebelum aplikasi dimulai, atau di latar belakang saat aplikasi berjalan. Parameter ini dapat memiliki nilai berikut:

- Foreground
- Background

Nilai default dari parameter ini adalah Background. Parameter ini hanya berlaku ketika nilai Install parameter dan UpdateEnabled keduanya trueadalah.
UpdateUnit Parameter String opsional.

Menentukan unit untuk UpdateInterval parameter. Parameter ini dapat memiliki nilai berikut:

- Hours
- Days
- Weeks

Parameter ini hanya berlaku ketika nilai Install parameter dan UpdateEnabled keduanya trueadalah.

Keterangan

Selain parameter yang tercantum di atas, tugas ini mewarisi parameter dari kelas GenerateManifestBase, yang mewarisi sendiri dari kelas Task. Untuk daftar parameter kelas Tugas, lihat Kelas dasar tugas.

Baca juga