Créer une librairie (DLL) en C ou C++ : quelques erreurs à éviter

In english: How to create a C or C++ library (DLL) : common mistakes.

Il est fréquent de fournir une librairie (bibliothèque) pour permettre au client d'utiliser votre produit dans son logiciel. Par exemple, si vous fournissez un logiciel de calcul scientifique, le client aura peut-être besoin de lire les fichiers générés par votre logiciel ou bien intégrer certains calculs à son produit. Si vous vendez des sondes de dioxyde de carbone, vous fournissez sûrement une DLL (Dynamic Link Library) permettant de lire les mesures.

Peu importe dans quel langage est développé votre logiciel, fournir une interface en C est permet une intégration presque partout et une utilisation dans la plupart des langages.

Sous Windows, vous fournissez donc un fichier .dll contenant les fonctions utiles au client, un fichier .lib qui liste ces fonctions et indique comment les trouver dans la .dll et un fichier .h qui contient la signature des fonctions lisibles par le programmeur. Sous Linux, la DLL s'appelle .so et elle est fournie uniquement avec un fichier .h.

Faut-il fournir une interface en C ou en C++ ?

Si vous avez développé votre programme en C++ et que vos clients utilisent du C++, fournir une DLL pour ce même langage permet d'en simplifier l'utilisation pour le client car il bénéficiera des avantages des classes, des références, etc. C'est ce que fait Qt par exemple. L'inconvénient est qu'il faut compiler la librairie pour plusieurs compilateurs voire plusieurs versions d'un même compilateur : GCC, Clang, MSVC (Visual Studio 2015, 2022, etc), etc.

La librairie standard C++ peut aussi changer entre les versions d'un même compilateur : entre deux versions de Visual Studio, par exemple std::string peut changer et provoquer des plantages difficiles à comprendre.

Une librairie C++ a certains avantages, mais a aussi un coût. Une solution est de rendre la bibliothèque open source pour que le client puisse la recompiler ; une autre solution est de développer une interface C++ header-only (uniquement dans le .h) qui cache l'interface C.

Éviter des erreurs fréquentes

malloc et free ou bien new et delete doivent être fait dans la même entité (programme ou DLL). Considérez la fonction suivante :

DLL_EXPORT char* GetProjectName(Project_t id);

Ici GetProjectName renvoie une chaine de caractères qui a été allouée par la DLL. Si le compilateur du client est différent du compilateur qui a produit la DLL, désallouer la chaine de caractères avec free peut provoquer un plantage car l'implémentation de l'allocateur peut être différente. Par exemple en debug, malloc et free peuvent être instrumentés pour détecter des problèmes.

La solution classique est la suivante :

DLL_EXPORT void GetProjectName(Project_t id, char* name);

Dans ce cas le client doit allouer un tableau et GetProjectName va copier la chaine. Il faut fournir au client la taille maximum possible ou une fonction GetProjectNameLength. Un alternative est de définir un type qui contient la chaine :

typedef struct MyString_ {
    const char * const str;
} MyString_t;

Et des fonctions pour manipuler MyString_t :

DLL_EXPORT MyString_t* CreateMyString(const str* ms);
DLL_EXPORT void DeleteMyString(MyString_t* ms);
DLL_EXPORT MyString_t* GetProjectName(Project_t id);

Les fonctions CreateMyString et GetProjectName font un malloc et la fonction DeleteMyString, un free. C'est donc la DLL qui se charge à la fois de l'allocation et de la libération de la mémoire.

On réduit aussi les erreurs car l'utilisateur n'a plus besoin de se soucier d'allouer la bonne taille. Les consts interdisent la modification de str par l'utilisateur pour éviter que DeleteMyString se retrouve à appeler free sur des données allouées par l'utilisateur.

Clarifier l'interface. Et les types sont là pour ça. On considère la fonction suivante :

DLL_EXPORT int GetCurrentProjectId();
DLL_EXPORT void RemoveFile(int projectId, int fileId);

Ici ce code peut être rendu beaucoup plus clair avec des types

typedef int ProjectId_t;
typedef int FileId_t;

DLL_EXPORT ProjectId_t GetCurrentProjectId();
DLL_EXPORT void RemoveFile(ProjectId_t projectId, FileId_t fileId);

Malheureusement, le compilateur n'émettra même pas un warning si l'utilisateur place un ProjectId_t au lieu d'un FileId_t, mais le code est quand même plus lisible.

Const correctness. Déclarer les pointeurs ou références const dès que possible.

DLL_EXPORT char* SetProjectName(Project_t id, const char* str);

Ici, str est const char*, c'est indispensable si l'utilisateur veut passer une chaine de caractère constante. Son code ne pourra pas respecter la const correctness si vous ne le faites pas.

