指定 ClickOnce 發佈屬性

您可以在 [專案設計工具] 的 [發佈] 頁面上,或使用發佈精靈來設定 ClickOnce 發佈屬性。 在本文中,您將了解如何指定基本屬性,例如發佈位置、安裝 URL、線上或離線安裝模式,以及發佈版本。

指定發佈位置

當您使用 ClickOnce 發行應用程式時,Publish Location屬性會指定放置應用程式檔案和資訊清單的位置。 這可以是檔案路徑或 FTP 伺服器的路徑。

您可以在 [專案設計工具] 的 [發佈] 頁面上,或使用 [發佈精靈] 來指定 Publish Location 屬性。 如需詳細資訊,請參閱如何:使用發佈精靈發佈 ClickOnce 應用程式

注意

當您使用 ClickOnce 安裝多個版本的應用程式時,安裝會將舊版應用程式移至您指定之發佈位置中名為 Archive 的資料夾。 以這種方式封存先前的版本可將安裝目錄與舊版的資料夾分開。

  1. 在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性]

  2. 按一下 [發佈] 索引標籤。

    注意

    在 ClickOnce for .NET Core 3.1 和 .NET 5 或更新版本中,您可以使用 [發佈] 工具來設定部署屬性,而不是 [發行精靈] 和 [專案設計工具的發佈] 頁面。 如需詳細資訊,請參閱使用 ClickOnce 部署 .NET Windows 應用程式以及 ClickOnce for .NET

  3. 在 [發佈位置] 欄位中,使用下列其中一種格式輸入發佈位置:

    • 若要發佈至檔案共用或磁碟路徑,請使用 UNC 路徑 (\Server\ApplicationName) 或檔案路徑 (C:\Deploy\ApplicationName) 來輸入路徑。

    • 若要發佈至 FTP 伺服器,請使用 ftp://ftp.microsoft.com/ApplicationName 格式<>來輸入路徑。

      請注意,文字必須出現在 [發佈位置] 方塊中才能讓 [瀏覽] (...) 按鈕運作。

指定位置讓終端使用者從此處執行安裝作業

發佈 ClickOnce 應用程式時,使用者要下載並安裝應用程式的位置不一定是您一開始發佈應用程式的位置。 例如,在某些組織中,開發人員可能會將應用程式發佈至暫存伺服器,然後系統管理員會將應用程式移至網頁服務器。

在此情況下,您可以使用 Installation URL 屬性來指定使用者將前往下載應用程式的網頁服務器。 這是必要的,因為這可讓應用程式資訊清單知道要在哪裡尋找更新。

Installation URL 屬性可以在 [專案設計工具] 的 [發佈] 頁面上設定。

注意

您也可以使用 PublishWizard 來設定 Installation URL 屬性。 如需詳細資訊,請參閱作法:使用發佈精靈發佈 ClickOnce 應用程式

指定安裝 URL

  1. 在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性]

  2. 按一下 [發佈] 索引標籤。

    注意

    在 ClickOnce for .NET Core 3.1 和 .NET 5 或更新版本中,您可以使用 [發佈] 工具來設定部署屬性,而不是 [發行精靈] 和 [專案設計工具的發佈] 頁面。 如需詳細資訊,請參閱使用 ClickOnce 部署 .NET Windows 應用程式以及 ClickOnce for .NET

  3. 在 [安裝 URL] 欄位中,使用格式為 https://www.contoso.com/ApplicationName 的完整 URL 輸入安裝位置,或使用格式為 \Server\ApplicationName 的 UNC 路徑。

指定 ClickOnce 離線或線上安裝模式

ClickOnce 應用程式的 Install Mode 會決定應用程式是否可供離線或線上使用。 當您選擇 [應用程式僅供線上使用] 時,使用者必須能夠存取 ClickOnce 發佈位置 (網頁或檔案共用),才能執行應用程式。 當您選擇 [應用程式可供離線使用] 時,應用程式也會將項目新增至 [開始] 功能表和 [新增或移除程式] 對話方塊;使用者能夠在未連線時執行應用程式。

