iOS

AI-перевод для iOS-приложений с помощью Lingo.dev CLI

Что такое iOS?

iOS — это мобильная операционная система Apple, которая используется на устройствах iPhone и iPad.

Что такое Lingo.dev CLI?

Lingo.dev — это платформа для перевода на базе искусственного интеллекта. Lingo.dev CLI читает исходные файлы, отправляет переводимый контент в большие языковые модели и записывает переведённые файлы обратно в ваш проект.

О данном руководстве

В этом руководстве объясняется, как настроить Lingo.dev CLI в iOS-приложении. Вы узнаете, как создать String Catalog в Xcode, настроить пайплайн перевода и протестировать результат в iOS-симуляторе.

Шаг 1. Создайте String Catalog

  1. Откройте свой проект в Xcode.
  2. Перейдите в File > New > File from Template.
  3. Выберите String Catalog из доступных шаблонов.
  4. Нажмите Next.
  5. Нажмите Create.

По умолчанию имя файла String Catalog — Localizable.xcstrings.

Шаг 2. Создайте локализуемые строки

  1. Откройте файл String Catalog.
  2. Выберите исходную локаль (например, English).
  3. Нажмите на иконку +, чтобы добавить новую строку.
  4. Введите ключ, например "welcome".
  5. Введите значение, например "Hello, world".

Шаг 3. Настройте CLI

В корне вашего Xcode-проекта создайте файл i18n.json:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "xcode-xcstrings": {
      "include": ["Localizable.xcstrings"]
    }
  }
}

Этот файл определяет:

  • файл(ы) String Catalog, которые должен переводить Lingo.dev CLI
  • языки, между которыми будет выполняться перевод

В этом случае конфигурация переводит String Catalog с английского на испанский.

Подробнее см. конфигурация i18n.json.

Шаг 4. Переведите контент

  1. Зарегистрируйтесь в Lingo.dev.

  2. Войдите в Lingo.dev через CLI:

    npx lingo.dev@latest login

  3. Запустите pipeline перевода:

    npx lingo.dev@latest run

    CLI обновит ваш файл Localizable.xcstrings с переведённым контентом и создаст файл i18n.lock для отслеживания переведённых строк (чтобы избежать лишних повторных переводов).

Шаг 5. Используйте переводы

В вашем Swift-коде обращайтесь к локализованным строкам по их ключам:

Text("welcome")

Шаг 6. Просмотрите переводы

  1. Перейдите в Product > Scheme > Edit Scheme.
  2. В появившемся окне выберите Run.
  3. Переключитесь на вкладку Options.
  4. В выпадающем списке App Language выберите язык для тестирования.
  5. Нажмите Close.
  6. Запустите приложение через симулятор.