uap4:Extension

Description

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

요소 계층 구조

<패키지>
<애플리케이션>
<애플리케이션>
<확장>
<uap4:Extension>

Syntax

<uap4:Extension Category       = "windows.sharedFonts" | "windows.userDataTaskDataProvider" | "windows.mediaCodec" | "windows.contactPanel" | "windows.loopbackAccessRules" | "windows.devicePortalProvider" | "windows.printWorkflowBackgroundTask" | "windows.printWorkflowForegroundTask"
                   Executable?    = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It 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 that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
                   EntryPoint?    = A string between 1 and 256 characters in length, representing the  task handling the extension. This is 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 between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.
                   StartPage?     = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. 
                   ResourceGroup? = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. 
                   uap10:TrustLevel?       = String value. Can be one of the following: "appContainer", "mediumIL".
                   uap10:RuntimeBehavior?  = String value. Can be one of the following: "windowsApp", "packagedClassicApp", "win32App".
                   uap10:HostId?           = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.
                   uap10:Parameters?       = A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. >

  <!-- Child elements -->
  ( uap4:SharedFonts
  | uap4:UserDataTaskDataProvider
  | uap4:MediaCodec 
  | uap4:ContactPanel
  | uap4:LoopbackAccessRules
  | uap4:DevicePortalProvider )?

</uap4:Extension>

? 선택 사항(0 또는 1)

특성

attribute Description 데이터 형식 필수
범주 확장의 범주입니다. 다음 중 하나
  • windows.sharedFonts
  • windows.userDataTaskDataProvider
  • windows.mediaCodec
  • windows.contactPanel
  • windows.loopbackAccessRules
  • windows.devicePortalProvider
  • windows.printWorkflowBackgroundTask
  • windows.printWorkflowForegroundTask
실행 파일 기본 시작 실행 파일입니다. 길이가 1~256자인 문자열로, ".exe"로 끝나야 하며 , :>, ", ", |, ?또는 *와 같은 문자를 <포함할 수 없습니다. 확장의 기본 실행 파일을 지정합니다. 지정하지 않으면 앱에 대해 정의된 실행 파일이 사용됩니다. 지정한 경우 EntryPoint 속성도 사용됩니다. 해당 EntryPoint 속성을 지정하지 않으면 앱에 대해 정의된 EntryPoint가 사용됩니다. 아니요
EntryPoint 활성화 가능한 클래스 ID입니다. 확장을 처리하는 작업을 나타내는 길이가 1자에서 256자 사이의 문자열입니다. 이는 일반적으로 Windows 런타임 형식의 정규화된 네임스페이스 이름입니다. EntryPoint를 지정하지 않으면 앱에 대해 정의된 EntryPoint가 대신 사용됩니다. 아니요
RuntimeType 런타임 공급자입니다. 이 특성은 일반적으로 앱에 혼합 프레임워크가 있는 경우에 사용됩니다. 마침표로 시작하거나 끝낼 수 없거나 다음 | 문자를 <>포함할 수 없는 길이가 1자에서 255자 사이의 문자열입니다. 아니요
StartPage 확장성 지점을 처리하는 웹 페이지입니다. 길이가 1자에서 256자 사이의 문자열로, | 다음 >문자를 <포함할 수 없습니다. 아니요
uap10:TrustLevel 확장의 신뢰 수준을 지정합니다. 문자열 값입니다. "appContainer", "mediumIL" 중 하나일 수 있습니다. 아니요
uap10:RuntimeBehavior 확장의 런타임 동작을 지정합니다. 문자열 값입니다. "windowsApp", "packagedClassicApp", "win32App" 중 하나일 수 있습니다. 아니요
uap10:HostId 확장에 대한 호스트 앱의 앱 ID를 지정합니다. 길이가 1~255자인 영숫자 문자열입니다. 알파벳 문자로 시작해야 합니다. 아니요
uap10:Parameters 확장에 전달할 명령줄 매개 변수를 포함합니다. 패키지 ID가 있는 데스크톱 앱에 대해서만 지원됩니다. 시작과 끝에 공백이 아닌 문자가 있는 길이가 1자에서 32767자 사이의 문자열입니다.

자식 요소

자식 요소 Description
SharedFonts 앱에서 사용할 공유 글꼴의 위치를 포함합니다.
UserDataTaskDataProvider 앱이 작업에 대한 DataProvider가 되도록 설정합니다.
MediaCodec 앱이 Microsoft Store 미디어 코덱을 설치할 수 있도록 하는 확장을 정의합니다.
ContactPanel Windows 앱에서 연락처 패널을 사용하도록 설정합니다.
LoopbackAccessRules 앱과 서비스 간의 통신을 가능하게 하는 루프백 필터에 대한 규칙을 포함합니다.
DevicePortalProvider 배포를 위한 디바이스 포털 공급자를 정의합니다.

설명

windows.printWorkflowBackgroundTaskwindows.printWorkflowForegroundTask 는 인쇄 시나리오를 지원하는 빈 확장 선언입니다. 인쇄 시스템에서 인쇄 데이터 처리를 시작하기 위해 백그라운드 작업 진입점을 처음에 호출하고 사용자에게 자세한 정보를 요청할 때 포그라운드 작업이 활성화됩니다. 백그라운드 진입점은 IBackgroundTask를 구현하는 클래스여야 합니다.

요구 사항

Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10/4

http://schemas.microsoft.com/appx/manifest/uap/windows10/10 ( uap10 특성의 경우)