<dependency> öğesi (ClickOnce uygulaması)
Uygulama için gereken bir platform veya derleme bağımlılığını tanımlar.
Sözdizimi
<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>
Öğeler ve öznitelikler
dependency
öğesi gereklidir. Aynı uygulama bildiriminde birden çok örneği dependency
olabilir.
öğesinin dependency
özniteliği yoktur ve aşağıdaki alt öğeleri içerir.
dependentOS
isteğe bağlı. osVersionInfo
öğesini içerir. dependentOS
ve dependentAssembly
öğeleri birbirini dışlar: bir öğe için biri dependency
veya diğeri bulunmalıdır, ancak her ikisini birden içermemelidir.
dependentOS
aşağıdaki öznitelikleri destekler.
Öznitelik | Açıklama |
---|---|
supportUrl |
isteğe bağlı. Bağımlı platform için bir destek URL'si belirtir. Gerekli platform bulunursa bu URL kullanıcıya gösterilir. |
description |
isteğe bağlı. öğesi tarafından dependentOS açıklanan işletim sistemini insan tarafından okunabilir biçimde açıklar. |
osVersionInfo
Gerekli. Bu öğe öğesinin dependentOS
alt öğesidir ve öğesini içerir os
. Bu öğenin özniteliği yok.
Os
Gerekli. Bu öğe, öğesinin osVersionInfo
alt öğesidir. Bu öğe aşağıdaki özniteliklere sahiptir.
Öznitelik | Açıklama |
---|---|
majorVersion |
Gerekli. İşletim sisteminin ana sürüm numarasını belirtir. |
minorVersion |
Gerekli. İşletim sisteminin ikincil sürüm numarasını belirtir. |
buildNumber |
Gerekli. İşletim sisteminin derleme numarasını belirtir. |
servicePackMajor |
Gerekli. İşletim sisteminin hizmet paketi ana numarasını belirtir. |
servicePackMinor |
isteğe bağlı. İşletim sisteminin hizmet paketi ikincil numarasını belirtir. |
productType |
isteğe bağlı. Ürün türü değerini tanımlar. Geçerli değerler: server , workstation ve domainController . Örneğin, Windows 10 için bu öznitelik değeri şeklindedir workstation . |
suiteType |
isteğe bağlı. Sistemde veya sistemin yapılandırma türünde kullanılabilen bir ürün paketini tanımlar. Geçerli değerler : , , , , , , professional , smallbusiness , smallbusinessRestricted ve terminal . home enterprise datacenter blade backoffice Örneğin, Windows 2000 Professional için bu öznitelik değeri şeklindedir professional . |
Dependentassembly
isteğe bağlı. assemblyIdentity
öğesini içerir. dependentOS
ve dependentAssembly
öğeleri birbirini dışlar: bir öğe için biri dependency
veya diğeri bulunmalıdır, ancak her ikisini birden içermemelidir.
dependentAssembly
aşağıdaki özniteliklere sahiptir.
Öznitelik | Açıklama |
---|---|
dependencyType |
Gerekli. Bağımlılık türünü belirtir. Geçerli değerler: prerequisite ve install . ClickOnce install uygulamasının bir parçası olarak bir derleme yüklenir. prerequisite ClickOnce uygulamasının yüklenebilmesi için önce genel derleme önbelleğinde (GAC) bir derleme bulunmalıdır. |
allowDelayedBinding |
Gerekli. Derlemenin çalışma zamanında program aracılığıyla yüklenip yüklenemeyeceğini belirtir. |
group |
isteğe bağlı. dependencyType özniteliği olarak install ayarlanırsa, yalnızca isteğe bağlı olarak yüklenen adlandırılmış bir derleme grubu belirler. Daha fazla bilgi için bkz. İzlenecek Yol: Tasarım Aracı Kullanarak ClickOnce Dağıtım API'siyle İsteğe Bağlı Derlemeleri İndirme.olarak ayarlanırsa framework ve dependencyType özniteliği olarak prerequisite ayarlanırsa, derlemeyi .NET Framework'ün bir parçası olarak belirler. .NET Framework 4 ve sonraki sürümlerde yüklenirken genel derleme önbelleği (GAC) bu derleme için denetlenmiyor. |
codeBase |
dependencyType özniteliği olarak ayarlandığında install gereklidir. Bağımlı derlemenin yolu. Mutlak bir yol veya bildirimin kod tabanına göre bir yol olabilir. Derleme bildiriminin geçerli olması için bu yolun geçerli bir URI olması gerekir. |
size |
dependencyType özniteliği olarak ayarlandığında install gereklidir. Bağımlı derlemenin bayt cinsinden boyutu. |
Assemblyıdentity
Gerekli. Bu öğe öğesinin dependentAssembly
alt öğesidir ve aşağıdaki özniteliklere sahiptir.
Ö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 |
isteğe bağlı. Uygulamanın veya derlemenin imzalandığı ortak anahtarın karma değerinin SHA-1 son 8 baytını temsil eden 16 karakterlik onaltılık dizeyi belirtir. Kataloğu imzalamak için kullanılan ortak anahtar 2048 bit veya daha fazla olmalıdır. |
processorArchitecture |
isteğe bağlı. İşlemciyi belirtir. Geçerli değerler x86 32 bit Windows ve I64 64 bit Windows içindir. |
language |
isteğe bağlı. Derlemenin EN-US gibi iki parçalı dil kodunu tanımlar. |
hash
hash
öğesi, öğesinin assemblyIdentity
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. dsig:Transform
öğesi aşağıdaki özniteliklere sahiptir.
Ö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. dsig:DigestMethod
öğesi aşağıdaki özniteliklere sahiptir.
Ö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
Uygulamanız tarafından kullanılan tüm derlemelerin karşılık gelen dependency
bir öğesi olmalıdır. Bağımlı derlemeler, platform derlemeleri olarak genel derleme önbelleğine önceden yüklenmesi gereken derlemeleri içermez.
Örnek
Aşağıdaki kod örneği, ClickOnce uygulama bildirimindeki öğeleri gösterir dependency
. Bu kod örneği, ClickOnce Uygulama Bildirimi konusu için sağlanan daha büyük bir örneğin parçasıdır.
<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>