ClickOnce uygulama bildirimi

Makale
01/12/2024

ClickOnce uygulama bildirimi, ClickOnce kullanılarak dağıtılan bir uygulamayı açıklayan bir XML dosyasıdır.

ClickOnce uygulama bildirimleri aşağıdaki öğelere ve özniteliklere sahiptir.

Öğe	Açıklama	Özellikler
<assembly> Öğesi	Gerekli. Üst düzey öğe.	`manifestVersion`
<assemblyIdentity> Öğesi	Gerekli. ClickOnce uygulamasının birincil derlemesini tanımlar.	`name` `version` `publicKeyToken` `processorArchitecture` `language`
<trustInfo> Öğesi	Uygulama güvenlik gereksinimlerini tanımlar.	Hiçbiri
<entryPoint> Öğesi	Gerekli. Uygulama kodu giriş noktasını tanımlar.	`name`
<dependency> Öğesi	Gerekli. Uygulamanın çalışması için gereken her bağımlılığı tanımlar. İsteğe bağlı olarak önceden yüklenmesi gereken derlemeleri tanımlar.	Hiçbiri
<file> Öğesi	isteğe bağlı. Uygulama tarafından kullanılan her bir ayrıştırılmayan dosyayı tanımlar. Dosyayla ilişkilendirilmiş Bileşen Nesne Modeli (COM) yalıtım verilerini içerebilir.	`name` `size` `group` `optional` `writeableType`
<fileAssociation> Öğesi	isteğe bağlı. Uygulamayla ilişkilendirilecek dosya uzantısını tanımlar.	`extension` `description` `progid` `defaultIcon`

Açıklamalar

ClickOnce uygulama bildirim dosyası, ClickOnce kullanılarak dağıtılan bir uygulamayı tanımlar. ClickOnce hakkında daha fazla bilgi için bkz . ClickOnce Güvenliği ve Dağıtımı.

Dosya konumu

ClickOnce uygulama bildirimi, dağıtımın tek bir sürümüne özgüdür. Bu nedenle, dağıtım bildirimlerinden ayrı olarak depolanmalıdır. Yaygın kural, bunları ilişkili sürümden sonra adlı bir alt dizine yerleştirmektir.

Uygulama bildirimi her zaman dağıtımdan önce imzalanmalıdır. Bir uygulama bildirimini el ile değiştirirseniz, uygulama bildirimini yeniden imzalamak, dağıtım bildirimini güncelleştirmek ve ardından dağıtım bildirimini yeniden imzalamak için mage.exe kullanmalısınız. Daha fazla bilgi için bkz . İzlenecek yol: ClickOnce uygulamasını el ile dağıtma.

Dosya adı söz dizimi

ClickOnce uygulama bildirim dosyasının adı, öğesinde assemblyIdentity tanımlanan uygulamanın tam adı ve uzantısı, ardından uzantısı .manifest olmalıdır. Örneğin, Example.exe uygulamasına başvuran bir uygulama bildirimi aşağıdaki dosya adı söz dizimini kullanır.

example.exe.manifest

Örnek

Aşağıdaki kod örneğinde ClickOnce uygulaması için bir uygulama bildirimi gösterilmektedir.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" xmlns:co.v2="urn:schemas-microsoft-com:clickonce.v2" xmlns="urn:schemas-microsoft-com:asm.v2" xmlns:asmv1="urn:schemas-microsoft-com:asm.v1" xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:co.v1="urn:schemas-microsoft-com:clickonce.v1">
  <asmv1:assemblyIdentity name="My Application Deployment.exe" version="1.0.0.0" publicKeyToken="43cb1e8e7a352766" language="neutral" processorArchitecture="x86" type="win32" />
  <application />
  <entryPoint>
    <assemblyIdentity name="MyApplication" version="1.0.0.0" language="neutral" processorArchitecture="x86" />
    <commandLine file="MyApplication.exe" parameters="" />
  </entryPoint>
  <trustInfo>
    <security>
      <applicationRequestMinimum>
        <PermissionSet Unrestricted="true" ID="Custom" SameSite="site" />
        <defaultAssemblyRequest permissionSetReference="Custom" />
      </applicationRequestMinimum>
      <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
        <!--
          UAC Manifest Options
          If you want to change the Windows User Account Control level replace the
          requestedExecutionLevel node with one of the following.

        <requestedExecutionLevel  level="asInvoker" uiAccess="false" />
        <requestedExecutionLevel  level="requireAdministrator" uiAccess="false" />
        <requestedExecutionLevel  level="highestAvailable" uiAccess="false" />

         If you want to utilize File and Registry Virtualization for backward
         compatibility then delete the requestedExecutionLevel node.
    -->
        <requestedExecutionLevel level="asInvoker" uiAccess="false" />
      </requestedPrivileges>
    </security>
  </trustInfo>
  <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>
<publisherIdentity name="CN=DOMAINCONTROLLER\UserMe" issuerKeyHash="18312a18a21b215ecf4cdb20f5a0e0b0dd263c08" /><Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
...
</Signature></r:issuer></r:license></msrel:RelData></KeyInfo></Signature></asmv1:assembly>

Ayrıca bkz.

ClickOnce uygulamalarını yayımlama