ClickOnce-Bereitstellungsmanifest

Artikel
08/10/2011

Ein Bereitstellungsmanifest ist eine XML-Datei, die eine ClickOnce-Bereitstellung beschreibt. Dabei wird u. a. die aktuelle bereitzustellende ClickOnce-Anwendung identifiziert.

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

Element	Beschreibungen	Attribute
<assembly>-Element	Erforderlich. Oberstes Element.	manifestVersion
<assemblyIdentity>-Element	Erforderlich. Identifiziert das Anwendungsmanifest für die ClickOnce-Anwendung.	name version publicKeyToken processorArchitecture culture
<description>-Element	Erforderlich. Identifiziert Anwendungsinformationen, die zum Erstellen eines Shell-Eintrags und eines Eintrags unter 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 (ClickOnce-Bereitstellung)	Erforderlich. Identifiziert die Versionen von .NET Framework, in denen die 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 (ClickOnce-Bereitstellung)	Erforderlich für signierte Manifeste. Enthält Informationen zum Herausgeber, der dieses Bereitstellungsmanifest signiert hat.	Name issuerKeyHash
<Signature>-Element	Optional. Enthält die erforderlichen Informationen, um dieses Bereitstellungsmanifest digital zu signieren.	None
<customErrorReporting>-Element (ClickOnce-Bereitstellung)	Optional. Legt einen URI zur Fehleranzeige fest.	Uri

Hinweise

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-Sicherheit und Bereitstellung.

Dateispeicherort

Die Bereitstellungsmanifestdatei verweist auf das richtige Anwendungsmanifest für die aktuelle Version der Anwendung. Wenn eine neue Version einer Anwendungsbereitstellung verfügbar gemacht wird, muss das Bereitstellungsmanifest aktualisiert werden, um auf das neue Anwendungsmanifest zu verweisen.

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

Dateinamensyntax

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

Beispiele

Im folgenden Codebeispiel wird ein Bereitstellungsmanifest veranschaulicht.

<?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>

Siehe auch

Konzepte

Veröffentlichen von ClickOnce-Anwendungen

Freigeben über