Applying Internationalization

To successfully localize your apps and services, you need to internationalize them first.

Internationalization mainly carries out the following two tasks: marking text strings for translation and formatting locale-sensitive data. Text strings of your apps and services need to be marked for translation. Formatting locale-sensitive data, such as dates, times, numbers or currency, for different locales and cultural conventions are also required. These are done by using an external internationalization library for each supported programming language.

Internationalization in webOS OSE is available for different programming languages. See Overview for the list of supported programming languages.

Note
This page only provides guides for marking strings for translation. For more information about formatting locale-sensitive data, please refer to the user guide of the provided internationalization library for each programming language.

JavaScript

For web apps developed in JavaScript, use iLib to internationalize your code.

Note
For more information about iLib, refer to the iLib documentation.

Enact Apps

Enact framework offers the $L component as part of its i18n library, which provides functions to map to translated strings.

Example for $L usage
`import $L, {toIString} from '@enact/i18n/$L'; $L('Close'); // => "Close" in the current locale toIString('Close'); // => an ilib IString representing "Close" in the current locale`

Note
For more information about the $L component, refer to the Enact documentation.

Non-Enact Apps

For web apps that do not utilize Enact framework, use the getString() API of ResBundle feature in iLib.

First, load the iLib library ilib-web.js through the <script> tag.

Example for loading ilib-web.js
`<html> <head> <script src=<path-to-ilib>/lib/ilib-web.js type="text/javascript"></script> ... </head> </html>`

For instance, if you're developing a built-in web app, the iLib library can be loaded as follows:

<script src=file://usr/share/javascript/ilib/lib/ilib-web.js type="text/javascript"></script>

After that, use the ResBundle.getString() method of iLib as shown in the example below:

Example for a non-Enact web app

Example for a non-Enact web app
`var ResBundle = require("ResBundle.js"); var rb = new ResBundle({locale: "en-US"}); var str = rb.getString("String 1"); // str is iLib string object var jsStr = str.toString(); // jsStr is js string object`

var ResBundle = require("ResBundle.js");
var rb = new ResBundle({locale: "en-US"});
var str = rb.getString("String 1"); // str is iLib string object
var jsStr = str.toString(); // jsStr is js string object

C++/C

If you are developing apps or services in C++/C, use libwebosi18n to internationalize your code.

The following shows an example which uses the getLocString() API of libwebosi18n in C++ and C:

Using getLocString() in C++

Using getLocString() in C++
`#include <webosi18n.h> std::string locale = "en-US"; const std::string file = "cppstrings.json"; const std::string resources_path = "/usr/share/localization/samplecpp"; ResBundle* resBundle = new ResBundle(locale, file, resources_path); resBundle->getLocString("String 1");`

#include <webosi18n.h>

std::string locale = "en-US";
const std::string file = "cppstrings.json";
const std::string resources_path = "/usr/share/localization/samplecpp";
ResBundle* resBundle = new ResBundle(locale, file, resources_path);

resBundle->getLocString("String 1");

Using getLocString() in C

Using getLocString() in C
`#include <webosi18n_C.h> const char* locale = "en-US"; const char* file = "cstrings.json"; const char* resources_path = "/usr/share/localization/sample_c"; ResBundleC* resBundle = resBundle_createWithRootPath(locale, file, resources_path); resBundle_getLocString(resBundle, "String 1");`

#include <webosi18n_C.h>

const char* locale = "en-US";
const char* file = "cstrings.json";
const char* resources_path = "/usr/share/localization/sample_c";
ResBundleC* resBundle = resBundle_createWithRootPath(locale, file, resources_path);

resBundle_getLocString(resBundle, "String 1");

Qt/QML

For Qt/QML apps, follow Qt's internationalization guideline. For details, refer to the Qt documentation.