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 파일을 직접 처리하므로 더 빠른 개발 주기가 가능합니다. BlockMap.xml, [Content_Types].xml 및 디지털 서명 파일은 DevelopmentMode에서 앱을 설치하는 데 필요하지 않습니다.

DevelopmentMode에 앱을 성공적으로 설치하려면 UWP 앱에 일반적으로 필요한 것 이상으로 이러한 추가 조건을 충족해야 합니다.

  • 앱은 현재 사용자 계정에 고유해야 합니다. 다른 사용자는 컴퓨터에 동일한 패키지 패밀리 이름을 가진 앱을 설치할 수 없습니다.
  • 이전 버전의 앱이 설치된 경우 이전 버전도 DevelopmentMode에 설치해야 합니다. UWP 앱은 DevelopmentMode 앱으로 업데이트할 수 없으며 그 반대의 경우도 마찬가지입니다.
  • 앱은 Microsoft Windows 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

적용 대상

추가 정보