Compartir a través de

Formato XML del manifiesto de paquete del proveedor de fuentes

  • Artículo

Nota:

Parte de la información hace referencia al producto de versión preliminar, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no proporciona ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.

Para mostrarse en el Panel de widgets, las aplicaciones que admiten fuentes de Windows deben registrar su proveedor de fuentes en el sistema. En el caso de las aplicaciones Win32, actualmente solo se admiten aplicaciones empaquetadas y los proveedores de fuentes especifican su información de registro en el archivo de manifiesto del paquete de la aplicación. En este artículo se documenta el formato XML para el registro de fuentes. Consulte la sección Ejemplo para obtener una lista de códigos de un manifiesto de paquete de ejemplo para un proveedor de fuentes Win32.

Extensión de la aplicación

El archivo de manifiesto del paquete de aplicación admite muchas extensiones y características diferentes para las aplicaciones de Windows. El formato del manifiesto de paquete de la aplicación se define mediante un conjunto de esquemas que se documentan en la referencia del esquema del manifiesto del paquete. Los proveedores de fuentes declaran su información de registro en uap3:AppExtension. El atributo Name de la extensión debe establecerse en "com.microsoft.windows.widgets.feeds".

Los proveedores de fuentes deberían incluir uap3:Properties como elemento secundario de uap3:AppExtension. El esquema del manifiesto de paquete no aplica la estructura del elemento uap3:Properties que no requiera XML con formato correcto. En el resto de este artículo se describe el formato XML que el Panel de widgets espera para registrar correctamente un proveedor de fuentes.

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

Jerarquía de elementos

FeedProvider

  Activación

    CreateInstance

  Definiciones

    Definición

FeedProvider

Elemento raíz de la información de registro del proveedor de fuentes.

Attribute Tipo Obligatorio Descripción Default value
Descripción string Sí Una descripción breve del proveedor de fuentes. N/D
DisplayName cadena Sí Nombre del proveedor de fuentes que se muestra en el Panel de widgets. N/D
Icono string Sí Ruta de acceso relativa al paquete a un archivo de imagen de icono que se muestra en el Panel de widgets. N/D
Id string Sí Identificador que identifica el proveedor de fuentes. Las implementaciones del proveedor de fuentes usan esta cadena para determinar o especificar a qué proveedores de fuentes de la aplicación se hace referencia para cada operación. Esta cadena debe ser única para todos los proveedores de fuentes definidos en el archivo de manifiesto de la aplicación. N/D

Activación

Especifica información de activación para el proveedor de fuentes.

CreateInstance

Se debe especificar CreateInstance para los proveedores de fuentes basados en Win32 que implementan la interfaz IFeedProvider. El sistema activará la interfaz con una llamada a CoCreateInstance. El atributo ClassId especifica el CLSID para el servidor CreateInstance que implementa la interfaz IFeedProvider.

Attribute Tipo Obligatorio Descripción Valor predeterminado
ClassId GUID Sí CLSID del servidor CreateInstance que implementa el proveedor de fuentes. N/D

Definiciones

Elemento contenedor para uno o varios registros de fuentes.

Definición

Representa el registro de una única fuente.

Attribute Tipo Obligatorio Descripción Valor predeterminado
Id string Sí Identificador que identifica la fuente. Las implementaciones del proveedor de fuentes usan esta cadena para determinar o especificar a qué fuentes de la aplicación se hace referencia para cada operación. Esta cadena debe ser única para todas las fuentes definidas en el archivo de manifiesto de la aplicación. N/D
DisplayName cadena Sí Nombre de la fuente que se muestra en el Panel de widgets. N/D
Descripción string Sí Descripción breve de la fuente. N/D
ContentUri string Sí Identificador URI desde el que se recupera el contenido de la fuente. N/D
Icono string Sí Ruta de acceso relativa al paquete a un archivo de imagen de icono que se muestra en el Panel de widgets. N/D
WebRequestFilter string No Cadena de filtro de solicitud web que especifica el conjunto de direcciones URL para las que se redirigirán las solicitudes de recursos a la implementación del proveedor de fuentes de IFeedResourceProvider. El patrón se expresa mediante el formato descrito en Patrones de coincidencia. La cadena de filtro del registro debe usar Punycode cuando sea necesario. Todos los tipos de contenido se redirigirán cuando coincidan, por lo que el filtro solo debe resolverse en el contenido destinado a obtenerse a través de IFeedResourceProvider en la aplicación. N/D
ExcludedRegions string No Lista de regiones en las que la fuente no debe estar disponible. Las fuentes pueden especificar ExcludedRegions o ExclusiveRegions, pero no deben especificar ambas en una única definición de fuente. El valor del atributo es una lista separada por comas de dos códigos de región de caracteres. N/D
ExclusiveRegions string No Lista de las únicas regiones en las que la fuente debe estar disponible. Las fuentes pueden especificar ExcludedRegions o ExclusiveRegions, pero no deben especificar ambas en la definición de fuente única. El valor del atributo es una lista separada por comas de dos códigos de región de caracteres. N/D

Puede usar recursos localizados en lugar de literales de cadena para los valores de atributo orientados a la interfaz de usuario. Para obtener más información, consulte Localizar cadenas en la interfaz de usuario y el manifiesto de paquete de aplicación.

Ejemplo

En el ejemplo de código siguiente, se muestra el uso del formato XML del manifiesto de paquete de fuentes.

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