Elemen <dependency> (aplikasi ClickOnce)

Artikel
10/10/2023

Mengidentifikasi platform atau dependensi perakitan yang diperlukan untuk aplikasi.

Sintaks


      <dependency>
   <dependentOS
      supportURL
      description
   >
      <osVersionInfo>
         <os
            majorVersion
            minorVersion
            buildNumber
            servicePackMajor
            servicePackMinor
            productType
            suiteType
         />
      </osVersionInfo>
   </dependentOS>
   <dependentAssembly
      dependencyType
      allowDelayedBinding
      group
      codeBase
      size
   >
      <assemblyIdentity
         name
         version
         processorArchitecture
         language
      >
         <hash>
            <dsig:Transforms>
               <dsig:Transform
                  Algorithm
            />
            </dsig:Transforms>
            <dsig:DigestMethod />
            <dsig:DigestValue>
            </dsig:DigestValue>
    </hash>

      </assemblyIdentity>
   </dependentAssembly>
</dependency>

Elemen dan atribut

dependency Elemen diperlukan. Mungkin ada beberapa instans dependency di manifes aplikasi yang sama.

Elemen dependency tidak memiliki atribut, dan berisi elemen turunan berikut.

dependentOS

Opsional. Berisi elemen osVersionInfo. Elemen dependentOS dan dependentAssembly saling eksklusif: satu atau yang lain harus ada untuk elemen dependency, tetapi tidak keduanya.

dependentOS mendukung atribut berikut.

Atribut	Deskripsi
`supportUrl`	Opsional. Menentukan URL dukungan untuk platform dependen. URL ini ditampilkan kepada pengguna jika platform yang diperlukan ditemukan.
`description`	Opsional. Menjelaskan, dalam bentuk yang dapat dibaca manusia, sistem operasi yang dijelaskan oleh elemen `dependentOS`.

osVersionInfo

Harus diisi. Elemen ini adalah turunan dari elemen dependentOS dan berisi elemen os. Elemen ini tidak memiliki atribut.

os

Harus diisi. Elemen ini adalah turunan dari elemen osVersionInfo. Elemen ini memiliki atribut berikut.

Atribut	Deskripsi
`majorVersion`	Harus diisi. Menentukan nomor versi utama OS.
`minorVersion`	Harus diisi. Menentukan nomor versi minor OS.
`buildNumber`	Harus diisi. Menentukan nomor build OS.
`servicePackMajor`	Harus diisi. Menentukan nomor utama paket layanan OS.
`servicePackMinor`	Opsional. Menentukan nomor minor paket layanan OS.
`productType`	Opsional. Mengidentifikasi nilai jenis produk. Nilai yang valid adalah `server`, `workstation`, dan `domainController`. Misalnya, untuk Windows 10, nilai atribut ini adalah `workstation`.
`suiteType`	Opsional. Mengidentifikasi rangkaian produk yang tersedia pada sistem, atau jenis konfigurasi sistem. Nilai yang valid adalah `backoffice`, `blade`, `datacenter`, `enterprise`, `home`, `professional`, `smallbusiness`, `smallbusinessRestricted`, dan `terminal`. Misalnya, untuk Windows 2000 Professional, nilai atribut ini adalah `professional`.

dependenAssembly

Opsional. Berisi elemen assemblyIdentity. Elemen dependentOS dan dependentAssembly saling eksklusif: satu atau yang lain harus ada untuk elemen dependency, tetapi tidak keduanya.

dependentAssembly memiliki atribut berikut.

Atribut	Deskripsi
`dependencyType`	Harus diisi. Menentukan jenis dependensi. Nilai yang berlaku adalah `prerequisite` atau `install`. Rakitan `install` diinstal sebagai bagian aplikasi ClickOnce. Rakitan `prerequisite` harus ada di singgahan perakitan global (GAC) sebelum aplikasi ClickOnce bisa menginstal.
`allowDelayedBinding`	Harus diisi. Menentukan apakah rakitan bisa dimuat secara terprogram selama durasi.
`group`	Opsional. Jika atribut `dependencyType` diatur ke `install`, menunjuk grup rakitan bernama yang menginstal sesuai permintaan. Untuk informasi selengkapnya, lihat Panduan: Mengunduh Rakitan sesuai Permintaan dengan API Penyebaran ClickOnce Menggunakan Perancang. Jika diatur ke `framework` dan atribut `dependencyType` diatur ke `prerequisite`, menunjuk perakitan sebagai bagian .NET Framework. Cache rakitan global (GAC) tidak diperiksa untuk perakitan ini saat menginstal pada .NET Framework 4 dan versi yang lebih baru.
`codeBase`	Diperlukan saat atribut `dependencyType` diatur ke `install`. Jalur ke rakitan dependen. Mungkin jalur absolut, atau jalur yang relatif terhadap basis kode manifes. Jalur ini harus berupa URI yang valid agar manifes rakitan valid.
`size`	Diperlukan saat atribut `dependencyType` diatur ke `install`. Ukuran rakitan dependen, dalam byte.

