Condividi tramite

Formato XML del manifesto del pacchetto per i provider di feed

  • Articolo

Nota

Alcune informazioni sono relative a un prodotto non definitivo, che potrebbe subire modifiche sostanziali prima del rilascio sul mercato. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Per essere visualizzati nella scheda Widget, le app che supportano i feed di Windows devono registrare il provider di feed con il sistema. Per le app Win32, solo le app in pacchetto attualmente sono supportate e i provider di feed specificano le informazioni di registrazione nel file manifesto del pacchetto dell'app. Questo articolo illustra il formato XML per la registrazione del feed. Vedere la sezione Esempio per un elenco di codice di un manifesto del pacchetto di esempio per un provider di feed Win32.

Estensione di app

Il file manifesto del pacchetto dell'app supporta molte estensioni e funzionalità diverse per le app di Windows. Il formato manifesto del pacchetto dell'app è definito da un set di schemi documentati nel Riferimento dello schema del manifesto del pacchetto. I provider di feed dichiarano le informazioni di registrazione all'interno di uap3:AppExtension. L'attributo Name dell'estensione deve essere impostato su "com.microsoft.windows.widgets.feeds".

I provider di feed devono includere uap3:Properties come figlio di uap3:AppExtension. Lo schema del manifesto del pacchetto non applica la struttura dell'elemento uap3:Properties diverso dalla richiesta di XML ben corretto. Nella parte restante di questo articolo viene descritto il formato XML previsto dalla scheda Widget per registrare correttamente un provider di feed.

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

Gerarchia elementi

FeedProvider

  Attivazione

    CreateInstance

  Definizioni

    Definizione

FeedProvider

Elemento radice delle informazioni di registrazione del provider di feed.

Attributo Type Obbligatorio Descrizione Default value
Descrizione string Sì Una breve descrizione del fornitore di feed. N/D
DisplayName string Sì Nome del provider di feed visualizzato nella scheda Widget. N/D
Icona string Sì Percorso relativo al pacchetto di un file di immagine icona visualizzato nella scheda Widget. N/D
Id string Sì ID che identifica il provider di feed. Le implementazioni del provider di feed usano questa stringa per determinare o specificare a quale provider di feed dell'app viene fatto riferimento per ogni operazione. Questa stringa deve essere univoca per tutti i provider di feed definiti all'interno del file manifesto dell'app. N/D

Attivazione

Specifica le informazioni di attivazione per il provider di feed.

CreateInstance

È necessario specificare CreateInstance per i provider di feed basati su Win32 che implementano l'interfaccia IFeedProvider. Il sistema attiverà l'interfaccia con una chiamata a CoCreateInstance. L'attributo ClassId specifica il CLSID per il server CreateInstance che implementa l'interfaccia IFeedProvider.

Attributo Type Obbligatorio Descrizione Default value
ClassId GUID Sì CLSID per il server CreateInstance che implementa il provider di feed. N/D

Definizioni

Elemento contenitore per una o più registrazioni di feed.

Definizione

Rappresenta la registrazione per un singolo feed.

Attributo Type Obbligatorio Descrizione Default value
Id string Sì ID che identifica il feed. Le implementazioni del provider di feed usano questa stringa per determinare o specificare a quale feed dell'app viene fatto riferimento per ogni operazione. Questa stringa deve essere univoca per tutti i feed definiti all'interno del file manifesto dell'app. N/D
DisplayName string Sì Nome del feed visualizzato nella scheda Widget. N/D
Descrizione string Sì Breve descrizione del feed. N/D
ContentUri string Sì URI dal quale viene recuperato il contenuto del feed. N/D
Icona string Sì Percorso relativo al pacchetto di un file di immagine icona visualizzato nella scheda Widget. N/D
WebRequestFilter string No Stringa di filtro richieste Web che specifica il set di URL per cui le richieste di risorse verranno reindirizzate all'implementazione del provider di feed di IFeedResourceProvider. Il modello viene espresso con il formato descritto in Modelli di corrispondenza. La stringa di filtro nella registrazione deve usare Punycode se necessario. Tutti i tipi di contenuto verranno reindirizzati quando corrispondono, in modo che il filtro debba essere risolto solo nel contenuto che si vuole ottenere tramite IFeedResourceProvider nell'applicazione. N/D
ExcludedRegions string No Elenco di aree in cui il feed non deve essere disponibile. I feed possono specificare ExcludedRegions o ExclusiveRegions, ma non devono specificare entrambi in una singola definizione di feed. Il valore dell'attributo è un elenco delimitato da virgole di due codici di area di caratteri. N/D
ExclusiveRegions string No Elenco delle uniche aree in cui deve essere disponibile il feed. I feed possono specificare ExcludedRegions o ExclusiveRegions, ma non devono specificare entrambi nella definizione di feed singolo. Il valore dell'attributo è un elenco delimitato da virgole di due codici di area di caratteri. N/D

È possibile usare le risorse localizzate anziché i valori letterali stringa per i valori degli attributi rivolti all'interfaccia utente. Per altre informazioni, vedere Localizzare le stringhe nell'interfaccia utente e nel manifesto del pacchetto dell'app.

Esempio

Nell'esempio di codice seguente viene illustrato l'utilizzo del formato XML del manifesto del pacchetto del feed.

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