article de presse - Cap Data Consulting

P ratique
"DefaultInstall",
SPINST_PROFILEITEMS,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL);
// Mise à jour du registre.
::SetupInstallFromInfSection(
NULL,
MyInf,
"DefaultInstall",
SPINST_REGISTRY,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL);
L'appel à SetupInstallFilesFromInfSection reçoit la section [DefaultInstall]
en paramètre. Cet appel a pour effet de mettre d'un seul coup dans la
queue tous les fichiers des trois sections pointées par la directive
CopyFiles de la section [DefaultInstall]. En revanche, les autres directives
de la section sont ignorées par la fonction. Il est important de noter que
l'API consulte les sections [SourceDisksNames] et [SourceDisksFiles] du
fichier .INF. Il est possible de s'affranchir de ces sections si l'on souhaite
gérer manuellement la localisation des fichiers sources. Dans ce cas,
on devra se tourner vers une API de plus bas niveau :
SetupInstallFromInfSection. Si on ne spécifie rien à cette API, quant à la
localisation des sources, les sections [SourceDisksNames] et
[SourceDisksFiles sont prises en compte normalement.
Vient ensuite l'appel à SetupQueueCopy. Cet appel ajoute un fichier,
Readme.txt dans la queue. Ce fichier n'est pas répertorié dans le fichier .INF.
Cela montre que, même si l'on part d'un fichier .INF pour le gros d'une installation,
il est possible de s'en affranchir. Par contre, cela impose de gérer
manuellement la localisation de la source et la localisation de la cible.
Après l'appel à SetupCommitFilequeue qui lance l'exécution de la
queue, vient un appel à SetupInstallFromInfSection, dont le propos est
non plus d'installer des fichiers constitutifs de l'application, mais de
créer une entrée dans le menu 'Démarrer' de Windows. La section du
fichier .INF passée en paramètre est encore [DefaultInstall) mais cette
fois, le drapeau n'est plus SPINST_FILES (cf. le morceau de code en
commentaire ci-dessus) mais SPINST_PROFILEITEMS. C'est donc la section
pointée par la directive ProfileItem de la section [DefaultInstall] qui
sera traitée. Remarquons que l'existence du drapeau SPINST_PROFILEI-
TEMS n'est pas mentionnée dans la documentation MSDN, pour une raison
inconnue. SPINST_PROFILEITEMS existe toutefois bel et bien
comme on peut s'en assurer en consultant l'en-tête setupapi.h. Vient,
pour terminer, un nouvel appel à SetupInstallFromInfSection semblable
au précédent, mais comme le drapeau SPINST_REGISTRY l'indique, il est
question, cette fois, de traiter la directive AddReg de [DefaultInstall], ce
qui a pour effet de configurer le registre pour une désinstallation ultérieure
de l'application.
6
Une installation sans fichier .INF
Nous avons vu qu'il est possible de mettre en queue un fichier qui n'est
pas recensé par un fichier .INF. Il est donc possible de s'affranchir totalement
de INF pour une application d'installation. C'est ainsi qu'est
constitué notre exemple 'Complet' qui simule en outre le dialogue avec
l'utilisateur. Tous les fichiers à installer sont listés dans un tableau. Ce
procédé est valable pour la démonstration, mais pas très heureux pour
l'installation d'une application du monde réel, car toute modification de
celle-ci conduit à modifier et recompiler l'installateur avec tous les problèmes
que ça implique. On préfèrera alors une base de données 'maison'.
Aux fichiers à installer est ajouté le fichier Uninstall.exe qui est
notre dernier exemple et qui devra donc exister c'est-à-dire être compilé
préalablement. Notre installation commence à ressembler à une vraie :-)
En revanche, notre exemple ne crée plus d'entrée dans le menu
'Démarrer'. Obtenir cela est simple. Nous invitons le lecteur à se reporter
à l'article traitant de la barre des tâches dans Programmez! 71.
Comme nous n'avons plus de fichiers INF nous devons mettre le registre
à jour manuellement. Il faut au minimum une clé comportant deux
valeurs :
- DisplayName qui sera le nom de l'application tel qu'affiché par le panneau
de configuration.
- UninstallString qui est la commande que lancera le système pour
désinstaller l'application. Pour notre exemple, la commande lance le
programme uninstall.exe mentionné plus haut.
Nous avons ajouté une troisième valeur. Il s'agit de la localisation du
répertoire d'installation tel qu'aurait pu le fournir l'utilisateur. Le programme
uninstall.exe lit cette valeur pour pouvoir désinstaller. Si la
valeur ou même la clé ne sont pas trouvées, uninstall.exe considère que
l'application est déjà désinstallée (cf. Code sur le Cd-rom).
7
Programmez n°85 76 avril 2006
Aller plus loin
Nous aurions pu travailler avec des logs. Il existe des API pour cela. Le
log classiquement utilisé est C:\WINDOWS\setupapi.log, mais n'importe
quel fichier peut être utilisé. Enfin, quand on y réfléchit, un programme
d'installation est essentiellement une moulinette à copier les fichiers et
à mettre à jour le registre. Rien n’empêche de tout coder sans utiliser
les API Setup. C'est d'ailleurs ce qu'a fait Microsoft lui-même, avec l'installateur
Windows qui est une application s'appuyant sur des fichiers
.MSI qui peuvent être décrits, en simplifiant, comme la base de données
maison que nous avons évoquée plus haut.
■ Frédéric Mazué fmazue@programmez.com
Niveau
C++ facile avancé expert