Install Mode 可以在 [專案設計工具] 的 [發佈] 頁面上設定。

注意

Install Mode 也可以使用發佈精靈來設定。 如需詳細資訊,請參閱作法:使用發佈精靈發佈 ClickOnce 應用程式

讓 ClickOnce 應用程式只能在線上使用

  1. 在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性]

  2. 按一下 [發佈] 索引標籤。

    注意

    在 ClickOnce for .NET Core 3.1 和 .NET 5 或更新版本中,您可以使用 [發佈] 工具來設定部署屬性,而不是 [發行精靈] 和 [專案設計工具的發佈] 頁面。 如需詳細資訊,請參閱使用 ClickOnce 部署 .NET Windows 應用程式以及 ClickOnce for .NET

  3. 在 [安裝模式和設定] 區域中,按一下 [應用程式只能在線上使用] 選項按鈕。

讓 ClickOnce 應用程式在線上或離線使用

  1. 在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性]

  2. 按一下 [發佈] 索引標籤。

  3. 在 [安裝模式和設定] 區域中,按一下 [應用程式也可供離線使用] 選項按鈕。

    安裝時,應用程式會將項目新增至 [開始] 功能表,以及 [控制台] 中的 [新增或移除程式]

設定 ClickOnce 發佈版本

ClickOnce Publish Version 屬性會決定您要發佈的應用程式是否會被視為更新。 每次遞增版本時,應用程式都會發佈為更新。

Publish Version 屬性可以在 [專案設計工具] 的 [發佈] 頁面上設定。

注意

專案選項會在每次發佈應用程式時自動遞增 Publish Version 屬性; 此選項預設為啟用。 如需詳細資訊,請參閱自動遞增 ClickOnce 發佈版本

變更發佈版本

  1. 選取方案總管 中的專案,然後按一下 [專案] 功能表中的 [屬性]

  2. 按一下 [發佈] 索引標籤。

    注意

    在 ClickOnce for .NET Core 3.1 和 .NET 5 或更新版本中,您可以使用 [發佈] 工具來設定部署屬性,而不是 [發行精靈] 和 [專案設計工具的發佈] 頁面。 如需詳細資訊,請參閱使用 ClickOnce 部署 .NET Windows 應用程式以及 ClickOnce for .NET

  3. 在 [發佈版本] 欄位中,遞增 [主要]、 [次要]、[組建] 或 [修訂版本號碼]

    注意

    您絕對不應該遞減版本號碼; 這樣做可能會導致無法預測的更新行為。

自動累加 ClickOnce 的發佈版本

發佈 ClickOnce 應用程式時,變更 Publish Version 屬性會導致以更新的形式發佈應用程式。 根據預設,Visual Studio 會在每次發佈應用程式時自動遞增 Publish VersionRevision 編號。

您可以在 [專案設計工具] 的 [發佈] 頁面上停用此行為。

注意

您看到的對話方塊與功能表命令,可能會因您所使用的設定或版本,而與說明中所述不同。 若要變更您的設定,請在 [工具] 功能表上選擇 [匯入和匯出設定]。 如需詳細資訊,請參閱重設設定

停用自動遞增發佈版本

  1. 在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性]

  2. 按一下 [發佈] 索引標籤。

    注意

    在 ClickOnce for .NET Core 3.1 和 .NET 5 或更新版本中,您可以使用 [發佈] 工具來設定部署屬性,而不是 [發行精靈] 和 [專案設計工具的發佈] 頁面。 如需詳細資訊,請參閱使用 ClickOnce 部署 .NET Windows 應用程式以及 ClickOnce for .NET

  3. 在 [發行版本] 區段中,清除 [使用每個版本自動遞增修訂] 核取方塊。