DLL в 1С: как подключить и использовать внешние библиотеки

Работа с внешними DLL-библиотеками в 1С:Предприятие открывает широкие возможности для интеграции с внешними системами, ускорения вычислений и реализации функций, недоступных в штатном языке 1С. Однако многие разработчики сталкиваются с трудностями: от ошибок подключения до некорректной передачи параметров. Эта статья поможет разобраться, как правильно работать с DLL в различных версиях платформы, избегая типичных ошибок.

Мы рассмотрим не только базовые механизмы вызова внешних функций через ExternalConnection или WinApi, но и нюансы работы с разными типами данных, обработку исключений, а также оптимизацию производительности. Особое внимание уделено проблеме "утечки памяти" при частом вызове DLL-методов и способам её предотвращения. Статья актуальна для версий платформы 1С:Предприятие 8.3 (включая последние релизы) и частично применима к 1С 7.7 (с оговорками).

Что такое DLL и зачем они нужны в 1С

DLL (Dynamic Link Library) — это внешняя библиотека, содержащая готовый исполняемый код, который может быть загружен и использован другими программами во время выполнения. В контексте 1С такие библиотеки позволяют:

• 🔌 Интегрироваться с оборудованием (сканеры штрихкодов, фискальные регистраторы, весы)
• ⚡ Ускорять вычисления (например, сложные математические операции через Math.NET)
• 🔒 Реализовывать криптографические функции (шифрование, электронная подпись)
• 🌐 Работать с API внешних сервисов (банки, госуслуги, облачные хранилища)

Основное преимущество — расширение функциональности без изменения конфигурации. Например, если в 1С нет встроенных методов для работы с PDF, можно подключить специализированную DLL (например, iTextSharp) и манипулировать документами напрямую.

Однако есть и ограничения: DLL должны быть совместимы с разрядностью платформы 1С (32-bit или 64-bit).

Версии 1С:Предприятие 8.3.20+ поддерживают только 64-разрядные библиотеки в соответствующем режиме работы.

Также

Способы подключения DLL в 1С

В 1С:Предприятие 8.3 существует два основных механизма работы с внешними библиотеками:

1. Через объект ExternalConnection — универсальный способ для вызова функций из COM-объектов или DLL, зарегистрированных в системе.
2. Через WinApi — прямой вызов функций из системных библиотек (например, user32.dll, kernel32.dll).

Рассмотрим оба подхода на примерах.

1. Подключение через ExternalConnection

Этот метод подходит для библиотек, которые экспортируют функции как COM-объекты. Например, если у вас есть DLL, написанная на C++ или C#, которая регистрируется в системе через regsvr32.

Пример кода для вызова функции Sum из библиотеки MyMath.dll:

Перем ОбъектDLL;

Процедура ПодключитьDLL()
Попытка
ОбъектDLL = Новый COMОбъект("MyMathLibrary.MathOperations");
Сообщить("Библиотека подключена успешно!");
Исключение
Сообщить("Ошибка подключения: " + ОписаниеОшибки());
КонецПопытки;
КонецПроцедуры

Функция СложитьЧисла(Число1, Число2)
Возврат ОбъектDLL.Sum(Число1, Число2);
КонецФункции

Важные нюансы:

• 🔹 Библиотека должна быть зарегистрирована в системе (например, командой regsvr32 MyMath.dll).
• 🔹 Имя COM-объекта ("MyMathLibrary.MathOperations") должно совпадать с тем, что указано в коде DLL.
• 🔹 Для 64-разрядной 1С нужна 64-разрядная версия DLL (и наоборот).

DLL зарегистрирована в системе (regsvr32)

Разрядность DLL совпадает с разрядностью 1С

Права пользователя позволяют загружать внешние библиотеки

Антивирус не блокирует файл DLL-->

2. Прямой вызов через WinApi

Этот способ используется для работы с системными библиотеками или DLL, которые не регистрируются как COM-объекты. Например, для вызова функции MessageBox из user32.dll:

Процедура ПоказатьСообщение()
ДекларацияWinApi = Новый WinApiДекларация("user32.dll", "MessageBoxA");
ДекларацияWinApi.ВозвратТипаДанных = Новый Тип("Число");
ДекларацияWinApi.ПараметрыДобавление(Новый ПараметрWinApi("hWnd", Новый Тип("Число")));
ДекларацияWinApi.ПараметрыДобавление(Новый ПараметрWinApi("lpText", Новый Тип("Строка")));
ДекларацияWinApi.ПараметрыДобавление(Новый ПараметрWinApi("lpCaption", Новый Тип("Строка")));
ДекларацияWinApi.ПараметрыДобавление(Новый ПараметрWinApi("uType", Новый Тип("Число")));

Результат = WinApi.Выполнить(ДекларацияWinApi, 0, "Привет из 1С!", "Сообщение", 0);
КонецПроцедуры

