다음을 통해 공유

확장(애플리케이션/확장)(Windows 10)

  • 아티클

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

요소 계층 구조

<패키지>

    <애플리케이션>

         <애플리케이션>

              <확장>

                   <확장>

Syntax

<Extension
  Category = 'One of the following values: "windows.backgroundTasks", "windows.preInstalledConfigTask", "windows.updateTask", or "windows.restrictedLaunch".'
  Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. Specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (normally the fully namespace-qualified name of a Windows Runtime type). If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  RuntimeType = 'A string with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:TrustLevel = 'An optional string value. If specified, it must be either "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior  = 'An optional string value. If specified, it must be one of the following values:  "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with an letter.'
  uap10:Parameters = 'A string with an optional value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
/>

  <!-- Child elements -->
  BackgroundTasks?

</Extension>

키

? 선택 사항(0개 또는 1개)

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
범주 패키지 확장성 지점의 유형입니다. windows.backgroundTasks, windows.preInstalledConfigTask, windows.updateTask 또는 windows.restrictedLaunch 값 중 하나일 수 있습니다. Yes
EntryPoint 활성화 가능한 클래스 ID입니다. 길이가 1~256자인 문자열입니다. 확장을 처리하는 작업(일반적으로 Windows 런타임 형식의 정규화된 네임스페이스 이름)을 나타냅니다. EntryPoint를 지정하지 않으면 앱에 대해 정의된 EntryPoint가 대신 사용됩니다. No
실행 파일 기본 시작 실행 파일입니다. 길이가 1~256자인 문자열로, 로 끝나.exe야 하며 , , , ">:|?또는 *문자를 <포함할 수 없습니다. 확장의 기본 실행 파일을 지정합니다. 지정하지 않으면 앱에 대해 정의된 실행 파일이 사용됩니다. 지정한 경우 EntryPoint 속성도 사용됩니다. 해당 EntryPoint 속성을 지정하지 않으면 앱에 대해 정의된 EntryPoint가 사용됩니다. No
RuntimeType 런타임 공급자입니다. 일반적으로 앱에 혼합된 프레임워크가 있을 때 사용됩니다. 로 시작하거나 끝낼 .<수 없는 길이가 1~255자인 문자열입니다( , , >, :", |, ?또는 *). No
StartPage 확장성 지점을 처리하는 웹 페이지입니다. , ?>*:|"또는 문자를 포함할 수 없는 길이가 1~256자<인 문자열입니다. No
ResourceGroup 리소스 관리 용도(예: CPU 및 메모리)를 위해 확장 활성화를 그룹화하는 데 사용되는 선택적 태그입니다. Application@ResourceGroup설명 섹션을 참조하세요. 길이가 1~255자인 영숫자 문자열입니다. 문자로 시작해야 합니다. No
uap10:TrustLevel 확장의 신뢰 수준을 지정합니다. 선택적 문자열 값입니다. 지정된 경우 appContainer 또는 mediumIL 값 중 하나일 수 있습니다. No
uap10:RuntimeBehavior 확장의 런타임 동작을 지정합니다.

자세한 내용과 요구 사항은 애플리케이션(Windows 10) 요소에 대한 항목을 참조 uap10:RuntimeBehavior 하세요.		 선택적 문자열 값입니다. 지정된 경우 "packagedClassicApp", "win32App" 또는 "windowsApp" 값 중 하나일 수 있습니다. No
uap10:HostId 확장에 대한 호스트 런타임의 ID를 지정합니다. 길이가 1~255자인 선택적 값이 있는 영숫자 문자열입니다. 문자로 시작해야 합니다. No
uap10:Parameters 확장에 전달할 명령줄 매개 변수를 포함합니다. 데스크톱 앱에 대해서만 지원됩니다. 시작과 끝에 공백이 아닌 문자가 있는 길이가 1~32767자인 문자열입니다. No

자식 요소

자식 요소 Description
BackgroundTasks windows.backgroundTasks 형식의 앱 확장성 지점을 정의합니다. 백그라운드 작업은 전용 백그라운드 호스트에서 실행됩니다. 즉, UI가 없는 경우

부모 요소

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

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

설명

활성화 정보 특성이 확장에 지정되지 않은 경우 부모 애플리케이션에서 상속됩니다. Application 요소에 대한 설명 섹션을 참조하세요.

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

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

참고

Categorywindows.UpdateTaskwindows.preInstalledConfigTask 특성이 또는 버전 1607 Windows 10 이전의 Windows 10 버전에 대해 EntryPoint 또는 StartPage 특성이 필요합니다. Windows 10 버전 1607부터는 Categorywindows.Use가 , UpdateTask일 때 또는 Windows 10 버전 1607 이상을 실행하는 디바이스만 대상으로 지정하기 위해 EntryPoint 또는 windows.preInstalledConfigTaskStartPage에 대한 값을 더 이상 지정할 필요가 없습니다.

추가 정보

개념앱 계약 및 확장

요구 사항

항목 값
네임스페이스 http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10