Pas plus de 4 paramètres pour vos fonctions. Utiliser une structure si la fonction a trop d'entrées. Pour retourner plusieurs paramètres utilisez des structures. N'utilisez surtout pas de tableaux pour renvoyer des données de natures différentes. Par exemple renvoyer un tableau contenant [x y z] peut être dangereux car l'utilisateur risque de se tromper d'ordre. En C++, évitez les std::pair qui ont ce défaut aussi.

Utilisez des pointeurs opaques pour identifier les instances de votre lib, cela permet de cacher les données stockées. En C++, le patron PIMPL sert à ça. Dans les exemples précédents, j'ai utilisé des entiers (par exemple Project_t) ce qui est moins efficace car il faut une map qui stocke la correspondance mais c'est parfois plus facile à gérer dans le logiciel du client.

Bien documenter le format des données, les types et les unités GetPressure, GetTemperature, GetDistance ne veulent rien dire si on ne précise pas si ce sont des bars, des N/m², des °C, °F, des mètres ou des mm.

Le plus important : la lib est l'interface entre vous et le client. La documentation et le nom des fonctions doit utiliser les termes du client pas un jargon interne !

En conclusion, demandez-vous ce que le client va comprendre de votre interface et quelles erreurs il va faire. Facilitez-lui la tâche en rendant les erreurs difficiles voire impossibles.

Support technique : les chercheurs et les industriels ont des besoins très différents

La qualité du support technique est aussi importante que la qualité du produit lui-même (matériel ou logiciel). Dans son choix, le client va préférer un support technique qui sait résoudre ses problèmes rapidement. Le client va probablement rester fidèle à une marque s'il sait que le support fonctionne bien.

En faisant du SAV pour du matériel industriel (optique, électronique ou logiciel), j'avais remarqué que tous les clients ne doivent pas être traités de la même manière et qu'il y avait des besoins différents entre la recherche et l'industrie.

Ainsi, un client industriel a souvent des questions entièrement dirigées vers son but : corriger un problème ou connaitre une bonne manière de réaliser son besoin. Il a des questions du type : "Comment faire ça ? Quelle configuration permet de créer mon produit ?".

Il attend de la rigueur dans le mode d'emploi du produit et l'idéal est de lui fournir des exemples concrets qui correspondent à son besoin.

J'ai remarqué qu'un client académique (chercheur, université, etc) ou R&D a des questions plus larges. Il va par exemple demander quelles sont les différentes manières de réaliser quelque chose ? S'il y a différentes méthodes, il veut pouvoir les comparer lui-même ou lire un comparatif chiffré. Il sait généralement déjà comment fonctionne le produit ou il connait déjà la théorie et il va plutôt chercher à comprendre la réalité technique derrière le nom commercial.

Utiliser un filtre avec un appareil photo compacte

Mon appareil photo compacte ne permet pas de fixer des filtres. Sauf en achetant un MagFilter qui est une bague pour aimanter des filtres au bout de l'objectif. Elle est disponible pour des compactes très similaires au mien, mais j'avais un peu peur de mettre du poids au bout de l'objectif.

Je me suis donc inspiré d'une solution trouvée sur Instructable qui consiste à fixer le filtre au bout d'un tube et le mettre autour l'objectif. Je n'ai cependant pas trouvé un tube similaire à celui de l'auteur.

A la place, j'ai acheté un tube PVC de 50 mm de diamètre et des filtres de 49 mm de diamètre. J'ai découpé le tube à la bonne longueur, c'est à dire à la plus petite taille qui n’obscurcis pas l'image (vignetage). Enfin, j'ai collé un filtre UV au bout en faisant un joint en colle silicone pour ne pas laisser passer de lumière. C'est un peu différent de la solution originale.

Sur mon appareil photo, ça donne ça :

Sony HX99 avec filtre polarisant
Le tube est juste posé autour de l'objectif, en utilisation réelle, il faut le tenir. Un filtre est vissé sur le filtre

Et la panoplie à mettre au bout :

  • Un filtre polarisant
  • Un filtre ND8
  • Un filtre ND1000
  • Un bouchon pour protéger

J'ai déjà pu faire quelques tests avec le filtre polarisant.

reflets dans une verre à pied
Un verre sur de la faïence. Il y a beaucoup de reflets autour et à droite du pieds du verre.

reflets dans une verre à pied
Sur cette photo prise avec le filtre polarisant, les reflets au pied du verre ont disparu. La photo est plus propre et fait mieux ressortir l'ombre du verre et la lumière orange.

Le tube me permet de zoomer quand même un peu même s'il y a un risque que l'objectif touche le filtre UV. Maintenant je réfléchie à un système pour fixer le tube au boitier.

Terrarium

Terrarium vu du dessus

Terrarium vu de face

Terrarium vue rapprochée

  • Peperomia
  • 2 fittonia
  • Asparagus
  • Ficus microcarpa