Skip to content

Latest commit

 

History

History
39 lines (32 loc) · 3.85 KB

FastStart.md

File metadata and controls

39 lines (32 loc) · 3.85 KB

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

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

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

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

Использование отладчика 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-файл либо вставить текст из буфера обмена