演练：手动部署 ClickOnce 应用程序

项目
03/10/2023

如果无法使用 Visual Studio 部署 ClickOnce 应用程序，或者需要使用高级部署功能（例如受信任的应用程序部署），应使用 Mage.exe 命令行工具来创建 ClickOnce 清单。本演练介绍了如何使用清单生成和编辑工具的命令行版本 (Mage.exe) 或图形版本 (MageUI.exe) 来创建 ClickOnce 部署。

注意

在适用于 .NET Core 3.1 和 .NET 5 或更高版本的 ClickOnce 中，使用 dotnetmage.exe，而不是 Mage.exe。有关详细信息，请参阅适用于 .NET 的 ClickOnce。

先决条件

本演练包含一些需要在生成部署之前选择的先决条件和选项。

安装 Mage.exe 和 MageUI.exe。

Mage.exe 和 MageUI.exe 是 Windows 软件开发工具包 (SDK) 的一部分。必须安装了 Windows SDK 或 Visual Studio 附带的 Windows SDK 版本。有关详细信息，请参阅 MSDN 上的 Windows SDK。
提供要部署的应用程序。

本演练假设有一个可供部署的 Windows 应用程序。此应用程序将称为 AppToDeploy。
确定部署的分发方式。

分发选项包括：Web、文件共享或 CD。有关详细信息，请参阅 ClickOnce Security and Deployment。
确定应用程序是否需要更高级别的信任。

如果应用程序需要完全信任（例如对用户系统的完全访问权限），可以使用 Mage.exe 的 -TrustLevel 选项进行设置。如果要为应用程序定义自定义权限集，可以从另一个清单复制 Internet 或 Intranet 权限部分，修改它以满足你的需要，然后使用文本编辑器或 MageUI.exe 将其添加到应用程序清单。有关详细信息，请参阅受信任的应用程序部署概述。
获取验证码证书。

应使用验证码证书对部署进行签名。可使用 Visual Studio、MageUI.exe 或 MakeCert.exe 以及 Pvk2Pfx.exe 工具生成测试证书，也可以从证书颁发机构 (CA) 获取证书。如果选择使用受信任的应用程序部署，还必须在所有客户端计算机上一次性安装证书。有关详细信息，请参阅 Trusted Application Deployment Overview。

注意

也可使用可从证书颁发机构获取的 CNG 证书对部署进行签名。
确保应用程序没有包含 UAC 信息的清单。

需要确定应用程序是否包含带有用户帐户控制 (UAC) 信息（例如 <dependentAssembly> 元素）的清单。若要检查应用程序清单，可以使用 Windows Sysinternals Sigcheck 实用工具。

如果应用程序包含带有 UAC 详细信息的清单，你必须重新生成不含 UAC 信息的清单。对于 Visual Studio 中的 C# 项目，打开“项目”属性并选择“应用程序”选项卡。在“清单”下拉列表中，选择“创建没有清单的应用程序” 。对于 Visual Studio 中的 Visual Basic 项目，打开“项目”属性，选择“应用程序”选项卡，然后单击“查看 UAC 设置”。在打开的清单文件中，删除单个 <asmv1:assembly> 元素中的所有元素。
确定应用程序是否需要针对客户端计算机的先决条件。

从 Visual Studio 部署的 ClickOnce 应用程序可在部署中包含先决条件安装引导程序 (setup.exe)。本演练创建了 ClickOnce 部署所需的两个清单。可以使用 GenerateBootstrapper 任务来创建先决条件引导程序。

使用 Mage.exe 命令行工具部署应用程序

创建一个用于存储 ClickOnce 部署文件的目录。
在刚刚创建的部署目录中，创建一个版本子目录。如果这是第一次部署应用程序，请将版本子目录命名为 1.0.0.0。

注意

部署版本可与应用程序版本不同。
将所有应用程序文件（包括可执行文件、程序集、资源和数据文件）复制到版本子目录。如有必要，可以创建包含其他文件的其他子目录。
打开 Windows SDK 或 Visual Studio 命令提示符并对版本子目录进行更改。
通过调用 Mage.exe 创建应用程序清单。以下语句为编译为在 Intel x86 处理器上运行的代码创建应用程序清单。
```
mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory .
```
注意

请确保在 -FromDirectory 选项后添加句点 (.)，它表示当前目录。如果不添加句点，则必须指定应用程序文件的路径。
使用验证码证书对应用程序清单进行签名。将 mycert.pfx 替换为证书文件的路径。将 passwd 替换为证书文件的密码。
```
mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd
```
从随 Visual Studio 和 Windows SDK 一起分发的 .NET Framework 4.6.2 SDK 开始，mage.exe 使用 CNG 和验证码证书对清单进行签名。使用与验证码证书相同的命令行参数。
更改为部署目录的根目录。
通过调用 Mage.exe 生成部署清单。默认情况下，Mage.exe 会将 ClickOnce 部署标记为已安装的应用程序，以便它可以联机和脱机运行。若要使应用程序仅在用户联机时可用，请使用值为 false 的 -Install 选项。如果使用默认值，并且用户将从网站或文件共享安装应用程序，请确保 -ProviderUrl 选项的值指向 Web 服务器或共享上的应用程序清单的位置。
```
mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application
```

使用验证码或 CNG 证书对部署清单进行签名。

mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd

将部署目录中的所有文件复制到部署目标或介质。这可以是网站或 FTP 站点上的文件夹、文件共享或 CD-ROM。
为用户提供安装应用程序所需的 URL、UNC 或物理介质。如果提供了 URL 或 UNC，则必须为用户提供部署清单的完整路径。例如，如果 AppToDeploy 部署到 AppToDeploy 目录中的 http://webserver01/，则完整的 URL 路径将为 http://webserver01/AppToDeploy/AppToDeploy.application。

