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 App Store every time there is a new localization version.
The integration provides:
Over-The-Air Content Delivery – the localized files can be sent to the application from the project whenever needed Real-time Preview – all the translations that are done via Editor can be shown in the application in real-time Screenshots – all screenshots made in the application may be automatically sent to your Crowdin project with tagged source strings
Requirements to integrate an iOS application with a 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 an iOS app.
Follow these steps to configure distribution:
Open the needed project and go to Project Settings > Content Delivery. Also, you can click 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.
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 three-dot button on the needed distribution, choose 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 Real-Time Preview and Screenshots|
|Crowdin authorization credentials. Open the project and go to Project Settings > Content Delivery, choose the feature you need and click Get Credentials|
|your_organization_domain||This field is not used to 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.