com.android.ide.common.repository

Class GradleVersionRange

java.lang.Object

com.android.ide.common.repository.GradleVersionRange

public class GradleVersionRange
extends java.lang.Object

GradleVersionRange is used to describe dependency version requirements.

e.g. a library has a dependency on androidx.core:core:1.5.7 it means that any library in the range [1.5.7, 2.0.0) would work as a dependency because androidx libraries guarantees semantic versioning.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object other)
GradleVersion	getMax() The upper bound (exclusive)
GradleVersion	getMin() The lower bound (inclusive)
int	hashCode()
GradleVersionRange	intersection(GradleVersion version)
GradleVersionRange	intersection(GradleVersionRange other)
static GradleVersionRange	parse(java.lang.String value) Parses the given version range.
static GradleVersionRange	parse(java.lang.String value, com.android.ide.common.repository.KnownVersionStability stability) Parses the given version range.
java.lang.String	toString()
static GradleVersionRange	tryParse(java.lang.String value) Parses the given version.
static GradleVersionRange	tryParse(java.lang.String value, com.android.ide.common.repository.KnownVersionStability stability) Parses the given version.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

parse

@NonNull
public static GradleVersionRange parse(@NonNull
                                                java.lang.String value)

Parses the given version range.

Parameters:

value - the version range to parse example: [2.3.4,3.0.0)

Returns:

the created Version object.

Throws:

java.lang.IllegalArgumentException - if the given value does not conform with any of the supported version formats.

parse

@NonNull
public static GradleVersionRange parse(@NonNull
                                                java.lang.String value,
                                                @NonNull
                                                com.android.ide.common.repository.KnownVersionStability stability)

Parses the given version range.

Parameters:

value - the version range to parse.

stability - the stability of the artifact.

Returns:

the created Version object.

Throws:

java.lang.IllegalArgumentException - if the given value does not conform with any of the supported version formats.

See Also:

Semantic Versioning

tryParse

@Nullable
public static GradleVersionRange tryParse(@NonNull
                                                    java.lang.String value,
                                                    @NonNull
                                                    com.android.ide.common.repository.KnownVersionStability stability)

Parses the given version. This method does the same as parse(String), but it does not throw exceptions if the given value does not conform with any of the supported version formats.

Parameters:

value - the version to parse.

stability - the stability of the artifact.

Returns:

the created GradleVersionRange object, or null if the given value does not conform with any of the supported version formats.

tryParse

@Nullable
public static GradleVersionRange tryParse(@NonNull
                                                    java.lang.String value)

Parses the given version. This method does the same as parse(String), but it does not throw exceptions if the given value does not conform with any of the supported version formats.

Parameters:

value - the version to parse.

Returns:

the created GradleVersionRange object, or null if the given value does not conform with any of the supported version formats.

getMin

@NonNull
public GradleVersion getMin()

The lower bound (inclusive)

getMax

@Nullable
public GradleVersion getMax()

The upper bound (exclusive)

intersection

@Nullable
public GradleVersionRange intersection(@NonNull
                                                 GradleVersionRange other)

intersection

@Nullable
public GradleVersionRange intersection(@NonNull
                                                 GradleVersion version)

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object