다음을 통해 공유


uap:Extension(Windows 10)

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

요소 계층 구조

<패키지>

    <애플리케이션>

         <애플리케이션>

              <확장>

                   <uap:Extension>

Syntax

<uap:Extension
  Category = 'A string that can have one of the following values: "windows.fileTypeAssociation", "windows.protocol", "windows.autoPlayContent", "windows.autoPlayDevice", "windows.shareTarget", "windows.search", "windows.fileOpenPicker", "windows.fileSavePicker", "windows.cachedFileUpdater", "windows.cameraSettings", "windows.accountPictureProvider", "windows.printTaskSettings", "windows.lockScreenCall", "windows.appointmentsProvider", "windows.alarm", "windows.webAccountProvider", "windows.dialProtocol", "windows.appService", "windows.mediaPlayback", "windows.print3DWorkflow", "windows.lockScreen", "windows.aboveLockScreen", "windows.personalAssistantLaunch", or "windows.voipCall".'
  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.'
  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 -->
  uap:FileTypeAssociation?
  uap:Protocol?
  uap:AutoPlayContent?
  uap:AutoPlayDevice?
  uap:ShareTarget?
  uap:FileOpenPicker?
  uap:FileSavePicker?
  uap:AppointmentsProvider?
  uap:WebAccountProvider?
  uap:DialProtocol?
  uap:AppService?
  uap:MediaPlayback?
  uap:VoipCall?

</uap:Extension>

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

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
범주 패키지 확장성 지점의 형식입니다. 다음 값 중 하나를 가질 수 있는 문자열: windows.fileTypeAssociation, windows.protocol, windows.autoPlayContent, windows.autoPlayDevice, windows.shareTarget, windows.search, windows.fileOpenPicker, windows.fileSavePicker, windows.cachedFileUpdater, windows.cameraSettings, windows.accountPictureProvider, windows.printTaskSettings, windows.lockScreenCall, windows.appointmentsProvider, windows.alarm, windows.webAccountProvider, windows.dialProtocol, windows.appService, windows.mediaPlayback, windows.print3DWorkflow, windows.lockScreen, windows.aboveLockScreen, windows.personalAssistantLaunch 또는 windows.voipCall. 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 확장의 런타임 동작을 지정합니다. 선택적 문자열 값입니다. 지정된 경우 windowsApp, packagedClassicApp 또는 win32App 값 중 하나일 수 있습니다. No
uap10:HostId 확장에 대한 호스트 런타임의 ID를 지정합니다. 1~255자 사이의 선택적 값이 있는 영숫자 문자열입니다. 문자로 시작해야 합니다. No
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
uap:AppService windows.appService 형식의 앱 확장성 지점을 선언합니다. 애플리케이션 계약은 앱이 다른 앱에 속한 백그라운드 작업을 호출하는 방법입니다. 또는 앱 계약을 서비스하기 위해 호출된 백그라운드 작업의 경우 호출자와 통신하는 방법입니다.
uap:AppointmentsProvider windows.appointmentsProvider 형식의 앱 확장성 지점을 선언합니다.
uap:AutoPlayContent windows.autoPlayContent 형식의 앱 확장성 지점을 선언합니다. 앱은 지정된 자동 실행 콘텐츠 작업을 제공합니다.
uap:AutoPlayDevice *windows.autoPlayDevice 형식의 앱 확장성 지점을 선언합니다. 앱은 지정된 자동 실행 디바이스 작업을 제공합니다.
uap:DialProtocol windows.dialProtocol*형식의 앱 확장성 지점을 선언합니다.
uap:FileOpenPicker windows.fileOpenPicker 형식의 앱 확장성 지점을 선언합니다. 앱을 사용하면 사용자가 지정된 형식의 파일을 선택하고 열 수 있습니다.
uap:FileSavePicker windows.fileSavePicker 형식의 앱 확장성 지점을 선언합니다. 앱을 사용하면 사용자가 지정된 형식의 파일에 대한 파일 이름, 확장명 및 스토리지 위치를 선택할 수 있습니다.
uap:FileTypeAssociation windows.fileTypeAssociation 형식의 앱 확장성 지점을 선언합니다. 파일 형식 연결은 앱이 지정된 형식의 파일을 처리하도록 등록되었음을 나타냅니다.
uap:MediaPlayback 앱이 비디오 코드 변환을 수행한다고 선언할 수 있도록 mediaPlayback 형식의 앱 확장성 지점을 선언합니다.
uap:Protocol windows.protocol 형식의 앱 확장성 지점을 선언합니다. URI 연결은 앱이 지정된 체계를 사용하여 URI를 처리하도록 등록되었음을 나타냅니다.
uap:ShareTarget windows.shareTarget 형식의 앱 확장 지점을 선언합니다. 앱은 지정된 형식의 파일을 공유할 수 있습니다.
uap:VoipCall 앱이 셀룰러 통화에서 VoIP 영상 통화로 업그레이드를 수행할 수 있음을 선언할 수 있도록 windows.voipCall 형식의 앱 확장성 지점을 선언하고 전화 번호로 직접 전화를 걸 수 있도록 지원하는 VoIP 앱인지 여부를 선언합니다.
uap:WebAccountProvider windows.webAccountProvider 형식의 앱 확장성 지점을 선언합니다.

부모 요소

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

설명

대부분의 확장 유형에서 Extension@ResourceGroup Application@ResourceGroup 일치해야 합니다(Application@ResourceGroup 생략된 경우 Extension@ResourceGroup 생략해야 함).

