Skip to main content

Visit Mozilla.org

Référence de l'API XPInstall:Objet Install:Méthodes:initInstall

Un article de MDC.


Sommaire

[modifier] initInstall

Initialise l'installation du logiciel spécifié et de sa version.

[modifier] Méthode de

Objet Install

[modifier] Syntaxe 

int initInstall (
   Chaîne displayName,
   Chaîne package,
   InstallVersion version,
   int flags);

int initInstall (
   Chaîne displayName,
   Chaîne package,
   Chaîne version,
   int flags);

int initInstall (
   Chaîne displayName,
   Chaîne package,
   Chaîne version);

int initInstall ( 

  String displayName,
  String package,
  InstallVersion version);

[modifier] Paramètres

La méthode initInstall a les paramètres suivants :

displayName
Une chaîne qui contient le nom du logiciel à installer. Le nom du logiciel est visible par l'utilisateur.
package
Le chemin dans la Client Version Registry concernant le logiciel (par exemple : Plugins/Adobe/Acrobat ou /royalairways/RoyalPI/).
Fournir un nom vide ou null est une erreur.
Le chemin peut être absolu ou relatif. Un chemin relatif est relatif à l'espace de nommage de Netscape 6. Un chemin relatif doit débuter par plugins/, pour être relatif à la partie plugins de cet espace de nommage ou par java/download/, pour être relatif à la partie Java. Toutes les autres parties de l'espace de nommage de Netscape 6 sont réservées à l'usage de Netscape.
La Client Version Registry est une description hiérarchique du logiciel enregistré pour être utilisé par Netscape 6. Le chemin fourni ici n'est pas l'emplacement du logiciel sur le disque local, il correspond aux informations concernant le logiciel dans le registre. La distinction est importante lorsque vous ajoutez des composants avec la méthode addFile.
version
Un objet InstallVersion ou une Chaîne représentant la version du paquetage à installer. Lorsque version est une Chaîne il peut contenir jusqu'à quatre nombres entiers, délimités par des points, tel que 1.17.1999.1517.
flags
Un champ optionnel, réservé pour un usage futur. Passe 0 comme valeur par défaut.

[modifier] Retour

Un nombre entier correspondant à un code d'erreur. Pour la liste complète des valeurs possibles, voir Codes retournés.

[modifier] Description

La méthode initInstall initialise l'installation du logiciel spécifié. Elle doit être appelée immédiatement après le constructeur. Il est erroné d'appeler toute autre méthode de l'objet Install avant l'appel de initInstall.

Après l'appel de la méthode initInstall, le script d'installation doit appeler les méthodes performInstall ou cancelInstall avant qu'il ne se termine. Si ces appels ne sont pas faits, Netscape 6 ne sera pas en mesure de nettoyer proprement les fichiers temporaires après la fin de l'exécution du script.

[modifier] Exemple

Pour débuter l'installation du plugin Royal Airways, on peut utiliser ce code : 

initInstall("Royal Airways TripPlanner","/RoyalAirways/
TripPlanner","1.0.0.0");
...
err = getLastError();
if (!err)
   performInstall();
else
   cancelInstall(err);
Récupérée de « http://developer.mozilla.org/fr/docs/R%C3%A9f%C3%A9rence_de_l%27API_XPInstall:Objet_Install:M%C3%A9thodes:initInstall »