Visão geral do pacote flash.globalization

Flash Player 10.1 e posterior, Adobe AIR 2.0 e posterior

O pacote flash.globalization utiliza os recursos de suporte cultural do sistema operacional base. Ele torna mais fácil escrever aplicativos que seguem as convenções culturais de usuários individuais.

As principais classes do pacote incluem:

  • A classe Collator que governa a classificação e correspondência das strings.

  • A classe CurrencyFormatter que formata números em strings de valores de moeda e analisa os símbolos e valores de moedas de strings de entrada

  • A classe DateTimeFormatter que formata os valores de data

  • A classe LocaleID para obter informações sobre uma localidade especifica

  • A classe NumberFormatter que formata e analisa valores numéricos

  • A classe StringTools que trata de conversões de strings sensíveis a localidades

O pacote flash.globalization e localização de recursos

O pacote flash.globalization não manipula localização de recursos. No entanto você pode utilizar a ID de localidade flash.globalization como o valor chave para obter recursos localizados utilizando outras técnicas. Por exemplo, você pode localizar recursos de aplicativo criados com o Flex usando as classes ResourceManager e ResourceBundle. Para mais informações, acesse Localizando aplicativos Flex .

O Adobe AIR 1.1 possui também alguns recursos para ajudar na localização de aplicativos AIR como discutido em Localização de aplicativos AIR .

Uma abordagem geral para internacionalização de um aplicativo

Os seguintes passos descrevem uma aproximação de alto nível para internacionalizar um aplicativo utilizando o pacote flash.globalization:

  1. Determinar ou definir a localidade.

  2. Criar uma ocorrência de uma classe de serviço (Collator, CurrencyFormatter, DateTimeFormatter, NumberFormatter ou StringTools).

  3. Verifique se existem erros e reduções de velocidade utilizando as propriedades lastOperationStatus.

  4. Formatar e exibir informações utilizando configurações de localidade especifica.

O próximo passo é carregar e exibir strings e recursos UI (interface do usuário) que são especificas para a localidade. Esta etapa pode incluir tarefas como, por exemplo:

  • Utilização de recursos autolayout para redimensionar a UI para acomodar comprimentos de sequência de caracteres

  • Selecionar as fontes corretas e os fontes reserva de suporte

  • Utilizar o mecanismo de texto FTE para fornecer suporte a outros sistemas de escrita

  • Certificar-se de que os editores de método de entrada são tratados corretamente

Verificando erros e reduções de velocidade

As classes de serviço flash.globalization seguem um padrão similar para identificar erros. Elas também compartilham um padrão para retornar de uma localidade solicitada indisponível para uma que possua suporte do sistema operacional.

O exemplo a seguir mostra como verificar a existência de erros e fallbacks ao instanciar classes de serviço. Cada classe de serviço possui uma propriedade lastOperationStatus que indica se a chamada de método mais recente disparou erros ou avisos. 

var nf:NumberFormatter = new NumberFormatter("de-DE"); 
if(nf.lastOperationStatus != LastOperationStatus.NO_ERROR) 
{ 
    if(nf.lastOperationStatus == LastOperationStatus.USING_FALLBACK_WARNING) 
    { 
        // perform fallback logic here, if needed 
        trace("Warning - Fallback locale ID: " + nf.actualLocaleIDName); 
    } 
    else 
    { 
        // perform error handling logic here, if needed 
        trace("Error: " + nf.lastOperationStatus); 
    } 
}

Este exemplo apenas rastreia uma mensagem se uma ID de localidade fallback é utilizada ou se há um erro. Seu aplicativo pode executar lógicas de manipulação de erros adicionais, caso seja necessário. Por exemplo, você pode exibir uma mensagem para o usuário ou forçar o aplicativo a utilizar uma localidade especifica suportada.