Android SDK v2 Changelog

2.3.1 and 2.3.1 Lite

  • Improved the translation fetching strategy
    • Added the com.lokalise.sdk.LokaliseTranslations interface that allows fetching translations directly from the bundle
    • Changed the internal SDK translation fetching strategy to LokaliseFallbackStrategy.IGNORE_BUNDLE_DEFAULT_LANGUAGE
  • Removed LokaliseUpdateError.NO_INTERNET_CONNECTION in favor of LokaliseOtaUpdateErrorType.UNKNOWN_HOST and LokaliseOtaUpdateErrorType.TIMEOUT to provide more information about connectivity issues.
  • Updated naming of some methods to improve clarity:
    • LokaliseResources.translateToolbarItems(toolbar: Toolbar) -> LokaliseResources.translateToolbarMenuItems(toolbar: Toolbar)
    • LokaliseFallbackStrategy.DEFAULT –> LokaliseFallbackStrategy.WITH_BUNDLE_DEFAULT_LANGUAGE
    • LokaliseFallbackStrategy.SKIP_BUNDLE_DEFAULT –> LokaliseFallbackStrategy.IGNORE_BUNDLE_DEFAULT_LANGUAGE
    • com.lokalise.sdk.LokaliseCallback –> com.lokalise.sdk.ota.LokaliseOtaUpdateCallback
    • com.lokalise.sdk.LokaliseUpdateError –> com.lokalise.sdk.ota.LokaliseOtaUpdateErrorType
  • Added the LokaliseAdditionalOptions interface for additional options provided by SDK.

2.3.0 and 2.3.0 Lite

  • Updated internal Lokalise domain (from .co to .com) for future compatibility.

2.2.1 and 2.2.1 Lite

  • In order to prevent issues while saving data for a new bundle (version, languages, translations), from this version, all changes will be processed in one database transaction.


  • Increased the minimum Android version supported from 16 to 21.
  • Fixed the cast type for the translations bundle. (The defect was introduced in version 2.1.2).
  • Updated the GSON library versions to fix a vulnerability.
    • Updated io.realm:realm-gradle-plugin from 10.10.1 to 10.13.1
    • Updated from 1.5.20 to 1.8.0
    • Updated from 7.0.4 to 7.4.2
  • Upgraded targetSdk and compileSdk versions to support Android 13.
  • Increased the OTA bundle fetch request timeout.

2.2.0 Lite

  • All changes on version 2.2.0.
  • Fixed the callback behaviour when the app version in the local database was always 1.

2.1.3 Lite

  • Updated from 2.3.0 to 2.9.0 version to fix a known vulnerability.
  • Added handling for a possible exception that may occur after the migration from Lokalise OTAv2 to OTAv3, when parsing the bundle’s JSON.


  • Updated from 2.3.0 to 2.9.0 version to fix a known vulnerability.
  • Added handling for a possible exception that may occur after the migration from Lokalise OTAv2 to OTAv3, when parsing the bundle’s JSON.

2.1.2 Lite

  • Prevents crashes by disabling WAL, which is enabled by default starting from Android 9.
  • Checks the physical space on the device before saving a bundle.
    • If the available space is greater than the bundle size plus 10MB, the bundle will be saved to the local database. The solution works both for internal and external storages, depending on the app location.
    • If the available space is less than the bundle plus 10MB, the app may receive a new callback: LokaliseCallback.onUpdateFailedNotEnoughSpace() with type LokaliseCallbackType.TYPE_NO_ENOUGH_SPACE
  • Wrapped the database initialization in try {} catch(SQLiteCantOpenDatabaseException). If the exception is caught, the SDK doesn't use the database but the bundle translations.


  • Fixed issues with returning configuration. From now on, the Lokalise SDK returns the system configuration changes with the app configuration set.
  • Added support for PreferenceFragmentCompat.


Breaking changes

  • Implemented translation strategy. Call Lokalise.init() with LokaliseFallbackStrategy.SKIP_BUNDLE_DEFAULT to skip default bundle translation if a primary translation wasn’t found. By default, LokaliseFallbackStrategy.DEFAULT is applied.
  • Call Lokalise.setLocale() with activity’ context to receive Activity.onConfigurationChanged() callback when new configuration was applied.
  • Lokalise.setLocale() is extended to receive variant according to the Locale class. Other parameters were renamed to be the same as in the Locale class - languageISO -> language, regionISO -> country. The change affects languages with different scripts, for example, Chinese Traditional and Chinese Simplified scripts.
  • Added the ability to receive Lokalise UUID identifier for test reasons -> Lokalise.getUserUUID().


Breaking changes

We are finalizing the specifications of the SDK 2, and this is probably the last beta build for this SDK before the full release. Please note, that since beta-10 LokaliseMenuInflater has been removed, and instead, you should use the translateToolbarItems method from LokaliseResources if you want your menu items to be translated automatically.

public class MainActivity extends AppCompatActivity {
    private Toolbar toolbar;

    protected void onCreate(Bundle savedInstanceState) {
        toolbar = findViewById(;

    public boolean onCreateOptionsMenu(Menu menu) {
        getMenuInflater().inflate(, menu);
        ((LokaliseResources) getResources()).translateToolbarItems(toolbar);
        return true;

Also, library has been updated to version 10, so if your project is using an old version of, you may need to update it.

File size

Please note that the size of the new APK file may increase. To mitigate this, we recommend uploading a bundle generated by Android Studio to Google Play instead of a simple APK file. This will allow Google Play to serve only needed resources to end-user devices drastically decreasing the download size.