Formát XML manifestu balíčku poskytovatele zdrojů

Poznámka:

Některé informace se týkají předem vydaného produktu, který může být podstatně změněn před komerčním vydáním. Společnost Microsoft neposkytuje žádné záruky, výslovné ani implicitní, ohledně zde poskytnutých informací.

Aby bylo možné je zobrazit na panelu widgetů, musí aplikace, které podporují informační kanály Windows, zaregistrovat poskytovatele informačního kanálu v systému. Pro Win32 aplikace jsou aktuálně podporovány pouze zabalené aplikace a poskytovatelé kanálů uvádějí své registrační informace v manifestu souboru balíčku aplikace. Tento článek popisuje XML formát pro registraci informačních kanálů. V části Příklad najdete výpis kódu ukázkového manifestu balíčku pro poskytovatele informačního kanálu Win32.

Rozšíření aplikace

Soubor manifestu balíčku aplikace podporuje mnoho různých rozšíření a funkcí pro aplikace pro Windows. Formát manifestu balíčku aplikace je definován sadou schémat, která jsou zdokumentována v odkazu na schéma manifestu balíčku . Poskytovatelé zdrojů deklarují své registrační informace v rámci uap3:AppExtension. Atribut Název rozšíření musí být nastaven na "com.microsoft.windows.widgets.feeds".

Poskytovatelé informačních kanálů by měli zahrnout uap3:Properties jako podřízenou vlastnost uap3:AppExtension. Schéma manifestu balíčku nevynucuje strukturu prvku uap3:Properties jinak než vyžadováním dobře formátovaného XML. Zbytek tohoto článku popisuje formát XML, který panel Widgetů očekává, aby mohl úspěšně zaregistrovat poskytovatele informačního kanálu.

<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>

Hierarchie elementů

Poskytovatel krmení

  Aktivace

    VytvořitInstanci

  Definice

    Definice

Poskytovatel krmení

Kořenový prvek informací o registraci poskytovatele informačního kanálu.

Vlastnost	Typ	Povinné	Popis	Výchozí hodnota
Popis	řetězec	Ano	Stručný popis poskytovatele kanálu.	není k dispozici
ZobrazovanýNázev	řetězec	Ano	Název poskytovatele informačního kanálu, který se zobrazí na panelu widgetů.	není k dispozici
ikona	řetězec	Ano	Cesta k souboru s obrázkem ikony, která je relativní vzhledem k balíčku a je zobrazena na nástěnce widgetů.	není k dispozici
Id	řetězec	Ano	ID, které identifikuje zprostředkovatele informačního kanálu. Implementace poskytovatelů informačního kanálu používají tento řetězec k určení, který z poskytovatelů informačního kanálu aplikace je odkazován pro každou operaci. Tento řetězec musí být jedinečný pro všechny poskytovatele kanálu definované v manifestu aplikace.	není k dispozici

Aktivace

Určuje informace o aktivaci poskytovatele informačního kanálu.

VytvořitInstanci

CreateInstance by měl být specifikován pro poskytovatele informačních kanálů založených na Win32, kteří implementují rozhraní IFeedProvider. Systém aktivuje rozhraní voláním CoCreateInstance. Atribut ClassId určuje CLSID pro CreateInstance server, který implementuje IFeedProvider rozhraní.

Vlastnost	Typ	Povinné	Popis	Výchozí hodnota
ClassId	Globálně jedinečný identifikátor (GUID)	Ano	CLSID serveru CreateInstance, který implementuje poskytovatele zdroje.	není k dispozici

Definice

Element kontejneru pro jednu nebo více registrací informačního kanálu.

Definice

Představuje registraci pro jediný kanál.

Vlastnost	Typ	Povinné	Popis	Výchozí hodnota
Id	řetězec	Ano	ID, které identifikuje informační kanál. Implementace zprostředkovatele informačního kanálu používají tento řetězec ke specifikaci nebo určení, které informační kanály aplikace jsou odkazovány pro každou operaci. Tento řetězec musí být jedinečný pro všechny informační kanály definované v souboru manifestu aplikace.	není k dispozici
ZobrazovanýNázev	řetězec	Ano	Název informačního kanálu, který se zobrazí na panelu widgetů.	není k dispozici
Popis	řetězec	Ano	Stručný popis informačního kanálu.	není k dispozici
ContentUri	řetězec	Ano	Identifikátor URI, ze kterého se získává obsah informačního kanálu.	není k dispozici
ikona	řetězec	Ano	Cesta k souboru s obrázkem ikony, která je relativní vzhledem k balíčku a je zobrazena na nástěnce widgetů.	není k dispozici
WebRequestFilter	řetězec	Ne	Řetězec filtru webového požadavku určující sadu adres URL, pro které budou požadavky na prostředky přesměrovány na implementaci poskytovatele informačního kanálu IFeedResourceProvider. Vzor se vyjadřuje pomocí formátu popsaného ve vzorech shody. V případě potřeby musí řetězec filtru v registraci používat punycode . Všechny typy obsahu budou při shodování přesměrovány, takže filtr by se měl omezit pouze na obsah, který má být získán prostřednictvím IFeedResourceProvider v aplikaci.	není k dispozici
Vyloučené oblasti	řetězec	Ne	Seznam oblastí, ve kterých by informační kanál neměl být dostupný. Informační kanály mohou určovat Vyloučené oblasti nebo Exkluzivní oblasti, ale nesmí být zadány v jedné definici informačního kanálu. Hodnota atributu je čárkami oddělený seznam dvou znakových kódů oblastí.	není k dispozici
ExclusiveRegions	řetězec	Ne	Seznam jediných oblastí, ve kterých by měl být informační kanál dostupný. Informační kanály mohou určovat Vyloučené oblasti nebo Exkluzivní oblasti, ale nesmí určovat obojí v jedné definici informačního kanálu. Hodnota atributu je čárkami oddělený seznam dvou znakových kódů oblastí.	není k dispozici

Místo řetězcových literálů můžete pro hodnoty atributů UI použít lokalizované prostředky. Další informace najdete v tématu Lokalizace řetězců v manifestu uživatelského rozhraní a balíčku aplikace.

Příklad

Následující příklad kódu ukazuje, jak se používá XML formát manifestu balíčku pro informační kanály.

<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/*"
                  ExcludedRegions="FR,DE,IT">
              </Definition>
          </Definitions>
      </FeedProvider>
  </uap3:Properties>
</uap3:AppExtension>