Objet Install

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 objets fichier 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

Étiquettes et contributeurs liés au document

Dernière mise à jour par : teoli,