Устранение неполадок CLI
Решайте проблемы с выбором файлов, базовым состоянием, получением результатов и каталогами, не начиная с удаления полезного состояния.
При диагностике сбоя держите под рукой номер установленной версии, команду, рабочую папку, текст ошибки и затронутые пути. Перед отправкой логов скройте учётные данные: диагностические данные запуска и сбоев могут содержать аргументы argv в исходном виде.
Нет исходных файлов, подходящих под шаблоны #
Найдите ближайший .lingo/config.json. Команда из вложенной папки может использовать проект из одной из родительских папок. Сначала проверьте include, затем pattern: даже пустой список включений имеет приоритет. Исключения действуют в пределах одной записи. Другая запись по-прежнему может выбрать этот файл.
Используйте поддерживаемый синтаксис сопоставления, например docs/en/**/*, заключайте шаблоны командной оболочки в кавычки и проверяйте, какие суффиксы поддерживаются. Для YAML нужно явно указать yaml, yaml-root-key или yaml-openapi, а для Android XML — android. Для файла .txt, .csv или .properties нужен шаблон, который заканчивается расширением файла, либо "format": "txt", "format": "csv" или "format": "properties". Широкий шаблон, например docs/en/**/*, не включает такой файл, а запись txt, csv или properties исключает все файлы без соответствующего расширения. Даже если формат указан явно, это не значит, что подойдёт любое расширение.
Результат записан не туда #
Прочитайте предупреждения о формировании пути и сравните путь назначения с тем, откуда приложение загружает файлы. Если сегмент исходной локали не распознан, задайте targetPath и sourceRoot, а не полагайтесь на запасной вариант со вставкой локали. Храните целевые файлы вне области поиска исходных и проверьте, нет ли конфликтов путей.
Само по себе перемещение файлов не обновляет базовое состояние. XCStrings специально использует один общий исходный каталог, а не обычную структуру с отдельными файлами для каждой локали. См. пути выходных файлов.
Параметр не действует #
Неизвестные ключи на корневом уровне и на уровне файла вызывают предупреждение и игнорируются. Проверьте написание и убедитесь, что выбранный обработчик поддерживает этот параметр. Настройки путей каталога не обновляют шаблоны push, а extract и check независимо друг от друга используют en как исходную локаль по умолчанию.
Для локальной оценки используется исполняемый файл lingo.config.ts, а не JSON проекта. Параметр защиты для JSON не обязательно действует на Markdown или другой формат.
Не найден артефакт базового состояния #
Предыдущий исходный артефакт, на который указывает хеш в Lockfile, должен быть доступен локально или на сервере. Проверьте указанную запись и восстановите заведомо корректные байты либо согласованное базовое состояние. Не придумывайте хеш и не удаляйте весь Lockfile, чтобы скрыть ошибку.
Если состояние отсутствует, первый обычный push сохраняет исходные байты. Для отсутствующих обычных целевых файлов нужно дозаполнение. В разделе Lockfile и кеш описано, какая запись нужна для этой операции.
Pull сообщает о конфликте #
Запустите lingo pull --dry-run, чтобы проверить, какие файлы будут записаны и почему. Если целевой файл отличается от результата на сервере, байтов, зафиксированных при push, и хеша в Lockfile, запись блокируется. Коммит этого файла не меняет результат сравнения.
Сохраните правку и согласуйте версии, восстановите известную версию или используйте принудительную запись, только если намеренно хотите заменить файл. Не редактируйте целевые файлы во время push --wait: в отличие от pull, эта команда не проверяет конфликты заново.
Работа завершилась с ошибкой или ещё не закончена #
Проверьте ошибки для каждого целевого файла. Различайте ожидание обработки, проверку, сбой и отсутствие результатов. Если запуск завершился с ошибкой, push --wait и pull сначала записывают готовые документы, а затем завершаются с ненулевым кодом. Проверьте состояние и сами файлы.
Если все незавершённые целевые файлы ожидают ручной проверки, push --wait и pull прекращают ожидание и сообщают об этом. Документы, для которых готовы все локали, можно получить. Запустите lingo pull ещё раз, когда проверка завершится. Повторный push не устраняет ожидание проверки.
Если запуск завершился с ошибкой, устраните указанную причину и повторите команду, подходящую для этой задачи. Для обычного обновления исходных файлов используйте lingo push --wait с неизменёнными исходными файлами и сохранённым базовым состоянием. Для отсутствующих целевых файлов повторите дозаполнение, но только после обновления существующих целевых файлов, следуя разделу Как добавить язык. Чтобы запросить ещё одну попытку, не нужно менять исходные файлы, включать принудительный режим или удалять состояние.
Push выводит ИД задания, которое отправляет или к которому подключается повторно. Если результаты предыдущего push ещё не получены и запрос не изменился, push использует тот же запрос: выполняющееся задание сохраняет свой ИД, а завершившееся с ошибкой заменяется новым. Сохраните ИД задания с ошибкой и убедитесь, что в следующей строке Job указан другой ИД. Это подтверждает отправку нового задания, но не успешный перевод: проверьте результаты по целевым файлам, получите их и просмотрите изменения. Не меняйте локальные целевые файлы во время --wait. Если нужно защитить локальные правки, выполняйте push и pull с проверкой конфликтов отдельно.
Если установленный клиент возвращает то же задание с ошибкой, прекратите повторные отправки и напишите на support@lingo.dev. Укажите версию CLI, команду без конфиденциальных данных, прежний и возвращённый ИД запуска, ревизию исходных файлов, затронутые локали и пути, время событий и текст ошибки без конфиденциальных данных. Не включайте в письмо учётные данные, конфиденциальный исходный текст и файлы с учётными данными в исходном виде. Пока мы разбираемся со сбоем, сохраните локальный указатель запуска и Lockfile.
Удаление указателя запуска — ненадёжный способ запросить новый перевод. Пока результаты push не получены, указатель хранит идентификатор запроса, который предотвращает повторные отправки. Если запуск не найден, проверьте, на том ли вы компьютере, верен ли абсолютный путь к корню проекта и не заменил ли другой push указатель.
Проверки каталога завершаются с ошибкой #
Выполняйте extract с той же локалью и путями, что и check. Прежде чем удалять неиспользуемые записи, изучите предупреждения о динамических и деструктурированных вызовах. Об отсутствии целевого файла сообщается, только если исходный каталог соответствует шаблонам files. В противном случае сравните ожидаемые локали с существующими файлами.
Очищайте каталог только от намеренно удалённых записей, заново создайте объявления, затем запустите check и сборку приложения. status теперь находится в check. Внутренние имена служб — не исполняемые команды.
Прежде чем что-либо удалять #
Purge позволяет заранее увидеть, какие целевые файлы будут удалены. Фильтры файлов и локалей ограничивают удаление выбранными целевыми файлами и их записями в Lockfile. Без фильтров purge удаляет весь Lockfile. Общие каталоги XCStrings пропускаются. Используйте purge, когда вам нужно именно удаление. Для большинства задач восстановления достаточно точечного исправления с сохранением принятых формулировок и состояния, которое можно восстановить.