Windows Dev Center

DeploymentOptions enumeration

Specifies the package deployment options.

Syntax


var value = Windows.Management.Deployment.DeploymentOptions.none;

Members

The DeploymentOptions enumeration has these members.

MemberValueDescription
None | none0

The default behavior is used.

ForceApplicationShutdown | forceApplicationShutdown1

If this package, or any package that depends on this package, is currently in use, the processes associated with the package are shut down forcibly so that registration can continue.

DevelopmentMode | developmentMode2

When you set this option, the app is installed in development mode. For info about development mode, see Remarks. Use this option to enable key app development scenarios.

You can't use this option in conjunction with a bundle package. If you use this option with a bundle package, your call returns ERROR_INSTALL_FAILED.

InstallAllResources | installAllResources32

When you set this option, the app is instructed to skip resource applicability checks. This effectively stages or registers all resource packages that a user passes in to the command, which forces applicability for all packages contained in a bundle. If a user passes in a bundle, all contained resource packages will be registered. Windows only.

ForceTargetApplicationShutdown | forceTargetApplicationShutdown64

If this package is currently in use, the processes associated with the package are shut down forcibly so that registration can continue.

Remarks

You can use the DevelopmentMode option to install apps without requiring an app package. Instead, the deployment engine processes the AppxManifest.xml file directly, which allows for a more rapid development cycle. The BlockMap.xml, [Content_Types].xml, and digital signature files are not required for app installation in DevelopmentMode.

To successfully install an app in DevelopmentMode, it must meet these additional conditions beyond what is typically required for Windows Store apps:

  • The app must be unique to the current user account. No other user can have an app with the same package family name installed on the computer.
  • If a previous version of the app was installed, the previous version must also be installed in DevelopmentMode. Windows Store apps can't be updated with a DevelopmentMode app and vice versa.
  • The app must be on an NTFS partition. Partitions with other formats are unsupported.
  • The app must be on a local drive. Installation from network locations is unsupported.
  • The app must be in an unencrypted location. Installation from encrypted directories is unsupported.
  • The app can't be installed from the WindowsApps directory.

If any of the preceding conditions aren't met, installation fails.

Additionally, to simplify and enhance the app development experience, these key operating system behaviors are modified when an app is installed in DevelopmentMode:

  • App payload files can be modified. If you modify an app payload file, the changes are reflected next time the app is launched. You don't need to reinstall the app unless you modify the AppxManifest.xml file.
  • Bytecode generation and NGEN are disabled. JS bytecode generation and .NET binary NGEN are disabled on DevelopmentMode packages to let you modify payload files without reinstalling your app.
  • App payload files aren't removed when the app is uninstalled. Because these files are potentially your source code, Windows doesn't delete these files when an app is uninstalled.
  • Network loopback is allowed. You must opt-in to network loopback as described in How to enable loopback and troubleshoot network isolation.
  • The app can be launched in DesignMode. For info about the DesignMode class, see DesignMode class.

Requirements (Windows 10 device family)

Device family

Universal

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.Management.Deployment
Windows::Management::Deployment [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.Management.Deployment
Windows::Management::Deployment [C++]

Metadata

Windows.winmd

Attributes

[Flags()]
[Version(0x06020000)]

See also

PackageManager.AddPackageAsync
PackageManager.RegisterPackageAsync
PackageManager.UpdatePackageAsync

 

 

Show:
© 2015 Microsoft