Сборка из исходников

При выходе новой версии Открытого пакета интеграций, вы можете получить собранные варианты поставки для разных платформ и операционных систем из описания релиза на GitHub или раздела "Скачать" на данном сайте. Однако, кроме использования уже готовых файлов, вы также можете собрать любой из вариантов поставки, используя исходный код проекта, распространяемый на платформе GitHub. В данном разделе описаны шаги для сборки каждого из таких вариантов

Ветки

В репозитории проекта есть две основные ветки - main и stable. В ветке main ведется основная, текущая разработка проекта. Это означает, что там могут находиться как актуальные исправления и доработки, так и различные незавершенные изменения или функции в процессе создания. Ветка stable, в свою очередь, всегда содержит актуальную кодовую базу последнего опубликованного релиза и обновляется только с выходом следующей стабильной версии пакета

В зависимости от решаемых задач, вы можете использовать код одной из этих веток в процессе сборки:

  git clone -b main https://github.com/Bayselonarrend/OpenIntegrations
  git clone -b stable https://github.com/Bayselonarrend/OpenIntegrations

Сборка версии для 1С

Кодовая база расширения для 1С:Предприятие хранится в репозитории в виде EDT-проекта. Вы можете использовать его непосредственно в 1С:EDT, либо экспортировать его из EDT в XML-формат для конфигуратора после подключения

Подключить проект в 1C:EDT можно при помощи команды Файл -> Импорт -> Проекты из Git. В процессе настройки вам будет предложено выбрать локальный репозиторий или клонировать удаленный, а также указать путь к конкретному проекту внутри него

В репозитории хранится две версии проекта: на русском и английском языках. Отличить их и выбрать необходимую можно по каталогу расположения - ru или en

После подключения проекта, вы можете экспортировать его в нативный XML-формат для Конфигуратора при помощи команды Файл -> Экспорт -> Конфигурация в XML-файлы

Сборка OneScript и CLI-версий

Версия для OneScript, а также консольное приложение на ее основе, являются OSPX-пакетами для установки через менеджер пакетов OPM. Их исходный код хранится в каталогах /src/<язык>/OInt и /src/<язык>/cli соответственно, и может быть собран вызовом следующей команды из выбранного каталога:

  opm build

В результате выполнения этой команды будет создан .ospx файл, который можно установить в локальный каталог пакетов OneScript при помощи команды

  opm install -f <путь к файлу ospx>

Сборка Windows-установщика, пакетов для Linux, а также других производных вариантов поставки, осуществляется при помощи комплексного скрипта сборки, который также находится внутри репозитория. Ознакомится с ним можно по пути /ci/os/releasemaker.os. Сами по себе, эти варианты поставки представляют собой те же opsx пакеты, но поставляемые вместе с движком OneScript в одном наборе