Based on Qt

The functionality in Qt Quick Ultralite is based on Internationalization and Localization in Qt and Qt Linguist. This document describes the differences, enhancements, and limitations compared to Qt.

Translation

Use either the qsTr() or qsTrId() function in QML files to mark string literals for translation. All such marked string literals are found by the Qt Linguist tool, which generates the translation source file (.ts) containing those strings.

Once translations are made, there will a .ts file for each language. These files are compiled to translation release files (.qm) and passed to the QML compiler, which replaces the qsTr() or qsTrId() calls with a lookup of the correct string based on the Qt.uiLanguage property.

The Qt.uiLanguage property can also be used in other bindings to make decisions based on the active language.

The translation example shows how to use qsTr() and the Qt.uiLanguage property.

Building with CMake

Listing the translation source files for the target languages in the TranslationFiles.files QmlProject property and using the containing QmlProject file in qul_add_target with QML_PROJECT specified will have two effects:

• It creates a update_translations CMake target which is not included in the default build. Trigger a build of this target to create or update the .ts files with new and changed translatable strings from the source code.
• It sets up the build system to embed the translations from the .ts files in the program binary.

Each .ts file introduces a translated language that can be switched to at runtime by setting the Qt.uiLanguage property. The name of the language is derived from the name of the .ts file. For example, the "app_nb_NO.ts" file defines the translations for nb_NO, which is the ISO language code for Norwegian Bokmål.

When the Qt.uiLanguage is empty, no translation is applied and the strings used in the source code are shown.

If an application does not support multiple languages, set the TranslationFiles.MCU.omitSourceLanguage to false.

Standalone qmlprojectexporter

When developing using a build system other than CMake, qmlprojectexporter can be run solely to update the translations, refer to qmlprojectexporter's update translation argument for more details.

Limitations

The following functionality is not currently supported:

• Translation of strings in C++ files
• Translation functions other than qsTr() such as qsTrId(), qsTranslate(), QT_TR_NOOP(), QT_TRANSLATE_NOOP() and QT_TRID_NOOP()
• The plural disambiguation argument in qsTr()