Приложение находится в каталоге исполняемых файлов 1C:EDT.
Можно использовать следующие опции:
1cedtcli -data D:\projects\МойПроект
1cedtcli -data D:\projects\МойПроект -timeout 5400 -file D:\projects\script.txt
1cedtcli -data D:\projects\МойПроект -vmargs -Xmx8g -command import --configuration-files D:\XML-1 --project D:\project-1
>1cedtcli -V
1.30.0-SNAPSHOT
Build: 2
Revision: bab3b67830e78ed251940c29e2687edf613457d7
1cedtcli -h -nl en_US
1cedtcli -data D:\projects\МойПроект -command clean-up-source --project-name Демо_EDT
1cedtcli -data D:\projects\МойПроект -file D:\projects\script.txt
После имени файла можно указать один или несколько аргументов, которые будут переданы в исполняемый файл. В файле они будут доступны как переменные $1, $2 и т.д.
Чтобы запустить 1C:EDT CLI в интерактивном режиме, после 1cedtcli укажите опцию -data — расположение рабочей области. Например:
1cedtcli -data D:\projects\МойПроект
В результате в интерпретаторе командной строки вы увидите приглашение 1C:EDT>. После этого можно вводить команды 1C:EDT CLI.
1cedtcli -data D:\projects\МойПроект -command clean-up-source --project-name Демо_EDT
Для выполнения последовательности команд можно использовать скрипты. Подробнее о скриптах читайте здесь.
build --yes
1C:EDT> build
Пожалуйста, подтвердите сборку следующих проектов:
pr24
pr24.ВесТоваров
pr24.Колонтитулы
Действительно собрать? (y/n; по умолчанию=n)
Если
после этого аргумента перечислены имена проектов, то будут
пересобраны только эти
проекты:build --yes [pr24 pr24.Колонтитулы]
"строка"
— каталог, который нужно установить в
качестве текущего рабочего. Если этот аргумент указан, то команда
меняет текущий рабочий каталог на
указанный:cd /path/to/new/working/directory
Если
аргумент пропущен, то команда выводит текущий рабочий
каталог:cd
Оптимизирует формат хранения данных проекта. Имеет один из следующих обязательных аргументов:
clean-up-source --project-name Демо_EDT
delete --yes
1C:EDT> delete
Пожалуйста, подтвердите удаление следующих проектов:
pr24
pr24.ВесТоваров
pr24.Колонтитулы
Действительно удалить? (y/n; по умолчанию=n)
Если
после этого аргумента перечислены имена проектов, то будут
удалены только эти
проекты:delete --yes [pr24 pr24.Колонтитулы]
Выйти из интерактивного режима командной строки. Имеет необязательные аргументы:
exit --yes
1C:EDT> exit
Вы действительно хотите выйти? (y/n; по умолчанию=y)
Экспортирует проект 1C:EDT в .xml-файлы конфигурации. Имеет следующие аргументы:
export --project D:\Демо_EDT --configuration-files D:\xml-files
format-modules --project D:\Демо_EDT
format-modules --project-name Демо_EDT
Выводит список доступных команд. Например:
help
help install-platform-support
import --project D:\Демо_EDT
Импортирует .xml-файлы конфигурации в проект 1C:EDT. Имеет следующие аргументы:
Например:
import --configuration-files D:\xml-files --project D:\Демо_EDT
import --base-project-name Демо_EDT --configuration-files D:\xml-files --project D:\Демо_EDT.ВесТоваров
import --version 8.3.24 --base-project-name Демо_EDT --configuration-files D:\xml-files --project D:\Демо_EDT.ВесТоваров
Устанавливает поддержку платформы «1С:Предприятие» указанной версии. Имеет обязательный аргумент:
install-platform-support --version 8.3.10
Сообщает список версий платформы «1С:Предприятие», которые поддерживаются данной средой разработки. Например:
1C:EDT> platform-versions
8.3.21
8.3.22
8.3.23
8.3.24
1C:EDT> project --details
Имя: pr24
Содержимое: C:\Users\Test\AppData\Local\1C\1cedtstart\projects\pr24\pr24
Имя: pr24.ВесТоваров
Содержимое: C:\Users\Test\AppData\Local\1C\1cedtstart\projects\pr24\pr24.ВесТоваров
Имя: pr24.Колонтитулы
Содержимое: C:\Users\Test\AppData\Local\1C\1cedtstart\projects\pr24\pr24.Колонтитулы
1C:EDT> project
pr24
pr24.ВесТоваров
pr24.Колонтитулы
Если после этого аргумента
перечислены имена проектов, то будет показана информация
только по этим
проектам:project --details [pr24 pr24.Колонтитулы]
1C:EDT> script
my-script
"строка"
— обязательный аргумент. Имя
скрипта.1C:EDT> script my-script
Имя: ms:my-script
Поставляемый: да
Поставщик: com.e1c.g5.v8.dt.library
Путь: script/my-script.1cedtcli
1C:EDT> script my-script --content
# Скрипт приветствует пользователя.
#
# Использование:
# hello "имя"
# Аргументы:
# имя - имя пользователя. Если не задано, приветствует мир.
#
# Дополнительно скрипт распечатывает свое расположение.
name = мир
if { $1 } {
name = $1
}
echo Привет, $name!
echo Расположение скрипта: $0
1C:EDT> script --load "C:\Users\test\cli-scripts\hello.1cedtcli"
hello
Сортирует объекты конфигурации в соответствии с настройками автоматической сортировки. Если автоматическая сортировка не была включена для проекта, будут установлены стандартные настройки автоматической сортировки, в соответствии с которыми объекты конфигурации будут отсортированы. Имеет один из следующих обязательных аргументов:
Список путей или список имен перечисляется через пробел в квадратных скобках. Если нужно передать только один путь или одно имя, квадратные скобки можно не использовать.
Например:
sort-project --project-list [D:\Демо_EDT D:\Демо_EDT.ВесТоваров]
sort-project --project-list D:\Демо_EDT
Удаляет поддержку платформы «1С:Предприятие» указанной версии. Имеет обязательный аргумент:
uninstall-platform-support --version 8.3.10
Проверяет проект и выводит результат в .tsv-файл. Имеет следующие аргументы:
Список путей или список имен перечисляется через пробел в квадратных скобках. Если нужно передать только один путь или одно имя, квадратные скобки можно не использовать.
validate --file D:\validation-result.tsv --project-list [D:\Демо_EDT D:\Демо_EDT.ВесТоваров]
validate --file D:\validation-result.tsv --project-list D:\Демо_EDT
Если 1C:EDT CLI должен вернуть код возврата 23 или 24 (например потому, что его вернула выполняемая команда в режиме -command или последняя команда из последовательности команд в режиме -file), код возврата будет увеличен на 100, то есть вернется 123 или 124 соответственно. Это сделано потому, что 23 и 24 являются особыми кодами возврата Eclipse с собственной семантикой.
В интерфейс командной строки 1C:EDT CLI можно добавлять собственные команды. Для этого нужно написать плагин для 1C:EDT, который будет подключаться к точке расширения com.e1c.g5.v8.dt.cli.api.cliCommand и реализовывать интерфейс com.e1c.g5.v8.dt.cli.api.ICliCommand.
Подробнее о разработке собственных команд командной строки можно прочитать здесь.
Для тестирования собственных команд 1C:EDT CLI можно использовать инструмент, описанный здесь.
Демонстрационный пример плагина можно посмотреть здесь.