ClickOnce-Bereitstellungsmanifest

Aktualisiert: November 2007

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	Beschreibung	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 Aktualisierungen und zum Verfügbarmachen für das System verwendet werden.	isRequiredUpdate
<dependency>-Element	Erforderlich. Identifiziert die Version der Anwendung, die für die Bereitstellung installiert werden soll, und den Speicherort des Anwendungsmanifests.	Keine
<Signature>-Element	Optional. Enthält die erforderlichen Informationen, um dieses Bereitstellungsmanifest digital zu signieren.	Keiner

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 Übersicht über die ClickOnce-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

In den folgenden Codebeispielen werden Bereitstellungsmanifeste für zwei gängige Bereitstellungstypen veranschaulicht.

Im ersten Beispiel wird ein Bereitstellungsmanifest für das Starten einer ClickOnce-Anwendung veranschaulicht. Eine ClickOnce-Anwendung, die gestartet wird, wird weder im Startmenü von Windows noch in der Systemsteuerung unter Software hinzugefügt, und es wird immer die neueste Version verwendet.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" 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="ValidateChildrenWithConstraints.app" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <description asmv2:publisher="MS" asmv2:product="Validate With Constraints" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <deployment install="false" minimumRequiredVersion="1.0.0.0" trustURLParameters="true">
    <deploymentProvider codebase="https://localhost/ValidateChildrenWithConstraints.application" />
  </deployment>
  <dependency>
    <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="Debug\ValidateChildrenWithConstraints.exe.manifest" size="5912">
      <assemblyIdentity name="ValidateChildrenWithConstraints.exe" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" 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>RokPpIeGiPcO/+UUi5thetccDTc=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>

  <Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
    ...
  </Signature>
</asmv1:assembly>

Das zweite Beispiel veranschaulicht ein Bereitstellungsmanifest für eine installierte ClickOnce-Anwendung, die vor der Ausführung nach Aktualisierungen sucht. Eine installierte ClickOnce-Anwendung wird im Startmenü von Windows und in der Systemsteuerung unter Software hinzugefügt. Zudem wird ein <deploymentProvider>-Tag angegeben, das einen alternativen Speicherort zum Abrufen von Anwendungsaktualisierungen beschreibt.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" 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="ValidateChildrenWithConstraints.app" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <description asmv2:publisher="MS" asmv2:product="Validate With Constraints" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <deployment install="true" minimumRequiredVersion="1.0.0.0" trustURLParameters="true">
    <subscription>
      <update>
        <expiration maximumAge="2" unit="days" />
      </update>
    </subscription>
    <deploymentProvider codebase="https://localhost/ValidateChildrenWithConstraints.application" />
  </deployment>
  <dependency>
    <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="Debug\ValidateChildrenWithConstraints.exe.manifest" size="5912">
      <assemblyIdentity name="ValidateChildrenWithConstraints.exe" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" 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>RokPpIeGiPcO/+UUi5thetccDTc=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  
  <Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
    ...
  </Signature>
</asmv1:assembly>

Siehe auch

Referenz

<assembly>-Element (ClickOnce-Bereitstellung)

<assemblyIdentity>-Element (ClickOnce-Bereitstellung)

<description>-Element (ClickOnce-Bereitstellung)

<deployment>-Element (ClickOnce-Bereitstellung)

<dependency>-Element (ClickOnce-Bereitstellung)

<Signature>-Element (ClickOnce-Bereitstellung)

Last updated on 2008-09-02

Freigeben über