GenerateDeploymentManifest 工作

產生 ClickOnce 部署資訊清單。ClickOnce 部署資訊清單藉由定義部署的唯一識別、識別部署特性 (如安裝或線上模式) 指定應用程式更新設定和更新位置,並指出對應的 ClickOnce 應用程式資訊清單,以描述應用程式的部署。

參數

下表說明 GenerateDeploymentManifest 工作的參數。

參數

描述

AssemblyName

選擇性 String 參數。

為已產生的資訊清單指定組件識別的 Name 欄位。如果沒有指定此參數,就會從 EntryPointInputManifest 參數推斷名稱。如果無法推斷名稱,工作便會擲回錯誤。

AssemblyVersion

選擇性 String 參數。

為已產生的資訊清單指定組件識別的 Version 欄位。如果未指定此參數,工作便會使用 "1.0.0.0" 的值。

CreateDesktopShortcut

選擇性 Boolean 參數。

如果為 true,則會在 ClickOnce 應用程式安裝期間在桌面上建立圖示。

DeploymentUrl

選擇性 String 參數。

指定應用程式的更新位置。如果未指定此參數,就不會為應用程式定義更新位置。然而,如果 UpdateEnabled 參數為 true,就必須指定更新位置。指定的值應該是完整的 URL 或 UNC 路徑。

Description

選擇性 String 參數。

指定應用程式的選擇性描述。

DisallowUrlActivation

選擇性 Boolean 參數。

指定應用程式是否該在透過 URL 開啟時自動執行。如果此參數為 true,應用程式就只能從 [開始] 功能表啟動。此參數的預設值為 false。此輸入只有在 Install 參數值為 true 時適用。

EntryPoint

選擇性 ITaskItem[] 參數。

指出產生之資訊清單組件的進入點 (Entry Point)。對於 ClickOnce 部署資訊清單,這項輸入會指定 ClickOnce 應用程式資訊清單。

在 Visual Studio 2005 中,GenerateApplicationManifest 工作需要使用 EntryPoint 來產生應用程式資訊清單 (組件或原生資訊清單不需要使用 EntryPoint)。 根據建置錯誤:「MSB3185: 未指定資訊清單的 EntryPoint」,會強制執行這個需求。

當沒有指定 EntryPoint 工作參數時, MSBuild 就不會發出這個錯誤。但是會插入 <customHostSpecified> 標記做為 <entryPoint> 標記的子系,例如:

<entryPoint xmlns="urn:schemas-

microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

您可以執行下列步驟,將 DLL 相依性加入至應用程式資訊清單:

  1. 透過呼叫 ResolveAssemblyReference,解析組件的參考。

  2. 將上一個工作的結果和組件本身傳遞至 ResolveManifestFiles

  3. 使用 Dependencies 參數,將相依性傳遞至 GenerateApplicationManifest

ErrorReportUrl

選擇性 [String] 參數。

指定在 ClickOnce 安裝期間對話方塊中所顯示網頁的 URL。

InputManifest

選擇性 ITaskItem 參數。

表示輸入 XML 文件,做為資訊清單產生器的基底。這可讓像是自訂資訊清單定義的結構化資料,反映在輸出資訊清單中。XML 文件中的根項目 (Root Element) 必須是 asmv1 命名空間中的組件節點。

Install

選擇性 Boolean 參數。

指定應用程式為已安裝的應用程式或是僅限線上的應用程式。如果此參數為 true,應用程式就會安裝到使用者的 [開始] 功能表中,並能從 [新增或移除程式] 對話方塊中移除。如果此參數為 false,應用程式就只能從網頁提供線上使用。此參數的預設值為 true。

MapFileExtensions

選擇性 Boolean 參數。

指定是否使用 .deploy 副檔名對應。如果此參數為 true,則每個程式檔案都會以 .deploy 副檔名發行。當 Web 伺服器安全性為啟用 ClickOnce 應用程式部署而限制必須解除封鎖的副檔名數目時,這個選項就很有用。此參數的預設值為 false。

MaxTargetPath

選擇性 String 參數。

指定 ClickOnce 應用程式部署中檔案路徑允許的長度上限。如果有指定此參數,就會對應用程式中每個檔案路徑的長度檢查這項限制。任何超過限制的項目都會導致建置警告。如果未指定此輸入或其值為零,就不會執行任何檢查。

MinimumRequiredVersion

選擇性 String 參數。

指定使用者是否能夠略過更新。如果使用者擁有低於最小需求的版本,就不會擁有略過更新的選項。此輸入只有在 Install 參數的值為 true 時適用。

OutputManifest

選擇性 ITaskItem 參數。

指定產生之輸出資訊清單檔的名稱。如果未指定此參數,就會從產生的資訊清單之識別中推斷輸出檔的名稱。

Platform

選擇性 String 參數。

指定應用程式的目標平台。這個參數可能具有下列其中一個值:

  • AnyCPU

  • x86

  • x64

  • Itanium

預設值是 AnyCPU

Product

選擇性 String 參數。

指定應用程式的名稱。如果未指定此參數,就會從產生資訊清單的識別推斷名稱。此名稱用於 [開始] 功能表上的捷徑名稱,而且是出現在 [新增或移除程式] 對話方塊中名稱的一部分。

Publisher

選擇性 String 參數。

指定應用程式的發行者。如果未指定此參數,就會從註冊的使用者,或是產生資訊清單的識別推斷名稱。此名稱用於 [開始] 功能表上的資料夾名稱,而且是出現在 [新增或移除程式] 對話方塊中名稱的一部分。

SuiteNamel

選擇性 String 參數。

指定 [開始] 功能表中應用程式在 ClickOnce 部署之後所在資料夾的名稱。

SupportUrl

選擇性 String 參數。

指定出現在 [新增或移除程式] 對話方塊中的應用程式連結。指定的值應該是完整的 URL 或 UNC 路徑。

TargetCulture

選擇性 String 參數。

識別應用程式的文化特性 (Culture),並指定產生資訊清單之組件識別的 Language 欄位。如果未指定此參數,就會假設應用程式不因文化特性而異。

TrustUrlParameters

選擇性 Boolean 參數。

指定是否應該讓 URL 查詢字串參數能在應用程式使用。此參數的預設值為 false,表示該參數無法提供應用程式使用。

UpdateEnabled

選擇性 Boolean 參數。

表示應用程式是否啟用更新。此參數的預設值為 false。此參數只有在 Install 參數的值為 true 時適用。

UpdateInterval

選擇性 Int32 參數。

指定應用程式的更新間隔。此參數的預設值為零。這個參數只適用於 InstallUpdateEnabled 參數的值都是 true 時。

UpdateMode

選擇性 String 參數。

指定是否在啟動應用程式之前於前景中檢查更新,或是當應用程式執行時,才在背景中檢查更新。這個參數可能具有下列其中一個值:

  • Foreground

  • Background

此參數的預設值為 Background。這個參數只適用於 InstallUpdateEnabled 參數的值都是 true 時。

UpdateUnit

選擇性 String 參數。

指定 UpdateInterval 參數的單位。這個參數可能具有下列其中一個值:

  • Hours

  • Days

  • Weeks

這個參數只適用於 InstallUpdateEnabled 參數的值都是 true 時。

備註

除了以上列出的參數之外,此項工作還會繼承 GenerateManifest 類別中的參數,而該類別本身又繼承 Task 類別。如需 Task 類別的參數清單,請參閱 工作基底類別

請參閱

參考

GenerateApplicationManifest 工作

SignFile 工作

概念

MSBuild 工作

其他資源

MSBuild 工作參考