assemblyIdentity

Harus diisi. Elemen ini adalah turunan elemen dependentAssembly dan memiliki atribut berikut.

Atribut	Deskripsi
`name`	Harus diisi. Mengidentifikasi nama aplikasi.
`version`	Harus diisi. Menentukan nomor versi aplikasi dalam format berikut: `major.minor.build.revision`
`publicKeyToken`	Opsional. Menentukan string heksadesimal 16 karakter yang mewakili 8 byte terakhir nilai hash `SHA-1` kunci umum tempat aplikasi atau rakitan ditandatangani. Kunci umum yang digunakan untuk menandatangani katalog harus 2048 bit atau lebih.
`processorArchitecture`	Opsional. Menentukan prosesor. Nilai yang valid adalah `x86` untuk Windows 32-bit dan `I64` untuk Windows 64-bit.
`language`	Opsional. Mengidentifikasi dua kode bahasa bagian, seperti EN-US, rakitan.

Hash

Elemen hash adalah turunan opsional elemen assemblyIdentity. Elemen hash tidak memiliki atribut.

ClickOnce menggunakan algoritma hash untuk semua file di aplikasi sebagai pemeriksaan keamanan, untuk memastikan bahwa tidak ada file yang diubah setelah penyebaran. Jika elemen hash tidak disertakan, pemeriksaan ini tidak akan dilakukan. Oleh karena itu, tidak disarankan untuk menghilangkan elemen hash.

dsig:Transforms

Elemen dsig:Transforms adalah turunan yang diperlukan elemen hash. Elemen dsig:Transforms tidak memiliki atribut.

dsig:Transform

Elemen dsig:Transform adalah turunan yang diperlukan elemen dsig:Transforms. Elemen dsig:Transform memiliki atribut berikut.

Atribut	Deskripsi
`Algorithm`	Algoritma digunakan untuk menghitung hash untuk file ini. Satu-satunya nilai saat ini yang digunakan oleh ClickOnce adalah `urn:schemas-microsoft-com:HashTransforms.Identity`.

dsig:DigestMethod

Elemen dsig:DigestMethod adalah turunan yang diperlukan elemen hash. Elemen dsig:DigestMethod memiliki atribut berikut.

Atribut	Deskripsi
`Algorithm`	Algoritma digunakan untuk menghitung hash untuk file ini. Satu-satunya nilai saat ini yang digunakan oleh ClickOnce adalah `http://www.w3.org/2000/09/xmldsig#sha1`.

dsig:DigestValue

Elemen dsig:DigestValue adalah turunan yang diperlukan elemen hash. Elemen dsig:DigestValue tidak memiliki atribut. Nilai teksnya adalah hash yang dihitung untuk file yang ditentukan.

Keterangan

Semua rakitan yang digunakan aplikasi Anda harus memiliki elemen dependency yang sesuai. Rakitan dependen tidak menyertakan rakitan yang harus diinstal sebelumnya dalam singgahan perakitan global sebagai rakitan platform.

Contoh

Contoh kode berikut mengilustrasikan elemen dependency di manifes aplikasi ClickOnce. Contoh kode ini adalah bagian dari contoh besar yang disediakan untuk topik Manifes Aplikasi ClickOnce.

<dependency>
  <dependentOS>
    <osVersionInfo>
      <os
        majorVersion="4"
        minorVersion="10"
        buildNumber="0"
        servicePackMajor="0" />
    </osVersionInfo>
  </dependentOS>
</dependency>
<dependency>
  <dependentAssembly
    dependencyType="preRequisite"
    allowDelayedBinding="true">
    <assemblyIdentity
      name="Microsoft.Windows.CommonLanguageRuntime"
      version="4.0.20506.0" />
  </dependentAssembly>
</dependency>

<dependency>
  <dependentAssembly
    dependencyType="install"
    allowDelayedBinding="true"
    codebase="MyApplication.exe"
    size="4096">
    <assemblyIdentity
      name="MyApplication"
      version="1.0.0.0"
      language="neutral"
      processorArchitecture="x86" />
    <hash>
      <dsig:Transforms>
        <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
      </dsig:Transforms>
      <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
      <dsig:DigestValue>DpTW7RzS9IeT/RBSLj54vfTEzNg=</dsig:DigestValue>
    </hash>
  </dependentAssembly>
</dependency>

Bagikan melalui