Разработка скриптов для Снегопата

Установка и настройка

Чтобы разрабатывать скрипты для нового Снегопата, вам понадобится установить такие продукты, как:

• Core.As – это ядро для запуска модуля Снегопата.

• Сам модуль Снегопата в виде git-репозитария.

• Visual Studio Community Edition – IDE, в которой происходит сборка модуля Снегопата.

• Visual Studio Code — хороший редактор TypeScript.

• Git — берете свой любимый.

Разберемся, где что брать.

• последний релиз Core.As Loader скачиваем по ссылке https://github.com/infostart-hub/core_as_loader/releases.
  Скачиваете архив из текущего релиза. В этот архив входят бинарники стартера и самого Core.As – модуль Снегопата сюда не входит, его нужно будет скачивать отдельно.
  Скачанный архив с релизом просто распакуйте в отдельную папку, из которой и будете его запускать. Core.As не требует какой-то особой установки, не пишет в реестр. Достаточно прав на запись в эту папку. Получится так:
  
  
  
  ВАЖНО: для дальнейшей сборки модуля Снегопата используется запуск утилит из Core.As, поэтому вам нужно в свойствах проекта для сборки Release платформ Win32 и x64 в пункте VC++ Directories (Каталоги VC++) прописать пути к папкам 
  Ваша_Папка_Core_As\lib\x64; Ваша_Папка_Core_As\lib\x86
  (подробнее об этом ниже)

• Далее клонируем модуль Снегопата из
  https://github.com/infostart-hub/snegopat_modul
  в ваше обычное место расположения проектов.

• Visual Studio Code – нужно просто скачать его по адресу https://code.visualstudio.com/download и установить.

• Visual Studio Community Edition нужно скачать по адресу https://visualstudio.microsoft.com/ru/vs/community/ и установить.
  На этапе установки необходимо будет обязательно выбрать опцию «Разработка классических приложений на C++», потому что в модуль Снегопата входят исходники небольшой DLL на C++.

На закладке «Отдельные компоненты» в поле поиска наберите script и обязательно установите:

• TypeScript SDK

• поддержку языков JavaScript и TypeScript

• диагностика JavaScript.

Это нужно для того, чтобы у вас собирались скрипты и работала их отладка.

Собираем модуль Снегопата

Мы сейчас создадим модуль Снегопата. Для этого заходим в папку, куда склонировали репо Снегопата и открываем проект snegopat_modul.sln.

Чтобы у вас работала отладка скриптов в Visual Studio, нужно проверить, что в Tools (Средства) – Options (Параметры) в пункте Just-In-Time у вас все галочки проставлены – Script (Скрипт), Native (Машинный), Managed (Управляемый).

Тогда отладчик Visual Studio будет подключаться к отладке скриптов Снегопата.

Еще раз напомню, что дальнейшей сборки модуля Снегопата используется запуск утилит из Core.As, поэтому пути к утилитам Core.As - Ваша_Папка_Core_As\lib\x64; Ваша_Папка_Core_As\lib\x86 нужно прописать в свойствах проекта.

Для этого нужно зайти в свойства проекта snegopat_modul и в пункте VC++ Directories (Каталоги VC++) задать пути для платформ Win32 и x64. Нам достаточно задать пути для конфигурации Release.

Это нужно, потому что часть процесса сборки модуля Снегопата сама сделана в виде модуля Core.As и для его запуска утилита coreas_runner_c.exe из состава Core.As должна запускаться просто по имени.

Поменяем конфигурацию проекта на Release и попробуем собрать проект pack_all – он соберет и проверит одновременно две версии (x64 и x86).

В результате в каталоге _build\Release должен собраться модуль Снегопата.

Теперь его нужно подключить к загружаемым модулям Core.As.

Папку _build\Release\load просто скопируйте в папку с Core.As, достаточно сделать это один раз.

Сам модуль располагается в _build\Release\modules\snegopat. Можно либо каждый раз копировать его в папку Core.As\modules при изменениях, либо один раз создать линк на неё (требуются права админа). Для этого открываем командную строку в папке Core.As\modules и выполняем команду:

mklink /d snegopat “путь к репо Снегопата\_build\Release\modules\snegopat”

Если у вас эти папки лежат где-то рядом, путь можно задать относительным.

Таким образом мы в папку модулей Core.As подключили модуль Снегопата – тот, который у нас собирается в папке _build.

Итак, мы выполнили настройку путей, собрали проект модуля Снегопата и создали ссылку на сборку в модулях Core.As.

Первый запуск – настраиваем стартер

Для запуска модуля идем в Core.As и запускаем starter.exe.

Ранее мы скопировали папку load, в которой для стартера есть настройка: отслеживать запуск процессов с именем 1cv8.exe и если такой процесс запущен, туда будет подгружаться библиотека test.dll, которая проверит, запущена ли 1С в режиме конфигуратора. Если запущена, то будет загружен модуль Снегопата.

Запускаем стартер – он создает иконку в трее и выводит уведомление, что запущен.

Теперь можно просто запускать 1С. При открытии Конфигуратора туда будет подключаться Снегопат.

Создаем свой скрипт для Снегопата

Скрипт для Снегопата мы будем писать на TypeScript в среде VS Code – здесь это делать наиболее удобно.

Для этого заходим в папку с репо Снегопата. В каталоге src/ts мы будем создавать свой скрипт на TypeScript. Все ts-файлы, которые есть в этой папке, при сборке проекта автоматически компилируются в JavaScript-файлы и копируются в каталог _build\ modules\snegopat\addins.

Запустите в этом каталоге VS Code.

Проще всего начать создавать скрипт, просто скопировав какой-то уже существующий. Поэтому просто скопируйте какой-либо из существующих скриптов, переименовав его на свой вкус.

Первое, что нам нужно сделать – это исправить информацию о скрипте. У каждого скрипта задается:

• uname – уникальное имя, по которому его можно найти в Снегопате.

• dname - описательное имя.

• descr – небольшое описание.

Ниже идет стандартная шапка с указанием пути к файлам snegopat.d.ts и v8.d.ts. Эти две строчки трогать не нужно – именно они подключают интеллисенс (контекстную подсказку по типам Снегопата и платформы).

В каждом скрипте должна быть точка входа, через которую можно вызвать его функциональность. Обычно это оформляется в виде макросов. Простейший макрос создается с помощью обычной функции, у которой название начинается с подстроки macros. Все, что после этой подстроки – это название макроса. Поэтому создадим функцию macrosMyFirstMacros().

Итак, простейший скрипт создан. Давайте проверим, что он загружается – добавим в макрос показ сообщения.

Чтобы этот скрипт у нас заработал, нам нужно перейти в Visual Studio и собрать проект. При этом скрипты на TypeScript компилируются в js-файлы и выкладываются в папку сборки.

После сборки, если вы не создали линк на получаемую папку, скопируйте её в Core.As.

Запускаем конфигуратор 1С, открываем список подключаемых скриптов - наш скрипт появился в списке, можно прямо сейчас его загрузить.

Проверим наш макрос. Нажимаем Ctrl+M – у нас в пользовательских аддинах появилась команда “Показ git blame: MyFirstMacros”.

Вызываем команду – выводится сообщение.

О развитии функционала скрипта, а именно о том, что предоставляет объектная модель Снегопата, какие возможности даёт и как её использовать - будет в следующей статье.

Пока же могу порекомендовать изучать справку Снегопата

На данный момент в ней описано не всё, но базовые вещи есть. Подсказка в Visual Studio Code - актуальная и отображает текущую объектную модель. Также можно изучать существующие скрипты, а в затруднительных случаях и код самого движка Снегопата в папке engine. Успехов и новых идей вам!