<dependency> öğesi (ClickOnce dağıtımı)

Makale
01/12/2024

Yüklenecek uygulamanın sürümünü ve uygulama bildiriminin konumunu tanımlar.

Sözdizimi


      <dependency>
   <dependentAssembly
      preRequisite
      visible
      dependencyType
      codeBase
      size
   >
      <assemblyIdentity
         name
         version
         publicKeyToken
         processorArchitecture
         language
         type
      />
      <hash>
         <dsig:Transforms>
            <dsig:Transform
                Algorithm
            />
         </dsig:Transforms>
         <dsig:DigestMethod />
         <dsig:DigestValue>
         </dsig:DigestValue>
      </hash>

   </dependentAssembly>
</dependency>

Öğeler ve öznitelikler

dependency öğesi gereklidir. Öznitelikleri yok. Dağıtım bildiriminde birden çok dependency öğe olabilir.

dependency öğesi genellikle bir ClickOnce uygulamasında bulunan derlemelerde ana uygulama için bağımlılıkları ifade eder. Main.exe uygulamanız DotNetAssembly.dll adlı bir derleme tüketiyorsa, bu derleme bir bağımlılık bölümünde listelenmelidir. Ancak bağımlılık, ortak dil çalışma zamanının belirli bir sürümüne, genel derleme önbelleğindeki (GAC) bir derlemeye veya COM nesnesine bağımlılıklar gibi diğer bağımlılık türlerini de ifade edebilir. Dokunmadan dağıtım teknolojisi olduğundan ClickOnce bu tür bağımlılıkların indirilmesini ve yüklenmesini başlatamaz, ancak belirtilen bağımlılıklardan biri veya daha fazlası yoksa uygulamanın çalışmasını engeller.

Dependentassembly

Gerekli. Bu öğe öğesini assemblyIdentity içerir. Aşağıdaki tabloda, desteklediği öznitelikler gösterilmektedir dependentAssembly .

Öznitelik	Açıklama
`preRequisite`	isteğe bağlı. Bu derlemenin GAC'de zaten var olması gerektiğini belirtir. Geçerli değerler: `true` ve `false`. ve `true`belirtilen derleme GAC'de yoksa, uygulama çalıştırılamaz.
`visible`	isteğe bağlı. Bağımlılıkları dahil olmak üzere en üst düzey uygulama kimliğini tanımlar. Uygulama depolamayı ve etkinleştirmeyi yönetmek için ClickOnce tarafından dahili olarak kullanılır.
`dependencyType`	Gerekli. Bu bağımlılık ile uygulama arasındaki ilişki. Geçerli değerler: - `install`. Bileşen, geçerli uygulamadan ayrı bir yüklemeyi temsil eder. - `preRequisite`. Bileşen geçerli uygulama için gereklidir.
`codebase`	isteğe bağlı. Uygulama bildiriminin tam yolu.
`size`	isteğe bağlı. Uygulama bildiriminin bayt cinsinden boyutu.

Assemblyıdentity

Gerekli. Bu öğe, öğesinin dependentAssembly alt öğesidir. öğesinin assemblyIdentity içeriği, ClickOnce uygulama bildiriminde açıklananla aynı olmalıdır. Aşağıdaki tabloda öğesinin öznitelikleri gösterilmektedir assemblyIdentity .

Öznitelik	Açıklama
`Name`	Gerekli. Uygulamanın adını tanımlar.
`Version`	Gerekli. Uygulamanın sürüm numarasını aşağıdaki biçimde belirtir: `major.minor.build.revision`
`publicKeyToken`	Gerekli. Uygulamanın veya derlemenin imzalandığı ortak anahtarın SHA-1 karmasının son 8 baytını temsil eden 16 karakterlik onaltılık dizeyi belirtir. İmza için kullanılan ortak anahtar 2048 bit veya daha büyük olmalıdır.
`processorArchitecture`	Gerekli. Mikro işlemciyi belirtir. Geçerli değerler `x86` 32 bit Windows ve `IA64` 64 bit Windows içindir.
`Language`	isteğe bağlı. Derlemenin iki parçalı dil kodlarını tanımlar. Örneğin, İngilizce (ABD) anlamına gelen EN-US. Varsayılan değer: `neutral`. Bu öğe ad alanındadır `asmv2` .
`type`	isteğe bağlı. Windows yan yana yükleme teknolojisiyle geriye dönük uyumluluk için. İzin verilen tek değerdir `win32`.

