org.apache.flex.compiler.common

Class VersionInfo

java.lang.Object

org.apache.flex.compiler.common.VersionInfo

public class VersionInfo
extends Object

A helper class for querying build number, Flex version, and library version information.

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPILER_BUILD_ATTRIBUTE Build number of the compiler that compiled the SWF.
static String	COMPILER_ELEMENT Element containing version information.
static String	COMPILER_NAME_ATTRIBUTE Product name of the compiler that compiled the SWF.
static String	COMPILER_NAMESPACE_PREFIX Prefix of the the compiler's namespace URI.
static String	COMPILER_NAMESPACE_URI Namespace of the "compiler" element.
static String	COMPILER_VERSION_ATTRIBUTE Version of the compiler that compiled the SWF.
static String	FLEX_MAJOR_VERSION
static String	FLEX_MINOR_VERSION
static String	FLEX_NANO_VERSION
static String	LIB_MAJOR_VERSION
static String	LIB_MINOR_VERSION
static String	LIB_VERSION_1_0 Lib version is the "version" of the SWC format.
static String	LIB_VERSION_1_1
static String	LIB_VERSION_1_2

Constructor Summary

Constructors

Constructor and Description
VersionInfo()

Method Summary

Methods

Modifier and Type	Method and Description
static String	buildMessage()
static int	compareVersions(String version1, String version2, boolean compareMajorVersion) Compare two version strings that are in at "Major.minor" format.
static String	getBuild()
static long	getBuildLong() Get the build number as a long.
static String	getCompilerBuild() The build number of the compiler.
static String	getCompilerName() The name of the compiler.
static String	getCompilerVersion() The version of the compiler.
static String	getFlexVersion()
static String	getLibVersion()
static boolean	IsNewerLibVersion(String swcLibVersion, boolean compareMajorVersion)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FLEX_MAJOR_VERSION

public static final String FLEX_MAJOR_VERSION

See Also:

Constant Field Values

FLEX_MINOR_VERSION

public static final String FLEX_MINOR_VERSION

See Also:

Constant Field Values

FLEX_NANO_VERSION

public static final String FLEX_NANO_VERSION

See Also:

Constant Field Values

LIB_VERSION_1_0

public static final String LIB_VERSION_1_0

Lib version is the "version" of the SWC format. Major number changes represent big (although not by definition incompatble) changes, such as bytecode format revs. Minor number changes are intended to represent easy-to-support modifications. The only universal rule is that the compiler will warn when a "future" major version is found in a SWC that's being read in. It's expected that incompatible changes will arise. Ad-hoc guard code will be added to implement those dividing lines. The way the code is currently laid out, these would probably be implemented in SWC.read(), but in any case they should be finable by looking at the callers of VersionInfo.getLibVersion().

Version 1.2: Add <keep-as3-metadata> container to catalog.xml to perserve metadata Version 1.1: Add <digest> container to catalog xml for cross-domain rsls support. Add "signatureChecksum" attribute to "script" element. Version 1.0: Initial version.

See Also:

Constant Field Values

LIB_VERSION_1_1

public static final String LIB_VERSION_1_1

See Also:

Constant Field Values

LIB_VERSION_1_2

public static final String LIB_VERSION_1_2

See Also:

Constant Field Values

LIB_MAJOR_VERSION

public static final String LIB_MAJOR_VERSION

See Also:

Constant Field Values

LIB_MINOR_VERSION

public static final String LIB_MINOR_VERSION

See Also:

Constant Field Values

COMPILER_ELEMENT

public static final String COMPILER_ELEMENT

Element containing version information.

See Also:

Constant Field Values

COMPILER_NAME_ATTRIBUTE

public static final String COMPILER_NAME_ATTRIBUTE

Product name of the compiler that compiled the SWF.

See Also:

Constant Field Values

COMPILER_VERSION_ATTRIBUTE

public static final String COMPILER_VERSION_ATTRIBUTE

Version of the compiler that compiled the SWF.

See Also:

Constant Field Values

COMPILER_BUILD_ATTRIBUTE

public static final String COMPILER_BUILD_ATTRIBUTE

Build number of the compiler that compiled the SWF.

See Also:

Constant Field Values

COMPILER_NAMESPACE_URI

public static final String COMPILER_NAMESPACE_URI

Namespace of the "compiler" element.

See Also:

Constant Field Values

COMPILER_NAMESPACE_PREFIX

public static final String COMPILER_NAMESPACE_PREFIX

Prefix of the the compiler's namespace URI.

See Also:

Constant Field Values

Constructor Detail

VersionInfo

public VersionInfo()

Method Detail

buildMessage

public static String buildMessage()

getBuild

public static String getBuild()

getBuildLong

public static long getBuildLong()

Get the build number as a long.

Returns:

build number as a long, 0 if the build number was not available.

getFlexVersion

public static String getFlexVersion()

getLibVersion

public static String getLibVersion()

getCompilerName

public static String getCompilerName()

The name of the compiler.

Returns:

name of the compiler.

getCompilerVersion

public static String getCompilerVersion()

The version of the compiler. Includes the major, minor, and nano versions separates by dots. For example, 4.7.0. The compiler version number comes from information from the manifest.mf file where as the Flex version number is hard-coded in this file.

Returns:

version of the compiler.

getCompilerBuild

public static String getCompilerBuild()

The build number of the compiler. Can be converted to a long. The compiler build number comes from information from the manifest.mf file where as the Flex build number comes from a properties file.

Returns:

the build number of the compiler.

IsNewerLibVersion

public static boolean IsNewerLibVersion(String swcLibVersion,
                        boolean compareMajorVersion)

Parameters:

swcLibVersion - - library version to compare with the current library version.

compareMajorVersion - - if true, compare only the major versions. Otherwise compare both major and minor versions.

Returns:

true if the given library version is greater than the compiled in library version.

compareVersions

public static int compareVersions(String version1,
                  String version2,
                  boolean compareMajorVersion)

Compare two version strings that are in at "Major.minor" format. Examples) "1.0", "1.1"

Parameters:

version1 - first version

version2 - second version

compareMajorVersion - compare only the major versions, disregarding the minor version.

Returns:

zero if the versions are equal less than zero if version1 is less than version2 greater than zero if version1 is greater than version2