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