API локализации Flutter (ARB)

Localization.One полностью поддерживает нативный формат ARB Flutter. Вместо того чтобы вручную редактировать сложные структуры JSON с метаданными, вы можете управлять переводами вашего мобильного приложения в удобном интерфейсе и экспортировать их непосредственно в ваш проект Flutter.

Почему разработчики выбирают наш API Flutter?

  • Нативный формат ARB: Мы генерируем действительные .arb файлы, совместимые с официальным пакетом flutter_localizations и intl.
  • Автоматизированные метаданные: Мы автоматически добавляем ключ @@locale, гарантируя, что ваши файлы ARB всегда действительны и распознаются компилятором Flutter.
  • Готово для мобильных устройств: Идеально подходит для управления динамическим контентом в ваших сборках для Android и iOS из одного источника.

Расширенное управление проектом

Масштабируйте локализацию вашего мобильного приложения без головной боли.

Единый рабочий процесс: Управляйте переводами для iOS и Android в одном месте. Экспортируйте в ARB для Flutter или отдельные XML/Strings, если это необходимо.

Метки и теги: Помечайте строки пользовательскими метками, такими как "Введение" или "Настройки", чтобы фильтровать экспорты через API.

Командное сотрудничество: Приглашайте переводчиков и копирайтеров. Назначайте детализированные роли (Владелец, Администратор, Менеджер, Переводчик).

Вебхуки: Автоматически запускайте Codemagic или GitHub Actions сборки, когда переводы обновляются.

Как интегрировать

Вариант 1: Ручной экспорт (UI)

Идеально для локальной разработки.

  1. Перейдите на ваш Панель управления проектом.
  2. Нажмите кнопку Скачать .
  3. Выберите Flutter ARB из выпадающего списка форматов.
  4. Выберите язык и скачайте файл .arb.

Вариант 2: Автоматизация с помощью API (CI/CD)

Получите последние переводы непосредственно в вашем конвейере сборки. Передайте параметр format=arb.

bash
# Скачайте английские переводы
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=1&format=arb" > lib/l10n/app_en.arb

# Скачайте испанские переводы
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=2&format=arb" > lib/l10n/app_es.arb

Вариант 3: Отправка через вебхуки

Настройте URL вебхука в настройках вашего проекта, чтобы полностью автоматизировать процесс.

  • Быстрые обновления: Ваш сервер получает POST-запрос вскоре после изменений (обычно в течение 5 минут).
  • Запуск сборок: Подключите вебхуки к вашему поставщику CI/CD, чтобы автоматически пересобирать ваше приложение при изменении контента.

Часто задаваемые вопросы

Нужно ли мне вручную добавлять @@locale?

Нет. Наш API автоматически добавляет ключ @@locale в верхней части файла ARB на основе запрашиваемого вами кода языка (например, "@@locale": "en"), так что файл готов к использованию сразу.

Могу ли я использовать такие заполнители как {name}?

Да. Flutter ARB поддерживает синтаксис ICU. Вы можете писать {name} или {count, plural, ...} в ваших переводах, и они будут экспортированы правильно.

Другие мобильные форматы:

  • Нативная разработка для Android? Смотрите Android XML.
  • Нативная разработка для iOS? Смотрите iOS Strings.

Готовы автоматизировать вашу локализацию Flutter? Создайте свою бесплатную учетную запись сегодня.