확장(패키지/확장)(Windows 10)

  • 아티클

패키지의 확장 지점을 선언합니다.

요소 계층 구조

<패키지>

    <확장>

         <확장>

구문

<Extension
  Category = 'A string that can have one of the following values: "windows.activatableClass.inProcessServer", "windows.activatableClass.outOfProcessServer", "windows.activatableClass.proxyStub", "windows.certificates", "windows.publisherCacheFolders", "windows.comInterface", or "windows.loaderSearchPathOverride".'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' 
  uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".'>

  <!-- Child elements -->
  InProcessServer
  OutOfProcessServer
  ProxyStub
  Certificates
  PublisherCacheFolders
  com:ComInterface
  uap6:LoaderSearchPathOverride

</Extension>

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
범주 패키지 확장성 지점의 형식입니다. windows.activatableClass.inProcessServer, windows.activatableClass.outOfProcessServer, windows.activatableClass.proxyStub, windows.certificates, windows.publisherCacheFolders, windows.comInterface 또는 windows.loaderSearchPathOverride 값 중 하나를 가질 수 있는 문자열입니다. Yes
uap10:TrustLevel 확장의 신뢰 수준을 지정합니다. appContainer 또는 mediumIL 값 중 하나를 가질 수 있는 선택적 문자열입니다. No
uap10:RuntimeBehavior 확장의 런타임 동작을 지정합니다. windowsApp, packagedClassicApp 또는 win32App 값 중 하나를 가질 수 있는 선택적 문자열입니다. No
uap10:HostId 이 값 확장에 대 한 호스트 런타임의 ID를 지정 합니다. 길이가 1~255자인 영숫자 문자열입니다. 문자로 시작해야 합니다.
uap10:Parameters 확장에 대한 명령줄 매개 변수를 포함합니다. 시작과 끝에 공백이 아닌 문자가 있는 길이가 1자에서 32767자 사이의 문자열입니다. No
uap11:Id 확장의 식별자입니다. ID는 패키지의 모든 확장에 대해 고유해야 합니다. 시작과 끝에 공백이 아닌 문자가 있는 길이가 1~255자인 선택적 문자열입니다. No
uap11:하위 시스템 이 특성은 기본 확장 구문에서 상속되며 com4 확장에는 적용되지 않습니다. 구문 유효성 검사 외에 이 값은 무시됩니다. 콘솔 또는 창 값 중 하나를 가질 수 있는 선택적 문자열입니다. No
uap11:SupportsMultipleInstances 인스턴스를 다른 프로세스에서 실행할지 여부를 지정합니다. 기본값은 false입니다. 선택적 부울 값입니다. No
uap11:ResourceGroup 리소스 관리 목적(예: CPU 및 메모리)을 위해 확장 활성화를 그룹화하는 데 사용할 수 있는 태그입니다. ResourceGroup을 설정할 수 있는 값은 자유 형식이며 유연합니다. Application@ResourceGroup 참조하세요. 길이가 1~255자인 선택적 영숫자 문자열입니다. 문자로 시작해야 합니다. No
uap11:CurrentDirectoryPath 애플리케이션 프로세스가 시작될 때 초기 디렉터리를 지정합니다. 이 특성은 매크로를 지원합니다. 자세한 내용은 패키지 매니페스트 스키마의 매크로를 참조하세요. , ?>|또는 *문자를 <포함할 수 없는 선택적 문자열입니다. > No
uap11:Parameters 이 특성은 기본 확장 구문에서 상속되며 com4 확장에는 적용되지 않습니다. 구문 유효성 검사 외에 이 값은 무시됩니다. 이 특성은 매크로를 지원합니다. 자세한 내용은 패키지 매니페스트 스키마의 매크로를 참조하세요. 시작과 끝에 공백이 아닌 문자가 있는 길이가 1~32767자인 선택적 문자열입니다. No
desktop7:CompatMode 이 확장의 정보가 클래식 방식으로 Windows에 등록되는지(예: 패키지되지 않은 앱이 레지스트리를 통해 COM에 형식을 등록하는지) 또는 좀 더 범위가 지정된 새로운 방식으로 등록할지를 지정합니다. 기본값은 "최신"입니다. CompatMode="classic"에는 Microsoft.classicAppCompat_8wekyb3d8bbwe 기능이 필요합니다. 선택적 문자열은 클래식 또는 최신 값 중 하나를 가질 수 있습니다. No
desktop7:Scope 이 패키지가 등록된 사용자(사용자)로 실행 중인 다른 애플리케이션에만 등록이 표시되는지 또는 컴퓨터(컴퓨터)의 모든 사용자 및 서비스에 표시되는지 여부를 지정합니다. 기본값은 "user"입니다. Scope="machine"에는 Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 기능이 필요합니다. 컴퓨터 또는 사용자 값 중 하나를 가질 수 있는 선택적 문자열입니다. No

자식 요소

자식 요소 Description
인증서 windows.certificates 형식의 패키지 확장성 지점을 선언합니다. 앱에는 지정된 인증서 저장소의 인증서가 하나 이상 필요합니다.
InProcessServer windows.activatableClass.inProcessServer 형식의 패키지 확장성 지점을 선언합니다. 앱은 하나 이상의 활성화 가능한 클래스를 노출하는 동적 링크 라이브러리(.dll)를 사용합니다.
OutOfProcessServer windows.activatableClass.outOfProcessServer 형식의 패키지 확장 지점을 선언합니다. 앱은 하나 이상의 활성화 가능한 클래스를 노출하는 실행 파일(.exe)을 사용합니다.
ProxyStub windows.activatableClass.proxyStub 형식의 패키지 확장성 지점을 선언합니다. 프록시는 하나 이상의 인터페이스로 구성될 수 있습니다.
PublisherCacheFolders windows.publisherCacheFolders 형식의 패키지 확장성 지점을 선언합니다. 패키지가 동일한 게시자의 다른 패키지와 공유하는 하나 이상의 폴더를 지정합니다.
com:ComInterface windows.comInterface 형식의 패키지 확장 지점을 선언합니다.
uap6:LoaderSearchPathOverride windows.loaderSearchPathOverride 형식의 패키지 확장 지점을 선언합니다.

부모 요소

부모 요소 Description
확장(형식: CT_PackageExtensions) 패키지에 대한 하나 이상의 확장성 지점을 정의합니다.

다음 요소는 이 요소와 이름이 같지만 콘텐츠나 특성은 다릅니다.

설명

확장성 지점은 패키지가 운영 체제에서 정의한 방식으로 기능을 추가할 수 있는 메커니즘입니다. 확장성 지점은 앱이 등록하여 코드를 실행하거나 현재 패키지의 리소스를 사용할 수 있는 위치입니다. 특정 앱에 대한 기능을 추가하려면 Applications 요소의 Application 자식 요소를 사용합니다.

windows.certificates 확장성 지점은 매니페스트에서 여러 번 선언할 수 없습니다.

추가 정보

요구 사항

항목 값
Namespace http://schemas.microsoft.com/appx/manifest/foundation/windows10
Com http://schemas.microsoft.com/appx/manifest/com/windows10
uap6 http://schemas.microsoft.com/appx/manifest/uap/windows10/10