Parts of this page show the use of the XPInstall API. The majority of this API is now deprecated and as of Gecko 1.9 no longer available. Extension, Theme, and plug-in developers must switch away from
install.js based packages to the new packaging scheme with an
install.rdf manifest. In particular plugin developers should see how to package a plugin as an extension.
Compares the version of a file or package with the version of an existing file or package.
int compareVersion ( String registryName, InstallVersion version); int compareVersion ( String registryName, String version); int compareVersion ( String registryName, int major, int minor, int release, int build);
compareVersion method has the following parameters:
- The pathname in the Client Version Registry for the component whose version is to be compared. This parameter can be an absolute pathname, such as
/royalairways/RoyalSWor a relative pathname, such as
plugsin/royalairway/RoyalSW. Note that the registry pathname is not the location of the software on the computer; it is the location of information about the software inside the Client Version Registry.
- An InstallVersion object containing version information or a String in the format major.minor.release.build, where major, minor, release, and build are integer values representing version information.
If the versions are the same or if Software Installation is not enabled, this method returns 0. If the version of
registryName is smaller (earlier) than
version, this method returns a negative number. Otherwise, this method returns a positive number. In particular, this method returns one of the following values:
- component not present or not registered.
registryNamehas a smaller (earlier) major number than
registryNamehas a smaller (earlier) minor number than
registryNamehas a smaller (earlier) release number than
registryNamehas a smaller (earlier) build number than
- The version numbers are the same; both objects represent the same version.
registryNamehas a larger (newer) build number than
registryNamehas a larger (newer) release number than
registryNamehas a larger (newer) minor number than
registryNamehas a larger (newer) major number than
The following constants can be used to check the value returned by compareVersion:
int MAJOR_DIFF = 4; int MINOR_DIFF = 3; int REL_DIFF = 2; int BLD_DIFF = 1; int EQUAL = 0;
In Communicator 4.5, the following constants are defined and available for checking the value returned by
<code>InstallTrigger.MAJOR_DIFF InstallTrigger.MINOR_DIFF InstallTrigger.REL_DIFF InstallTrigger.BLD_DIFF InstallTrigger.EQUAL </code>
compareVersion method compares the version of an installed file or package with a specified version. It is often used as a check against which to initiate the installation process. If
registryName is not found in the Client Version Registry or if
registryName does not have version,
registryName is assumed to have a version of 0.0.0.0. If
registryName represents a file,
compareVersion checks for the existence of the file. If the file has been deleted, its version is assumed to be 0.0.0.0.