Información general sobre el paquete flash.globalization

Flash Player 10.1 y posterior, Adobe AIR 2.0 y posterior

El paquete flash.globalization reúne las funciones de compatibilidad cultural del sistema operativo subyacente. Facilita la escritura de aplicaciones que siguen las convenciones culturales de usuarios individuales.

Las clases principales del paquete incluyen:

  • La clase Collator que rige la ordenación y la coincidencia de las cadenas

  • La clase CurrencyFormatter que da formato a números de cadenas de cantidad de divisa y analiza las cantidades y los símbolos en las cadenas de entrada

  • La clase DateTimeFormatter que da formato a valores de fecha

  • La clase LocaleID para recuperar información sobre una configuración regional específica

  • La clase NumberFormatter que da formato y analiza valores numéricos

  • La clase StringTools que gestiona la conversión tipográfica de cadenas para distinguir entre mayúsculas y minúsculas

El paquete flash.globalization y la localización de recursos

El paquete flash.globalization no se encarga de la localización de recursos. No obstante, puede utilizar la ID de configuración regional flash.globalization como valor de clave para recuperar recursos localizados mediante otras técnicas. Por ejemplo, puede localizar recursos de aplicaciones creadas con Flex con las clases ResourceManager y ResourceBundle. Para obtener más información, consulte Localizing Flex Applications (sólo disponible en inglés).

Adobe AIR 1.1 también contiene algunas funciones que ayudan a localizar aplicaciones de AIR, tal como se aborda en Localización de aplicaciones de AIR.

Enfoque general de la internacionalización de una aplicación

Los siguientes pasos describen un enfoque habitual de alto nivel para internacionalizar una aplicación con el paquete flash.globalization:

  1. Determine o establezca la configuración regional.

  2. Cree una instancia de una clase de servicio (Collator, CurrencyFormatter, DateTimeFormatter, NumberFormatter o StringTools).

  3. Busque errores y repuestos con las propiedades lastOperationStatus.

  4. Dé formato y visualice información con ajustes específicos de una configuración regional.

El siguiente paso es cargar y visualizar cadenas y recursos de la interfaz de usuario específicos de la configuración regional. Este paso puede incluir tareas como:

  • Usar las funciones autolayout para cambiar la UI de tamaño y poder admitir la longitud de la cadenas

  • Elegir las fuentes adecuadas y las de repuesto

  • Usar el motor de texto FTE para admitir otros sistemas de escritura

  • Garantizar que los editores de método de entrada se gestionan correctamente

Comprobación de errores y repuestos

Las clases del servicio flash.globalization siguen todas un mismo patrón para identificar errores. También comparten un patrón para ofrecer una configuración regional sustituta compatible con el sistema operativo de cada usuario.

El siguiente ejemplo muestra cómo comprobar errores y repuestos cuando se crean instancias de clases de servicio. Cada clase de servicio tiene una propiedad lastOperationStatus que indica si la llamada ma´s reciente al método activó errores o advertencias.

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 ejemplo simplemente traza un mensaje si se utiliza un ID de configuración regional de repuesto o si se produce un error. Su aplicación puede aplicar lógica de gestión de errores adicional, si es necesario. Por ejemplo, puede mostrar un mensaje al usuario o hacer que la aplicación utilice una configuración regional específica admitida.