1C Platform Tools

yellow-hammer

7 installs

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

Installation

Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.

Copied to clipboard

More Info

1C Platform Tools

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

Возможности

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

Панель команд 1C Platform Tools

Все команды доступны через дерево задач в боковой панели:

Информационные базы: операции с ИБ
Конфигурация: работа с конфигурацией
Расширения: работа с расширениями
Внешние файлы: обработки и отчеты
Зависимости: управление зависимостями
Запуск: запуск приложений 1С
Тестирование: тесты и проверки
Задачи (workspace): задачи и конфигурации запуска

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

Требования

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

Установка

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

Настройка

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

Настройки доступны через 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              # Файл для активации расширения

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

Все команды выполняются в терминале VS Code для видимости вывода
Расширение автоматически ищет vrunner.bat в oscript_modules/bin/ проекта
Параметр --ibconnection берется из env.json (секция default['--ibconnection'], по умолчанию /F./build/ib)
Все пути к файлам внутри workspace должны быть относительными

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

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

Лицензия

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

Автор

Ivan Karlo (i.karlo@outlook.com)

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