1C Platform Tools

Расширение для Visual Studio Code с инструментами разработки для экосистемы 1С. Предоставляет удобный интерфейс для работы с проектами 1С через панель команд и дерево задач.

Возможности

Откройте панель «1C Platform Tools» в боковой панели VS Code. Все команды организованы по категориям.

В дереве доступны следующие разделы:

• Избранное — быстрый доступ к выбранным командам (отображается вверху при наличии избранных)
• Информационные базы — операции с ИБ
• Конфигурация — загрузка, выгрузка, сборка и разбор конфигурации
• Расширения — работа с расширениями конфигурации
• Внешние файлы — сборка и разбор обработок и отчётов
• Зависимости — управление зависимостями (OPM, packagedef)
• Запуск — запуск Предприятия и Конфигуратора
• Тестирование — XUnit, синтаксический контроль, Vanessa, Allure
• Установить версию — установка версии конфигурации, расширений, отчётов и обработок
• Задачи (oscript) — запуск задач из каталога tasks (vrunner/OneScript)
• Задачи (workspace) — задачи из tasks.json и конфигурации из launch.json

Избранное

Можно добавить любые команды в избранное для быстрого доступа:

1. Вызовите команду «Настроить избранное» из палитры команд (Ctrl+Shift+P → «1C: Дерево: Настроить избранное») или через контекстное меню заголовка панели.
2. В открывшемся списке отметьте нужные команды (в том числе с параметрами: конкретное расширение, отчёт, обработка или задача oscript).
3. Избранные команды появятся в секции «Избранное» вверху дерева и сохраняются между сессиями.

Команды также доступны через палитру команд (Ctrl+Shift+P → введите «1C»).

Требования

• Visual Studio Code версии 1.106.1 или выше
• Node.js версии 18.x или выше
• OneScript (oscript) - для выполнения скриптов
• vanessa-runner (vrunner) - для выполнения команд 1С
• OPM (OneScript Package Manager) - для управления зависимостями

Установка

1. Откройте VS Code
2. Перейдите в раздел Extensions (Ctrl+Shift+X)
3. Найдите "1C Platform Tools"
4. Нажмите "Install"

Настройка

Расширение автоматически активируется при открытии проекта 1С (наличие файла packagedef в корне проекта).

Инициализация проекта

Если в открытой папке ещё нет файла packagedef, панель «1C Platform Tools» не отображается, но команды доступны из палитры команд (Ctrl+Shift+P). Выполните «1C: Зависимости: Инициализировать packagedef» — будет создан файл packagedef из шаблона. После успешного создания расширение активируется полностью: панель и дерево команд появятся без перезагрузки окна. Если вызвать любую другую команду расширения без открытого проекта 1С, будет показано информационное сообщение с подсказкой использовать эту команду.

Логирование

Расширение пишет логи в панель Output (Вид → Вывод), канал «1C Platform Tools». Уровень детализации задаётся в настройках:

• Настройка: 1c-platform-tools.logLevel
• Значения: error (только ошибки), warnings (ошибки и предупреждения), info (по умолчанию), debug (полный вывод для диагностики)

При сбое команды откройте Output → «1C Platform Tools», при необходимости установите уровень debug, воспроизведите проблему и приложите логи к отчёту об ошибке.

Настройки доступны через File > Preferences > Settings (или Ctrl+,) и поиск "1C Platform Tools". Параметры подключения к информационной базе настраиваются в файле env.json в корне проекта:

{
  "default": {
    "--ibconnection": "/F./build/ib"
  }
}

Структура проекта

Расширение опирается на структуру каталогов проекта vanessa-bootstrap — шаблона правильной разработки на платформе 1С:Предприятие 8.

Рекомендуемая структура проекта:

project/
├── build/
│   ├── ib/                 # Информационная база
│   └── out/                # Собранные файлы
├── src/
│   ├── cf/                 # Исходники конфигурации
│   ├── cfe/                # Исходники расширений
│   ├── epf/                # Исходники внешних обработок
│   └── erf/                # Исходники внешних отчетов
├── oscript_modules/        # Зависимости (устанавливаются через OPM)
├── env.json                # Настройки подключения к ИБ
└── packagedef              # Файл для активации расширения

Работа с Docker

Расширение поддерживает выполнение команд vrunner через Docker-контейнеры. Это полезно для работы в окружениях без локальной установки платформы 1С (например, GitHub Codespaces).

Подготовка Docker-образа:

Docker-образы для работы с платформой 1С и vanessa-runner можно собрать из репозитория pravets/onec-images:

1. Форкните репозиторий pravets/onec-images
2. Следуйте инструкциям в репозитории для сборки образа vrunner
3. Опубликуйте собранный образ в ваш Docker registry (Docker Hub, GitHub Container Registry и т.д.)

Настройка Docker в расширении:

1. Включите Docker-режим: 1c-platform-tools.docker.enabled = true
2. Укажите Docker-образ: 1c-platform-tools.docker.image = "your-registry/vrunner:8.3.27.1786"

Важно:

• Docker-образ должен содержать установленную платформу 1С:Предприятие и vanessa-runner

• При использовании Docker параметр --ibcmd используется автоматически (так как в Docker нет GUI)

• Пути автоматически нормализуются для Docker-окружения (/F./build/ib → /F./workspace/build/ib)

• Ограничение: В Docker можно выполнять только команды, которые поддерживают --ibcmd:

  • ✅ Операции с информационными базами (init-dev, update-dev, dump, restore, dump-dt, load-dt)
  • ✅ Операции с конфигурацией (load, dump, dumpcf, compile, decompile)
  • ✅ Операции с расширениями (compileext, decompileext, unloadext, compileexttocfe)
  • ✅ Операции с внешними файлами (compileepf, decompileepf)
  • ❌ Запуск приложений (run, designer) - требуют GUI
  • ❌ Тестирование (xunit, syntax-check, vanessa) - могут требовать GUI

  При попытке выполнить команду, которая не поддерживает --ibcmd, расширение покажет предупреждение.

Важные нюансы

• Все команды выполняются в терминале VS Code для видимости вывода
• Расширение автоматически ищет vrunner.bat в oscript_modules/bin/ проекта
• Параметр --ibconnection берется из env.json (секция default['--ibconnection'], по умолчанию /F./build/ib)
• Все пути к файлам внутри workspace должны быть относительными
• Для использования ibcmd требуется установка платформы 1С:Предприятие с компонентом "Сервер 1С: Предприятия 8" (настройка 1c-platform-tools.useIbcmd)
• При использовании Docker (docker.enabled = true) параметр --ibcmd используется автоматически
• Инициализация: без файла packagedef панель скрыта; команда «1C: Зависимости: Инициализировать packagedef» из палитры создаёт проект и сразу включает панель без перезагрузки
• Логи: диагностика и ошибки пишутся в Output → «1C Platform Tools»; уровень задаётся настройкой 1c-platform-tools.logLevel (info по умолчанию, debug для детального разбора)

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

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

Лицензия

MIT License. Подробности см. в файле LICENSE.

Автор

Ivan Karlo (i.karlo@outlook.com)

При желании, отблагодарить автора можно по ссылке:

• Boosty
• Сбор в Т-банк