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
initInstallavec 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
getFolderpour obtenir les objetsfichieret passe ces références objet àaddFileautant 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