iOS SDK
Crowdin SDK дозволяє миттєво доставити нові переклади з проекту Crowdin у вашу програму. Під час використання інтеграції з Crowdin SDK вам не потрібно буде оновлювати додаток у App Store кожен раз, коли з’являється нова версія локалізації.
Інтеграція забезпечує:
- Доставки вмісту по повітрю - локалізовані файли можуть надсилатися з проекту програмі, коли це потрібно.
- Попередній перегляд у режимі реального часу - усі переклади, зроблені в редакторі, можуть бути показані у вашій версії програми в режимі реального часу. Перегляньте переклади, які ви вже зробили, і ті, які ви зараз набираєте.
- Скріншоти - Усі скріншоти, зроблені в програмі, разом із позначеними вихідними рядками, можуть бути автоматично надіслані вашому проекту Crowdin.
Для отримання додаткової інформації про Crowdin iOS SDK, включаючи кроки встановлення та налаштування, дивіться наше сховище GitHub.
Системні вимоги
Вимоги до інтеграції програми iOS з проектом у Crowdin:
Інструмент розробки
- Xcode version 10.2+
Мова програмування програми
- Swift version 4.2+
Операційна система
- iOS version 9.0+
Дистрибуції та випуски
Розподіл - це сховище CDN, яке відображає перекладений вміст вашого проекту і потрібно інтегруватися з додатком iOS.
Виконайте наступні дії для налаштування розподілу:
-
Відкрийте потрібний проект та перейдіть до Налаштування проекту > Доставка вмісту.
Ви також можете натиснути кнопку Отримати ідентифікаційні дані, щоб перевірити деталі, необхідні для програми OAuth під час підключення пакета SDK Crowdin. 
-
Додайте новий дистрибутив, натиснувши кнопку Додати розподіл. Оберіть лише ті файли, переклади яких потрібно вказати в програмі, і натисніть Далі.
-
Скопіюйте хеш дистрибутива, щоб використовувати його для інтеграції.
-
Створіть стільки необхідних дистрибутивів і оберіть різні файли для кожного. Вам потрібно буде натискати кнопку Випустити поруч із необхідним розповсюдженням кожного разу, коли ви бажаєте надсилати нові переклади до програми.
Увага! Наразі Спеціальні мови, діалекти та Картографування мови не підтримуються для інтеграції iOS.
Встановлення, налаштування та вдосконалені функції SDK Crowdin
Дізнайтеся більше про те, як налаштувати Crowdin SDK для вашої програми в нашому сховищі GitHub.
Параметри
| Обов’язково для всіх функцій | |
| your_distribution_hash | Унікальний хеш, який ви можете отримати, перейшовши до Налаштування проекту > Доставка вмісту. Щоб побачити хеш розподілу, натисніть кнопку двокрапки поруч із потрібним розподілом, оберіть Редагувати та скопіюйте хеш дистрибутива |
| localizations | Цільові мови для вашого проекту Crowdin (наприклад, ‘fr’, ‘el’). Формат: osx_locale |
| source_language | Мова оригіналу вашого проекту Crowdin (наприклад,, "en"). Формат: osx_locale |
| Обов'язкові для попереднього перегляду в режимі реалізованого часу та зменшеного екрану | |
| client_id; client_secret | Повноваження авторизації Crowdin. Відкрийте проект та перейдіть до Налаштування проекту > Доставка вмісту, оберіть потрібну функцію та натисніть Отримати ідентифікаційні дані |
| your_organization_domain | Це поле не використовується для проекту Crowdin |
Шаблони експорту файлів
Ви можете вказати шаблони експорту файлів та перевірити існуючі за допомогою Налаштування файлу. Для інтеграції iOS підтримуються такі заповнювачі:
| Ім'я | Опис |
|---|---|
| %language% | Назва мови (наприклад, українська) |
| %locale% | Місцевий стандарт (наприклад, uk-UA) |
| %locale_with_underscore% | Місцевий стандарт (наприклад, uk_UA) |
| %osx_code% | Локальний стандартний ідентифікатор OS X, який використовується для імені каталогу ".lproj" |
| %osx_locale% | Локальний стандарт OS X, який використовується для іменування ресурсів перекладу (напр. uk, zh-Hans, zh_HK) |
Безпека
Функція CDN для SDK Crowdin iOS побудована з урахуванням безпеки, а це означає, що можливість мінімального доступу для кінцевого користувача є обов’язковою. Якщо ви вирішили використовувати SDK Crowdin iOS, переконайтеся, що ви надали наступну інформацію для кінцевих користувачів.
- Ми використовуємо веб-сервіси Amazon (AWS) для нашої обчислювальної інфраструктури. AWS мають сертифікацію ISO 27001 та пройшли безліч перевірок SSAE 16. Усі переклади зберігаються на серверах AWS.
- При використанні CDN для Crowdin iOS SDK - переклади завантажуються на Amazon CloudFront для доставки до програми та прискорення завантаження. Майте на увазі, що користувачі завантажують переклади без додаткової аутентифікації.
- Ми використовуємо шифрування для захисту ваших даних під час передачі.
- Ми не зберігаємо будь-яку особисту інформацію (PII) кінцевого користувача, але ви можете розробити власний варіант відмови в програмі, щоб користувачі мали повний контроль.
- Функції автоматичних знімків екрана та попереднього перегляду використовуються командами розробників та перекладачами. Ці функції не слід компілювати у виробничу версію вашої програми. Тому вони жодним чином не повинні впливати на конфіденційність кінцевих користувачів.