Internationalization¶

Using PO Files¶

PO files are a good way to handle Internationalization.
Documentation is available here.

In this example, let’s create two PO files for two different languages(English and Portuguese) and add them to resources/nls.

Labels_en_us.po:

msgid ""
msgstr ""
"Language: en_US\n"
"Language-Team: English\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"

msgid "Label1"
msgstr "My label 1"

msgid "Label2"
msgstr "My label 2"

Labels_pt_br.po:

msgid ""
msgstr ""
"Language: pt_BR\n"
"Language-Team: Portuguese\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"

msgid "Label1"
msgstr "Minha label 1"

msgid "Label2"
msgstr "Minha label 2"

These PO files have to be converted to be usable by the application.
In order to let the build system know which PO files to process, they must be referenced in MicroEJ Classpath using a myapp.nls.list file.

Configuring NLS in MicroEJ¶

First add those two dependencies to the module.ivy of your projet:

<dependency org="ej.library.runtime" name="nls" rev="3.0.1"/>
<dependency org="com.microej.library.runtime" name="binary-nls" rev="2.5.0"/>

Then, let’s create a myapp.nls.list file, and put it in the resources/list folder. The file looks like this:
```
com.mycompany.myapp.Labels
```
Note

For each line, PO files whose name starts with the interface name (Labels in the example) are retrieved from the MicroEJ Classpath and used to generate:
- a Java interface with the given fully qualified name, containing a field for each msgid of the PO files.
- a NLS binary file containing the translations.

Usage¶

Import the interface set in the myapp.nls.list file:
```
import com.mycompany.myapp.Labels;
```

Print the available locales:

for (String locale : Labels.NLS.getAvailableLocales()) {
    System.out.println(locale);
}

Print the current locale:

System.out.println(Labels.NLS.getCurrentLocale());

Change the current locale:
```
Labels.NLS.setCurrentLocale("pt_BR");
```

Finally, put a message from NLS in a label. The code looks like this:

public static void main(String[] args) {
    MicroUI.start();
    Desktop desktop = new Desktop();
    Labels.NLS.setCurrentLocale("pt_BR");
    // For english locale uncomment the line below and comment the pt_BR locale setter call.
    // Labels.NLS.setCurrentLocale("en_US");
    Label label = new Label(Labels.NLS.getMessage(Labels.Label1));
    desktop.setWidget(label);
    desktop.requestShow();
}

The result looks like this:
Setting the locale to “en_US” the result is as follows: