App Localization

To localize your app into more than one language, you need to write additional appinfo.json files per each language. Because the app ID and version in the top-level appinfo.json are used to validate and correct the values and structure, make sure that the app ID and version in each localized appinfo.json file are the same as those in the top-level appinfo.json file. Any app that fails validation cannot be packaged or uploaded.

Depending on the locale settings, the matching app information is displayed on the launcher and the Home screen.

To add app information in a specific locale, you need to first create a locale folder under the resources folder and then write an appinfo.json file under the correct location as shown below:

Directory structure and appinfo.json files for localizing app metadata

Note

The locale consists of Language, Script, and Country/Region information. (e.g., ko-KR, mn-Cy-MN)

With additional appinfo.json files, your app can display its title and description in different languages. All other properties are kept the same as the top-level appinfo.json file.

{
  "title": "Translated app title",
  "appDescription": "Translated app description"
}
Important
  • In the appinfo.json file for localization, you should fill appDescription and title properties.
  • If you use non-Latin letters (non-ASCII) in the appinfo.json file, you should save the file in UTF-8 without BOM format.

When the locale value is changed after adding an appinfo.json file corresponding to the locale information, the top-level appinfo.json file is loaded into the system memory of webOS TV first, and then other appinfo.json files are overridden depending on the locale setting.