Tugas GenerateDeploymentManifest
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- ItaniumNilai 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- BackgroundNilai 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- WeeksParameter 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.