GenerateDeploymentManifest 任务

生成 ClickOnce 部署清单。 ClickOnce 部署清单描述如何通过为部署定义唯一标识、标识部署特征(如安装或联机模式)、指定应用程序更新设置和更新位置,以及指示相应的 ClickOnce 应用程序清单,来进行应用程序的部署。

参数

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

参数 说明
AssemblyName 可选 String 参数。

指定生成的清单的程序集标识的 Name 字段。 如果未指定此参数,则从 EntryPointInputManifest 参数中推断名称。 如果无法推断名称,则任务将引发错误。
AssemblyVersion 可选 String 参数。

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

如果为 True,则将在安装 ClickOnce 应用程序过程中在桌面创建图标。
DeploymentUrl 可选 String 参数。

指定应用程序的更新位置。 如果未指定此参数,则不会为应用程序定义更新位置。 但是,如果 UpdateEnabled 参数为 true,则必须指定更新位置。 指定的值应为完全限定的 URL 或 UNC 路径。
Description 可选 String 参数。

指定应用程序的可选说明。
DisallowUrlActivation 可选 Boolean 参数。

指定当通过 URL 打开应用程序时是否应该自动运行该应用程序。 如果此参数为 true,则应用程序只能从“开始”菜单中启动。 此参数的默认值为 false。 仅当 Install 参数值为 true 时才应用此输入。
EntryPoint 可选 ITaskItem[] 参数。

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

如果未指定 EntryPoint 任务参数,将 <customHostSpecified> 标记作为 <entryPoint> 标记的子标记插入,例如:

<entryPoint xmlns="urn:schemas-microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

通过执行以下步骤,可将 DDL 依赖项添加到应用程序清单:

1. 通过调用 ResolveAssemblyReference 解析程序集引用。
2. 将上一个任务的输出和程序集本身传递给 ResolveManifestFiles
3. 使用 Dependencies 参数将依赖项传递给 GenerateApplicationManifest
ErrorReportUrl 可选 System.String 参数。

指定安装 ClickOnce 过程中显示在对话框中的网页 URL。
InputManifest 可选 ITaskItem 参数。

指示输入 XML 文档,使其充当清单生成器的基础。 这使得结构化数据(如自定义清单定义)可反映在输出清单中。 XML 文档中的根元素必须是 asmv1 命名空间中的程序集节点。
Install 可选 Boolean 参数。

指定应用程序是已安装应用程序还是仅联机应用程序。 如果此参数为 true,则应用程序将安装在用户的“开始”菜单中,并可通过“添加或删除程序”对话框将其删除。 如果此参数为 false,则应用程序适用于在网页上联机使用。 此参数的默认值为 true
MapFileExtensions 可选 Boolean 参数。

指定是否使用 .deploy 文件扩展名映射。 如果此参数为 true,则每个程序文件都使用 .deploy 文件扩展名发布。 此选项限制文件扩展名的数量(必须取消阻止这些文件扩展名,才能启用 ClickOnce 应用程序部署),有助于提升 Web 服务器安全性。 此参数的默认值为 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 时才应用此参数。

备注

除上面列出的参数外,此任务还从 GenerateManifestBase 类继承参数,后者自身继承自 Task 类。 有关任务类的参数列表,请参阅任务基类

另请参阅