Интерфейс командной строки утилиты ring (не поддерживается)

Важно: Начиная с версии 2024.1 этот интерфейс не поддерживается. Используйте интерфейс 1C:EDT CLI.

При установке 1C:EDT также устанавливается утилита ring, входящая в состав платформы «1С:Предприятие». С ее помощью можно выполнять ряд операций, автоматизирующих ваш процесс разработки. Все команды, предназначенные для работы 1C:EDT находятся в модуле edt этой утилиты.

Стандартно утилита ring находится в каталоге:

Чтобы получить справку по всем командам интерфейса командной строки, выполните:

ring edt@2021.3.1:x86_64 help

где 2021.3.1:x86_64 — версия интересующего вас модуля edt.

Получить список всех установленных модулей (с версиями) можно командой:

ring help modules

Список версий платформы

Чтобы получить список поддерживаемых версий платформы используйте команду platform-versions. Она имеет один параметр:

Примечание: Для выполнения любого действия с 1C:EDT инициализируется контейнер с OSGi, которому требуется рабочая область. Поэтому при выполнении этой команды будет создана временная рабочая область в temp-каталоге пользователя. Она будет удалена после выполнения команды.

Например:

ring edt@2021.3.1:x86_64 platform-versions

Список версий 1C:EDT

Чтобы получить список установленных версий 1C:EDT используйте команду list из подсистемы locations. Она не имеет параметров.

Например:

ring edt@2021.3.1:x86_64 locations list

Назначить версию 1C:EDT по умолчанию

Чтобы назначить версию 1C:EDT по умолчанию для данного модуля используйте команду set-default из подсистемы locations.

Она имеет один параметр — путь к установленной версии 1C:EDT. Используйте значение @none чтобы сбросить установку по умолчанию

Например:

ring edt@2021.3.1:x86_64 locations set-default C:\Program Files\1C\1CE\components\1c-edt-2021.3.1+18-x86_64

Оптимизировать формат хранения данных проекта

Чтобы оптимизировать формат хранения данных проекта используйте команду clean-up-source из подсистемы workspace. Она имеет следующие параметры:

Пример:

ring edt@2021.3.1:x86_64 workspace clean-up-source --workspace-location C:\projects\2021.3.0

Экспорт проекта в xml-выгрузку конфигурации

Чтобы конвертировать проект из файлового представления 1C:EDT в xml-выгрузку конфигурации используйте команду export из подсистемы workspace. Она имеет следующие параметры:

Пример выполнения:

ring edt@2021.3.1:x86_64 workspace export --project D:/project-1 --configuration-files d:/XML-1/ --workspace-location D:/workspace

Импорт xml-выгрузки конфигурации в проект

Чтобы конвертировать xml-выгрузку конфигурации в файловое представление 1C:EDT используйте команду import из подсистемы workspace. Она имеет следующие параметры:

Примеры выполнения:

ring edt@2021.3.1:x86_64 workspace import --configuration-files d:/XML-1/ --project D:/project-1 --workspace-location D:/workspace
ring edt@2021.3.1:x86_64 workspace import --configuration-files d:/XML-2/ --project D:/project-2 --base-project-name project-1 --workspace-location D:/workspace
ring edt@2021.3.1:x86_64 workspace import --configuration-files d:/XML-2/ --project D:/project-2 --base-project-name project-1 --version 8.3.11 --workspace-location D:/workspace

Проверка проекта

Чтобы проверить проект используйте команду validate из подсистемы workspace. Она имеет следующие параметры:

  • --workspace-location — обязательный параметр. Каталог рабочей области;
  • --edt-location — каталог, содержащий нужную версию 1C:EDT. Если параметр не задан, то используется либо версия по умолчанию, либо самая ранняя установка, связанная с модулем edt;
  • --file — обязательный параметр. Файл для записи результатов валидации в формате TSV. Если файл уже существует, будет выдана ошибка;
  • --project-list — список каталогов, откуда загрузить проекты в формате 1C:EDT для проверки. Одновременно можно использовать только один аргумент: project-list или project-name-list;
  • --project-name-list — список имен проектов в текущей рабочей области, откуда загрузить проекты в формате 1C:EDT для проверки. Одновременно можно использовать только один аргумент: project-list или project-name-list;

Пример выполнения:

ring edt@2021.3.1:x86_64 workspace validate --project-list D:/project-1 D:/project-2 --file D:/validation-result.txt --workspace-location D:/workspace