MageUI.exe（图形化客户端中的清单生成和编辑工具）
除了使用基于 Windows 的用户界面 (UI) 之外，MageUI.exe 与命令行工具 Mage.exe 支持的功能完全相同。 使用此工具，你可以对部署清单和应用程序清单执行创建、编辑和签名操作。 用 MageUI.exe 创建的新清单以 .NET Framework 4 Client Profile 为目标。 早期版本的 MageUI.exe 应用于以 .NET Framework 的早期版本为目标。 在清单中添加或删除程序集时或重新对现有清单签名时，MageUI.exe 不会将清单更新为以 .NET Framework 4 Client Profile 为目标。 有关详细信息，请参阅 Mage.exe（清单生成和编辑工具）。
此工具会自动随 Visual Studio 一起安装。 若要运行该工具，请使用 Visual Studio 开发人员命令提示或 Visual Studio 开发人员 PowerShell。
Mage.exe 和 MageUI.exe 的两个版本作为组件包含在 Visual Studio 中。 若要查看版本信息，请运行 MageUI.exe，选择 “帮助” 并选择 “关于” 。 本文档描述 Mage.exe 和 MageUI.exe 的 4.0.x.x 版本。
备注
使用 MageUI.exe 保存已用证书签名的应用程序清单时，MageUI.exe 不支持 compatibleFrameworks 元素。 这种情况下必须使用 Mage.exe。
UIElement 列表
下表列出了可用的菜单项和工具栏项。
| 命令 | 菜单 | 快捷键 | 描述 |
|---|---|---|---|
| 应用程序清单 | 文件，新建 | 创建新的应用程序清单。 | |
| 部署清单 | 文件，新建 | 创建新的部署清单。 | |
| 打开 | 文件 | Ctrl+O | 打开现有的部署清单、应用程序清单或信任许可证以进行编辑。 |
| 关闭 | 文件 | Ctrl+F4 | 关闭打开的文件。 如果在关闭文件之前修改文件，则 MageUI.exe 将提示你使用公钥、密钥对或存储的证书对文件重新进行签名。 |
| 保存 | 文件 | Ctrl+S | 将当前具有用户输入焦点的文档保存到磁盘。 |
| 另存为 | 文件 | 将文件保存到磁盘，使你能够提供新的文件名和/或位置。 | |
| 全部保存 | 文件 | 保存对 MageUI.exe 中当前打开的全部文件所做的更改。 | |
| 首选项 | 文件 | 打开“首选项”对话框。 有关详细信息，请参阅下一节。 | |
| 退出 | 文件 | Alt + F4 | 退出 MageUI.exe。 |
| 剪切 | 编辑 | Ctrl+X | 从应用程序中移除当前选定的文本，然后将其移至系统剪贴板。 |
| 复制 | 编辑 | Ctrl+C | 将当前选定的文本复制到系统剪贴板。 |
| 粘贴 | 编辑 | Ctrl+V | 将文本从系统剪贴板粘贴到当前活动的文本元素中。 |
| 删除 | 编辑 | 删除列表中当前选定的元素，如“部署清单”选项卡上的信任许可证。 | |
| 全部关闭 | 窗口 | 关闭 MageUI.exe 中当前打开的所有文件。 如果一个或多个文件需要保存，则 MageUI.exe 将提示你对其进行保存。 MageUI.exe 还会提示你为每个未签名或已更改的文件选择一个签名密钥。 | |
| 关于 | 帮助 | 显示有关 MageUI.exe 的版本和版权信息。 |
“首选项”对话框
“首选项”对话框包含下列元素。
| UI 元素 | 描述 |
|---|---|
| 保存时签名 | 当你保存修改时提示对文件进行签名。 |
| 使用默认签名证书 | 使用在“证书文件”文本框中输入的密钥对全部文件进行签名。 这样可消除通常在你保存文件并且选择了“保存时签名”时出现的签名提示。 使用“证书文件”文本框旁边的省略号 ( … ) 按钮选择密钥文件。 |
| 摘要算法 | 指定用来生成依赖项摘要的算法。 值必须为“sha256RSA”或“sha1RSA”。 使用 SHA1 作为默认值。 在应用程序和部署清单中使用。 如果用户在保存清单时提供证书，则使用证书中的算法生成依赖项摘要。 |
“签名选项”对话框
首次保存清单或信任许可证，或者更改清单或信任许可证时，会显示“签名选项”对话框。 仅当选择了“首选项”对话框中的“保存时签名”选项时，才会显示该对话框。 在对指定“时间戳 URI”文本框中的值的清单进行签名时，必须连接到 Internet。
该对话框包含下列元素。
| UI 元素 | 描述 |
|---|---|
| 使用证书文件签名 | 使用文件系统上存储的数字证书对清单进行签名。 |
| 文件 | 提供一个可以键入表示证书的 .pfx 文件的路径的区域。 |
| ... | 打开“选择文件”对话框，以便选择现有的 .pfx 文件。 |
| 新建 | 生成一个无法通过证书颁发机构 (CA) 验证的新 .pfx。 要详细了解用于对 ClickOnce 部署进行签名的证书类型，请参阅受信任的应用程序部署概述。 |
| 密码 | 提供一个可以键入在使用此证书进行签名时所需要的密码的区域。 如果不适用，则可以保留为空白。 |
| 使用存储的证书签名 | 显示计算机的证书存储区中存储的可选数字证书的列表。 |
| 时间戳 URI | 显示数字时间戳服务的统一资源定位器 (URI)。 如果数字证书在你部署应用程序的下一个版本之前过期，则为清单加盖时间戳可以让你不必对清单进行重新签名。 有关详细信息，请参阅 Windows 根证书程序成员以及 ClickOnce 和 Authenticode。 |
| 不签名 | 允许你保存清单，而无需添加数字证书签名。 |
选项卡和面板的说明
使用 MageUI.exe 打开某个文档时，该文档将显示在自己的选项卡页中。 每个选项卡都包含一组属性面板。 这些面板包含经过分组的文档数据子集。
应用程序清单选项卡
“应用程序清单”选项卡显示应用程序清单的内容。 应用程序清单描述了部署中包含的所有文件，以及要在客户端上运行应用程序所需的权限。
“应用程序清单”选项卡包含以下选项卡。
| UI 元素 | 说明 |
|---|---|
| 名称 | 指定有关此部署的识别信息。 |
| 说明 | 指定发布者、产品和支持信息。 |
| 应用程序选项 | 指定它是否为浏览器应用程序，以及此清单是否为信任信息的源。 |
| 文件 | 指定构成此部署的所有文件。 |
| 所需权限 | 指定在客户端上运行应用程序所需的最小权限集。 |
名称选项卡
首次创建或打开应用程序清单时，会显示“名称”选项卡。 它唯一地标识部署，并选择性地指定有效目标平台。
| UI 元素 | 说明 |
|---|---|
| 名称 | 必需。 应用程序清单的名称。 通常与文件名相同。 |
| Version | 必需。 以 N.N.N.N 格式部署的版本号。只有第一个主要内部版本号是必需的。 例如，对于应用程序的 1.0 版，有效值包括 1、1.0、1.0.0 和 1.0.0.0。 |
| 处理器 | 可选。 此部署可在其上运行的计算机体系结构。 默认值为 msil，即 Microsoft 中间语言，它是所有托管程序集的默认格式。 如果在应用程序中对程序集进行了预编译（以使其适用于特定的体系结构），则请更改此字段。 有关预编译的详细信息，请参阅 Ngen.exe（本机映像生成器）。 |
| 区域性 | 可选。 应用程序在其中运行的两部分 ISO 国家和地区代码。 默认值为 neutral。 |
| 公钥标记 | 可选。 已用于对此应用程序清单进行签名的公钥。 如果这是新清单或未签名的清单，则此字段显示为 Unsigned。 |
说明选项卡
通常在部署清单中提供此信息。 只有在“应用程序选项”选项卡上选中了“使用应用程序清单信任信息”复选框时，才能修改这些字段。
| UI 元素 | 描述 |
|---|---|
| 发布者 | 负责该应用程序的个人或组织的姓名或名称。 此值用作“开始”菜单文件夹名。 |
| 产品 | 完整的产品名称。 如果为部署清单的“部署选项”选项卡上的“应用程序类型”元素选择了“本地安装”，则此名称将为此应用程序的“开始”菜单链接和“添加或删除程序”中显示的名称。 |
| 支持位置 | 客户可以从中为应用程序获取帮助和支持的 URL。 |
应用程序选项选项卡
| UI 元素 | 描述 |
|---|---|
| Windows Presentation Foundation 浏览器应用程序 | 指定它是否是在浏览器中作为 XAML 浏览器应用程序 (XBAP) 运行的 WPF 应用程序。 |
| 使用应用程序清单信任信息 | 指定此清单是否包含信任信息。 |
文件选项卡
| UI 元素 | 描述 |
|---|---|
| 应用程序目录 | 应用程序的文件驻留在其中的目录。 使用省略号 ( … ) 按钮选择此目录。 |
| 填充 | 将应用程序目录和子目录中的所有文件添加到应用程序清单。 如果 MageUI.exe 在目录中找到单个可执行文件，它会自动将其标记为入口点，即客户端上启动 ClickOnce 应用程序时执行时的第一个文件。 |
| 应用程序文件 | 列出应用程序中的所有文件。 每个文件具有三个可编辑的特性，如下所述。 |
| 文件类型 | 文件类型可以是以下四个值之一： - 无。 - 入口点。 应用程序的主要可执行文件。 只能将一个可执行文件标记为入口点。 - 数据文件。 向应用程序提供数据的文件（例如 XML 文件）。 - 图标文件。 应用程序图标，例如出现在桌面上或应用程序的窗口一角的图标。 |
| Optional | 不会在初次安装或更新时下载标记为可选的文件，但可能在运行时使用 System.Deployment 按需 API 下载。 有关详细信息，请参见演练：在设计器中使用 ClickOnce 部署 API 按需下载程序集。 |
| 组 | 一组可选的文件的标签。 可以将组标签应用于一组文件，并使用按需 API 下载一批文件（只进行一次 API 调用）。 |
所需权限选项卡
如果需要向应用程序授予比默认授予更多的本地计算机访问权限，请使用“所需权限”选项卡。 有关详细信息，请参阅保护 ClickOnce 应用程序。
| UI 元素 | 描述 |
|---|---|
| 权限集类型 | 在客户端上运行此应用程序所需的最小权限集。 有关这些权限集以及需要的或不需要的权限的说明，请参阅命名的权限集。 |
| 详细信息 | 为应用程序清单创建用于表示权限集的 XML。 除非充分理解应用程序清单 XML 格式，否则不应手动编辑此 XML。 有关详细信息，请参阅 ClickOnce 应用程序清单。 |
部署清单选项卡
“部署清单”选项卡包含以下选项卡。
| UI 元素 | 说明 |
|---|---|
| 名称 | 指定有关此部署的识别信息。 |
| 说明 | 指定发布者、产品和支持信息。 |
| 部署选项 | 指定有关部署的其他信息，如应用程序类型和开始位置。 |
| 更新选项 | 指定 ClickOnce 应多久检查一次应用程序更新。 |
| 应用程序引用 | 指定此部署的应用程序清单。 |
名称选项卡
首次创建或打开部署清单时，会显示“名称”选项卡。 它唯一地标识部署，并选择性地指定有效目标平台。
| UI 元素 | 说明 |
|---|---|
| 名称 | 必需。 部署清单的名称。 通常与文件名相同。 |
| Version | 必需。 以 N.N.N.N 格式部署的版本号。只有第一个主要内部版本号是必需的。 例如，对于应用程序的 1.0 版，有效值包括 1、1.0、1.0.0 和 1.0.0.0。 |
| 处理器 | 可选。 此部署可在其上运行的计算机体系结构。 默认值为 msil，即 Microsoft 中间语言，它是所有托管程序集的默认格式。 如果在应用程序中对程序集进行了编译（以使其适用于特定的体系结构），则请更改此字段。 |
| 区域性 | 可选。 应用程序在其中运行的两部分 ISO 国家/地区代码。 默认值为 neutral。 |
| 公钥标记 | 可选。 已用于对此部署清单进行签名的公钥。 如果这是新清单或未签名的清单，则此字段显示为 Unsigned。 |
说明选项卡
| UI 元素 | 描述 |
|---|---|
| 发布者 | 必需。 负责该应用程序的个人或组织的姓名或名称。 此值用作“开始”菜单文件夹名。 |
| 产品 | 必需。 完整的产品名称。 如果为“部署选项”选项卡上的“应用程序类型”元素选择了“本地安装”，则此名称将为此应用程序的“开始”菜单链接和“添加或删除程序”中显示的名称。 |
| 支持位置 | 可选。 客户可以从中为应用程序获取帮助和支持的 URL。 |
部署选项选项卡
| UI 元素 | 描述 |
|---|---|
| 应用程序类型 | 可选。 指定此应用程序是将其自身安装到客户端计算机（“本地安装”）、联机运行（“仅限联机状态”），还是作为在浏览器中运行的 WPF 应用程序（“WPF 浏览器应用程序”）。 默认值是“本地安装”。 |
| 开始位置 | 可选。 应用程序应实际从其启动的 URL。 在从 CD 部署应从 Web 进行自我更新的应用程序时非常有用。 |
| 在清单中包括开始位置(ProviderURL) | 可选。 指定 ClickOnce 要检查是否存在应用程序更新的 URL。 |
| 安装后自动运行应用程序 | 必需。 指定 ClickOnce 应用程序应在从 URL 初始安装后立即运行。 默认选中此复选框。 |
| 允许向应用程序传递 URL 参数 | 必需。 允许通过追加到部署清单 URL 的查询字符串将参数数据传输给 ClickOnce 应用程序。 默认情况下，不选中此复选框。 |
| 使用 .deploy 文件扩展名 | 必需。 选中后，应用程序清单中的所有文件都必须具有 .deploy 扩展名。 默认情况下，不选中此复选框。 |
更新选项选项卡
仅当“名称”选项卡上的“应用程序类型”选择框设置为“本地安装”时，“更新选项”选项卡才包含此处提及的选项。
| UI 元素 | 描述 |
|---|---|
| 此应用程序应检查更新 | 指定 ClickOnce 是否应检查应用程序更新。 如果未选中此复选框，应用程序将不检查更新，除非通过使用 System.Deployment.Application 命名空间中的 API 以编程方式进行更新。 |
| 选择应用程序何时应该检查更新 | 提供两个更新检查选项： - 应用程序启动前。 在应用程序执行之前执行更新检查。 - 应用程序启动后。 更新检查在应用程序主窗体初始化后开始，并将在下次启动该应用程序时运行。 |
| 更新检查频率 | 确定 ClickOnce 应多久检查一次更新： - 每次应用程序运行时检查。 ClickOnce 在用户每次打开应用时都将执行更新检查。 - 检查间隔：：选择检查更新之前必须经过的时间间隔和单位（小时、天或周）。 |
| 指定所需的此应用程序的最低版本 | 可选。 指定应用程序的特定版本为必需的安装，从而防止用户使用更早版本。 |
| Version | 如果已选中“指定所需的此应用程序的最低版本”复选框，则为必需。 提供的版本号的格式必须为 N.N.N.N。只有第一个主要内部版本号是必需的。 例如，对于应用程序的 1.0 版，有效值包括 1、1.0、1.0.0 和 1.0.0.0。 |
应用程序引用选项卡
“应用程序引用”选项卡包含与本主题前面所述的“名称”选项卡相同的字段。 唯一的例外是下面的字段。
| UI 元素 | 描述 |
|---|---|
| 选择清单 | 使你能够选择应用程序清单。 选择应用程序清单后，此页面上的所有其他字段均将进行填充。 |
