更新:2007 年 11 月
部署清单是一种 XML 文件,用来描述 ClickOnce 部署,包括要部署的当前 ClickOnce 应用程序版本的标识。
部署清单具有下列元素和属性。
元素 |
说明 |
属性 |
---|---|---|
必选。顶级元素。 |
manifestVersion |
|
必选。标识 ClickOnce 应用程序的应用程序清单。 |
name version publicKeyToken processorArchitecture culture |
|
必选。标识用于在控制面板中创建外壳表示和“添加/删除程序”项的应用程序信息。 |
publisher product supportUrl |
|
可选。标识用来部署更新并向系统公开的属性。 |
isRequiredUpdate |
|
必选。标识要为部署而安装的应用程序版本以及应用程序清单的位置。 |
无 |
|
可选。包含对此部署清单进行数字签名所需的信息。 |
无 |
备注
部署清单文件标识 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>
请参见
参考
<assemblyIdentity> 元素(ClickOnce 部署)