iOS

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

Что такое iOS?

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

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

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

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

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

Шаг 1. Создайте каталог строк

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

По умолчанию имя файла каталога строк — Localizable.xcstrings.

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

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

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

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

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

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

  • файлы каталога строк, которые Lingo.dev CLI должен перевести
  • языки, между которыми выполняется перевод

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

Чтобы узнать больше, см. конфигурация i18n.json.

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

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

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

    npx lingo.dev@latest login

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

    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. Запустите приложение через симулятор.