使用 MageUI.exe 图形工具部署应用程序

创建一个用于存储 ClickOnce 部署文件的目录。
在刚刚创建的部署目录中，创建一个版本子目录。如果这是第一次部署应用程序，请将版本子目录命名为 1.0.0.0。

注意

部署版本可能与应用程序版本不同。
将所有应用程序文件（包括可执行文件、程序集、资源和数据文件）复制到版本子目录。如有必要，可以创建包含其他文件的其他子目录。
启动 MageUI.exe 图形工具。
```
MageUI.exe
```
从菜单中依次选择“文件”、“新建”、“应用程序清单”，创建新的应用程序清单。
在默认的“名称”选项卡上，键入此部署的名称和版本号。另需指定为应用程序构建的处理器，例如 x86。
选择“文件”选项卡，然后选择“应用程序目录”文本框旁边的省略号 (...) 按钮。将显示“浏览文件夹”对话框。
选择包含应用程序文件的版本子目录，然后选择“确定”。
如果将从 Internet Information Services (IIS) 部署，请选中“在填充时将 .deploy 扩展名添加到任何不带该扩展名的文件”复选框。
转到“填充”按钮，将所有应用程序文件添加到文件列表中。如果应用程序包含多个可执行文件，请从“文件类型”下拉列表中选择“入口点”，将此部署的主要可执行文件标记为启动应用程序。（如果应用程序仅包含一个可执行文件，MageUI.exe 会标记该文件。）
选择“所需的权限”选项卡并选择需要应用程序断言的信任级别。默认值为 FullTrust，适用于大多数应用程序。
从菜单中依次选择“文件”、“另存为” 。系统将出现一个“签名选项”对话框，提示你对应用程序清单进行签名。
如果将证书作为文件存储在文件系统上，请使用“使用证书文件签名”选项，然后使用省略号 (…) 按钮从文件系统中选择证书。然后键入证书密码。

-或-

如果证书保存在可从计算机访问的证书存储中，请选择“使用存储的证书签名”选项，然后从提供的列表中选择证书。
选择“确定”以对应用程序清单进行签名。将显示 “另存为” 对话框。
在“另存为”对话框中，指定版本目录，然后选择“保存” 。
从菜单中依次选择“文件”、“新建”、“部署清单”，以创建部署清单。
在“名称”选项卡上，为此部署指定名称和版本号（在本示例中为 1.0.0.0）。另需指定为应用程序构建的处理器，例如 x86。
选择“说明”选项卡，并指定“发布者”和“产品”的值。（当应用程序安装在客户端计算机上以供脱机使用时，“产品”是在 Windows“开始”菜单上为应用程序指定的名称。）
选择“部署选项”选项卡，然后在“开始位置”文本框中，指定应用程序清单在 Web 服务器或共享上的位置。例如 \\myServer\myShare\AppToDeploy.application。
如果在上一步中添加了 .deploy 扩展名，还需在此处选择“使用 .deploy 文件扩展名”。
选择“更新选项”选项卡，并指定希望此应用程序更新的频率。如果应用程序使用 UpdateCheckInfo 自行检查更新，请清除“此应用程序应检查更新”复选框。
选择“应用程序引用”选项卡，然后转到“选择清单”按钮。此时会出现“打开”对话框。
选择之前创建的应用程序清单，然后选择“打开”。
从菜单中依次选择“文件”、“另存为” 。系统将出现一个“签名选项”对话框，提示你对部署清单进行签名。
如果将证书作为文件存储在文件系统上，请使用“使用证书文件签名”选项，然后使用省略号 (…) 按钮从文件系统中选择证书。然后键入证书密码。

-或-

如果证书保存在可从计算机访问的证书存储中，请选择“使用存储的证书签名”选项，然后从提供的列表中选择证书。
转到“确定”以对部署清单进行签名。将显示 “另存为” 对话框。
在“另存为”对话框中，将一个目录上移到部署的根目录，然后选择“保存” 。
将部署目录中的所有文件复制到部署目标或介质。这可以是网站或 FTP 站点上的文件夹、文件共享或 CD-ROM。
为用户提供安装应用程序所需的 URL、UNC 或物理介质。如果提供了 URL 或 UNC，则必须为用户提供部署清单的完整路径。例如，如果 AppToDeploy 部署到 AppToDeploy 目录中的 http://webserver01/，则完整的 URL 路径将为 http://webserver01/AppToDeploy/AppToDeploy.application。

后续步骤

当需要部署新版本的应用程序时，创建一个以新版本（例如 1.0.0.1）命名的新目录，并将新的应用程序文件复制到新目录中。接下来，需要按照前面的步骤创建和签名新的应用程序清单，并更新和签名部署清单。务必要在 Mage.exe-New 和 -Update 调用中指定相同的最新版本，因为 ClickOnce 仅更新最新的版本，以版本号最左边的整数为准。如果使用的是 MageUI.exe，则可以通过以下方式更新部署清单：打开部署清单，选择“应用程序引用”选项卡，转到“选择清单”按钮，然后选择更新后的应用程序清单。

演练：手动部署 ClickOnce 应用程序

先决条件

使用 Mage.exe 命令行工具部署应用程序

使用 MageUI.exe 图形工具部署应用程序

后续步骤

反馈

反馈

其他资源

演练：手动部署 ClickOnce 应用程序

先决条件

使用 Mage.exe 命令行工具部署应用程序

使用 MageUI.exe 图形工具部署应用程序

后续步骤

相关内容

反馈

反馈

其他资源