共用方式為


DeploymentOptions 列舉

定義

指定套件部署選項。

此列舉支援其成員值的位元組合。

public enum class DeploymentOptions
/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class DeploymentOptions
[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum DeploymentOptions
var value = Windows.Management.Deployment.DeploymentOptions.none
Public Enum DeploymentOptions
繼承
DeploymentOptions
屬性

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

欄位

DevelopmentMode 2

當您設定此選項時,應用程式會安裝在開發模式中。 如需開發模式的相關資訊,請參閱。 使用此選項來啟用重要的應用程式開發案例。您無法將此選項與套件組合套件搭配使用。 如果您搭配套件組合套件使用此選項,則呼叫會傳回ERROR_INSTALL_FAILED。

ForceApplicationShutdown 1

如果此套件或任何相依于此套件的套件目前正在使用中,則與封裝相關聯的進程會強制關閉,以便繼續註冊。

ForceTargetApplicationShutdown 64

如果此套件目前正在使用中,則與封裝相關聯的進程會強制關閉,以便繼續註冊。

ForceUpdateFromAnyVersion 262144

強制暫存/註冊特定版本的套件,不論是否已暫存/註冊更高版本。

InstallAllResources 32

當您設定此選項時,系統會指示應用程式略過資源適用性檢查。 這會有效地階段或註冊使用者傳遞至 命令的所有資源套件,這會強制套用套件組合中包含的所有套件。 如果使用者傳入套件組合,則會註冊所有自主資源套件。 僅限 Windows。

None 0

會使用預設行為。

RequiredContentGroupOnly 256

當您設定此選項時,只會暫存必要的內容群組。 應用程式可以單獨安裝為具有必要內容群組的套件。

RetainFilesOnFailure 2097152

如果部署失敗,請勿移除在安裝過程中已在目的電腦上建立的檔案。

StageInPlace 4194304

當您設定此選項時,封裝將會就地暫存。 此欄位適用于通知系統以準備虛擬桌面案例中的應用程式註冊。

備註

您可以使用 DevelopmentMode 選項來安裝應用程式,而不需要應用程式套件。 相反地,部署引擎會直接處理 AppxManifest.xml 檔案,這可讓開發週期更快速。 在 DevelopmentMode中安裝應用程式時,不需要 BlockMap.xml[Content_Types].xml 和數位簽章檔案。

若要在 DevelopmentMode中成功安裝應用程式,它必須符合 UWP 應用程式通常需要的其他條件:

  • 應用程式必須是唯一的目前使用者帳戶。 其他使用者無法在電腦上安裝具有相同套件系列名稱的應用程式。
  • 如果已安裝舊版的應用程式,則先前的版本也必須安裝在 DevelopmentMode 中。 UWP 應用程式無法使用 DevelopmentMode 應用程式進行更新,反之亦然。
  • 應用程式必須位於 Microsoft Windows NT 檔案系統 (NTFS) 分割區上。 不支援具有其他格式的資料分割。
  • 應用程式必須位於本機磁片磁碟機上。 不支援從網路位置安裝。
  • 應用程式必須位於未加密的位置。 不支援從加密目錄安裝。
  • 無法從 WindowsApps 目錄安裝應用程式。 如果不符合上述任一條件,安裝就會失敗。

此外,為了簡化並增強應用程式開發體驗,在 DevelopmentMode中安裝應用程式時,會修改這些重要的作業系統行為:

  • 您可以修改應用程式承載檔案。 如果您修改應用程式承載檔案,下次啟動應用程式時會反映變更。 除非您修改 AppxManifest.xml 檔案,否則不需要重新安裝應用程式。
  • 已停用位元組程式碼產生和 NGEN。 在 DevelopmentMode套件上停用 JS 位元組程式碼產生和 .NET 二進位 NGEN,可讓您修改承載檔案,而不需重新安裝您的應用程式。
  • 卸載應用程式時,不會移除應用程式承載檔案。 因為這些檔案可能是您的原始程式碼,所以當應用程式卸載時,Windows 不會刪除這些檔案。
  • 允許網路回送。 您必須加入宣告網路回送,如 如何啟用回送並針對網路隔離進行疑難排解中所述。
  • 應用程式可以在 DesignMode中啟動。 如需 DesignMode 類別的相關資訊,請參閱 DesignMode 類別

版本歷程記錄

Windows 版本 SDK 版本 已新增值
1703 15063 RequiredContentGroupOnly
1809 17763 ForceUpdateFromAnyVersion
1903 18362 RetainFilesOnFailure
2004 19041 StageInPlace

適用於

另請參閱