Globalización y accesibilidad para notificaciones del sistema y de icono (aplicaciones de Windows en tiempo de ejecución)

Applies to Windows and Windows Phone

En este tema, se describen los pasos que debes seguir para globalizar tus notificaciones del sistema y de icono mediante localización, escalado y accesibilidad. Se describen los protocolos mediante los cuales puedes hacer referencia a texto e imágenes que forman parte del paquete de tu aplicación o que se guardan en tu almacenamiento local, los caminos que te permiten comunicarte con distintos idiomas y culturas, la configuración de la accesibilidad y el ajuste del tamaño de tus imágenes en diferentes dispositivos. Si ya usas la plataforma de recursos de aplicaciones en tus aplicaciones, conocerás estas convenciones de nombres y estructuras.

El texto se puede localizar almacenando las cadenas en diferentes idiomas en un archivo de recursos—Resources.resjson (JavaScript) o Resources.resw (C# y C++).

Es posible localizar o escalar las imágenes, o hacerlas accesibles, mediante un contraste alto. La manera en que se administran las imágenes depende de su origen.

  • Imágenes locales. La plataforma de recursos que se describe en este tema no administra las imágenes del almacenamiento local (ms-appdata:///local/). Como el sistema no elige la versión de archivo apropiada, la propia aplicación debe asegurarse de que las versiones de archivo apropiadas estén en el almacén local.
  • Imágenes de nube. Puedes anexar una cadena de consulta a la dirección URL de la imagen. La siguiente tabla muestra las distintas cadenas de consulta.

    Nota  Para agregar una cadena de consulta al identificador uniforme de recursos (URI) de la imagen cuando esta se recupera desde un servidor web, debes invalidar el valor predeterminado y establecer el atributo addImageQuery en "true", en la carga XML de la notificación de icono o del sistema. El atributo addImageQuery aparece en los elementos visual, binding e image de ambos esquemas de notificación, tile (icono) y toast (del sistema). Si addImageQuery se configura explícitamente en más de uno de esos elementos, el valor en un elemento secundario invalida el valor en el primario o en otro antecesor. Por ejemplo, un valor addImageQuery "true" en un elemento image invalida un addImageQuery "false" en su elemento binding primario.

    TipoCadena de consultaValores posiblesEjemplo
    Escalams-scale
    • 80 (solo en la pantalla Inicio)
    • 100
    • 140
    • 180
    ?ms-scale=100
    Accesibilidadms-contrast
    • standard (estándar)
    • black (negro)
    • white (blanco)
    ?ms-contrast=standard
    Localizaciónms-langLa etiqueta de idioma BCP-47 especificada en el atributo lang de la plantilla de notificación, o bien el idioma predeterminado de la aplicación, si lang se omite.?ms-lang=en-US

     

Cómo estructurar el paquete de la aplicación para globalización y accesibilidad

Nota  Las convenciones de nombres y estructuras que se muestran en este tema son solo un esquema para la asignación de nombres de archivos y la organización de archivos para la globalización. Puedes usar decoraciones de nombres de archivo (como "escala-140"), organizar los archivos en carpetas con nombres adecuados o usar una combinación de ambas opciones, como describimos en este tema.

  • Text
    • Crea una carpeta con el nombre "strings" (cadenas). Este contenedor es opcional, pero permite una mejor organización.
    • En la carpeta "strings", crea una subcarpeta para el idioma predeterminado, cuyo nombre siga la especificación BCP-47 (por ejemplo, "es-ES"). En esa subcarpeta, agrega un archivo Resources.resjson (para JavaScript) o un archivo Resources.resw (para C# y C++) que contenga las cadenas para el idioma predeterminado. Aquí te mostramos un ejemplo:
      
      /ProjectFolder
          /strings
              /en-US
                  resources.resjson
      
    • Localización: agrega otra carpeta para cada idioma no predeterminado admitido, cuyo nombre siga las especificaciones BCP-47 respectivas. En cada carpeta, coloca un archivo Resources.resjson o Resources.resw que contenga las cadenas localizadas para ese idioma. Aquí te mostramos un ejemplo:
      
      /ProjectFolder
          /strings
              /en-US
                  resources.resjson
              /fr-FR
                  resources.resjson
              /ja-JP
                  resources.resjson
      
  • Imágenes

    Nota  Esto se aplica solo a las imágenes incluidas en el paquete de la aplicación (ms-appx), no a las imágenes guardadas en almacenamiento local (ms-appdata:///local/).

    • Crea una carpeta con el nombre "images" (imágenes). Agrega las imágenes del idioma predeterminado, cuyo nombre siga la especificación BCP-47, directamente a la raíz de esta carpeta.
    • Localización: en la carpeta "images" crea carpetas para cada idioma no predeterminado admitido, cuyo nombre siga las especificaciones BCP-47 respectivas. Agrega las imágenes para cada idioma en su carpeta respectiva, como se muestra aquí:
      
      /ProjectFolder
          /images
              welcome.png
              /fr-FR
                  welcome.png
              /ja-JP
                  welcome.png
      

      Nota  Todos los archivos de imagen correspondientes a los distintos idiomas deben tener el mismo nombre de archivo.

    • Accesibilidad: en cada carpeta específica para un idioma, incluido el idioma predeterminado, crea una carpeta para cada configuración de contraste admitida. Dentro de una de esas carpetas, coloca el archivo imagen de específico para esa configuración de contraste. Ten en cuenta que todos los archivos conservarán el mismo nombre de archivo.
      
      /ProjectFolder
          /images
              welcome.png
              /contrast-black
                  welcome.png
              /contrast-white
                  welcome.png
              /fr-FR
                  welcome.png
                  /contrast-black
                      welcome.png
                  /contrast-white
                      welcome.png
              /ja-JP
                  welcome.png
                  /contrast-black
                      welcome.png
                  /contrast-white
                      welcome.png
      
    • Escalado: cada una de las imágenes descritas anteriormente se debe proporcionar en variantes específicas de la escala, con los nombres de archivo decorados con el identificador de escala correspondiente. Ten en cuenta que la plataforma de recursos de aplicaciones no reconoce esta decoración como parte del nombre de archivo, para que todos estos archivos tengan el mismo nombre. El siguiente ejemplo muestra una estructura de imágenes para recursos de idioma de en-US y ja-JP. Hay una imagen individual disponible para cada valor de escala y de contraste en ambos idiomas.
      
      /ProjectFolder
          /images
              welcome.scale-80.png
              welcome.scale-100.png
              welcome.scale-140.png
          
              /contrast-black
                  welcome.scale-80.png
                  welcome.scale-100.png
                  welcome.scale-140.png
              /contrast-white
                  welcome.scale-80.png
                  welcome.scale-100.png
                  welcome.scale-140.png
              /ja-JP
                  welcome.scale-80.png
                  welcome.scale-100.png
                  welcome.scale-140.png
              
                  /contrast-black
                      welcome.scale-80.png
                      welcome.scale-100.png
                      welcome.scale-140.png
                  /contrast-white
                      welcome.scale-80.png
                      welcome.scale-100.png
                      welcome.scale-140.png
      

Para obtener más información, consulta estos temas:

Cómo usar imágenes y texto localizados en una notificación

Esta sección explica cómo hacer referencia a los recursos globalizados en tus notificaciones para que Windows pueda seleccionar la versión adecuada en función de la configuración del dispositivo.

Texto

En el elemento text del contenido de plantilla, usa el prefijo "ms-resource:" en el cuerpo del texto, seguido por la etiqueta de cadena como se define en el archivo Resources.resjson o Resources.resw. Por ejemplo, supongamos que tienes un archivo \fr-FR\Resources.resjson que contiene la siguiente entrada:

"greeting" : "Bonjour",

El elemento <text id="1">ms-resource:greeting</text> del contenido XML de la plantilla permitiría la recuperación de la cadena si el idioma de la interfaz de usuario se estableciera como francés.

Si el cuerpo de un elemento text omite el prefijo "ms-resource:", se trata como texto literal.

Imágenes locales

Imágenes incluidas en el paquete de la aplicación

Agrega el prefijo "ms-appx:///" a la ruta de acceso del recurso del elemento image de tu plantilla. Por ejemplo:


<image id="1" src="ms-appx:///images/welcome.png"/>

Para las imágenes incluidas en el paquete de la aplicación, Windows identifica la imagen correcta mediante la estructura de archivos o la decoración en el nombre del archivo. Cuando proporciones un recurso de imagen globalizado en la plantilla, debes incluir solamente el nombre del archivo.

  • Correcto: <image id="1" src="ms-appx:///images/welcome.png"/>
  • Incorrecto: <image id="1" src="ms-appx:///images/welcome.scale-100.png"/>
  • Incorrecto: <image id="1" src="ms-appx:///images/contrast-black/welcome.scale-100.png"/>

Imágenes guardadas en el almacenamiento local

Agrega el prefijo "ms-appdata:///local/" a la ruta de acceso al archivo relativa al almacenamiento local (Windows.Storage.ApplicationData.current.localFolder). Windows no puede reconocer las versiones de imagen en el almacenamiento local en función de la estructura de almacenamiento como en la plataforma de recursos de aplicaciones.


<image id="1" src="ms-appdata:///local/welcome.png"/>

Imágenes guardadas en las carpetas Roaming o Temp

Estas imágenes no se pueden usar.

Imágenes web

Usa un controlador HTTP para inspeccionar la cadena de consulta y buscar los valores de idioma, escala y contraste que se pueden usar.

Temas relacionados

Globalización de la aplicación
Elegir las imágenes de tu aplicación
Hacer que los iconos sean accesibles
Recursos de aplicaciones y ejemplos de localización
Esquema XML de un icono
Esquema XML de una notificación del sistema
Introducción a los iconos y notificaciones de icono
Inicio rápido: crear un icono predeterminado con el editor de manifiestos de Microsoft Visual Studio
Inicio rápido: enviar una notificación del sistema
Catálogo de plantillas de icono
El catálogo de plantillas de notificaciones del sistema
Directrices y lista de comprobación de iconos y notificaciones
Directrices y lista de comprobación de notificaciones del sistema

 

 

Mostrar:
© 2014 Microsoft