Android SDK (скоро)
Crowdin SDK дозволяє миттєво доставити нові переклади з проекту Crowdin у вашу програму. Використовуючи цю інтеграцію, не потрібно буде оновлювати додаток щоразу через Google Play Store, щоб отримати нову версію локалізації.
Інтеграція забезпечує:
- Доставки вмісту по повітрю - локалізовані файли можуть надсилатися з проекту програмі, коли це потрібно.
- Попередній перегляд у режимі реального часу - усі переклади, зроблені в редакторі, можуть бути показані у вашій версії програми в режимі реального часу. Перегляньте переклади, які ви вже зробили, і ті, які ви зараз набираєте.
- Скріншоти - Усі скріншоти, зроблені в програмі, разом із позначеними вихідними рядками, можуть бути автоматично надіслані вашому проекту Crowdin.
Для отримання додаткової інформації про Crowdin Android SDK, включаючи кроки встановлення та налаштування, дивіться наше Сховище GitHub.
Системні вимоги
Вимоги до інтеграції програми Android з проектом у Crowdin:
Інструмент розробки
- Android SDK version 16+
Мова програмування програми
- Java version 8+
або - Kotlin version 1.3+
Дистрибуції та випуски
Розподіл - це сховище CDN, яке відображає перекладений вміст вашого проекту і потрібно інтегруватися з додатком Android.
Налаштування розподілу
Виконайте наступні дії для налаштування розподілу:
-
Відкрийте проект та перейдіть до Налаштування проекту > Доставка вмісту.
Ви також можете натиснути кнопку Отримати сертифікати, щоб перевірити деталі, необхідні для програми OAuth при підключенні до SDK Crowdin. 
-
Додайте новий дистрибутив, натиснувши кнопку Додати розподіл. Оберіть лише ті файли, переклади яких потрібно вказати в програмі, і натисніть Далі.
-
Скопіюйте хеш дистрибутива, щоб використовувати його для інтеграції.
-
Створіть стільки необхідних дистрибутивів і оберіть різні файли для кожного. Вам потрібно буде натискати кнопку Випустити поруч із необхідним розповсюдженням кожного разу, коли ви бажаєте надсилати нові переклади до програми.
Увага!НаразіСпеціальні мови, діалекти та картографування мови не підтримуються для інтеграції Android.
Встановлення, налаштування та вдосконалені функції SDK Crowdin
Дізнайтеся більше про те, як налаштувати Crowdin SDK для вашої програми в нашому сховищі GitHub.
Параметри
| Обов’язково для всіх функцій | |
| your_distribution_hash | Унікальний хеш, який ви можете отримати, перейшовши до Налаштування проекту > Доставка вмісту. Щоб побачити хеш розподілу, натисніть кнопку двокрапки поруч із потрібним розподілом, оберіть Редагувати та скопіюйте хеш дистрибутива |
| Потрібно для додаткових функцій | |
| source_language | Мова оригіналу вашого проекту Crowdin (напр., "en") |
| client_id; client_secret | Повноваження авторизації Crowdin. Відкрийте проект та перейдіть до Налаштування проекту > Доставка вмісту, оберіть потрібну функцію та натисніть Отримати ідентифікаційні дані |
| За бажанням | |
| network_type | Тип використовуваної мережі. Ви можете вибрати NetworkType.ALL, NetworkType.CELLULAR або NetworkType.WIFI |
| interval_in_milisec | Оновлення інтервалів в мілісекундах |
Шаблони експорту файлів
Ви можете вказати шаблони експорту файлів та перевірити існуючі за допомогою Налаштування файлу. Для інтеграції Android підтримуються такі заповнювачі:
| Ім'я | Опис |
|---|---|
| %language% | Назва мови (наприклад, українська) |
| %two_letters_code% | Код мови ISO 639-1 (напр., uk) |
| %three_letters_code% | Код мови ISO 639-2/T (напр., uk) |
| %locale% | Місцевий стандарт (наприклад, uk-UA) |
| %locale_with_underscore% | Місцевий стандарт (наприклад, uk_UA) |
| %android_code% | Ідентифікатор мови в Android використаний в назвах «values-» директорій |
Безпека
Функція CDN для Crowdin Android SDK побудована з урахуванням безпеки, а це означає, що можливість мінімального доступу для кінцевого користувача є обов’язковою. Якщо ви вирішили використовувати SDK Crowdin для Android, переконайтеся, що надаєте наступну інформацію для кінцевих користувачів.
- Ми використовуємо веб-сервіси Amazon (AWS) для нашої обчислювальної інфраструктури. AWS мають сертифікацію ISO 27001 та пройшли безліч перевірок SSAE 16. Усі переклади зберігаються на серверах AWS.
- При використанні CDN для Crowdin Android SDK - переклади завантажуються на Amazon CloudFront для доставки в програму і прискорюють завантаження. Майте на увазі, що користувачі завантажують переклади без додаткової аутентифікації.
- Ми використовуємо шифрування для захисту ваших даних під час передачі.
- Ми не зберігаємо будь-яку особисту інформацію (PII) кінцевого користувача, але ви можете розробити власний варіант відмови в програмі, щоб користувачі мали повний контроль.
- Функції автоматичних знімків екрана та попереднього перегляду використовуються командами розробників та перекладачами. Ці функції не слід компілювати у виробничу версію вашої програми. Тому вони жодним чином не повинні впливати на конфіденційність кінцевих користувачів.