GenerateDeploymentManifest 任务

生成 ClickOnce 部署清单。 ClickOnce 部署清单通过以下方式描述应用程序的部署:定义部署的唯一标识,标识部署特征(如安装或联机模式),指定应用程序的更新设置和更新位置,并指示对应的 ClickOnce 应用程序清单。

参数

下表描述了 GenerateDeploymentManifest 任务的参数。

Parameter

说明

AssemblyName

可选 String 参数。

为生成的清单指定程序集标识的 Name 字段。 如果未指定此参数,将从 EntryPointInputManifest 参数推断出该名称。 如果无法推断出该名称,此任务将引发一个错误。

AssemblyVersion

可选 String 参数。

为生成的清单指定程序集标识的 Version 字段。 如果未指定此参数,此任务将使用“1.0.0.0”值。

CreateDesktopShortcut

可选 Boolean 参数。

如果为 ture,则在 ClickOnce 应用程序安装期间在桌面上创建图标。

DeploymentUrl

可选 String 参数。

指定应用程序的更新位置。 如果未指定此参数,则表示没有为应用程序定义更新位置。 但是,如果 UpdateEnabled 参数为 true,则必须指定更新位置。 指定的值应该是完全限定的 URL 路径或 UNC 路径。

Description

可选 String 参数。

指定应用程序的可选说明。

DisallowUrlActivation

可选 Boolean 参数。

指定应用程序在通过 URL 打开时是否应该自动运行。 如果此参数为 true,则只能从“开始”菜单启动该应用程序。 此参数的默认值为 false。 只有在 Install 参数值为 true 时,此输入才适用。

EntryPoint

可选 ITaskItem[] 参数。

指示生成的清单程序集的入口点。 对于 ClickOnce 部署清单,此输入指定 ClickOnce 应用程序清单。

在 Visual Studio 2005 中,GenerateApplicationManifest 任务需要一个 EntryPoint 来生成应用程序清单。 (程序集或本机清单不需要 EntryPoint。)此要求会通过以下生成错误来强制实施:“MSB3185: 未指定清单的入口点。”

在未指定 EntryPoint 任务参数时,MSBuild 不会发出此错误。 而是插入 <customHostSpecified> 标记作为 <entryPoint> 标记的一个子级,例如:

<entryPoint xmlns="urn:schemas-

microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

您可以通过使用下列步骤,将 DLL 依赖项添加到应用程序清单:

  1. 通过调用 ResolveAssemblyReference 解析程序集引用。

  2. 将上一任务的输出和程序集本身传递到 ResolveManifestFiles

  3. 通过使用 Dependencies 参数将依赖项传递到 GenerateApplicationManifest

ErrorReportUrl

可选 [String] 参数。

指定在 ClickOnce 安装期间对话框中显示的网页的 URL。

InputManifest

可选 ITaskItem 参数。

指示要用作清单生成器的基础的输入 XML 文档。 这样,结构数据(如自定义清单定义)就可以反映在输出清单中。 XML 文档中的根元素必须是 asmv1 命名空间中的程序集节点。

Install

可选 Boolean 参数。

指定应用程序是安装型应用程序还是仅联机的应用程序。 如果此参数为 true,应用程序将安装在用户的“开始”菜单中,并且可以通过使用“添加/删除程序”对话框来移除该应用程序。 如果此参数为 false,应用程序将通过网页联机使用。 此参数的默认值为 true。

MapFileExtensions

可选 Boolean 参数。

指定是否使用 .deploy 文件扩展名映射。 如果此参数为 true,将使用 .deploy 文件扩展名发布每一个程序文件。 此选项对于 Web 服务器安全性非常有用,可以限制为启用 ClickOnce 应用程序部署而必须取消阻止的文件扩展名的数量。 此参数的默认值为 false。

MaxTargetPath

可选 String 参数。

指定 ClickOnce 应用程序部署中文件路径的最大允许长度。 如果指定此参数,将会对照此限制检查该应用程序中每个文件路径的长度。 超出该限制的任何项都会引发一个生成警告。 如果未指定此输入或此输入为零,则不执行检查。

MinimumRequiredVersion

可选 String 参数。

指定用户是否可以跳过更新。 如果用户的版本低于要求的最低版本,将不能选择跳过更新。 只有当 Install 参数的值为 true 时,此输入才适用。

OutputManifest

可选 ITaskItem 参数。

指定生成的输出清单文件的名称。 如果未指定此参数,将从生成的清单的标识中推断出该输出文件的名称。

Platform

可选 String 参数。

指定应用程序的目标平台。 此参数可以具有下列值:

  • AnyCPU

  • x86

  • x64

  • Itanium

默认值为 AnyCPU

Product

可选 String 参数。

指定应用程序的名称。 如果未指定此参数,将从生成的清单的标识中推断出该名称。 此名称用于“开始”菜单中的快捷名称,并且是“添加/删除程序”对话框中显示的名称的一部分。

Publisher

可选 String 参数。

指定应用程序的发行者。 如果未指定此参数,将从注册用户或生成的清单的标识中推断出该名称。 此名称用于“开始”菜单中的文件夹名,并且是“添加/删除程序”对话框中显示的名称的一部分。

SuiteNamel

可选 String 参数。

指定“开始”菜单上的该文件夹的名称,在 ClickOnce 部署之后,此应用程序在该文件夹中。

SupportUrl

可选 String 参数。

指定在“添加/删除程序”对话框中为应用程序显示的链接。 指定的值应该是完全限定的 URL 路径或 UNC 路径。

TargetCulture

可选 String 参数。

标识应用程序的区域性,并为生成的清单指定程序集标识的 Language 字段。 如果未指定此参数,则假定该应用程序不依区域性而变的。

TrustUrlParameters

可选 Boolean 参数。

指定是否应使 URL 查询字符串参数可供应用程序使用。 此参数的默认值为 false,这表示这些参数将不提供给应用程序使用。

UpdateEnabled

可选 Boolean 参数。

指示是否对应用程序启用更新。 此参数的默认值为 false。 只有当 Install 参数的值为 true 时,此参数才适用。

UpdateInterval

可选 Int32 参数。

指定应用程序的更新间隔。 此参数的默认值为零。 只有当 InstallUpdateEnabled 参数的值均为 true 时,此参数才适用。

UpdateMode

可选 String 参数。

指定应该在启动应用程序之前在前台检查更新,还是在运行应用程序时在后台检查更新。 此参数可以具有下列值:

  • Foreground

  • Background

此参数的默认值为 Background。 只有当 InstallUpdateEnabled 参数的值均为 true 时,此参数才适用。

UpdateUnit

可选 String 参数。

指定 UpdateInterval 参数的单位。 此参数可以具有下列值:

  • Hours

  • Days

  • Weeks

只有当 InstallUpdateEnabled 参数的值均为 true 时,此参数才适用。

备注

除了上面列出的参数,此任务还将从 GenerateManifest 类继承参数,此类本身从 Task 类继承。 有关 Task 类的参数列表,请参见 任务基类类。

请参见

参考

GenerateApplicationManifest 任务

SignFile 任务

概念

MSBuild 任务

其他资源

MSBuild 任务参考