Поиск неисправностей VS Code

Ключ-АСТРОМ Extensions работает как приложение NodeJS в среде выполнения VS Code, сосуществуя со всеми другими расширениями, установленными в вашем редакторе. Приложение всегда запускается вместе с редактором, независимо от того, работаете ли вы над проектом расширения. Такое поведение создаёт довольно сложную среду, в которой стандартные функции могут выполняться нестабильным образом, как планировалось.

Продолжайте читать, чтобы узнать, как устранить неполадки, если расширение не работает должным образом, и как связаться с нами, если вам потребуется дополнительная поддержка.

Каналы вывода

Большинство функций расширения предназначены для использования уведомлений пользовательского интерфейса или каналов вывода VS Code для предоставления обратной связи в случаях, когда операции идут не так или не могут продолжаться.

Доступ к выходным каналам осуществляется из нижней части редактора. Просто выберите вкладку «Вывод» и воспользуйтесь раскрывающимся списком справа. Для передачи информации об ошибках доступны два основных канала:

• Ключ-АСТРОМ: канал в формате JSON, который большинство функций будет использовать для обмена полезными данными об ошибках.
• Ключ-АСТРОМ Fast Mode: этот канал в формате JSON сообщает об ошибках, связанных со сборкой, когда включен режим быстрой разработки.

Логи

Помимо этого, вы можете получить более подробную информацию из логов расширения. Расширение отправляет свои логи в специальный канал вывода, называемый Ключ-АСТРОМ Log. В отличие от двух других каналов вывода, этот канал форматирует данные в виде логов и добавляет временные метки для каждого сообщения.

Вы можете настроить уровень детализации сообщений, публикуемых в этом канале, в глобальных настройках редактора. Найдите раздел «Поведение» и настройте уровень детализации по своему усмотрению.

Сборка архива логов

Расширение также хранит логи выполнения на диске с уровнем детализации отладочной информации. Ключ-АСТРОМ Extensions предлагает команду для упаковки внутренней папки логов и сохранения её в выделенном месте. Чтобы выполнить эту команду, нажмите F1, затем выберите Загрузить архив поддержки.

Вы можете настроить механизм устаревания файлов логов в настройках.

Поддержка

Этот проект с открытым исходным кодом поддерживается сообществом. Если вам нужна помощь с какой-либо функцией или вы обнаружили ошибку, свяжитесь с нами, создав issue на GitHub.

Сообщая об ошибках, используйте наш шаблон «Ошибка» и опишите проблему как можно чётче. Укажите такие сведения, как ваша операционная система и версия расширения, а также приложите любые соответствующие файлы или фрагменты YAML.

Запрос на помощь с функциями можно начать с создания пустой заявки. Опишите, чего вы пытаетесь добиться, что идёт не так, как ожидалось, и используйте метку «Требуется помощь» .

В любом случае прикрепите архив логов.