9. Utilisation du Yocto-3D-V2 en C++
Intégration en librairie statique
L'intégration de de la librairie Yoctopuce sous forme de librairie statique permet une compilation
rapide du programme en une seule commande. Elle ne requiert pas non plus l'installation d'une
librairie dynamique spécifique à Yoctopuce sur le système final, tout est dans l'exécutable.
Pour utiliser la librairie statique, il faut la compiler à l'aide du shell script
sous Windows. Ce script qui se situe à la racine de la librairie, détecte l'OS et
build.bat
recompile toutes les librairies ainsi que les exemples correspondants.
Ensuite, pour intégrer la librairie statique Yoctopuce à votre projet, vous devez inclure le répertoire
de la librairie Yoctopuce à votre IncludePath, et ajouter le sous-répertoire de
Sources
correspondant à votre système d'exploitation à votre LibPath.
Binaries/...
Finalement, pour que votre projet se construise ensuite correctement, il faudra linker avec votre
projet la librairie Yoctopuce et les librairies systèmes requises:
• Pour Windows: yocto-static.lib
• Pour Mac OS X: libyocto-static.a. IOKit.framework et CoreFoundation.framework
• Pour Linux: libyocto-static.a, libm, libpthread, libusb1.0 et libstdc++.
Attention, sous Linux, si vous voulez compiler en ligne de commande avec GCC, il est en général
souhaitable de linker les librairies systèmes en dynamique et non en statique. Pour mélanger sur la
même ligne de commande des librairies statiques et dynamiques, il faut passer les arguments
suivants:
gcc (...) -Wl,-Bstatic -lyocto-static -Wl,-Bdynamic -lm -lpthread -lusb-1.0 -lstdc++
Intégration en librairie dynamique
L'intégration de la librairie Yoctopuce sous forme de librairie dynamique permet de produire un
exécutable plus petit que les deux méthodes précédentes, et de mettre éventuellement à jour cette
librairie si un correctif s'avérait nécessaire sans devoir recompiler le code source de l'application. Par
contre, c'est un mode d'intégration qui exigera systématiquement de copier la librairie dynamique sur
la machine cible ou l'application devra être lancée (yocto.dll sous Windows, libyocto.so.1.0.1 sous
Mac OS X et Linux).
Pour utiliser la librairie dynamique, il faut la compiler à l'aide du shell script
ou
sous Windows. Ce script qui se situe à la racine de la librairie, détecte l'OS et
build.bat
recompile toutes les librairies ainsi que les exemples correspondant.
Ensuite, pour intégrer la librairie dynamique Yoctopuce à votre projet, vous devez inclure le
répertoire
Sources
correspondant à votre système d'exploitation à votre LibPath.
Binaries/...
Finalement, pour que votre projet se construise ensuite correctement, il faudra linker avec votre
projet la librairie dynamique Yoctopuce et les librairies systèmes requises:
• Pour Windows: yocto.lib
• Pour Mac OS X: libyocto, IOKit.framework et CoreFoundation.framework
• Pour Linux: libyocto, libm, libpthread, libusb1.0 et libstdc++.
Avec GCC, la ligne de commande de compilation est simplement:
gcc (...) -lyocto -lm -lpthread -lusb-1.0 -lstdc++
58
de la librairie Yoctopuce à votre IncludePath, et ajouter le sous-répertoire de
sous UNIX, ou
build.sh
sous UNIX,
build.sh
www.yoctopuce.com