Crowdin SDK allows delivering new translations from the Crowdin project to your application immediately. Using integration with Crowdin SDK, there will be no need to update the application in the App Store every time there is a new localization version.
The integration provides:
Requirements to integrate an iOS application with a project in Crowdin:
App Programming Language
Configure the distribution to mirror the translated content of your project and integrate with iOS app. Read more about Distributions.
For more details on how to set up Crowdin SDK for your application visit our GitHub repository.
|Required for all features|
|your_distribution_hash||Unique hash, which you can get by going to Projects Settings > Content Delivery. To see the distribution hash, click on the needed distribution, select Edit and copy distribution hash.|
|localizations||Target languages of your Crowdin project (e.g., ‘fr’, ‘el’). Format: osx_locale.|
|source_language||Source language of your Crowdin project (e.g., "en"). Format: osx_locale.|
|Required for advanced features|
|Crowdin authorization credentials. Open the project and go to Settings > Content Delivery. In the For Mobile Applications section, click Get Credentials.|
|your_organization_domain||This field is not used for the Crowdin project.|
You can set file export patterns and check existing ones using File Settings. The following placeholders are supported for iOS integration:
|%language%||Language name (e.g., Ukrainian)|
|%locale%||Locale (e.g., uk-UA)|
|%locale_with_underscore%||Locale (e.g., uk_UA)|
|%osx_code%||OS X locale identifier used to name ".lproj" directories|
|%osx_locale%||OS X locale used to name translation resources (e.g., uk, zh-Hans, zh_HK)|
Crowdin iOS 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 iOS 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, CDN may still return them with a delay.