Formato XML do manifest do pacote do fornecedor de feed

Observação

Algumas informações estão relacionadas ao produto pré-lançado, que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, em relação às informações fornecidas aqui.

Para serem exibidos no Painel de Widgets, os aplicativos compatíveis com feeds do Windows devem registrar seu provedor de feeds no sistema. Para aplicações Win32, atualmente só são suportadas aplicações empacotadas e os fornecedores de feeds especificam as suas informações de registo no ficheiro de manifesto do pacote da aplicação. Este artigo documenta o formato XML para registro de feed. Consulte a seção Exemplo para obter uma listagem de código de um manifesto de pacote de exemplo para um provedor de feed Win32.

Extensão de aplicativo

O arquivo de manifesto do pacote do aplicativo oferece suporte a muitas extensões e recursos diferentes para aplicativos do Windows. O formato de manifesto do pacote do aplicativo é definido por um conjunto de esquemas que são documentados na referência do esquema de manifesto do pacote . Os provedores de feed declaram suas informações de registro dentro do uap3:AppExtension. O atributo Name da extensão deve ser definido como "com.microsoft.windows.widgets.feeds".

Os provedores de feed devem incluir uap3:Properties como filho de uap3:AppExtension. O esquema de manifesto do pacote não impõe a estrutura do elemento uap3:Properties, exigindo apenas XML bem formado. O restante deste artigo descreve o formato XML que o Widgets Board espera para registrar com êxito um provedor de 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>

Hierarquia de elementos

FeedProvider

  Ativação

    CreateInstance

  Definições

    Definição

FeedProvider

O elemento raiz das informações de registro do provedor de feed.

Atributo	Tipo	Obrigatório	Descrição	Valor predefinido
Descrição	corda	Sim	Uma breve descrição do fornecedor de feeds.	N/A
Nome_de_Visualização	corda	Sim	O nome do provedor de feed que é exibido no painel de widgets.	N/A
Ícone	corda	Sim	O caminho relativo ao pacote para um arquivo de imagem de ícone que é exibido no Quadro de widgets.	N/A
ID	corda	Sim	Um ID que identifica o provedor de feed. As implementações do provedor de feed usam essa cadeia de caracteres para determinar ou especificar qual dos provedores de feed do aplicativo está sendo referenciado para cada operação. Essa cadeia de caracteres deve ser exclusiva para todos os provedores de feed definidos no arquivo de manifesto do aplicativo.	N/A

Ativação

Especifica informações de ativação para o provedor de feed.

CreateInstance

CreateInstance deve ser especificado para provedores de feed baseados em Win32 que implementam a interface IFeedProvider . O sistema ativará a interface com uma chamada para CoCreateInstance. O atributo ClassId especifica o CLSID para o servidor CreateInstance que implementa a interface IFeedProvider .

Atributo	Tipo	Obrigatório	Descrição	Valor predefinido
ID de Classe	Identificador Globalmente Único (GUID)	Sim	O CLSID do servidor CreateInstance que implementa o fornecedor de feeds.	N/A

Definições

O elemento de contêiner para um ou mais registos de feeds.

Definição

Representa o registro de um único feed.

Atributo	Tipo	Obrigatório	Descrição	Valor predefinido
ID	corda	Sim	Um ID que identifica o feed. As implementações do provedor de feed usam essa cadeia de caracteres para determinar ou especificar quais feeds do aplicativo estão sendo referenciados para cada operação. Essa cadeia de caracteres deve ser exclusiva para todos os feeds definidos no arquivo de manifesto do aplicativo.	N/A
Nome_de_Visualização	corda	Sim	O nome do feed que é exibido no painel de widgets.	N/A
Descrição	corda	Sim	Uma breve descrição do feed.	N/A
ContentUri	corda	Sim	O URI do qual o conteúdo do feed é recuperado.	N/A
Ícone	corda	Sim	O caminho relativo ao pacote para um arquivo de imagem de ícone que é exibido no Quadro de widgets.	N/A
WebRequestFilter	corda	Não	Uma cadeia de caracteres de filtro de solicitação da Web especificando o conjunto de URLs para as quais as solicitações de recursos serão redirecionadas para a implementação do provedor de feed de IFeedResourceProvider. O padrão é expresso usando o formato descrito em Padrões de correspondência. A string de filtro no registro deve usar Punycode quando necessário. Todos os tipos de conteúdo serão redirecionados quando correspondidos, portanto, o filtro só deve resolver para o conteúdo destinado a ser obtido por meio do IFeedResourceProvider no aplicativo.	N/A
Regiões excluídas	corda	Não	Uma lista das regiões onde o alimento para animais não deve estar disponível. Os feeds podem especificar ExcludedRegions ou ExclusiveRegions, mas não devem especificar ambos em uma única definição de feed. O valor do atributo é uma lista separada por vírgulas de dois códigos de região de caracteres.	N/A
ExclusiveRegions	corda	Não	Uma lista das únicas regiões onde o alimento para animais deve estar disponível. Os feeds podem especificar ExcludedRegions ou ExclusiveRegions, mas não devem especificar ambos na definição de feed único. O valor do atributo é uma lista separada por vírgulas de dois códigos de região de caracteres.	N/A

Você pode usar recursos localizados em vez de strings literais para os valores de atributo destinados à interface do usuário. Para obter mais informações, consulte Localizar cadeias de caracteres em sua interface do usuário e manifesto do pacote do aplicativo.

Exemplo

O exemplo de código a seguir ilustra o uso do formato XML de manifesto do pacote de 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>