확장(형식: CT_ApplicationExtensions)

  • 아티클

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

요소 계층 구조

<패키지>
<애플리케이션>
<애플리케이션>
<확장>
<내선 번호>

Syntax

<Extension Category     = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
           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 *. >

  <!-- Child elements -->
  ( FileTypeAssociation
  | Protocol
  | AutoPlayContent
  | AutoPlayDevice
  | ShareTarget
  | FileOpenPicker
  | FileSavePicker
  | BackgroundTasks
  )?

</Extension>

키

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

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
범주

앱 확장 지점의 유형입니다.

이 특성 값은 다음 중 하나일 수 있습니다.

  • windows.fileTypeAssociation
  • windows.protocol
  • windows.autoPlayContent
  • windows.autoPlayDevice
  • windows.shareTarget
  • windows.search
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.cachedFileUpdater
  • windows.contactPicker
  • windows.backgroundTasks
  • windows.cameraSettings
  • windows.accountPictureProvider
  • windows.printTaskSettings
 예
EntryPoint

활성화 가능한 클래스 ID입니다.

 확장을 처리하는 작업을 나타내는 길이가 1~256자인 문자열입니다. 이는 일반적으로 Windows 런타임 형식의 정규화된 네임스페이스 이름입니다. EntryPoint를 지정하지 않으면 앱에 대해 정의된 EntryPoint가 대신 사용됩니다. 아니요
실행 파일

기본 시작 실행 파일입니다.

 길이가 1~256자인 문자열로, ".exe"로 끝나야 하며 , :>, %, ", ", |, ?또는 *와 같은 문자를 <포함할 수 없습니다. 확장에 대한 기본 실행 파일을 지정합니다. 지정하지 않으면 앱에 대해 정의된 실행 파일이 사용됩니다. 지정한 경우 EntryPoint 속성도 사용됩니다. 해당 EntryPoint 속성을 지정하지 않으면 앱에 대해 정의된 EntryPoint가 사용됩니다. 아니요
RuntimeType

런타임 공급자입니다. 이 특성은 일반적으로 앱에 혼합 프레임워크가 있는 경우에 사용됩니다.

 마침표로 시작하거나 끝낼 수 없거나 다음 | 문자를 <>포함할 수 없는 길이가 1자에서 255자 사이의 문자열입니다. 아니요
StartPage

확장성 지점을 처리하는 웹 페이지입니다.

 1~256자 사이의 문자열로 , , >:, %, ", |, ?, *등의 문자를 <포함할 수 없습니다. 예

 

자식 요소

자식 요소 Description
AutoPlayContent

windows.autoPlayContent 형식의 앱 확장성 지점을 선언합니다. 앱은 지정된 자동 실행 콘텐츠 작업을 제공합니다.
AutoPlayDevice

windows.autoPlayDevice 형식의 앱 확장 지점을 선언합니다. 앱은 지정된 자동 실행 디바이스 작업을 제공합니다.
BackgroundTasks

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

windows.fileOpenPicker 형식의 앱 확장성 지점을 선언합니다. 앱을 사용하면 사용자가 지정된 형식의 파일을 선택하고 열 수 있습니다.
FileSavePicker

windows.fileSavePicker 형식의 앱 확장성 지점을 선언합니다. 이 앱을 통해 사용자는 지정된 형식의 파일에 대한 파일 이름, 확장명 및 스토리지 위치를 선택할 수 있습니다.
FileTypeAssociation

windows.fileTypeAssociation 형식의 앱 확장 지점을 선언합니다. 파일 형식 연결은 앱이 지정된 형식의 파일을 처리하도록 등록되었음을 나타냅니다.
프로토콜

windows.protocol 형식의 앱 확장성 지점을 선언합니다. URI 연결은 앱이 지정된 체계를 사용하여 URI를 처리하도록 등록되었음을 나타냅니다.
ShareTarget

windows.shareTarget 형식의 앱 확장 지점을 선언합니다. 앱은 지정된 형식의 파일을 공유할 수 있습니다.

 

부모 요소

부모 요소 Description
확장(형식: CT_ApplicationExtensions)

앱에 대한 하나 이상의 확장성 지점을 정의합니다.

 

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

설명

이러한 확장성 지점은 앱당 한 번만 선언할 수 있습니다.

  • windows.accountPictureProvider
  • windows.cachedFileUpdater
  • windows.cameraSettings
  • windows.contactPicker
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.printTaskSettings
  • windows.search
  • windows.shareTarget

**확장에 대한 의미 체계 규칙에 대한 참고 사항: **확장 요소의 경우 매니페스트 API에 다음 의미 체계 규칙이 적용됩니다.

/Application/@StartPage 지정한 경우 JavaScript 및 앱 확장을 사용하는 Windows 앱입니다.

  • 비워 둘 수 있음
  • StartPage만 지정할 수 있습니다.
  • BackgroundTask 확장이 아닌 한 Executable 및 EntryPoint(선택적 RuntimeType 허용)를 모두 지정할 수 있습니다. 이 경우 실행 파일을 생략하고 기본값은 BackgroundTaskHost.exe 실행 파일로 생략할 수 있습니다.

/Application/@StartPage 지정되지 않은 경우 C# 또는 VB 및 XAML 및 앱 확장을 사용하는 UWP 앱입니다.

  • 비워 둘 수 있음
  • StartPage만 지정할 수 있습니다.
  • Executable 또는 RuntimeType이 지정된 경우 EntryPoint를 지정해야 합니다.

예

다음 예제는 SDK 샘플 중 하나의 패키지 매니페스트에서 가져옵니다.

<Applications>
  <Application Id="App" StartPage="default.html">
    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>
    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>
      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

참고 항목

ConceptsApp계약 및 확장

요구 사항

값
Namespace http://schemas.microsoft.com/appx/2010/manifest