Crowdin SDK allows delivering new translations from Crowdin Enterprise 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 project in Crowdin Enterprise:
App Programming Language
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 Integrations & API > 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.
To configure Android SDK integration you need to:
Follow these steps to configure distribution:
To integrate SDK with your application you need to follow step by step instructions localed in our GitHub repository.
This feature allows translators to see translations in the application in real-time. It can also be used by managers and QA team 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 & API > Over-The-Air Content Delivery. To see the distribution hash right-click on the needed distribution, choose Edit and copy distribution hash|
|Required for advanced features|
|source_language||Source language in your Crowdin Enterprise project (e.g. "en")|
|Crowdin Enterprise authorization credentials. Open the project and go to Integrations & API > Android, 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|
Currently, there are the following integration limitations:
toolbarmanually inside the activity or fragment
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.