Un additif est du code qui étend les fonctions de J-Pilot, sans ajouter aucun code à J-Pilot, ou nécessiter de le recompiler. C'est typiquement une bibliothèque partagée qui contient des fonctions d'interfaçage (callback) prédéfinies.
Une fonction d'interfaçage est une fonction qui n'est pas appelée
par l'application elle-même, mais à partir d'un programme externe.
Lorsque J-Pilot démarre, il analyse les répertoires d'additifs
pour y trouver d'éventuelles bibliothèques partagées (~/.jpilot/plugins/
et $BASE_DIR/share/jpilot/plugins). Quand il trouve une bibliothèque
partagée, il trouve des fonctions d'interfaçage à l'intérieur de la
bibliothèque et les appelle suivant le besoin. Ainsi, un additif peut
prendre une part intégrante à un programme général du simple fait de son
existence et quand on le retire, le programme principal fonctionne toujours, avec juste la fonction apportée par l'additif en moins.
Pour trouver les additifs disponibles, vérifiez ma page d'additifs à l'adresse jpilot.linuxbox.com/plugins.html où j'en garde une liste.
Si vous prévoyez d'écrire un additif, vérifiez mes pages http://jpilot.linuxbox.com/plugin.html pour plus d'information. J'y ai rassemblé des informations sur l'écriture et l'implémentation. Bonne chance, les utilisateurs vous en seront reconnaissants.
Si vous créez un additif, j'apprécierais que vous me donniez un lien sur le site pour que je puisse le mettre sur mon site Web. Cela encouragera d'avantage de personnes à utiliser J-Pilot et votre additif. Même si vous travaillez sur un additif, faites le moi savoir et je le mettrai comme travail en cours, pour que personne ne duplique votre effort. Mon adresse de courrier électronique est judd@engineer.com.
Pour pouvoir utiliser un additif, il doit être situé sous le répertoire
$BASEDIR/share/jpilot/plugins avec $BASEDIR
valant /usr/local dans des conditions normales.
S'il y est situé, J-Pilot le trouvera en vérifiant ce répertoire au prochain
démarrage et fournira une entrée dans le menu J-Pilot.
Si vous avez des problèmes pour installer un additif, consultez la FAQ pour plus d'informations.
Pour trouver comment compiler un additif donné, vérifiez dans l'archive que vous avez téléchargée le fichier INSTALL. Normalement, la compilation devrait s'effectuer à l'aide de la commande standard :
./configure
make
make install
Après avoir effectué ceci, le nouvel additif devrait se trouver sous
le répertoire $BASEDIR/share/jpilot/plugins.
Avec cela, vous avez effectué tout ce qui est nécessaire pour installer l'additif. Après le prochain démarrage de J-Pilot, vous devriez être l'heureux propriétaire d'un tout nouvel additif flambamt neuf.
Vous pouvez installer un additif de façon générique, en utilisant la
procédure détaillée ci-dessus, dans le répertoire
$BASEDIR/share/jpilot/plugins. En faisant cela, tous
les utilisateurs du système peuvent faire appel au nouvel additif installé.
Mais, vous devrez être root pour ce faire.
Si vous voulez installer un additif pour un seul utilisateur - pour une
raison ou pour une autre - vous pouvez le faire en plaçant les fichiers
additifs (,,.so``) dans le répertoire $HOME/.jpilot/plugins.
De cette façon, seul l'utilisateur concerné peut utiliser l'additif qu'il
a installé.