hash

hash öğesi, öğesinin file isteğe bağlı bir alt öğesidir. öğesinin hash özniteliği yok.

ClickOnce, dağıtımdan sonra dosyaların hiçbirinin değiştirilmediğinden emin olmak için bir uygulamadaki tüm dosyaların algoritmik karmasını güvenlik denetimi olarak kullanır. hash Öğesi dahil değilse, bu denetim gerçekleştirilmeyecektir. Bu nedenle, öğesinin atlanması hash önerilmez.

dsig:Dönüşümler

dsig:Transforms öğesi, öğesinin hash gerekli bir alt öğesidir. öğesinin dsig:Transforms özniteliği yok.

dsig:Transform

dsig:Transform öğesi, öğesinin dsig:Transforms gerekli bir alt öğesidir. Aşağıdaki tabloda öğesinin öznitelikleri gösterilmektedir dsig:Transform .

Öznitelik	Açıklama
`Algorithm`	Bu dosyanın özetini hesaplamak için kullanılan algoritma. Şu anda ClickOnce tarafından kullanılan tek değerdir `urn:schemas-microsoft-com:HashTransforms.Identity`.

dsig:DigestMethod

dsig:DigestMethod öğesi, öğesinin hash gerekli bir alt öğesidir. Aşağıdaki tabloda öğesinin öznitelikleri gösterilmektedir dsig:DigestMethod .

Öznitelik	Açıklama
`Algorithm`	Bu dosyanın özetini hesaplamak için kullanılan algoritma. Şu anda ClickOnce tarafından kullanılan tek değerdir `http://www.w3.org/2000/09/xmldsig#sha1`.

dsig:DigestValue

dsig:DigestValue öğesi, öğesinin hash gerekli bir alt öğesidir. öğesinin dsig:DigestValue özniteliği yok. Metin değeri, belirtilen dosyanın hesaplanan karmasıdır.

Açıklamalar

Dağıtım bildirimleri genellikle uygulama bildiriminin adını ve sürümünü tanımlayan tek assemblyIdentity bir öğeye sahiptir.

Örnek 1

Aşağıdaki kod örneği, ClickOnce dağıtım bildirimindeki bir dependency öğeyi gösterir.

<!-- Identify the assembly dependencies -->
<dependency>
  <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="MyApplication.exe" size="16384">
    <assemblyIdentity name="MyApplication" version="0.0.0.0" cultural="neutral" processorArchitecture="msil" />
    <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>YzXYZJAvj9pgAG3y8jXUjC7AtHg=</dsig:DigestValue>
    </hash>
  </dependentAssembly>
</dependency>

Örnek 2

Aşağıdaki kod örneği, GAC'de zaten yüklü olan bir derlemeye bağımlılığı belirtir.

<dependency>
  <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true">
    <assemblyIdentity name="GACAssembly" version="1.0.0.0" language="neutral" processorArchitecture="msil" />
  </dependentAssembly>
</dependency>

Örnek 3

Aşağıdaki kod örneği, ortak dil çalışma zamanının belirli bir sürümüne bağımlılığı belirtir.

<dependency>
  <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true">
    <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="2.0.50215.0" />
  </dependentAssembly>
</dependency>

Örnek 4

Aşağıdaki kod örneği bir işletim sistemi bağımlılığını belirtir.

<dependency>
   <dependentOS supportUrl="http://www.microsoft.com" description="Microsoft Windows Operating System">
      <osVersionInfo>
         <os majorVersion="4" minorVersion="10" />
      </osVersionInfo>
   </dependentOS>
</dependency>

Aracılığıyla paylaş