演练：手动部署不需要重新签名并保留署名信息的 ClickOnce 应用程序
当你创建 ClickOnce 应用程序并将其提供给客户进行发布和部署时，客户通常必须更新部署清单并对其进行重新签名。 虽然这在大多数情况下仍是首选方法，但 .NET Framework 3.5 使你可以创建可由客户部署的 ClickOnce 部署，而无需重新生成新的部署清单。 有关详细信息，请参阅在不重新签名的情况下为测试服务器和生产服务器部署 ClickOnce 应用程序。
当你创建 ClickOnce 应用程序，然后将其分配给客户进行发布和部署时，应用程序可以使用客户的署名或保留你自己的署名。 例如，如果应用程序是单个专用应用程序，你可能想要保留你自己的署名。 如果应用程序是针对每个客户高度自定义的，那么你可能希望使用客户署名。 通过 .NET Framework 3.5，你可以在将应用程序提供给组织进行部署时保留你自己的署名、出版商信息和安全签名。 有关详细信息，请参阅创建供其他人部署的 ClickOnce 应用程序。
注意
在本演练中，你将使用命令行工具 Mage.exe 或图形工具 MageUI.exe 手动创建部署。 有关手动部署的详细信息，请参阅演练：手动部署 ClickOnce 应用程序。
注意
在适用于 .NET Core 3.1 和 .NET 5 或更高版本的 ClickOnce 中，使用 dotnetmage.exe，而不是 Mage.exe。 有关详细信息，请参阅适用于 .NET 的 ClickOnce。
先决条件
若要执行本演练中的步骤，需要以下各项：
准备部署的 Windows 窗体应用程序。 此应用程序将称为 WindowsFormsApp1。
Visual Studio 或 Windows SDK。
使用 Mage.exe 部署具有多个部署和署名支持的 ClickOnce 应用程序
打开 Visual Studio 命令提示符或 Windows SDK 命令提示符，然后更改到要存储 ClickOnce 文件的目录。
创建一个以当前部署版本命名的目录。 如果这是你首次部署应用程序，则可能会选择“1.0.0.0”。
注意
部署版本可能与应用程序版本文件不同。
创建名为 bin 的子目录，并复制此处的所有应用程序文件（包括可执行文件、程序集、资源和数据文件）。
通过调用 Mage.exe 生成应用程序清单。
mage -New Application -ToFile 1.0.0.0\WindowsFormsApp1.exe.manifest -Name "Windows Forms App 1" -Version 1.0.0.0 -FromDirectory 1.0.0.0\bin -UseManifestForTrust true -Publisher "A. Datum Corporation"使用数字证书对应用程序清单进行签名。
mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx通过调用 Mage.exe 生成部署清单。 默认情况下，Mage.exe 会将 ClickOnce 部署标记为已安装的应用程序，以便它可以联机和脱机运行。 若要使应用程序仅在用户联机时可用，请使用值为
f的-i参数。 由于此应用程序将利用多个部署功能，因此请排除 Mage.exe 的-providerUrl参数。 （在版本 3.5 之前的 .NET Framework 版本中，排除脱机应用程序的-providerUrl将导致错误。）mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest请不要签署部署清单。
将所有文件提供给客户，客户将在其网络上部署应用程序。
此时，客户必须用自己的自行生成证书对部署清单进行签名。 例如，如果客户在一家名为 Adventure Works 的公司工作，则他可以使用 MakeCert.exe 工具生成自签名证书。 接下来，使用 Pvk2pfx.exe 工具将 MakeCert.exe 创建的文件合并到可传递到 Mage.exe 的 PFX 文件中。
makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx接下来，客户使用此证书对部署清单进行签名。
mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx客户向其用户部署应用程序。
使用 MageUI.exe 部署具有多个部署和署名支持的 ClickOnce 应用程序
打开 Visual Studio 命令提示符或 Windows SDK 命令提示符，然后导航到要存储 ClickOnce 文件的目录。
创建名为 bin 的子目录，并复制此处的所有应用程序文件（包括可执行文件、程序集、资源和数据文件）。
创建一个以当前部署版本命名的子目录。 如果这是你首次部署应用程序，则可能会选择“1.0.0.0”。
注意
部署版本可能与应用程序版本文件不同。
将 \bin 目录移动到步骤 2 中创建的目录中。
启动图形工具 MageUI.exe。
MageUI.exe从菜单中依次选择“文件”、“新建”、“应用程序清单”，创建新的应用程序清单。
在默认的“名称”选项卡上，输入此部署的名称和版本号。 此外，为 Publisher 提供一个值，该值将用作部署时“开始”菜单中应用程序快捷方式链接的文件夹名称。
选择“应用程序选项”选项卡，然后单击“使用应用程序清单以获取信任信息”。 这将为此 ClickOnce 应用程序启用第三方署名。
选择“文件”选项卡，然后单击“应用程序目录”文本框旁边的“浏览”按钮。
选择包含在步骤 2 中创建的应用程序文件的目录，然后在“文件夹选择”对话框中单击“确定”。
单击“填充”按钮，将所有应用程序文件添加到文件列表中。 如果应用程序包含多个可执行文件，请从“文件类型”下拉列表中选择“入口点”，将此部署的主要可执行文件标记为启动应用程序。 （如果应用程序仅包含一个可执行文件，则 MageUI.exe 会标记该文件。）
选择“所需的权限”选项卡并选择需要应用程序断言的信任级别。 默认值为 Full Trust，适用于大多数应用程序。
从菜单中选择“文件”、“保存”，然后保存应用程序清单。 保存应用程序清单时，系统将提示你对应用程序清单进行签名。
如果将证书作为文件存储在文件系统上，请使用“签署为证书文件”选项，然后使用省略号 (…) 按钮从文件系统中选择证书。
-或-
如果证书保存在可从计算机访问的证书存储中，请选择“使用存储的证书签名”选项，然后从提供的列表中选择证书。
从菜单中选择“文件”、“新建”、“部署清单”以创建部署清单，然后在“名称”选项卡上，提供名称和版本号（本例中为 1.0.0.0）。
切换到“更新”选项卡，并指定希望此应用程序更新的频率。 如果应用程序使用 ClickOnce 部署 API 自行检查更新，请清除标记为“此应用程序应检查更新”的复选框。
切换到“应用程序引用”选项卡。你可以通过单击“选择清单”按钮，然后选择在前面步骤中创建的应用程序清单，预先填充此选项卡上的所有值。
选择“保存”，并将部署清单保存到磁盘。 保存应用程序清单时，系统将提示你对应用程序清单进行签名。 单击“取消”可保存清单，而无需对其进行签名。
向客户提供所有应用程序文件。
此时，客户必须用自己的自行生成证书对部署清单进行签名。 例如，如果客户在一家名为 Adventure Works 的公司工作，则他可以使用 MakeCert.exe 工具生成自签名证书。 接下来，使用 Pvk2pfx.exe 工具将 MakeCert.exe 创建的文件合并到可传递到 MageUI.exe 的 PFX 文件中。
makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx生成证书后，客户现在会通过在 MageUI.exe 中打开部署清单并保存它来签署部署清单。 当出现签名对话框时，客户选择“签署为证书文件”选项，然后选择已保存在磁盘上的 PFX 文件。
客户向其用户部署应用程序。
相关内容
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