ClickOnce 部署清单

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

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

元素

说明

特性

<assembly> 元素

必选。 顶级元素。

manifestVersion

<assemblyIdentity> 元素

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

name

version

publicKeyToken

processorArchitecture

culture

<description> 元素

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

publisher

product

supportUrl

<deployment> 元素

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

install

minimumRequiredVersion

mapFileExtensions

disallowUrlActivation

trustUrlParameters

<compatibleFrameworks> 元素(ClickOnce 部署)

必选。 标识此应用程序可在其上安装和运行的 .NET Framework 版本。

SupportUrl

<dependency> 元素

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

preRequisite

visible

dependencyType

codebase

size

<publisherIdentity> 元素(ClickOnce 部署)

对于已签名清单是必需的。 包含有关为此部署清单签名的发布者的信息。

Name

issuerKeyHash

<Signature> 元素

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

<customErrorReporting> 元素(ClickOnce 部署)

可选。 指定发生错误时所显示的 URI。

Uri

备注

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

有关更多信息,请参见 ClickOnce 安全和部署

文件位置

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

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

文件名语法

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

示例

下面的代码示例示出部署清单。

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

请参见

概念

发布 ClickOnce 应用程序