Enable localization for KStars on Android

As a first KDE application, KStars got localization working on Android. KStars has the traditional gettext translations in the KDE system and these translations had to be downloaded, converted and packaged inside the apk.

The basic steps were to enable localization on Android:

1. Set CMake variable KDE_L10N_AUTO_TRANSLATIONS to ON. This step will automatically download the translations during the build with a custom build target "fetch-translations".
2. Convert the translations from .po extension into .mo format. This step was done with a custom build target in CMake:

IF (ANDROID)
    ADD_CUSTOM_TARGET(convert_translations_to_android ${CMAKE_SOURCE_DIR}/tools/convert_translations.sh ${CMAKE_BINARY_DIR}/android/export/share/kstars
                        WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
    ADD_DEPENDENCIES(convert_translations_to_android fetch-translations)
ENDIF ()

The convert_translations.sh script can be found here: https://github.com/KDE/kstars/blob/master/tools/convert_translations.sh

3. Set the application domain for translation as usual in the sources:

KLocalizedString::setApplicationDomain("kstars");

4. Add the installation directory on the device like a locale dir:

#if defined(__ANDROID__)
KLocalizedString::addDomainLocaleDir("kstars", "/data/data/org.kde.kstars.lite/qt-reserved-files/share/kstars/locale");
#endif

With the above steps and the current bleeding-edge KI18n KF5 module, your application will load with the current system language on the device.

You can check the whole commit by visiting: https://github.com/KDE/kstars/commit/bf4ac1e6a9a745eb37fc2e719e3fd95b00f84135

Of course, it was not so easy. There were some challenges with the KI18n module because it uses libintl-lite on Android and this lightweight library does not work exactly like the GNU gettext. This library expects a locale filename to bind for the current localization context instead of the location of locale subdirectories. KI18n had to be fixed to provide the filename for libintl-lite on Android platform.

Megjegyzések

Megjegyzés küldése

Népszerű bejegyzések ezen a blogon

Finalizing the GSoC project for KStars

I worked on the KStars during this summer to improve the codebase with C++11 features with Google Summer of Code. I spent the last month to write the first GUI tests for KStars and KStars Lite. KStars Lite can be built and run also on Linux host now although it was developed for Android by a previous GSoC student in 2016. Additional contributions include fixing some bugs found by Clang Sanitizers, usability improvements and templeted FITS decoding. The GSoC period was successful, the goals were reached, but if I would have still more time...
További információk

The achievements during the first GSoC period in KStars

I was able to do major improvements to the build system of KStars. I think more and more open-source projects should pick up these low-hanging fruits with CMake and Clang: - CCache: Speed-up the development time and working with git branches by caching the compiled object files. - Unity Build: This simple "hack" can reduce the build time dramatically by compiling temporary C++ meta files in which the normal C++ files are included. The build time can be speeded up to 2x-3x for bigger projects. - Clang Sanitizers: Use undefined behavior and address sanitizers to hunt down memory handling errors. Although the executable must be recompiled with Clang and special compiler flags, the resulted binary will run with minimal slowdown. It is not a complete replacement, but these sanitizers can catch most of the problems found by Valgrind during normal runtime. - Clang Format: Format the source code with a real compiler engine. More details are on our wiki page: https://techbase
További információk