iOS SDK

Crowdin SDK дозволяє миттєво доставити нові переклади з проекту Crowdin у вашу програму. Під час використання інтеграції з Crowdin SDK вам не потрібно буде оновлювати додаток у App Store кожен раз, коли з’являється нова версія локалізації.

Інтеграція забезпечує:

  • Доставки вмісту по повітрю - локалізовані файли можуть надсилатися з проекту програмі, коли це потрібно.
  • Попередній перегляд у режимі реального часу - усі переклади, зроблені в редакторі, можуть бути показані у вашій версії програми в режимі реального часу. Перегляньте переклади, які ви вже зробили, і ті, які ви зараз набираєте.
  • Скріншоти - Усі скріншоти, зроблені в програмі, разом із позначеними вихідними рядками, можуть бути автоматично надіслані вашому проекту Crowdin.

Системні вимоги

Вимоги до інтеграції програми iOS з проектом у Crowdin:

Інструмент розробки

  • Xcode version 10.2+

Мова програмування програми

  • Swift version 4.2+

Операційна система

  • iOS version 9.0+

Дистрибуції та випуски

Розподіл - це сховище CDN, яке відображає перекладений вміст вашого проекту і потрібно інтегруватися з додатком iOS.

Виконайте наступні дії для налаштування розподілу:

  1. Відкрийте потрібний проект та перейдіть до Налаштування проекту > Доставка вмісту. Over-the-Air Content DeliveryВи також можете натиснути кнопку Отримати ідентифікаційні дані, щоб перевірити деталі, необхідні для програми OAuth під час підключення пакета SDK Crowdin. Доставка контенту в прямому ефірі

  2. Додайте новий дистрибутив, натиснувши кнопку Додати розподіл. Оберіть лише ті файли, переклади яких потрібно вказати в програмі, і натисніть Далі. Доставка контенту в прямому ефірі

  3. Скопіюйте хеш дистрибутива, щоб використовувати його для інтеграції. Доставка контенту в прямому ефірі

  4. Створіть стільки необхідних дистрибутивів і оберіть різні файли для кожного. Вам потрібно буде натискати кнопку Випустити поруч із необхідним розповсюдженням кожного разу, коли ви бажаєте надсилати нові переклади до програми. Доставка контенту в прямому ефірі

Увага! Наразі Спеціальні мови, діалекти та Картографування мови не підтримуються для інтеграції 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) кінцевого користувача, але ви можете розробити власний варіант відмови в програмі, щоб користувачі мали повний контроль.
  • Функції автоматичних знімків екрана та попереднього перегляду використовуються командами розробників та перекладачами. Ці функції не слід компілювати у виробничу версію вашої програми. Тому вони жодним чином не повинні впливати на конфіденційність кінцевих користувачів.

Ця стаття була корисною?