ClickOnce 部署清单

更新:2007 年 11 月

部署清单是一种 XML 文件,用来描述 ClickOnce 部署,包括要部署的当前 ClickOnce 应用程序版本的标识。

部署清单具有下列元素和属性。

元素

说明

属性

<assembly> 元素

必选。顶级元素。

manifestVersion

<assemblyIdentity> 元素

必选。标识 ClickOnce 应用程序的应用程序清单。

name

version

publicKeyToken

processorArchitecture

culture

<description> 元素

必选。标识用于在控制面板中创建外壳表示和“添加/删除程序”项的应用程序信息。

publisher

product

supportUrl

<deployment> 元素

可选。标识用来部署更新并向系统公开的属性。

isRequiredUpdate

<dependency> 元素

必选。标识要为部署而安装的应用程序版本以及应用程序清单的位置。

<Signature> 元素

可选。包含对此部署清单进行数字签名所需的信息。

备注

部署清单文件标识 ClickOnce 应用程序部署,包括当前版本和其他部署设置。该文件引用应用程序清单,该清单描述了应用程序的当前版本以及部署中包含的所有文件。

有关更多信息,请参见 ClickOnce 部署概述

文件位置

部署清单文件引用应用程序当前版本的正确应用程序清单。如果要使应用程序部署的新版本可用,必须更新部署清单,使其引用新的应用程序清单。

该部署清单文件必须使用强名称,并且还可以包含用于发行者验证的证书。

文件名语法

部署清单文件的名称必须以 .application 扩展名结尾。

示例

下面的代码示例阐释两种常见部署类型的部署清单。

第一个示例阐释用于启动 ClickOnce 应用程序的部署清单。已启动的 ClickOnce 应用程序不添加到 Windows“开始”菜单或“添加/删除程序”中,并且始终使用最新版本。

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

第二个示例阐释已安装的 ClickOnce 应用程序的部署清单,该应用程序在运行前检查更新。已安装的 ClickOnce 应用程序添加到 Windows“开始”菜单中,并且控制面板的“添加/删除程序”中会添加一个新的项。此外,该示例还指定了 <deploymentProvider> 标记,该标记描述轮询应用程序更新的备用位置。

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

请参见

参考

<assembly> 元素(ClickOnce 部署)

<assemblyIdentity> 元素(ClickOnce 部署)

<description> 元素(ClickOnce 部署)

<deployment> 元素(ClickOnce 部署)

<dependency> 元素(ClickOnce 部署)

<Signature> 元素(ClickOnce 部署)