Skip to content

Latest commit

 

History

History
475 lines (312 loc) · 17.5 KB

FAQ.ru.md

File metadata and controls

475 lines (312 loc) · 17.5 KB

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

Общие вопросы

Что такое это расширение?

Это расширение для VS Code, которое предоставляет полнофункциональную среду разработки для конфигураций 1С:Предприятие. Оно воссоздает привычный интерфейс конфигуратора 1С непосредственно в VS Code.

Зачем использовать VS Code вместо конфигуратора?

Преимущества:

  • Современный интерфейс и функциональность
  • Лучшая интеграция с Git и системами контроля версий
  • Мощные инструменты поиска и рефакторинга
  • Расширяемость через плагины
  • Кроссплатформенность
  • Бесплатность

Поддерживаются ли все версии 1С?

Расширение работает с конфигурациями, выгруженными в XML формат. Поддерживаются:

  • 1С:Предприятие 8.3
  • 1С:Предприятие 8.2 (частично)

Можно ли редактировать конфигурацию напрямую в базе?

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

Установка и настройка

Как установить расширение?

Из Marketplace:

  1. Откройте VS Code
  2. Нажмите Ctrl+Shift+X
  3. Найдите "OneDesigner"
  4. Нажмите "Установить"

Из файла .vsix:

  1. Скачайте .vsix файл
  2. В VS Code: Ctrl+Shift+P → "Extensions: Install from VSIX"
  3. Выберите скачанный файл

Как выгрузить конфигурацию в XML?

  1. Откройте конфигуратор 1С
  2. Меню: Конфигурация → Выгрузить конфигурацию в файл
  3. Укажите папку для выгрузки
  4. Дождитесь завершения

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

Проверьте:

  1. Версия VS Code >= 1.80.0
  2. В папке есть файл Configuration.xml
  3. Нет ошибок в консоли разработчика (Help → Toggle Developer Tools)

Решение:

  • Перезагрузите VS Code
  • Переустановите расширение
  • Проверьте логи в Output Channel

Как обновить расширение?

Расширение обновляется автоматически через VS Code Marketplace. Для ручного обновления:

  1. Откройте панель расширений
  2. Найдите "OneDesigner"
  3. Нажмите кнопку "Update" если доступна

Работа с конфигурацией

Дерево метаданных не загружается

Возможные причины:

  1. Отсутствует файл Configuration.xml
  2. Некорректная структура папок
  3. Ошибки в XML-файлах
  4. Недостаточно прав доступа

Решение:

  1. Проверьте наличие Configuration.xml в корне папки
  2. Проверьте права доступа к файлам
  3. Откройте консоль разработчика и проверьте ошибки
  4. Попробуйте выгрузить конфигурацию заново

Изменения не сохраняются

Возможные причины:

  1. Файлы только для чтения
  2. Файлы открыты в другом редакторе
  3. Ошибка валидации
  4. Недостаточно прав

Решение:

  1. Проверьте права на запись
  2. Закройте файлы в других редакторах
  3. Проверьте сообщения об ошибках валидации
  4. Проверьте логи в Output Channel

Как откатить изменения?

Если используете Git:

git checkout -- путь/к/файлу

Если нет Git:

  1. Расширение создает резервные копии перед изменениями
  2. Найдите файл с расширением .backup
  3. Восстановите из резервной копии

Можно ли работать с несколькими конфигурациями?

Да, используйте VS Code Workspace:

  1. Файл → Добавить папку в рабочую область
  2. Добавьте папки с разными конфигурациями
  3. Каждая конфигурация будет иметь свое дерево метаданных

Редактирование

Как добавить новый реквизит?

Через XML:

  1. Откройте XML-файл объекта
  2. Добавьте секцию реквизита
  3. Сохраните файл
  4. Дерево обновится автоматически

Через конфигуратор:

  1. Добавьте реквизит в конфигураторе
  2. Выгрузите конфигурацию
  3. Обновите папку в VS Code

Как создать новую форму?

В текущей версии создание новых объектов не поддерживается. Используйте конфигуратор для создания, затем редактируйте в VS Code.

Редактор форм не открывается

Проверьте:

  1. Файл формы существует
  2. XML-файл формы корректен
  3. Нет ошибок в консоли

Решение:

  1. Проверьте структуру XML
  2. Попробуйте открыть через контекстное меню
  3. Перезагрузите VS Code

Как изменить макет формы?

  1. Откройте форму в редакторе
  2. Используйте визуальный макет для перемещения элементов
  3. Или редактируйте свойства в палитре свойств
  4. Изменения сохраняются автоматически

Производительность

Расширение работает медленно

Причины:

  1. Большая конфигурация
  2. Много открытых файлов
  3. Недостаточно памяти
  4. Конфликт с другими расширениями

Решение:

  1. Закройте неиспользуемые редакторы
  2. Увеличьте память для VS Code
  3. Отключите неиспользуемые расширения
  4. Используйте поиск вместо прокрутки дерева

Как ускорить загрузку конфигурации?

Оптимизации:

  1. Расширение использует кэширование
  2. Ленивая загрузка узлов дерева
  3. Инкрементальный парсинг

Дополнительно:

  1. Используйте SSD диск
  2. Исключите папку из антивируса
  3. Закройте другие приложения

Дерево метаданных долго обновляется

