Cette page fait parti de la Référence de l'API XPInstall. Notez que si vous être un développeur d'extension, de thème, ou de plug-in, vous n'avez plus besoin d'une grande partie de cette API. Plus particulièrement, le script install.js
utilisé pour l'installation et l'enregistrement du contenu des XPI
est déprécié en faveur du nouveau manifeste déclaratif install.rdf
et du nouveau schéma de paquetage.
Install
Utilisez l'objet Install
pour gérer le téléchargement et l'installation d'un logiciel à partir du gestionnaire d'installations XPI.
Présentation
L'objet Install
est principalement utilisé dans les scripts d'installation. Dans tous les cas, l'objet Install
est implicite, comme l'objet window
dans les scripts de pages Web, et n'a pas besoin d'être mis en préfixe des méthodes de l'objet. Les deux lignes suivantes, par exemple, sont équivalentes :
f = getFolder("Program"); f = Install.getFolder("Program");
Un script d'installation est composé d'appels à l'objet Install
et possède généralement la structure suivante :
- Initialisation de l'installation
-
Appelle
initInstall
avec le nom de l'installation et les informations nécessaires d'enregistrement et de version. - Ajout des fichiers pour l'installation
-
Ajoute les fichiers à installer en appelant
getFolder
pour obtenir les objetsfichier
et passe ces références objet àaddFile
autant de fois que nécessaire. - Exécution de l'installation
- Vérifie que les fichiers ont été ajoutés avec succès (c'est-à-dire, en vérifiant les codes d'erreur retournés depuis les principales méthodes de l'installation), et poursuit l'installation si tout est correct :
performOrCancel(); function performOrCancel() { if (0 == getLastError()) performInstall(); else cancelInstall(); }
Pour des exemples de scripts complets, voir des exemples de scripts.
Interwiki Languages Links