Внешняя
сборка
При разработке на платформе BPMSoft может возникнуть необходимость использовать готовую стороннюю функциональность. Для этого в конфигурацию подключается внешняя сборка — готовая скомпилированная DLL-библиотека .NET, которая становится доступна в пользовательском C#-коде.
Внешнюю библиотеку можно подключить двумя способами:
Импорт внешней сборки в пакет
Для того чтобы импортировать внешнюю сборку в пакет, выполните следующее:
- Откройте раздел «Конфигурация».
- Нажмите «Добавить» → «Импортировать».
Рисунок 1 — Выбор действия «Импортировать» в разделе «Конфигурация»
- Выберите файл DLL.
После импорта внешняя сборка станет доступна для использования в пользовательском C#-коде.
Импортированная библиотека будет отображаться в составе пакета в разделе «Конфигурация» как «Внешняя сборка». При экспорте пакета такая библиотека передается вместе с пакетом, в файловой системе внешние сборки размещаются в папке Assemblies пакета.
Добавление ссылки в файл проекта
Подключение через файл проекта предполагает ручное добавление ссылки на DLL в файл проекта конфигурации. Этот способ используется, если нет возможности добавить внешнюю сборку через импорт.
Необходимо учитывать, что в этом случае при переносе пакета внешняя библиотека не переносится автоматически. Изменения, внесенные в конфигурационные файлы, также не применяются автоматически на целевой среде, поэтому их потребуется вносить вручную.
Для BPMSoft на платформе .NET 8 необходимо отредактировать файл по пути \BPMSoft.Configuration\BPMSoft.Configuration.Dev.csproj, а для BPMSoft на платформе .NET Framework — файл по пути \BPMSoft.WebApp\BPMSoft.Configuration\BPMSoft.Configuration.Dev.csproj. В файле проекта найдите блок <ItemGroup Label="3-rd party references"> и добавьте в него элемент Reference с указанием пути к подключаемой библиотеке.
Пример настройки:
<ItemGroup Label="3-rd party references">
<Reference Include="MyCustomLibrary">
<HintPath>$(CoreLibPath)\MyCustomLibrary.dll</HintPath>
<Private>false</Private>
</Reference>
</ItemGroup>
В приведенном примере $(CoreLibPath) — путь к корневому каталогу с приложением, от которого строится ссылка на библиотеку. Вместо него укажите фактический путь к каталогу, в котором размещена библиотека DLL. Путь должен быть корректным для той среды, в которой выполняется сборка приложения.
Подключаемая библиотека должна быть совместима с платформой приложения: для приложений на .NET 8 библиотека должна быть собрана под .NET 8, для приложений на .NET Framework — под .NET Framework 4.7.2. В противном случае при компиляции могут возникнуть ошибки.