從命令列建置 ClickOnce 應用程式

  • 發行項

更新： 2008 年 7 月

在 Visual Studio 中，您可以從命令列建置專案，即使專案是在整合式開發環境 (IDE) 中建立的。事實上，您可以在只安裝 .NET Framework 的另一部電腦上，重新建置以 Visual Studio 所建立的專案。這可讓您使用自動化處理序 (例如在集中建置實驗室，或使用超越建置專案本身範圍的進階指令碼技術)，重新產生組建。

使用 MSBuild 重新產生 ClickOnce 應用程式部署

當您在命令列叫用 (Invoke) msbuild /target:publish，它會告訴 MSBuild 系統，建置專案並在發行資料夾中建立 ClickOnce 應用程式。這相當於在 IDE 中選取 [發行] 命令。

這個命令會執行 msbuild.exe，它位於 Visual Studio 命令提示字元環境中的路徑。

"target" 向 MSBuild 指示如何處理命令。主要目標為「建置」目標和「發行」目標。建置目標相當於在 IDE 中選取 [建置] (或按 F5) 命令。如果您只要建置專案，可以輸入 msbuild，完成此作業。因為建置目標是所有由 Visual Studio 所產生專案的預設目標，所以這個命令有作用。這表示您不必明確指定建置目標。因此，輸入 msbuild 與輸入 msbuild /target:build 會執行相同作業。

/target:publish 命令告訴 MSBuild，叫用發行目標。發行目標相依於建置目標。這表示發行作業是建置作業的超集。例如，如果您變更其中一個 Visual Basic 或 C# 原始程式檔，則發行作業會自動重新建置對應的組件。

如需使用 Mage.exe 命令列工具建立 ClickOnce 資料清單，產生完整 ClickOnce 部署的詳細資訊，請參閱逐步解說：手動部署 ClickOnce 應用程式。

使用 MSBuild 建立和建置基本的 ClickOnce 應用程式

若要建立和發行 ClickOnce 專案

  1. 從 [檔案] 功能表中，按一下 [新增專案]。[新增專案] 對話方塊便會出現。

  2. 選取 [Windows 應用程式]，並為它命名為 CmdLineDemo。

  3. 從 [建置] 功能表中，按一下 [發行] 命令。

    這個步驟可確保專案正確設定為產生 ClickOnce 應用程式部署。

    [發行精靈] 隨即出現。

  4. 在 [發行精靈] 中，按一下 [完成]。

    Visual Studio 隨即會產生和顯示名稱為 Publish.htm 的預設 Web 網頁。

  5. 儲存專案，並記下儲存專案的資料夾位置。

上面的步驟會建立 ClickOnce 專案，這個專案已經第一次發行。現在您可以在 IDE 以外重新產生組建。

若要從命令列重新產生組建

  1. 結束 Visual Studio。

  2. 從 Windows [開始] 功能表，依序按一下 [所有程式]、[Microsoft Visual Studio 2008]、[Visual Studio Tools] 和 [Visual Studio 2008 命令提示字元]。這應該會開啟一個命令提示字元，其位置便在目前使用者的根資料夾中。

  3. 在 [Visual Studio 2008 命令提示字元]，將目前目錄切換到前面剛建置好的專案位置。例如，輸入 chdir My Documents\Visual Studio\Projects\CmdLineDemo。

  4. 若要移除上面＜若要建立和建置 ClickOnce 專案＞中產生的現有檔案，請輸入 rmdir /s publish。

    這個步驟是選擇性，但這個動作會確保所有新檔案都是由此命令列組建產生的。

  5. 輸入 msbuild /target:publish。

上面的步驟將會在專案中名稱為 [Publish] 的子資料夾，產生完整的 ClickOnce 應用程式部署。CmdLineDemo.application 是 ClickOnce 部署資訊清單。資料夾 CmdLineDemo_1.0.0.0 包含檔案 CmdLineDemo.exe 和 CmdLineDemo.exe.manifest (ClickOnce 應用程式資訊清單)。Setup.exe 是啟動載入器 (Bootstrapper)，預設為安裝 .NET Framework。DotNetFX 資料夾包含 .NET Framework 的可轉散發套件。這些就是透過 Web、UNC 或 CD/DVD 部署應用程式所需的完整檔案集。

發行屬性

當您用以上的程序發行應用程式時，[發行精靈] 會將下列屬性插入專案檔。這些屬性直接影響 ClickOnce 應用程式的產生方式。

CmdLineDemo.vbproj / CmdLineDemo.csproj：

<AssemblyOriginatorKeyFile>WindowsApplication3.snk</AssemblyOriginatorKeyFile>
<GenerateManifests>true</GenerateManifests>
<TargetZone>LocalIntranet</TargetZone>
<PublisherName>Microsoft</PublisherName>
<ProductName>CmdLineDemo</ProductName>
<PublishUrl>https://localhost/CmdLineDemo</PublishUrl>
<Install>true</Install>
<ApplicationVersion>1.0.0.*</ApplicationVersion>
<ApplicationRevision>1</ApplicationRevision>
<UpdateEnabled>true</UpdateEnabled>
<UpdateRequired>false</UpdateRequired>
<UpdateMode>Foreground</UpdateMode>
<UpdateInterval>7</UpdateInterval>
<UpdateIntervalUnits>Days</UpdateIntervalUnits>
<UpdateUrlEnabled>false</UpdateUrlEnabled>
<IsWebBootstrapper>true</IsWebBootstrapper>
<BootstrapperEnabled>true</BootstrapperEnabled>