Этот метод более гибкий, но требует точного указания типов данных для параметров и возвращаемого значения. Ошибка в объявлении типов приведёт к падению 1С или некорректной работе функции.

Типы данных: как правильно передавать параметры

Одна из самых сложных задач при работе с DLL в 1С — корректная передача параметров. Типы данных в 1С и во внешних библиотеках часто не совпадают, что приводит к ошибкам или неверным результатам.

Ниже приведена таблица соответствия основных типов:

Особое внимание стоит уделить строкам. В 1С строки передаются как BSTR (для COM) или как указатели на символы (char*) для WinApi. При этом:

• 📌 Для ANSI-строк (однобайтовая кодировка) используйте суффикс A в имени функции (например, MessageBoxA).
• 📌 Для Unicode-строк (двухбайтовая кодировка) — суффикс W (например, MessageBoxW).

Пример передачи строки в Unicode:

ДекларацияWinApi = Новый WinApiДекларация("user32.dll", "MessageBoxW");
ДекларацияWinApi.ПараметрыДобавление(Новый ПараметрWinApi("lpText", Новый Тип("Строка")));

Обработка ошибок и отладка

Ошибки при работе с DLL в 1С часто сложно диагностировать, так как платформа не всегда выдаёт понятные сообщения. Рассмотрим типичные проблемы и способы их решения.

1. Типичные ошибки и их причины

• 🚨 Ошибка при вызове конструктора (COMОбъект) — библиотека не зарегистрирована или несовместима по разрядности.
• 🚨 Недопустимый вызов метода — неправильное имя метода или неверные типы параметров.
• 🚨 Нарушение доступа к памяти — ошибка в самой DLL (например, обращение к несуществующему адресу).
• 🚨 Функция не найдена в библиотеке — опечатка в имени функции или неверная версия DLL.

Для диагностики используйте:

• 🔍 Журнал регистрации 1С (1CV8Log в папке временных файлов).
• 🔍 Отладчик DLL (если у вас есть исходный код библиотеки).
• 🔍 Утилиты вроде Dependency Walker для проверки зависимостей DLL.

Функция ВызватьВнешнююФункцию(Параметр1, Параметр2)
Попытка
Результат = ОбъектDLL.MyFunction(Параметр1, Параметр2);
Возврат Результат;
Исключение
ЗаписатьЖурналРегистрации(НСтр("ru = 'Ошибка вызова MyFunction: '") + ОписаниеОшибки(), УровеньЖурналаОшибка);
Возврат Неопределено;
КонецПопытки;
КонецФункции

Частый вызов внешних библиотек может значительно замедлить работу 1С, особенно если:

1. Кэшируйте объект DLL:

   Создавайте экземпляр COMОбъект один раз (например, при старте системы) и используйте его повторно.

2. Минимизируйте передачу данных:

   Если нужно передать большой массив, лучше сделать это одним вызовом, а не по элементам.

3. Используйте асинхронные вызовы:

   Для долгих операций (например, обработка изображений) запускайте DLL в фоновом потоке через АсинхроннаяПроцедура.

4. Проверяйте "утечки памяти":

   После работы с DLL освобождайте ресурсы (например, вызывайте Освободить() для COM-объектов).

Перем гОбъектDLL;

Процедура ИнициализироватьDLL()
Если гОбъектDLL = Неопределено Тогда
гОбъектDLL = Новый COMОбъект("MyLibrary.MyClass");
КонецЕсли;
КонецПроцедуры

Процедура НапечататьЧек()
Попытка
ФР = Новый COMОбъект("AddIn.Fptr10");
ФР.ОткрытьПорт("COM1");
ФР.НачатьЧек();
ФР.ПробитьСумму(100, 1, "Товар 1", 18, 0);
ФР.ЗакрытьЧек();
ФР.ЗакрытьПорт();
Исключение
Сообщить("Ошибка печати: " + ОписаниеОшибки());
КонецПопытки;
КонецПроцедуры

Функция ПолучитьХэш(Строка)
Хэшер = Новый COMОбъект("System.Security.Cryptography.SHA256Managed");
Байты = Хэшер.ComputeHash(ТекстВДвоичныеДанные(Строка, КодировкаТекста.UTF8));
Возврат Base64Строка(Байты);
КонецФункции

Процедура ОтправитьПлатеж(Сумма, Счет, Инн)
БанкAPI = Новый COMОбъект("Tinkoff.BusinessAPI");
Результат = БанкAPI.SendPayment(Сумма, Счет, Инн);
Если Результат.Успех Тогда
Сообщить("Платёж отправлен, ID: " + Результат.ID);
Иначе
Сообщить("Ошибка: " + Результат.Сообщение);
КонецЕсли;
КонецПроцедуры

Данные = Новый Структура("Поле1, Поле2", 100, "Текст");
СтрокаДанных = СтруктураВСтроку(Данные);
Результат = ОбъектDLL.ОбработатьДанные(СтрокаДанных);