Crowdin SDK allows delivering new translations from the Crowdin project to your application immediately. Using this integration there will be no need to every time update application via Google Play Store to get the new localization version.
The integration provides:
Requirements to integrate Android application with the project in Crowdin:
App Programming Language
Distribution is a CDN vault that mirrors the translated content of your project and is required for integration with Android app.
Follow these steps to configure distribution:
Open your project and go to Project Settings > Content Delivery.
Also, you can press Get Credentials button to check the details required for the OAuth application while connecting Crowdin SDK.
Add new distribution using Add Distribution button. Choose only the files, translations for which you want to be shown in your application and click Next.
Copy distribution hash so you can use it for integration.
Сreate 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.
|Required for all features|
|your_distribution_hash||Unique hash which you can get by going to Project Settings > Content Delivery. To see the distribution hash, click three-dot button on the needed distribution, choose Edit and copy distribution hash|
|Required for advanced features|
|source_language||Source language in your Crowdin project (e.g. "en")|
|Crowdin authorization credentials. Open the project and go to Project Settings > Content Delivery, choose the feature you need and click Get Credentials|
|network_type||Network type to be used. You may select NetworkType.ALL, NetworkType.CELLULAR, or NetworkType.WIFI|
|interval_in_milisec||Update intervals in milliseconds|
You can set file export patterns and check existing ones using File Settings. The following placeholders are supported for Android integration:
|%language%||Language name (e.g. Ukrainian)|
|%two_letters_code%||Language code ISO 639-1 (e.g. uk)|
|%three_letters_code%||Language code ISO 639-2/T (e.g. ukr)|
|%locale%||Locale (e.g. uk-UA)|
|%locale_with_underscore%||Locale (e.g. uk_UA)|
|%android_code%||Android Locale identifier used to name "values-" directories|
For more details on how to set up Crowdin SDK for your application visit our GitHub repository.