Share via

指定 ClickOnce 发布属性

  • 项目

可以在项目设计器的“发布”页上或使用发布向导配置 ClickOnce 发布属性。 在本文中，你将了解如何指定基本属性，例如发布位置、安装 URL、联机或脱机安装模式以及发布版本。

指定发布位置

使用 ClickOnce 发布应用程序时，“Publish Location”属性指定放置应用程序文件和清单的位置。 这可以是文件路径或 FTP 服务器的路径。

可以在“项目设计器”的“发布”页上或使用发布向导指定 Publish Location 属性。 有关详细信息，请参阅如何：使用发布向导发布 ClickOnce 应用程序。

注意

当使用 ClickOnce 安装多个版本的应用程序时，安装会将应用程序的早期版本移动到位于你指定的发布位置的名为“Archive”的文件夹中。 按照这种方式对早期版本进行存档，可以使安装目录与早期版本所在的文件夹分开。

  1. 在“解决方案资源管理器” 中选择了项目的情况下，在“项目” 菜单上单击“属性” 。

  2. 单击“发布”选项卡。

    注意

    在适用于 .NET Core 3.1 和 .NET 5（或更高版本）的 ClickOnce 中，需要使用“发布”工具（而不是“发布”向导和项目设计器的“发布”页）来设置部署属性。 有关详细信息，请参阅使用 ClickOnce 部署 .NET Windows 应用程序和 ClickOnce for .NET。

  3. 在“发布位置”字段中，使用以下格式之一输入发布位置：

    • 若要发布到文件共享或磁盘路径，请使用 UNC 路径 (\\Server\ApplicationName) 或文件路径 (C:\Deploy\ApplicationName) 输入路径。

    • 若要发布到 FTP 服务器，请使用格式 ftp://ftp.microsoft.com/<ApplicationName> 输入路径。

      请注意，“发布位置”框中必须存在文本才能使浏览（“...”）按钮正常工作 。

指定最终用户从中进行安装的位置

在发布 ClickOnce 应用程序时，用户下载和安装应用程序的位置不一定是你最初发布应用程序的位置。 例如，在某些组织中，开发人员可能会将应用程序发布到暂存服务器，然后管理员会将该应用程序移动到 Web 服务器。

在这种情况下，可以使用 Installation URL 属性来指定用户下载应用程序时将使用的 Web 服务器。 这是必需的，以便应用程序清单知道在何处查找更新。

可以在“项目设计器”的“发布”页上设置 Installation URL 属性 。

备注

也可以使用 PublishWizard 设置 Installation URL 属性。 有关详细信息，请参阅如何：使用发布向导发布 ClickOnce 应用程序。

指定安装 URL

  1. 在“解决方案资源管理器” 中选择了项目的情况下，在“项目” 菜单上单击“属性” 。

  2. 单击“发布”选项卡。

    注意

    在适用于 .NET Core 3.1 和 .NET 5（或更高版本）的 ClickOnce 中，需要使用“发布”工具（而不是“发布”向导和项目设计器的“发布”页）来设置部署属性。 有关详细信息，请参阅使用 ClickOnce 部署 .NET Windows 应用程序和适用于 .NET 的 ClickOnce。

  3. 在“安装 URL”字段中，使用 https://www.contoso.com/ApplicationName 格式的完全限定 URL 或 \Server\ApplicationName 格式的 UNC 路径输入安装位置。

指定 ClickOnce 脱机或联机安装模式

ClickOnce 应用程序的 Install Mode 确定应用程序是可供脱机使用还是联机使用。 选择“应用程序仅可联机使用”时，用户必须有权访问 ClickOnce 发布位置（网页或文件共享）才能运行该应用程序。 选择“应用程序也可脱机使用”时，应用程序会将条目添加到“开始”菜单和“添加或删除程序”对话框；用户能够在未连接时运行应用程序。

可以在“项目设计器”的“发布”页上设置 Install Mode。

备注

还可通过使用发布向导来设置 Install Mode。 有关详细信息，请参阅操作说明：使用发布向导发布 ClickOnce 应用程序。

使 ClickOnce 应用程序仅可联机使用

  1. 在“解决方案资源管理器” 中选择了项目的情况下，在“项目” 菜单上单击“属性” 。

  2. 单击“发布”选项卡。

    注意

    在适用于 .NET Core 3.1 和 .NET 5（或更高版本）的 ClickOnce 中，需要使用“发布”工具（而不是“发布”向导和项目设计器的“发布”页）来设置部署属性。 有关详细信息，请参阅使用 ClickOnce 部署 .NET Windows 应用程序和适用于 .NET 的 ClickOnce。

  3. 在“安装模式和设置”区域中，单击“应用程序仅可联机使用”选项按钮。

使 ClickOnce 应用程序可供联机或脱机使用

  1. 在“解决方案资源管理器” 中选择了项目的情况下，在“项目” 菜单上单击“属性” 。

  2. 单击“发布”选项卡。

  3. 在“安装模式和设置”区域中，单击“应用程序也可脱机使用”选项按钮。

    安装后，应用程序会将条目添加到“开始”菜单和控制面板中的“添加或删除程序”。

设置 ClickOnce 发布版本

ClickOnce Publish Version 属性决定是否将要发布的应用程序视为更新。 每次版本递增时，应用程序都将作为更新发布。

可以在“项目设计器”的“发布”页上设置 Publish Version 属性 。

注意

有一个项目选项会在每次发布应用程序时自动递增 Publish Version 属性；默认情况下启用此选项。 有关详细信息，请参阅自动递增 ClickOnce 发布版本。

更改发布版本

  1. 在“解决方案资源管理器” 中选择一个项目，然后在“项目” 菜单上单击“属性” 。

  2. 单击“发布”选项卡。

    注意

    在适用于 .NET Core 3.1 和 .NET 5（或更高版本）的 ClickOnce 中，需要使用“发布”工具（而不是“发布”向导和项目设计器的“发布”页）来设置部署属性。 有关详细信息，请参阅使用 ClickOnce 部署 .NET Windows 应用程序和适用于 .NET 的 ClickOnce。

  3. 在“发布版本”字段中，递增“主版本号”、“次版本号”、“内部版本号”或“修订”版本号 。

    注意

    切勿递减版本号；这样做可能会导致不可预知的更新行为。

自动递增 ClickOnce 发布版本

发布 ClickOnce 应用程序时，更改 Publish Version 属性将导致应用程序作为更新发布。 默认情况下，Visual Studio 会在每次发布应用程序时自动递增 Publish Version 的 Revision 版本号。

可以在“项目设计器”的“发布”页上禁止该行为 。

注意

显示的对话框和菜单命令可能会与“帮助”中的描述不同，具体取决于你现用的设置或版本。 若要更改设置，请在 “工具” 菜单上选择 “导入和导出设置” 。 有关详细信息，请参阅重置设置。

禁用发布版本的自动递增

  1. 在“解决方案资源管理器” 中选择了项目的情况下，在“项目” 菜单上单击“属性” 。

  2. 单击“发布”选项卡。

    注意

    在适用于 .NET Core 3.1 和 .NET 5（或更高版本）的 ClickOnce 中，需要使用“发布”工具（而不是“发布”向导和项目设计器的“发布”页）来设置部署属性。 有关详细信息，请参阅使用 ClickOnce 部署 .NET Windows 应用程序和 ClickOnce for .NET。

  3. 在“发布版本”部分中，清空“自动递增每个版本的修订号”复选框 。

相关内容