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 にインストールする必要があります。 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

適用対象

こちらもご覧ください