Skip to content

Latest commit

 

History

History
101 lines (72 loc) · 5.03 KB

README.md

File metadata and controls

101 lines (72 loc) · 5.03 KB
Raw

Утилита которая дружит vscode и 1С:Предприятие

Что надо знать:

Про Visual Studio Code

  1. Что такое vscode и где его взять
  2. three-way merge
  3. Command Line Interface (CLI)

Про поставку конфигураций 1С

  1. Поставка и поддержка конфигурации
  2. Настройки внешних программ для операций сравнения/объединения

VSCode CLI

--diff <file1> <file2> - Open a file difference editor. Requires two file paths as arguments.

--merge <path1> <path2> <base> <result> - Perform a three-way merge by providing paths for two modified versions of a file, the common origin of both modified versions, and the output file to save merge results.

--wait - Wait for the files to be closed before returning.

--new-window - Opens a new session of VS Code instead of restoring the previous session (default).

--sync <on | off> - Turn sync on or off.

Perforce P4Merge конфигурация для 1С:Предприятия

Compare two files:

-C utf8-bom -nl %baseCfgTitle -nr %secondCfgTitle %baseCfg %secondCfg

Three-way merge:

-C utf8-bom -nl %baseCfgTitle -nr %secondCfgTitle -nb %oldVendorCfgTitle %oldVendorCfg %baseCfg %secondCfg %merged

По функциональности похоже на vscode. Используем этот шаблон для составления утилиты которая будет запускать vscode.

VSCode

Compare two files:

--diff %baseCfg %secondCfg --new-window --sync off

Three-way merge:

--merge %baseCfg %secondCfg %oldVendorCfg %merged --new-window --sync off --wait

Особенности

Платформа кидает пути со смешанными слешами, например такие:

"C:\Users\zeegin\AppData\Local\Temp\mrg/CommonModule.DistributedModule.Module(File C__Users_zeegin_Downloads_1Cv8_1.0.2.cf).txt"

Пути в файлах кидаются с расширением .txt а чтобы в vscode работала подсветка должны быть .bsl. Потому надо обернуть в создание файлов .bsl копированием.

Платформа ожидает результат в %merged, однако сам файл не создает. vscode хочет чтобы в --merge ... <result> файл уже был. Потому надо файл создать, например копированием %secondCfg, а после завершения работы vscode уже кинуть в путь, который ожидает платформа.

У батч скриптов есть два варианта получения параметров коммандной строки:

  • %1 - получает параметр по индексу 1 включая кавычки " если они есть.
  • %~1 - получает параметр по индексу 1 исключая кавычки " если они есть.

Обычная команда copy плохо работает с путями со смешанными слешами, потому лучше использовать xcopy.

Как использовать:

  1. При установке vscode выбирите пункт добавление программы в PATH, тогда ее можно открывать командой консоли code.
  2. Выбирите в конфигураторе Сервис -> Параметры -> Сравнение/Объединение -> Создать.
  3. Переименуйте в VSCode.
  4. Впишите исполняемый файл полный путь до vscode-adapter.cmd, например C:\git\vscode-merge-tool-adapter-cli\vscode-adapter.cmd.
  5. Введите команду для сравнения двух файлов: 
    --diff %baseCfg %secondCfg
  6. Введите команду для трехстороннего объединения: 
    --merge %baseCfg %secondCfg %oldVendorCfg %merged
  7. Выберите VSCode в качестве редактора.
    • Показывать различия без учета структуры.
    • Режим Объединить с помощью внешней программы.

Скриншоты

Близкие по назначению проекты

ocvc - утилита, упрощающая перенос участков кода из Конфигуратора 1С в Visual Studio Code.