피드 공급자 패키지 매니페스트 XML 형식

참고 항목

일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적, 또는 묵시적인 보증을 하지 않습니다.

위젯 보드에 표시하려면 Windows 피드를 지원하는 앱이 해당 피드 공급자를 시스템에 등록해야 합니다. Win32 앱의 경우 패키지된 앱만 현재 지원되며 피드 공급자는 앱 패키지 매니페스트 파일에 등록 정보를 지정합니다. 이 문서에서는 피드 등록을 위한 XML 형식을 문서화합니다. Win32 피드 공급자에 대한 예제 패키지 매니페스트의 코드 목록은 예제 섹션을 참조하세요.

앱 확장

앱 패키지 매니페스트 파일은 Windows 앱에 대한 다양한 확장 및 기능을 지원합니다. 앱 패키지 매니페스트 형식은 패키지 매니페스트 스키마 참조에 설명된 스키마 집합에 의해 정의됩니다. 피드 공급자는 uap3:AppExtension 내에서 등록 정보를 선언합니다. 확장의 이름 특성은 "com.microsoft.windows.widgets.feeds"로 설정해야 합니다.

피드 공급자는 uap3:AppExtension의 자식으로 uap3:Properties를 포함해야 합니다. 패키지 매니페스트 스키마는 올바른 형식의 XML을 요구하는 것 외에는 uap3:Properties 요소의 구조를 적용하지 않습니다. 이 문서의 나머지 부분에는 피드 공급자를 성공적으로 등록하기 위해 위젯 보드에서 예상하는 XML 형식에 대해 설명합니다.

<uap3:Extension Category="windows.appExtension">
  <uap3:AppExtension Name="com.microsoft.windows.widgets.feeds" DisplayName="ContosoApp" Id="ContosoApp" PublicFolder="Public">
    <uap3:Properties>
      <!-- Feed provider registration content goes here -->
    </uap3:Properties>
  </uap3:AppExtension>
</uap3:Extension>

요소 계층 구조

FeedProvider

  활성화

    CreateInstance

  정의

    정의

FeedProvider

피드 공급자 등록 정보의 루트 요소입니다.

특성	Type	필수	설명	기본값
설명	string	예	피드 공급자에 대한 간단한 설명입니다.	해당 없음
DisplayName	string	예	위젯 보드에 표시되는 피드 공급자의 이름입니다.	해당 없음
Icon	string	예	위젯 보드에 표시되는 아이콘 이미지 파일의 패키지 상대 경로입니다.	해당 없음
ID	string	예	피드 공급자를 식별하는 ID입니다. 피드 공급자 구현은 이 문자열을 사용하여 각 작업에 대해 참조되는 앱의 피드 공급자를 결정하거나 지정합니다. 이 문자열은 앱 매니페스트 파일 내에 정의된 모든 피드 공급자에 대해 고유해야 합니다.	해당 없음

활성화

피드 공급자에 대한 활성화 정보를 지정합니다.

CreateInstance

IFeedProvider 인터페이스를 구현하는 Win32 기반 피드 공급자에 대해 CreateInstance를 지정해야 합니다. 시스템은 CoCreateInstance를 호출하여 인터페이스를 활성화합니다. ClassId 특성은 IFeedProvider 인터페이스를 구현하는 CreateInstance 서버에 대한 CLSID를 지정합니다.

특성	Type	필수	설명	기본값
ClassId	GUID	예	피드 공급자를 구현하는 CreateInstance 서버의 CLSID입니다.	해당 없음

정의

하나 이상의 피드 등록에 대한 컨테이너 요소입니다.

정의

단일 피드에 대한 등록을 나타냅니다.

특성	Type	필수	설명	기본값
ID	string	예	피드를 식별하는 ID입니다. 피드 공급자 구현은 이 문자열을 사용하여 각 작업에 대해 참조되는 앱의 피드를 결정하거나 지정합니다. 이 문자열은 앱 매니페스트 파일 내에 정의된 모든 피드에 대해 고유해야 합니다.	해당 없음
DisplayName	string	예	위젯 보드에 표시되는 피드의 이름입니다.	해당 없음
설명	string	예	피드에 대한 간단한 설명	해당 없음
ContentUri	string	예	피드 콘텐츠가 검색되는 URI입니다.	해당 없음
Icon	string	예	위젯 보드에 표시되는 아이콘 이미지 파일의 패키지 상대 경로입니다.	해당 없음
WebRequestFilter	string	아니요	리소스 요청이 피드 공급자의 IFeedResourceProvider구현으로 리디렉션될 URL 집합을 지정하는 웹 요청 필터 문자열입니다. 패턴은 Match Patterns에 설명된 형식을 사용하여 표현됩니다. 등록의 필터 문자열은 필요한 경우 Punycode를 사용해야 합니다. 일치하는 경우 모든 콘텐츠 형식이 리디렉션되므로 필터는 애플리케이션에서 IFeedResourceProvider를 통해 얻을 수 있는 콘텐츠로만 확인되어야 합니다.	해당 없음

UI 연결 속성 값에 문자열 리터럴 대신 지역화된 리소스를 사용할 수 있습니다. 자세한 내용은 UI 및 앱 패키지 매니페스트의 문자열 지역화를 참조하세요.

예시

다음 코드 예제에서는 피드 패키지 매니페스트 XML 형식의 사용을 보여줍니다.

<uap3:AppExtension Name="com.microsoft.windows.widgets.feeds" DisplayName="ContosoApp" Id="ContosoApp" PublicFolder="Public">
  <uap3:Properties>
      <FeedProvider Description="ms-resource:ProviderDescription" Icon="ms-appx:Images\ContosoProviderIcon.png">
          <Activation>
              <CreateInstance ClassId="ECB883FD-3755-4E1C-BECA-D3397A3FF15C" />
          </Activation>
          <Definitions>
              <Definition Id="Contoso_Feed" DisplayName="ms-resource:FeedDisplayName"                  Description="ms-resource:FeedDescription"
                  ContentUri="https://contoso.com/news"
                  Icon="ms-appx:Images\ContosoFeedIcon.png"
                  WebRequestFilter="https://contoso.com/*/feed/appResource/*" >
              </Definition>
          </Definitions>
      </FeedProvider>
  </uap3:Properties>
</uap3:AppExtension>