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

适用于

另请参阅