Elemen <deployment> (penyebaran ClickOnce)

Artikel
10/10/2023

Mengidentifikasi atribut yang digunakan untuk penyebaran pembaruan dan paparan sistem.

Sintaks


      <deployment
   install
   minimumRequiredVersion
   mapFileExtensions
   disallowUrlActivation
   trustUrlParameters
>
   <subscription>
         <update>
            <beforeApplicationStartup/>
            <expiration
               maximumAge
               unit
            />
         </update>
   </subscription>
   <deploymentProvider
      codebase
   />
</deployment>

Elemen dan atribut

Elemen deployment diperlukan dan berada di namespace layanan urn:schemas-microsoft-com:asm.v2. Elemen ini memiliki atribut berikut.

Atribut	Deskripsi
`install`	Harus diisi. Menentukan apakah aplikasi ini muncul di menu Mulai Windows dan di aplikasi Panel Kontrol Tambahkan atau Hapus Program. Nilai yang berlaku adalah `true` atau `false`. Jika `false`, ClickOnce akan selalu menjalankan versi terbaru aplikasi ini dari jaringan, dan tidak akan mengenali elemen `subscription`.
`minimumRequiredVersion`	Opsional. Menentukan versi minimum dari aplikasi ini yang dapat berjalan di komputer klien. Jika nomor versi aplikasi kurang dari nomor versi yang disediakan dalam manifes penyebaran, maka aplikasi tidak akan berjalan. Nomor versi harus ditentukan dalam format `N.N.N.N`, di mana `N` adalah bilangan bulat tidak bertanda. Jika atribut `install` adalah `false`, maka `minimumRequiredVersion` tidak boleh diatur.
`mapFileExtensions`	Opsional. Default ke `false`. Jika `true`, maka semua file dalam penyebaran harus memiliki ekstensi .deploy. ClickOnce akan menghapus ekstensi ini dari file-file ini segera setelah mengunduhnya dari server Web. Jika Anda menerbitkan aplikasi menggunakan Visual Studio, aplikasi secara otomatis akan menambahkan ekstensi ini ke semua file. Parameter ini memungkinkan semua file dalam penyebaran ClickOnce diunduh dari server Web, yang akan memblokir transmisi file yang berakhiran ekstensi "tidak aman" seperti .exe.
`disallowUrlActivation`	Opsional. Default ke `false`. Jika `true`, mencegah aplikasi yang diinstal dimulai dengan mengklik URL atau memasukkan URL ke browser. Jika atribut `install` tidak ada, atribut ini diabaikan.
`trustURLParameters`	Opsional. Default ke `false`. Jika `true`, memungkinkan untuk URL berisikan parameter string kueri yang diteruskan ke aplikasi, sama seperti argumen baris perintah yang diteruskan ke aplikasi baris perintah. Untuk informasi selengkapnya, lihat Cara: Mengambil Informasi String Kueri dalam Aplikasi ClickOnce Online. Jika atribut `disallowUrlActivation` adalah `true`, maka `trustUrlParameters` harus dikecualikan dari manifes, atau secara eksplisit diatur ke `false`.

Elemen deployment juga berisi elemen-elemen turunan berikut.

langganan

Opsional. Berisi elemen update. Elemen subscription tidak memiliki atribut. Jika elemen subscription tidak ada, aplikasi ClickOnce tidak akan pernah memindai pembaruan. Jika atribut install dari elemen deployment adalah false, maka elemen subscription diabaikan, karena aplikasi ClickOnce yang diluncurkan dari jaringan selalu menggunakan versi terbaru.

update

Harus diisi. Elemen ini adalah turunan dari elemen subscription dan berisikan elemen beforeApplicationStartup atau elemen expiration. beforeApplicationStartup dan expiration tidak dapat ditentukan dalam manifes penyebaran yang sama.

Elemen update tidak memiliki atribut.

beforeApplicationStartup