Обновление должно занимать < 500 мс. Если дольше:

  1. Проверьте размер конфигурации
  2. Проверьте нагрузку на диск
  3. Проверьте логи производительности

Интеграция с Git

Как настроить Git для конфигурации?

Создайте .gitignore:

# VS Code
.vscode/
*.code-workspace

# Временные файлы
*.tmp
*.backup
*.log

# Кэш расширения
.1c-cache/

Инициализируйте репозиторий:

git init
git add .
git commit -m "Initial commit"

Какие файлы коммитить?

Коммитить:

  • Все XML-файлы конфигурации
  • Файлы модулей (.bsl)
  • Файлы форм
  • Configuration.xml

Не коммитить:

  • Временные файлы
  • Кэш
  • Локальные настройки VS Code

Как разрешать конфликты?

При конфликте в XML:

  1. Откройте файл с конфликтом
  2. VS Code покажет маркеры конфликта
  3. Выберите нужную версию или объедините вручную
  4. Сохраните файл
  5. Добавьте в staging и закоммитьте

Рекомендация: Используйте инструменты сравнения конфигураций 1С для сложных конфликтов.

Можно ли использовать GitHub/GitLab?

Да, расширение полностью совместимо с любыми Git-хостингами:

  • GitHub
  • GitLab
  • Bitbucket
  • Azure DevOps
  • Собственный Git-сервер

Тестирование

Как запустить тесты расширения?

Для разработчиков:

npm test                # Все тесты
npm run test:unit       # Unit тесты
npm run test:property   # Property-based тесты
npm run test:integration # Интеграционные тесты

Что такое property-based тесты?

Property-based тесты проверяют свойства, которые должны выполняться для всех входных данных, а не для конкретных примеров. Расширение использует библиотеку fast-check.

Пример: Вместо теста "парсинг конкретного XML работает", мы тестируем "парсинг любого валидного XML работает корректно".

Как сообщить об ошибке?

  1. Проверьте, что ошибка воспроизводится
  2. Проверьте Issue Tracker
  3. Создайте новый issue с:
    • Описанием проблемы
    • Шагами для воспроизведения
    • Ожидаемым и фактическим поведением
    • Версией VS Code и расширения
    • Скриншотами или логами

Расширенные возможности

Можно ли создать собственный редактор?

Да, расширение предоставляет API для создания кастомных редакторов. См. Руководство разработчика.

Как добавить поддержку нового типа объектов?

См. раздел "Добавление нового типа метаданных" в Руководстве разработчика.

Можно ли автоматизировать задачи?

Да, используйте:

  1. VS Code Tasks
  2. Скрипты Node.js
  3. API расширения

Пример задачи:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Проверить конфигурацию",
      "type": "shell",
      "command": "node scripts/validate-config.js"
    }
  ]
}

Поддерживается ли EDT формат?

В текущей версии поддерживается только XML формат конфигуратора. Поддержка EDT планируется в будущих версиях.

Безопасность

Безопасно ли использовать расширение?

Да, расширение:

  • Не отправляет данные на внешние серверы
  • Работает только локально
  • Открытый исходный код
  • Проходит проверку VS Code Marketplace

Создаются ли резервные копии?

Да, расширение автоматически создает резервные копии перед изменением файлов. Копии сохраняются с расширением .backup.

Как защитить конфигурацию?

Рекомендации:

  1. Используйте Git для версионирования
  2. Регулярно делайте резервные копии
  3. Ограничьте доступ к папке конфигурации
  4. Не храните пароли в конфигурации

Лицензирование

Какая лицензия у расширения?

MIT License - свободная лицензия с минимальными ограничениями.

Можно ли использовать в коммерческих проектах?

Да, расширение можно свободно использовать в коммерческих проектах.

Нужно ли платить за использование?

Нет, расширение полностью бесплатное.

Поддержка

Где получить помощь?

Каналы поддержки:

Как внести вклад в проект?

См. CONTRIBUTING.md для подробной информации.

Планируются ли новые функции?

Да, см. Roadmap для планов развития.

Запланировано:

  • Поддержка EDT формата
  • Отладчик 1С
  • Рефакторинг кода
  • Анализ качества кода
  • Генерация документации

Сравнение с другими инструментами

Чем отличается от конфигуратора?

Функция Конфигуратор VS Code + Расширение
Редактирование метаданных ✅ ✅
Редактирование кода ✅ ✅ (лучше)
Отладка ✅ ⏳ (планируется)
Git интеграция ❌ ✅
Рефакторинг ⚠️ ✅
Расширяемость ❌ ✅
Кроссплатформенность ⚠️ ✅
Стоимость Платно Бесплатно

Чем отличается от EDT?

EDT - это Eclipse-based среда разработки от 1С. Основные отличия:

VS Code + Расширение:

  • Легче и быстрее
  • Лучшая интеграция с Git
  • Больше расширений
  • Бесплатно

EDT:

  • Официальная поддержка 1С
  • Встроенная отладка
  • Больше функций для 1С
  • Платно

Можно ли использовать оба инструмента?

Да, можно использовать VS Code для редактирования кода и конфигуратор/EDT для других задач. Главное - синхронизировать изменения через выгрузку/загрузку конфигурации.

Дополнительные ресурсы

Обучающие материалы

Сообщество

Связанные проекты


Не нашли ответ на свой вопрос?

Создайте issue в Issue Tracker или задайте вопрос в Discussions.