Перейти к содержанию

Быстрый старт

Ниже описана последовательность действий для быстрого старта разработки

Создание новых диагностик

  1. Создать каталог проекта bsl-language-server
  2. Склонировать в созданный каталог репозиторий проекта https://github.com/1c-syntax/bsl-language-server.git
  3. Выполнить настройку окружения по инструкции
  4. Выполнить команды для ингнорирования изменений в служебных файлах
  5. git update-index --assume-unchanged ./.idea/compiler.xml
  6. git update-index --assume-unchanged ./.idea/encodings.xml
  7. git update-index --assume-unchanged ./.idea/misc.xml
  8. Открыть файл build.gradle.kts из каталога проекта, согласиться с импортом зависимостей, дождаться их скачивания
  9. Выполнить (из контекстного меню или консоли ide) команду gradlew test, успешность выполнения которой укажет на корректность выполненной настройки
  10. Ознакомится с примером создания диагностики, описанием структуры и назначения файлов и другими статьями раздела для разработчиков

Использование отладчика AST

Для анализа AST дерева при создании диагностик, может потребоваться получить визуальное представление дерева. Для этого необходимо выполнить следующие шаги

  • Создать каталог проекта bsl-parser
  • Склонировать в созданный каталог репозиторий проекта https://github.com/1c-syntax/bsl-parser.git
  • Выполнить настройку окружения по инструкции (если ранее не выполнялась)
  • Установить плагин ANTLR v4 grammar plugin

  • перезапустить IDEA при необходимости

  • Настроить плагин - File | Settings | Languages & Frameworks | ANTLR v4 default project settings ANTLR v4 grammar plugin

  • Установить настройку Case transformation in the Preview window в Transform to uppercase when lexing
  • Открыть файл build.gradle.kts из каталога проекта, согласиться с импортом зависимостей, дождаться их скачивания
  • После скачивания:
  • Для анализа bsl файлов (кода 1С)
    • Открыть файл src/main/antlr/BSLParser.g4
    • Установить курсор строку с правилом file: (первое правило в файле) и выбрать пункт контекстного меню Test Rule file
    • В открывшемся окне выбрать bsl-файл либо вставить текст из буфера обмена
  • Для анализа sdbl файлов (запросов 1С)
    • Открыть файл src/main/antlr/SDBLParser.g4
    • Установить курсор строку с правилом queryPackage: (первое правило в файле) и выбрать пункт контекстного меню Test Rule queryPackage
    • В открывшемся окне выбрать sdbl-файл либо вставить текст из буфера обмена