Crowdin SDK allows delivering new translations from the Crowdin Enterprise project to your application immediately. Using integration with Crowdin SDK there will be no need to update the application in the Google Play Store every time there is a new localization version.
The integration provides:
Requirements to integrate Android application with a project in Crowdin Enterprise:
App Programming Language
Configure the distribution to mirror the translated content of your project and integrate with the Android app. Read more about Distributions.
To configure Android SDK integration, follow these steps:
To configure distribution, follow these steps:
To integrate SDK with your application, you need to enable Over-The-Air Content Delivery so that the application can pull translations from the CDN vault. For this, follow step-by-step instructions located in our GitHub repository.
This feature allows translators to see translations in the application in real-time. Managers and the QA team can also use it to preview translations before release.
Enable this feature if you want all the screenshots made in the application to be automatically sent to your Crowdin Enterprise project with tagged strings. This way, translators will have an additional context for the source strings.
|Required for all features|
|your_distribution_hash||Unique hash, which you can get by going to Integrations > Content Delivery. To see the distribution hash, click on the needed distribution, select Edit and copy distribution hash.|
|Required for advanced features|
|source_language||Source language of your Crowdin Enterprise project (e.g., "en").|
|Crowdin Enterprise authorization credentials. Open the project and go to Applications > System > Android SDK. In the Advanced features section, click on the needed feature, 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 используемый в названиях «values-» директорий|
Crowdin Android SDK CDN feature is built with security in mind, which means minimal access possible from the end-user is required. When you decide to use Crowdin Android SDK, please make sure you’ve made the following information accessible to your end-users.
Q: What might cause the occasional delay in getting the latest translations in the app?
A: CDN caches all the translations in release for up to 1 hour. When new translations are released in Crowdin Enterprise, CDN may still return them with a delay.