Adobe Flex Development

Рано или подзно перед разработчиком встает задача локализации приложения. На самом деле сделать это очень просто, но и тут есть свои подводные камни. Итак, обо всем по порядку.

Как создать новую локаль?

По умолчанию Flex поддерживает две локали — английскую и японскую (en_US, jp_JP). Предположим вам необходимо обеспечить поддержку немецкой локали de_DE. Вам придется создать ее самостоятельно:

1) Запускаем командную строку от имени администратора.

2) Переходим в папку установки Flex SDK, в директорию bin (в моем случае это C:\Program Files\Adobe\Flex Builder 3\sdks\3.0.0\bin\) и находим утилиту copylocale.exe
Запускаем ее следующим образом:
copylocale en_US de_DE

3) Переходим в папку с локалями, чтобы убедиться в успешности операции. В моем случае это C:\Program Files\Adobe\Flex Builder 3\sdks\3.0.0\frameworks\locale\
Там должна появиться новая папка de_DE и в ней набор swc-файлов. Готово!

Выкладываю свою версию немецкой локали (Flex SDK 3.0.0), скачать ее можно тут.

Примечание: мой архив включает datavisualization_rb.swc, который необходим для работы некоторых компонентов Flex.

Создаем мультиязычный проект

Итак вы подготовили проект и создали, теперь займемся непосредственно локализацией. В корне проекта создайте папку locale в которую поместите папки с названием используемых локалей в приложении, например создайте en_US и de_DE. Переводы мы будем хранить в так называемых .properies файлах. У вас должна в итоге получиться структура похожая на мою:

Я создал translations.properies файл для каждой локали. Синтаксис этих файлов предельно прост — записываем туда пары

КЛЮЧ = ЗНАЧЕНИЕ (строка)

или

КЛЮЧ = ЗНАЧЕНИЕ_1, ЗНАЧЕНИЕ_2, ..., ЗНАЧЕНИЕ_N. (массив)

каждую с новой строки. Файлы необходимо сохранять в кодировке UTF-8. Итак внесем в наши файлы переводы.

en_US:

CANCEL = Cancel
SAVE = Save
FIELD_IS_REQUIRED = This field is required

de_DE:

CANCEL = Abbrechen
SAVE = Speichern
FIELD_IS_REQUIRED = Pflichtfeld

И последний, но немаловажный штрих — настройка компилятора. Добавьте следующие аргументы компилятора в свой проект (в среде Flex Builder это делается по правому клику на проекте Properties -> Flex Library Compiler -> Additional Compiler Arguments):

-locale de_DE en_US -source-path+=../locale/{locale}

При таких аругментах компилятора локалью по умолчанию будет de_DE.

Класс Translator

Создадим класс Translator для инкапсуляции наших переводов.

package ru.flexdev.utils
{
	import mx.resources.ResourceManager;
 
	public class Translator 
	{
		[ResourceBundle("translations")]
		public static const TRANSLATIONS_RESOURCE:String = 'translations';
 
		public static function getString(name:String):String 
		{
			var result:String = ResourceManager.getInstance().getString(TRANSLATIONS_RESOURCE, name);
			return result ? result : name;
		}
 
                public static function getStringArray(name:String):Array {
			var result:Array = ResourceManager.getInstance().getStringArray(TRANSLATIONS_RESOURCE, name);
			return result ? result : name;	
		}
	}
}

Теперь мы можем пользоваться переводами в UI. Например:

<mx:Button label="{Translator.getString('CANCEL')}" />

Заключение

В заключении хочу добавить несколько моментов по поводу синтаксиса .properties файлов.
1) Стандарта нет, но я для себя создал правило записывать ключи в верхнем регистре, как константы.
2) Как я уже сказал — файлы должны быть сохранены в кодировке UTF-8, но можно этого и не делать, а просто заменять в тексте UTF-символы их кодами, например для de_DE:

A-umlaut: \u00E4
O-umlaut: \u00F6
U-umlaut: \u00FC
double S: \u00DF

3) Текущую локаль приложения я обычно передаю через flashvars во Flex и устанавливаю при инициализации приложения так:

private function init():void
{
    // set up locale
    var localeChain:Array = ["de_DE", "en_US"];
    var locale:String = Application.application.parameters.localeString;
    if(localeChain.indexOf(locale) > -1) {
        resourceManager.localeChain = [locale];
    }
    else {
        resourceManager.localeChain = localeChain;
    }
    // startup
    ...
}

Надеюсь получилось не слишком запутано, если что-то не ясно — я отвечу на адекватные вопросы по теме статьи.

Flex i18n, locale, translations