Opsional. Elemen ini adalah turunan elemen update dan tidak memiliki atribut. Ketika terdapat elemen beforeApplicationStartup, aplikasi akan diblokir saat ClickOnce memeriksa pembaruan, jika klien online. Jika elemen ini tidak ada, ClickOnce akan terlebih dahulu memindai pembaruan berdasarkan nilai yang ditentukan untuk elemen expiration. beforeApplicationStartup dan expiration tidak dapat ditentukan dalam manifes penyebaran yang sama.

kedaluwarsa

Opsional. Elemen ini adalah turunan dari elemen update, dan tidak memiliki turunan. beforeApplicationStartup dan expiration tidak dapat ditentukan dalam manifes penyebaran yang sama. Saat pemeriksaan pembaruan terjadi dan versi yang diperbarui terdeteksi, versi baru akan disimpan dalam cache saat versi yang ada berjalan. Versi baru kemudian akan diinstal pada peluncuran aplikasi ClickOnce berikutnya.

Elemen expiration mendukung atribut berikut.

Atribut	Deskripsi
`maximumAge`	Harus diisi. Mengidentifikasi berapa lama seharusnya pembaruan saat ini berlangsung sebelum aplikasi melakukan pemeriksaan pembaruan. Unit waktu ditentukan oleh atribut `unit`.
`unit`	Harus diisi. Mengidentifikasi unit waktu untuk `maximumAge`. Unit yang valid adalah `hours`, `days`, `weeks`.

deploymentProvider

Untuk .NET Framework 2.0, elemen ini bersifat wajib jika manifes penyebaran berisi bagian subscription. Untuk .NET Framework 3.5 dan yang lebih baru, elemen ini bersifat opsional, dan akan menjadi default ke server dan jalur file tempat manifes penyebaran ditemukan.

Elemen ini adalah turunan elemen deployment dan memiliki atribut berikut.

Atribut	Deskripsi
`codebase`	Harus diisi. Mengidentifikasi lokasi, sebagai Pengidentifikasi Sumber Daya Seragam (URI), dari manifes penyebaran yang digunakan untuk memperbarui aplikasi ClickOnce. Elemen ini juga memungkinkan untuk meneruskan lokasi pembaruan bagi penginstalan berbasis CD. Harus berupa URI yang valid.

Keterangan

Anda dapat mengonfigurasi aplikasi ClickOnce untuk memindai pembaruan saat memulai, memindai pembaruan setelah memulai, atau tidak pernah memeriksa pembaruan. Untuk memindai pembaruan saat memindai, pastikan bahwa elemen beforeApplicationStartup ada di bawah elemen update. Untuk memindai pembaruan setelah memulai, pastikan bahwa elemen expiration ada di bawah elemen update, dan menyediakan interval pembaruan.

Untuk menonaktifkan pemeriksaan pembaruan, hapus elemen subscription. Saat Anda menentukan untuk tidak pernah memindai pembaruan dalam manifes penyebaran, Anda masih dapat memeriksa pembaruan secara manual dengan menggunakan metode CheckForUpdate.

Catatan

Kelas ApplicationDeployment dan API di System.Deployment.Application namespace tidak didukung dalam .NET Core dan .NET 5 dan versi yang lebih baru. Di .NET 7, metode baru untuk mengakses properti penyebaran aplikasi didukung. Untuk informasi selengkapnya, lihat Properti penyebaran Access ClickOnce di .NET. .NET 7 tidak mendukung metode ApplicationDeployment yang setara.

Untuk informasi selengkapnya tentang bagaimana deploymentProvider berkaitan dengan pembaruan, lihat Memilih Strategi Pembaruan ClickOnce.

Contoh

Contoh kode berikut mengilustrasikan elemen deployment dalam manifes penyebaran ClickOnce. Contoh ini menggunakan elemen deploymentProvider untuk menunjukkan lokasi pembaruan yang diinginkan.

<deployment install="true" minimumRequiredVersion="2.0.0.0" mapFileExtension="true" trustUrlParameters="true">
    <subscription>
      <update>
        <expiration maximumAge="6" unit="hours" />
      </update>
    </subscription>
    <deploymentProvider codebase="http://www.adatum.com/MyApplication.application" />
  </deployment>

Lihat juga

Manifes penyebaran ClickOnce

Bagikan melalui