com.android.ide.common.repository

Class MavenRepositories

java.lang.Object

com.android.ide.common.repository.MavenRepositories

public class MavenRepositories
extends java.lang.Object

Utilities for dealing with the standard m2repository directory layout.

Method Summary

Modifier and Type	Method and Description
static java.io.File	getArtifactDirectory(java.io.File repository, GradleCoordinate coordinate)
static java.io.File	getArtifactIdDirectory(java.io.File repository, java.lang.String groupId, java.lang.String artifactId)
static GradleCoordinate	getHighestInstalledVersion(java.lang.String groupId, java.lang.String artifactId, java.io.File repository, java.lang.String filter, boolean allowPreview) Deprecated. For testability, use getHighestInstalledVersion(String, String, File, String, boolean, FileOp).
static GradleCoordinate	getHighestInstalledVersion(java.lang.String groupId, java.lang.String artifactId, java.io.File repository, java.lang.String filter, boolean allowPreview, com.android.repository.io.FileOp fileOp) Find the best matching GradleCoordinate
static GradleVersion	getHighestInstalledVersionNumber(java.lang.String groupId, java.lang.String artifactId, java.io.File repository, java.lang.String filter, boolean allowPreview, com.android.repository.io.FileOp fileOp) Find the best matching GradleVersion.
static GradleVersion	getHighestVersion(java.io.File versionDir, java.lang.String filter, boolean allowPreview, com.android.repository.io.FileOp fileOp) Given a directory containing version numbers returns the highest version number matching the given filter
static java.io.File	getMavenMetadataFile(java.io.File repository, java.lang.String groupId, java.lang.String artifactId)
static boolean	isPreview(GradleCoordinate coordinate) Decides whether a given GradleCoordinate is considered preview.

Methods inherited from class java.lang.Object

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

Method Detail

getHighestInstalledVersion

@Nullable
public static GradleCoordinate getHighestInstalledVersion(@NonNull
                                                                    java.lang.String groupId,
                                                                    @NonNull
                                                                    java.lang.String artifactId,
                                                                    @NonNull
                                                                    java.io.File repository,
                                                                    @Nullable
                                                                    java.lang.String filter,
                                                                    boolean allowPreview,
                                                                    @NonNull
                                                                    com.android.repository.io.FileOp fileOp)

Find the best matching GradleCoordinate

Parameters:

groupId - the artifact group id

artifactId - the artifact id

repository - the path to the m2repository directory

filter - an optional filter which the matched coordinate's version name must start with

allowPreview - whether preview versions are allowed to match

Returns:

the best (highest version) matching coordinate, or null if none were found

getHighestInstalledVersionNumber

@Nullable
public static GradleVersion getHighestInstalledVersionNumber(@NonNull
                                                                       java.lang.String groupId,
                                                                       @NonNull
                                                                       java.lang.String artifactId,
                                                                       @NonNull
                                                                       java.io.File repository,
                                                                       @Nullable
                                                                       java.lang.String filter,
                                                                       boolean allowPreview,
                                                                       @NonNull
                                                                       com.android.repository.io.FileOp fileOp)

Find the best matching GradleVersion. Like getHighestInstalledVersion(String, String, File, String, boolean, FileOp) but operates on GradleVersion instead of GradleCoordinate.

Parameters:

groupId - the artifact group id

artifactId - the artifact id

repository - the path to the m2repository directory

filter - an optional filter which the matched version name must start with

allowPreview - whether preview versions are allowed to match

fileOp - file operator to use for file access

Returns:

the best (highest version) matching version, or null if none were found

getHighestVersion

@Nullable
public static GradleVersion getHighestVersion(@NonNull
                                                        java.io.File versionDir,
                                                        @Nullable
                                                        java.lang.String filter,
                                                        boolean allowPreview,
                                                        @NonNull
                                                        com.android.repository.io.FileOp fileOp)

Given a directory containing version numbers returns the highest version number matching the given filter

Parameters:

versionDir - the directory containing version numbers

filter - an optional filter which the matched version name must start with

allowPreview - whether preview versions are allowed to match

fileOp - file operator to use for file access

Returns:

the best (highest version), or null if none were found

isPreview

public static boolean isPreview(GradleCoordinate coordinate)

Decides whether a given GradleCoordinate is considered preview.

This is mostly compatible with GradleCoordinate.isPreview(), but there is one edge case that we need to handle, related to Play Services. (See https://b.android.com/75292)

getHighestInstalledVersion

@Deprecated
 @Nullable
public static GradleCoordinate getHighestInstalledVersion(@NonNull
                                                                                 java.lang.String groupId,
                                                                                 @NonNull
                                                                                 java.lang.String artifactId,
                                                                                 @NonNull
                                                                                 java.io.File repository,
                                                                                 @Nullable
                                                                                 java.lang.String filter,
                                                                                 boolean allowPreview)

Deprecated. For testability, use getHighestInstalledVersion(String, String, File, String, boolean, FileOp).

getArtifactIdDirectory

public static java.io.File getArtifactIdDirectory(@NonNull
                                                  java.io.File repository,
                                                  @NonNull
                                                  java.lang.String groupId,
                                                  @NonNull
                                                  java.lang.String artifactId)

getArtifactDirectory

public static java.io.File getArtifactDirectory(@NonNull
                                                java.io.File repository,
                                                @NonNull
                                                GradleCoordinate coordinate)

getMavenMetadataFile

public static java.io.File getMavenMetadataFile(@NonNull
                                                java.io.File repository,
                                                @NonNull
                                                java.lang.String groupId,
                                                @NonNull
                                                java.lang.String artifactId)