您可以在命令列覆寫這些屬性，而不需變更專案檔本身。例如，下列將會建置不含啟動載入器的 ClickOnce 應用程式部署：

msbuild /target:publish /property:BootstrapperEnabled=false

在 Visual Studio 中，從 [專案設計工具] 的 [發行]、[安全性] 和 [簽章] 屬性頁面，控制發行屬性。以下是發行屬性的描述，以及在應用程式設計工具的各個屬性頁中如何設定屬性的指示：

  • AssemblyOriginatorKeyFile 決定簽署 ClickOnce 應用程式資訊清單所使用的金鑰檔。這個金鑰也可以用來簽署組件的強式名稱。在 [專案設計工具] 的 [簽章] 頁面中，設定這個屬性。

下列屬性在 [安全性] 頁面中設定：

  • [啟用 ClickOnce 安全性設定] 可決定是否產生 ClickOnce 資訊清單。最初建立專案時，產生 ClickOnce 資訊清單的功能預設為關閉。當您第一次發行時，精靈會自動開啟這個旗標。

  • TargetZone 決定發出給 ClickOnce 應用程式資訊清單的信任層級。可能值為 "Internet"、"LocalIntranet" 和 "Custom"。Internet 和 LocalIntranet 將會造成預設權限集發出至 ClickOnce 應用程式資訊清單。LocalIntranet 為預設值，基本上表示完全信任。Custom 指定只有基底 app.manifest 檔案中明確指定的權限，才會發出至 ClickOnce 應用程式資訊清單。app.manifest 檔案是部分資訊清單檔案，只包含信任資訊定義。它是隱藏檔案，當您在 [安全性] 頁面中設定權限時，便會自動加入至專案。

下列屬性在 [發行] 頁面中設定：

  • PublishUrl 是應用程式在 IDE 中發行時的目標位置。如果未指定 InstallUrl 或 UpdateUrl 屬性，就會將它插入 ClickOnce 應用程式資訊清單。

  • ApplicationVersion 指定 ClickOnce 應用程式的版本。這是四碼版本號碼。如果最後一碼是 "*"，則在建置時間 ApplicationRevision 會取代資訊清單中所插入的值。

  • ApplicationRevision 會指定修訂。這是整數，每次您在 IDE 發行時，這個整數會累加。請注意，對於在命令列執行的組建，它不會自動累加。

  • Install 可以判斷應用程式是安裝的應用程式還是從 Web 執行的應用程式。

  • InstallUrl (未顯示) 是使用者安裝應用程式的來源位置。如果指定，這個值就會燒錄至 setup.exe 啟動載入器 (如果已啟用 IsWebBootstrapper 屬性)。如果未指定 UpdateUrl，也會將此值插入應用程式資訊清單。

  • SupportUrl (未顯示) 是 [新增或移除程式] 對話方塊中已安裝程式的連結位置。

下列屬性在 [應用程式更新] 對話方塊 (從 [發行] 頁面存取) 中設定。

  • UpdateEnabled 指出應用程式是否應該檢查更新檔。

  • UpdateMode 指定前景更新或背景更新。

  • UpdateInterval 指定應用程式應該檢查更新檔的頻率。

  • UpdateIntervalUnits 指定 UpdateInterval 值的單位：小時、天數或週數。

  • UpdateUrl (未顯示) 是應用程式將接收更新檔的來源位置。如果指定，這個值會插入應用程式資訊清單。

  • 下列屬性在 [發行選項] 對話方塊 (從 [發行] 頁面存取) 中設定。

  • PublisherName 指定發行者的名稱，當安裝或執行應用程式時，它會顯示在提示中。在安裝的應用程式案例中，它也用來指定 [開始] 功能表上的資料夾名稱。

  • ProductName 指定產品的名稱，當安裝或執行應用程式時，它會顯示在提示中。在安裝的應用程式案例中，它也用來指定 [開始] 功能表上的捷徑名稱。

  • 下列屬性在 [必要條件] 對話方塊 (從 [發行] 頁面存取) 中設定。

  • BootstrapperEnabled 能夠判斷是否要產生 setup.exe 啟動載入器。

  • IsWebBootstrapper 能夠判斷 setup.exe 啟動載入器是透過 Web 還是以磁碟架構的模式運作。

InstallURL、SupportUrl 和 PublishURL

您可以指定三個 URL：InstallURL、SupportUrl 和 PublishURL。如果您發行至 Web URL，則只需要指定 PublishURL。只有在與 PublishURL 不同時，才需要指定其他 URL。在 IDE 中，您可能想要發行到與使用者安裝位置不同的位置。例如，您可以將 PublishURL 設為 FTP 路徑，並且將 InstallURL 設為 Web URL。在這個情況下，PublishURL 只用於 IDE 傳輸檔案，但不用於命令列組建。最後，如果您要發行的 ClickOnce 應用程式，會從安裝位置以外的地方自行更新，便可以使用 UpdateUrl。

請參閱

工作

逐步解說：手動部署 ClickOnce 應用程式

概念

MSBuild 概觀

其他資源

ClickOnce 部署

變更記錄

日期

記錄

原因

2008 年 7 月

更新 TargetZone 屬性之有效值的清單。

內容 Bug 修正。