Globalização e acessibilidade de blocos e notificações do sistema (aplicativos do Tempo de Execução do Windows)

Applies to Windows and Windows Phone

Este tópico discute as etapas que você deve tomar para globalizar seu bloco e as notificações do sistema por meio de localização, dimensionamento e acessibilidade. Vamos abordar os protocolos pelos quais você faz referência a texto e imagens que fazem parte do pacote do aplicativo ou estão salvos em armazenamento local, os caminhos pelos quais você lida com os diferentes idiomas e culturas, as configurações da facilidade de acesso e o dimensionamento das suas imagens em dispositivos diferentes. Se você já estiver usando a plataforma de recursos de aplicativo em seus aplicativos, você estará familiarizado com estas convenções de estrutura e de nomenclatura.

O texto pode ser localizado armazenando as cadeias de caracteres em vários idiomas em um arquivo de recursos —Resources.resjson (JavaScript) ou Resources.resw (C# e C++).

As imagens podem ser localizadas, dimensionadas e tornadas acessíveis por meio do alto contraste. Como as imagens são manipuladas depende da sua origem.

  • Imagens locais. As imagens no armazenamento local (ms-appdata:///local/) não são manipuladas pela plataforma de recursos discutida neste tópico. Uma vez que o sistema não escolhe a versão apropriada do arquivo, o próprio aplicativo deve garantir que as versões apropriadas dos arquivos sejam alocadas no armazenamento local.
  • Imagens na nuvem. Uma cadeia de caracteres de consulta pode ser anexada à URL da imagem. A tabela a seguir mostra as cadeias de caracteres de consulta diferentes.

    Observação  Para adicionar uma cadeia de caracteres ao URI (Uniform Resource Identifier) ao recuperar uma imagem de um servidor da Web, você deverá substituir o padrão e definir o atributo addImageQuery como "true" na carga XML da notificação do bloco ou do sistema. O atributo addImageQuery aparece nos elementos visual, de associação e de imagem dos esquemas de bloco e notificação do sistema. Se o addImageQuery estiver explicitamente definido em mais de um desses elementos, o valor de um elemento filho substituirá o valor do elemento pai ou de outro ancestral. Por exemplo, um valor addImageQuery de "true" em um elemento de imagem substitui um addImageQuery de "false" em seu elemento de associação pai.

    TipoCadeia de caracteres de consultaValores possíveisExemplo
    Escalams-scale
    • 80 (somente tela Inicial)
    • 100
    • 140
    • 180
    ?ms-scale=100
    Acessibilidadems-contrast
    • standard
    • black
    • white
    ?ms-contrast=standard
    Localizaçãoms-langA marca de idioma BCP-47 especificada no atributo lang do modelo de notificação ou o idioma padrão do aplicativo se lang for omitido.?ms-lang=en-US

     

Como estruturar o pacote de aplicativos para globalização e acessibilidade

Observação  As convenções de estrutura e nomenclatura mostradas neste tópico são apenas um esquema para denominar e organizar os arquivos para globalização. Você pode usar decorações de nome de arquivo (como "escala-140"), organizar os arquivos em pastas com nomes apropriados ou combinar as duas opções como mostramos neste tópico.

  • Texto
    • Crie uma pasta denominada "strings". Este contêiner é opcional, mas permite uma melhor organização.
    • Na pasta "strings", crie uma subpasta para seu idioma padrão, denominada com sua especificação BCP-47 (por exemplo, "en-US"). Nessa subpasta, adicione um arquivo Resources.resjson (para JavaScript) ou arquivo Resources.resw (para C# e C++) que contém as cadeias de caracteres para seu idioma padrão. Um exemplo é mostrado aqui:
      
      /ProjectFolder
          /strings
              /en-US
                  resources.resjson
      
    • Localização: adicione outra pasta para cada idioma não padrão aceito, denominada com suas especificações BCP-47. Em cada pasta, coloque um arquivo Resources.resjson ou Resources.resw que contém as cadeias de caracteres localizadas para esse idioma. Um exemplo é mostrado aqui:
      
      /ProjectFolder
          /strings
              /en-US
                  resources.resjson
              /fr-FR
                  resources.resjson
              /ja-JP
                  resources.resjson
      
  • Imagens

    Observação  Isso se aplica somente às imagens fornecidas no pacote de aplicativo (ms-appx), não às imagens no armazenamento local (ms-appdata:///local/).

    • Crie uma pasta denominada "images". Adicione imagens ao seu idioma padrão, denominado com a respectiva especificação BCP-47, diretamente para a raiz desta pasta.
    • Localização: na pasta "images", crie uma para cada idioma não padrão aceito, denominadas com a respectiva especificação BCP-47. Adicione as imagens de cada idioma à respectiva pasta, conforme mostrado aqui:
      
      /ProjectFolder
          /images
              welcome.png
              /fr-FR
                  welcome.png
              /ja-JP
                  welcome.png
      

      Observação  Os arquivos de imagem correspondentes aos diferentes idiomas devem ter o mesmo nome de arquivo.

    • Acessibilidade: sob cada pasta de idioma específico, incluindo o idioma padrão, crie uma pasta para cada configuração de contraste com suporte. Dentro de cada uma dessas pastas, coloque o arquivo de imagem específico para essa configuração de contraste. Observe que todos os arquivos ainda têm o mesmo nome de arquivo.
      
      /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
      
    • Dimensionamento: Cada uma das imagens citadas acima deve ser fornecida em variantes específicas de escala, com seus nomes decorados com o identificador de escala adequado. Observe que esta decoração não é reconhecida pela plataforma de recursos do aplicativo como parte do nome do arquivo, de modo que todos esses arquivos ainda têm efetivamente o mesmo nome. O exemplo a seguir mostra uma estrutura de imagem para os recursos do idioma en-US e ja-JP. Uma única imagem está disponível para todos os valores de escala e de contraste nos dois 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 saber mais, veja estes tópicos:

Como usar imagens e texto localizados em uma notificação

Esta seção explica como fazer referência a seus recursos globalizados nas notificações para que o Windows possa selecionar a versão correta com base as configurações do dispositivo.

Texto

No elemento text do conteúdo do modelo, use o prefixo "ms-resource:" no corpo do texto, seguido pela marca de cadeia de caracteres definida no arquivo Resources.resjson ou Resources.resw. Por exemplo, se você tiver um arquivo \fr-FR\Resources.resjson com esta entrada:

"greeting" : "Bonjour",

O elemento <text id="1">ms-resource:greeting</text> no conteúdo XML do modelo faz essa cadeia de caracteres ser recuperada, se o idioma da interface do usuário foi determinado como francês.

Se o prefixo "ms-resource:" não está no corpo de um elemento text, ele é tratado como texto literal.

Imagens locais

Imagens incluídas no pacote de aplicativo

Adicione o prefixo "ms-appx:///" a caminho do recursos no elemento image do modelo. Por exemplo:


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

Para imagens incluídas no pacote de aplicativo, o Windows identifica a imagem correta pela estrutura do arquivo e/ou a decoração do nome do arquivo. Ao fornecer um recurso de imagem globalizado no modelo, coloque apenas o nome do arquivo.

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

Imagens salvas no armazenamento local

Adicione o prefixo "ms-appdata:///local/" ao caminho do arquivo relativo ao armazenamento local (Windows.Storage.ApplicationData.current.localFolder). As versões de imagem em armazenamento local não podem ser reconhecidas pelo Windows com base na estrutura de armazenamento, como naplataforma de recursos do aplicativo.


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

Imagens salvas nas pastas Roaming ou Temp

Essas imagens não podem ser usadas.

Imagens da Web

Use um manipulador HTTP para inspecionar os valores de idioma, escala e contraste da cadeia de caracteres de consulta que podem ser usados.

Tópicos relacionados

Globalizando seu aplicativo
Escolhendo as imagens do seu aplicativo
Tornando os blocos acessíveis
Amostras de recursos e localização de aplicativos
Esquema XML de blocos
Esquema XML do sistema
Visão geral de blocos e notificações de bloco
Guia de início rápido: criando um bloco padrão com o editor de manifesto do Microsoft Visual Studio
Guia de início rápido: enviando uma notificação do sistema
O catálogo de modelos de bloco
O catálogo de modelos de notificação do sistema
Diretrizes e lista de verificação de blocos e notificações
Diretrizes e lista de verificação de notificações do sistema

 

 

Mostrar:
© 2014 Microsoft