mozilla
Vos résultats de recherche

    addFile

     

    addFile

    Extrait un sous-composant unique dans un répertoire temporaire. Met en file d'attente le sous-composant pour son ajout dans la Client Version Registry et son installation dans le répertoire final.

    Méthode de

    Objet Install

    Syntaxe

    public int addFile (
       Chaîne registryName,
       InstallVersion version,
       Chaîne xpiSourcePath,
       Objet localDirSpec,
       Chaîne relativeLocalPath,
       Booléen forceUpdate);
    
    public int addFile (
       Chaîne registryName,
       Chaîne version,
       Chaîne xpiSourcePath,
       Objet localDirSpec,
       Chaîne relativeLocalPath,
       Booléen forceUpdate);
    
    public int addFile (
       Chaîne xpiSourcePath);
    
    public int addFile (
       Chaîne registryName,
       Chaîne xpiSourcePath,
       Objet localDirSpec,
       Chaîne relativeLocalPath);
    
    public int addFile (
       Chaîne registryName,
       Chaîne version,
       Chaîne xpiSourcePath,
       Objet localDirSpec,
       Chaîne relativeLocalPath);
    

    Paramètres

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

    registryName
    Le chemin dans la Client Version Registry concernant le fichier. Ce paramètre peut être un chemin absolu (commençant par /), tel que /royalairways/RoyalSW/executable ou un chemin relatif (ne commençant pas par /), tel que executable. Généralement, les chemins absolus ne sont utilisés que pour composants partagés, ou les composants provenant d'autres éditeurs, tel que /Microsoft/shared/msvcrt40.dll. Généralement, les chemins relatifs le sont par rapport au chemin principal spécifié dans la méthode initInstall. Ce paramètre peut également être vide, dans ce cas le paramètre xpiSourcePath est utilisé comme un chemin relatif. Remarquez que le chemin de registre n'est pas l'emplacement du logiciel sur l'ordinateur, il s'agit de l'emplacement des informations concernant le logiciel dans la Client Version Registry .
    version
    Un objet InstallVersion ou une Chaîne de 1 à 4 valeurs entières délimitées par des points, telle que 1.17.1999.1517. Pour les variantes de cette méthode sans argument de version, la valeur de initInstall sera utilisée.
    xpiSourcePath
    Une chaîne spécifiant l'emplacement du fichier dans l'archive <tt>xpi</tt>.
    localDirSpec
    Un objet représentant un répertoire. Le fichier est installé dans ce répertoire sur la machine de l'utilisateur. Vous pouvez créer cet objet en passant une chaîne représentant le répertoire à la méthode getFolder.
    relativeLocalPath
    Un chemin relatif au paramètre localDirSpec. Le fichier est installé dans ce répertoire sur la machine de l'utilisateur. Vous devez toujours utiliser des barres obliques (/) dans ce chemin, sans considération pour les conventions d'écritures du système d'exploitation. Si ce paramètre n'est pas renseigné ou NULL, xpiSourcePath est utilisé.
    flags
    Un champ optionnel, réservé pour un usage futur. Passe 0 comme valeur par défaut.

    Retour

    Un code d'erreur entier. Pour la liste des valeurs possibles, voir Codes retournés.

    Description

    La méthode addFile met le fichier dans un répertoire temporaire. Pour le déplacer, ainsi que tous les autres fichiers, vers son emplacement final, appelez la méthode performInstall après avoir ajouté avec succès tous les fichiers.

    Note : Si vous installez des fichiers binaires sur un Macintosh, soyez attentif à ce que le format binaire de ces fichiers doit être AppleSingle pour que les informations de ressources soient installées proprement. Certains logiciels de transfert de fichiers convertissent les binaires Apple dans ce format si vous les transférez d'un Macintosh vers une machine Unix/Windows avant de compresser ces fichiers sur la machine de destination.

    Exemple

    var xpiSrc = "file.txt";
    initInstall("Ajout d'un fichier",
       "addFile",
       "1.0.1.7",
       1);
    f = getFolder("Program");
    setPackageFolder(f);
    addFile(xpiSrc);
    if (0 == getLastError())
       performInstall();
    else
       cancelInstall();</pre>
    

    Interwiki Languages Links

    Étiquettes et contributeurs liés au document

    Contributors to this page: Fredchat, Kyodev, teoli
    Dernière mise à jour par : teoli,