ClickOnce-Bereitstellungsmanifest

Artikel
01/12/2024

Ein Bereitstellungsmanifest ist eine XML-Datei, die eine ClickOnce-Bereitstellung beschreibt, einschließlich der Bestimmung der aktuellen ClickOnce-Anwendungsversion für die Bereitstellung.

Bereitstellungsmanifeste verfügen über die folgenden Elemente und Attribute.

Element	Beschreibung	Attribute
<assembly>-Element	Erforderlich. Ein Element der obersten Ebene.	`manifestVersion`
<assemblyIdentity>-Element	Erforderlich. Identifiziert das Anwendungsmanifest für die ClickOnce-Bereitstellung.	`name` `version` `publicKeyToken` `processorArchitecture` `culture`
<description>-Element	Erforderlich. Identifiziert Anwendungsinformationen, die zum Erstellen eines Shell-Eintrags und des Elements Software in der Systemsteuerung verwendet werden.	`publisher` `product` `supportUrl`
<deployment>-Element	Optional. Identifiziert die Attribute, die für die Bereitstellung von Updates und zum Verfügbarmachen für das System verwendet werden.	`install` `minimumRequiredVersion` `mapFileExtensions` `disallowUrlActivation` `trustUrlParameters`
<compatibleFrameworks>-Element	Erforderlich. Identifiziert die Versionen von .NET Framework, mit denen diese Anwendung installiert und ausgeführt werden kann.	`SupportUrl`
<dependency>-Element	Erforderlich. Identifiziert die Version der Anwendung, die für die Bereitstellung installiert werden soll, und den Speicherort des Anwendungsmanifests.	`preRequisite` `visible` `dependencyType` `codebase` `size`
<publisherIdentity>-Element	Für signierte Manifeste erforderlich. Enthält Informationen zum Herausgeber, der dieses Bereitstellungsmanifest signiert hat.	`Name` `issuerKeyHash`
<Signature>-Element	Optional. Enthält die notwendigen Informationen, um dieses Bereitstellungsmanifest digital zu signieren.	Keine
<customErrorReporting>-Element	Optional. Gibt einen URI an, der bei einem Fehler angezeigt wird.	Uri

Bemerkungen

Die Bereitstellungsmanifestdatei identifiziert eine ClickOnce-Anwendungsbereitstellung einschließlich der aktuellen Version und anderer Bereitstellungseinstellungen. Sie verweist auf das Anwendungsmanifest, in dem die aktuelle Version der Anwendung und alle in der Bereitstellung enthaltenen Dateien beschrieben werden.

Weitere Informationen finden Sie unter ClickOnce Security and Deployment.

Dateispeicherort

Die Bereitstellungsmanifestdatei verweist auf das richtige Anwendungsmanifest für die aktuelle Version der Anwendung. Wenn Sie eine neue Version einer Anwendungsbereitstellung verfügbar machen, müssen Sie das Bereitstellungsmanifest zum Verweisen auf das neue Anwendungsmanifest aktualisieren.

Die Bereitstellungsmanifestdatei muss über einen starken Namen verfügen und kann auch Zertifikate für die Herausgeberüberprüfung enthalten.

Dateinamenssyntax

Der Name einer Bereitstellungsmanifestdatei muss mit der Erweiterung .application enden.

Beispiele

Das folgende Codebeispiel veranschaulicht ein Bereitstellungsmanifest.

<?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.v1="urn:schemas-microsoft-com:clickonce.v1"
  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:xrml="urn:mpeg:mpeg21:2003:01-REL-R-NS"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <assemblyIdentity
    name="My Application Deployment.app"
    version="1.0.0.0"
    publicKeyToken="43cb1e8e7a352766"
    language="neutral"
    processorArchitecture="x86"
    xmlns="urn:schemas-microsoft-com:asm.v1" />
  <description
    asmv2:publisher="My Company Name"
    asmv2:product="My Application"
    xmlns="urn:schemas-microsoft-com:asm.v1" />
  <deployment install="true">
    <subscription>
      <update>
        <expiration maximumAge="0" unit="days" />
      </update>
    </subscription>
    <deploymentProvider codebase="\\myServer\sampleDeployment\MyApplicationDeployment.application" />
  </deployment>
  <compatibleFrameworks xmlns="urn:schemas-microsoft-com:clickonce.v2">
    <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.20506" />
    <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.20506" />
  </compatibleFrameworks>
  <dependency>
    <dependentAssembly
      dependencyType="install"
      codebase="1.0.0.0\My Application Deployment.exe.manifest"
      size="6756">
      <assemblyIdentity
        name="My Application Deployment.exe"
        version="1.0.0.0"
        publicKeyToken="43cb1e8e7a352766"
        language="neutral"
        processorArchitecture="x86"
        type="win32" />
      <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>E506x9FwNauks7UjQywmzgtd3FE=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
<publisherIdentity name="CN=DOMAIN\MyUsername" issuerKeyHash="18312a18a21b215ecf4cdb20f5a0e0b0dd263c08" /><Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
...
</Signature></asmv1:assembly>

Weitere Informationen

Veröffentlichen von ClickOnce-Anwendungen