uap:Protocol(Windows 10)

  • 아티클

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

요소 계층 구조

<패키지>

    <애플리케이션>

         <애플리케이션>

              <확장>

                   <uap:Extension>

                        <uap:Protocol>

Syntax

<uap:Protocol
  Name = 'A string with a value between 2 and 39 characters in length that contains numbers, lowercase letters, periods ("."), plus signs ("+"), or dashes ("-"). The string cannot start with a period (".").'
  DesiredView = 'A string that can have one of the following values: "default", "useLess", "useHalf", "useMore", or "useMinimum".'
  ReturnResults = 'An optional string that can have one of the following values: "none", "always", "optional".' >

  <!-- Child elements -->
  uap:Logo?
  & uap:DisplayName?
  & desktop7:ProgId
</uap:Protocol>

키

? 선택적(0개 또는 1개) & 인터리브 커넥터(임의의 순서로 발생할 수 있음)

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
이름 URI 스키마의 이름(예: mailto)입니다. 이 이름은 패키지에 대해 고유해야 합니다. 숫자, 소문자, 마침표(), 기호(+) 또는 대시-(.)를 포함하는 길이가 2~39자인 문자열입니다. 문자열은 마침표(.)로 시작할 수 없습니다. Yes
DesiredView 약속이 시작될 때 사용할 원하는 화면 공간 크기입니다. default, useLess, useHalf, useMore 또는 useMinimum 값 중 하나를 가질 수 있는 문자열입니다. No
ReturnResults 앱이 URI 활성화를 통해 호출될 때 값을 반환할지 여부를 지정합니다. 다음 값 중 하나를 가질 수 있는 선택적 문자열입니다. "none"(값을 반환하지 않음), "always"(URI 활성화는 항상 결과를 반환함), "선택적"(URI 활성화는 LaunchUriForResultsAndContinueAsync를 사용하여 결과에 대해 활성화된 경우 결과를 반환합니다). No

자식 요소

자식 요소 Description
uap:DisplayName 사용자에게 표시할 수 있는 친숙한 이름입니다.
uap:Logo 이미지가 포함된 파일의 경로입니다.
desktop7:ProgId CLSID와 연결할 수 있는 ProgID(프로그래밍 식별자)입니다.

부모 요소

부모 요소 Description
uap:Extension 앱의 확장 지점을 선언합니다.

예제

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

<Applications>
  <Application
    Id="App"
    StartPage="default.html">
    <Extensions>
      <uap:Extension
        Category="windows.protocol">
        <uap:Protocol
          Name="alsdk" />
      </uap:Extension>
    </Extensions>
  </Application>
</Applications>

추가 정보

작업URI 활성화를 처리하는 방법

개념앱 계약 및 확장

요구 사항

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