DeploymentOptions 枚举

  • 参考

定义

命名空间:
Windows.Management.Deployment
编辑

指定包部署选项。

此枚举支持其成员值的按位组合。

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
继承
Enum
DeploymentOptions
属性
FlagsAttribute ContractVersionAttribute

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 中安装以前的版本。 不能使用 DevelopmentMode 应用更新 UWP 应用，反之亦然。
  • 应用必须位于 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

适用于

另请参阅