Тема: Разработка плагинов - основные ошибки

[Дмитрий Маслов]

При разработке плагинов к LeaderTask, разработчики допускают всяческие неточности при взаимодействии с LeaderTask API.
В этой теме будут выкладываться типичные ошибки.

[Дмитрий Маслов]

1. Используйте юникод!

Игнорирование того, что параметры должны поступать в юникоде - двухбайтной кодировке, типичной для функций Windows API (wchar_t) - приводит к ошибкам.
Передача строковых параметров в ansi (однобайтной кодировке) в лучшем случае воспримется программой как китайский язык, в общем случае приводит либо к падению программы, либо неопределенному поведению.
Это касается всех функций, в том числе и AddinLT_Task_SetRTFComment

[Дмитрий Маслов]

2. Следите за зависимостями от сторонних DLL

На компьютере пользователя могут отсутствовать необходимые для работы Вашего плагина DLL - тогда Ваш плагин просто у пользователя не загрузится (без всяких ошибок).
Самое распространенное здесь это отсутствие Debug библиотек у пользователя, по этому выкладывайте плагины всегда в Release сборке.

[Hush]

3. Для Delphi нужно указать модель вызова функции "cdecl"
Пример:

Код: [Выделить]

function AddinLT_Task_GetTitle(id:PWideChar):PWideChar; cdecl; external 'lt_plugins.dll' name 'AddinLT_Task_GetTitle';

[Дмитрий Маслов]

4. Запускайте функции LeaderTask API (AddinLT_...) в основном потоке

На текущий момент работа плагинов не предназначена для многопоточного режима, по этому вызов функций LeaderTask API из потоков созданных внутри плагина может приводить к зависанию, вылетанию программы или зацикливанию.
В следующих версиях все функцию будут возвращать FALSE если вызваны не в том потоке.

[NA]

Для Delphi я бы отметил как минимум 3 важных момента:

1. Как уже указано выше - cdecl, обязательно.
2. {$Z4} - просто скажите спасибо, поставьте в начало шаблона и забудьте о ней навсегда.
3. Грабля, которая чуть не выела мне весь мозг. При переводе API на Pascal пропарил указать в одном из многочисленных объявлений var.

[Hush]

При экспорте ф-ий из dll для Delphi будьте внимательны - сишный тип BOOL соответствует типу BOOL в Delphi, а не привычному в Delphi типу Boolean. Но можно указать BOOL в экспорте функциии, а передавать туда Boolean, Delphi автоматически сделает приведение типов. Подробнее о разнице в этих типах можно прочитать здесь