Référence de l'API XPInstall:Objet InstallTrigger:Méthodes:compareVersion

Un article de MDC.

Sommaire 1 compareVersion 1.1 Méthode de 1.2 Syntaxe 1.3 Paramètres 1.4 Retour 1.5 Description

[modifier] compareVersion

Compare la version d'un fichier ou d'un paquetage avec la version d'un fichier ou d'un paquetage existant.

[modifier] Méthode de

Objet InstallTrigger

[modifier] Syntaxe

int compareVersion (
   String registryName,
   InstallVersion version);

int compareVersion (
   String registryName,
   String version);

int compareVersion (
   String registryName,
   int major,
   int minor,
   int release,
   int build);

[modifier] Paramètres

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

registryName

Le nom du chemin d'accès dans la Client Version Registry du composant dont la version doit être comparée. Ce paramètre peut être un chemin absolu, tel que /royalairways/RoyalSW ou un chemin relatif, tel que plugsin/royalairway/RoyalSW. Le nom du chemin d'accès dans le registre n'est pas l'emplacement du logiciel sur le disque dur de l'ordinateur. Il correspond au chemin d'accès vers les informations concernant le logiciel dans la Client Version Registry.

version

Un objet InstallVersion contenant les informations de version ou une chaîne au format majeur.mineur.version.compilation, où majeur, mineur, version et compilation sont des valeurs entières représentant les informations de version.

[modifier] Retour

Si les versions sont identiques ou si l'installation de logiciels est désactivée, cette méthode retourne 0. Si la version de registryName est inférieure (plus ancienne) à version, cette méthode retourne un nombre négatif. Autrement, cette méthode retourne un nombre positif. En particulier, cette méthode retourne l'une des valeurs suivantes :

-5

Le composant n'est pas présent ou il n'est pas enregistré.

-4

registryName a un numéro majeur plus petit (plus ancien) que le paramètre version.

-3

registryName a un numéro mineur plus petit (plus ancien) que le paramètre version.

-2

registryName a un numéro de version plus petit (plus ancien) que le paramètre version.

-1

registryName a un numéro de compilation plus petit (plus ancien) que le paramètre version.

0

Les numéros de version sont égaux ; les deux objets représentent la même version.

1

registryName a un numéro de majeur plus grand (plus récent) que le paramètre version.

2

registryName a un numéro de mineur plus grand (plus récent) que le paramètre version.

3

registryName a un numéro de version plus grand (plus récent) que le paramètre version.

4

registryName a un numéro de compilation plus grand (plus récent) que le paramètre version.

Les constantes suivantes peuvent être utilisées pour vérifier la valeur retournée par compareVersion :

• int MAJOR_DIFF = 4 ;
• int MINOR_DIFF = 3 ;
• int REL_DIFF = 2 ;
• int BLD_DIFF = 1 ;
• int EQUAL = 0.

Dans Communicator 4.5, les constantes suivantes sont définies et sont disponibles pour la vérification de la valeur retournée par compareVersion :

• InstallTrigger.MAJOR_DIFF ;
• InstallTrigger.MINOR_DIFF ;
• InstallTrigger.REL_DIFF ;
• InstallTrigger.BLD_DIFF ;
• InstallTrigger.EQUAL.

[modifier] Description

La méthode compareVersion compare la version d'un fichier ou d'un paquetage installé avec la version spécifiée. Elle est souvent utilisée comme vérification avant l'initialisation du processus d'installation. Si registryName n'est pas trouvé dans la Client Version Registry ou si registryName n'a pas de version, registryName est présumé avoir la version 0.0.0.0. Si registryName représente un fichier, compareVersion vérifie l'existence du fichier. Si le fichier a été effacé, sa version est présumée être 0.0.0.0.