DeploymentOptions 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
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 |