UI 기반 계약의 경우: Extension@ResourceGroup 지정되지 않은 경우 애플리케이션과 암시적으로 그룹화됩니다. Extension@ResourceGroup Application@ResourceGroup 일치하지 않으면 매니페스트는 스키마 유효성 검사에 실패합니다.

백그라운드 작업 또는 백그라운드 작업을 기반으로 하는 계약에 대해 Extension@ResourceGroup 지정되지 않은 경우 모든 백그라운드 작업에 대한 기본 그룹과 연결됩니다. 백그라운드 작업 계약은 Application@ResourceGroup 동일한 값을 지정할 수 있습니다.

다음 확장의 경우 Extension@ResourceGroup 실행되는 백그라운드 작업을 다른 그룹과 독립적으로 리소스 및 수명 주기 관리가 되는 다양한 프로세스로 그룹화할 수 있습니다. windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTaskwindows.updateTask.

예를 들어 매니페스트에 이러한 세 개의 항목이 있는 경우입니다.

<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask" ResourceGroup="Group1">
  <BackgroundTasks>
    <Task Type="timer"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask2" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="controlChannel"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask3" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="pushNotification"/>
  </BackgroundTasks>
</Extension>

그런 다음 마지막 두 백그라운드 작업이 동시에 활성화된 경우 의 backgroundtaskhost.exe 동일한 instance 활성화됩니다. 그러나 backgroundtaskhost.exe 별도의 instance ResourceGroup이 다르기 때문에 첫 번째 항목에 대해 회전됩니다.

확장에 대해 ResourceGroup을 지정하지 않으면 모든 백그라운드 작업이 의 backgroundtaskhost.exe동일한 instance 활성화됩니다.

또한 이러한 확장(windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask 또는 windows.updateTask) 중 하나가 부모 Application 요소의 ResourceGroup 특성과 동일한 값을 지정하는 경우 UI와 동일한 프로세스에서 활성화됩니다.

다음 확장은 패키지 디자이너 UI의 선언 탭에서 찾을 수 있습니다. 이러한 각 요소에 대한 설명을 참조하세요.

  • Search: 앱을 검색 공급자로 등록합니다. 앱의 인덱싱된 콘텐츠는 Search 참을 통해 시작된 전역 검색 환경에서 검색 결과로 나타날 수 있습니다. 응용 프로그램당 이 선언의 인스턴스 하나만 사용할 수 있습니다.
  • CachedFileUpdater: 앱을 캐시된 파일 업데이트자로 등록하여 앱이 다른 Microsoft Store 앱에서 액세스하는 파일에 대한 업데이트를 공급자로 지정할 수 있도록 합니다. 응용 프로그램당 이 선언의 인스턴스 하나만 사용할 수 있습니다.
  • 카메라 설정: 앱이 웹 카메라 디바이스에 대한 사용자 지정 제어판을 제공할 수 있도록 합니다. 응용 프로그램당 이 선언의 인스턴스 하나만 사용할 수 있습니다.
  • AccountPictureProvider: 앱을 계정 사진 공급자로 등록하여 계정 사진 모드에서 시작하고 추가 프롬프트 없이 사용자의 사진을 설정할 수 있도록 합니다. 응용 프로그램당 이 선언의 인스턴스 하나만 사용할 수 있습니다.
  • PrintTaskSettings: 앱에서 기본 인쇄 설정 환경을 바꿀 수 있습니다. 응용 프로그램당 이 선언의 인스턴스 하나만 사용할 수 있습니다.
  • LockScreen: 휴대폰이 잠겨 있으면 사용자가 수행할 수 있는 상호 작용의 양이 제한됩니다. 경우에 따라 사용자는 휴대폰의 잠금을 해제하지 않고 VoIP 통화에 응답할 수 있습니다. 이 계약을 통해 가능합니다. 응용 프로그램당 이 선언의 인스턴스 하나만 사용할 수 있습니다.
  • 경보: 애플리케이션은 자신을 시스템 경보 앱으로 선언할 수 있습니다. 사용자가 선택 UI를 통과하여 시스템 알람을 설정하면 시스템 알람 앱으로 선언된 애플리케이션만 선택할 수 있습니다. 응용 프로그램당 이 선언의 인스턴스 하나만 사용할 수 있습니다.
  • BackgroundTasks: 백그라운드 작업을 사용하면 애플리케이션이 서로 통신하고 한 애플리케이션이 다른 애플리케이션을 호출할 수 있습니다. 계약을 사용하여 이러한 백그라운드 작업을 제공하거나 시작하려면 애플리케이션을 앱 서비스로 선언해야 합니다. 각 응용 프로그램에서는 이 선언의 여러 인스턴스를 사용할 수 있습니다.
  • Print3DWorkFlow: 3D 프린터 제조업체는 유니버설 Windows 앱을 제공하여 3D 인쇄 대화 상자에서 고유한 환경을 제공할 수 있습니다. 그렇지 않은 경우 Windows는 기본 3D 인쇄 환경을 제공합니다. 응용 프로그램당 이 선언의 인스턴스 하나만 사용할 수 있습니다.
  • PersonalAssistantLaunch: 앱이 Cortana와 통합되도록 허용합니다. 응용 프로그램당 이 선언의 인스턴스 하나만 사용할 수 있습니다.

요구 사항

항목
rescap4 http://schemas.microsoft.com/appx/manifest/uap/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version Windows 10 버전 1511(빌드 10586)