Plug-ins

2.6 Plug-ins

Les scripts NSIS supportent l'appel de plug-ins. Les plug-ins sont des fichiers DLL écrits en C, C++, Delphi ou tout autre langage de programmation. Les Plug-ins fournissent une base de code plus puissante à NSIS puisqu'ils peuvent contenir n'importe quel code depuis celui qui fait le calcul de 1 + 1 à celui qui communique avec d'autres ordinateurs via FireWire.

Pour appeler une fonction plug-in dans votre script vous devez ajouter une ligne comme suit:

NomDLL::NomFonction "paramètre numéro 1" "paramètre numéro 2" "paramètre numéro 3"

Chaque fonction de plug-in a ses propres exigences lorsqu'il arrive le moment de traiter les paramètres, certains n'en auront pas besoin, d'autres en accepterons autant que nécessaire. Par exemple:

nsExec::ExecToLog '"${NSISDIR}\makensis.exe" /CMDHELP'
InstallOptions::dialog "$PLUGINSDIR\test.ini"
NSISdl::download http://download.nullsoft.com/winamp/client/winamp281_lite.exe $2

Les plug-ins que NSIS reconnaît sont listés au début de la sortie du compilateur. NSIS recherche les plug-ins dans le répertoire Plug-ins sous votre répertoire NSIS et en liste toutes les fonctions disponibles. Vous pouvez utiliser !addPluginDir pour dire à NSIS de chercher aussi dans d'autres répertoires.

Il y a plusieurs plug-ins fournis avec votre distribution NSIS. InstallOptions est un plug-in populaire qui vous permet de rajouter des pages personnalisées à votre installation, combiné avec vos commandes de Pages NSIS (voir Pages). Le plug-in Startmenu fournit une page qui permet à l'utilisateur de choisir un dossier de Démarrage. Il y a un grand choix de plug-ins pour différents objectifs, regardez le répertoire Docs pour les fichiers d'aide et d'exemples. Vous pouvez trouver des plug-ins additionnels en ligne dans les Wiki NSIS.

Vous pouvez aussi créer vos propres plug-ins si vous savez programmer. Voir le plugin exemple pour savoir comment faire. Le code source des plug-ins inclus peut aussi être trouvé dans le package source code.

Précédent | Sommaire | Suivant