mobile-sdk-android | Crowdin Android SDK delivers all new translations | Internationalization library

You have two ways to install Crowdin Android SDK.
From Jitpack Add this to your root build.gradle at the end of repositories: allprojects { repositories { ... maven { url 'https://jitpack.io' } } } Add the dependency: dependencies { implementation 'com.github.crowdin.mobile-sdk-android:sdk:1.5.1' } For Android project which already have transitive dependency of com.google.code.gson, after integration of Crowdin SDK, it will show you the following error during build time: Duplicate class com.google.gson.DefaultDateTypeAdapter found in modules xxx.jar (xxx.jar) and jetified-gson-2.8.5.jar (com.google.code.gson:gson:2.8.5) To resolve, either exclude gson from Crowdin or from your library is OK, but be sure to keep the newer one for backward-compatibility. implementation ('com.github.crowdin.mobile-sdk-android:sdk:1.5.1') { exclude group: 'com.google.code.gson', module: 'gson' }
Manually download or clone this module.
To configure Android SDK integration you need to:. Distribution is a CDN vault that mirrors the translated content of your project and is required for integration with Android app. To manage distributions open the needed project and go to Over-The-Air Content Delivery. You can create as many distributions as you need and choose different files for each. You’ll need to click the Release button next to the necessary distribution every time you want to send new translations to the app.
Upload your xml localization files to Crowdin. If you have ready translations, you can also upload them.
Set up Distribution in Crowdin.
Set up SDK and enable Over-The-Air Content Delivery feature in your project.
The CDN feature does not update the localization files. if you want to add new translations to the localization files you need to do it yourself.
Once SDK receives the translations, it's stored on the device as application files for further sessions to minimize requests the next time the app starts. Storage time can be configured using withUpdateInterval option.
CDN caches all the translation in release for up to 15 minutes and even when new translations are released in Crowdin, CDN may return it with a delay.
Inject Crowdin translations by adding override method in BaseActivity class to inject Crowdin translations into the Context. If you already migrated to AppCompat 1.2.0+ version. Please use this method: Kotlin override fun getDelegate() = BaseContextWrappingDelegate(super.getDelegate()) Java @NonNull @Override public AppCompatDelegate getDelegate() { return new BaseContextWrappingDelegate(super.getDelegate()); } And for AppCompat 1.1.0 and lower use this: Kotlin override fun attachBaseContext(newBase: Context) { super.attachBaseContext(Crowdin.wrapContext(newBase)) } Java @Override protected void attachBaseContext(Context newBase) { super.attachBaseContext(Crowdin.wrapContext(newBase)); } Note! If you don’t have BaseActivity class add the following code to all of your activities.
Enable Over-The-Air Content Delivery in your project so that application can pull translations from CDN vault. Add the following code to App/Application class: Kotlin override fun onCreate() { super.onCreate() Crowdin.init(applicationContext, CrowdinConfig.Builder() .withDistributionHash(your_distribution_hash) .withNetworkType(network_type) // optional .withUpdateInterval(interval_in_seconds) // optional .build()) } Java @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); Crowdin.init(this, new CrowdinConfig.Builder() .withDistributionHash(your_distribution_hash) .withNetworkType(network_type) // optional .withUpdateInterval(interval_in_seconds) // optional .build()); } Config option Description Example withDistributionHash Distribution Hash withDistributionHash("7a0c1...7uo3b") withNetworkType Network type to be used for translations download Acceptable values are:- NetworkType.ALL (default) - NetworkType.CELLULAR- NetworkType.WIFI withUpdateInterval Translations update interval in seconds. The minimum and the default value is 15 minutes. Translations will be updated every defined time interval once per application load withUpdateInterval(900)