com.android.sdklib.repository.descriptors
Interface IPkgDesc

All Superinterfaces:
java.lang.Comparable<IPkgDesc>, IPkgCapabilities
All Known Subinterfaces:
IPkgDescExtra
All Known Implementing Classes:
PkgDesc, PkgDescExtra

public interface IPkgDesc
extends java.lang.Comparable<IPkgDesc>, IPkgCapabilities

IPkgDesc keeps information on individual SDK packages (both local or remote packages definitions.)
Packages have different attributes depending on their type.

To create a new IPkgDesc, use one of the package-specific constructors provided by PkgDesc.newXxx().

To query packages capabilities, rely on getType() and the IPkgDesc.hasXxx() methods provided by IPkgDesc.


Method Summary
 AndroidVersion getAndroidVersion()
          Returns the package's AndroidVersion or null.
 FullRevision getFullRevision()
          Returns the package's FullRevision or null.
 MajorRevision getMajorRevision()
          Returns the package's MajorRevision or null.
 FullRevision getMinPlatformToolsRev()
          Returns the package's min-platform-tools-rev or null.
 FullRevision getMinToolsRev()
          Returns the package's min-tools-rev or null.
 java.lang.String getPath()
          Returns the package's path string or null.
 PkgType getType()
          Returns the type of the package.
 java.lang.String getVendorId()
          Returns the package's vendor-id string or null.
 boolean isUpdateFor(IPkgDesc existingDesc)
          Indicates whether this package descriptor is an update for the given existing descriptor.
 
Methods inherited from interface java.lang.Comparable
compareTo
 
Methods inherited from interface com.android.sdklib.repository.descriptors.IPkgCapabilities
hasAndroidVersion, hasFullRevision, hasMajorRevision, hasMinPlatformToolsRev, hasMinToolsRev, hasPath, hasVendorId
 

Method Detail

getType

@NonNull
PkgType getType()
Returns the type of the package.

Returns:
Returns one of the PkgType constants.

getFullRevision

@Nullable
FullRevision getFullRevision()
Returns the package's FullRevision or null.

Returns:
A non-null value if IPkgCapabilities.hasFullRevision() is true; otherwise a null value.

getMajorRevision

@Nullable
MajorRevision getMajorRevision()
Returns the package's MajorRevision or null.

Returns:
A non-null value if IPkgCapabilities.hasMajorRevision() is true; otherwise a null value.

getAndroidVersion

@Nullable
AndroidVersion getAndroidVersion()
Returns the package's AndroidVersion or null.

Returns:
A non-null value if IPkgCapabilities.hasAndroidVersion() is true; otherwise a null value.

getPath

@Nullable
java.lang.String getPath()
Returns the package's path string or null.

For PkgType.PKG_SYS_IMAGES, the path is the system-image ABI.
For PkgType.PKG_PLATFORMS, the path is the platform hash string.
For PkgType.PKG_ADDONS, the path is the platform hash string.
For PkgType.PKG_EXTRAS, the path is the extra-path string.

Returns:
A non-null value if IPkgCapabilities.hasPath() is true; otherwise a null value.

getVendorId

@Nullable
java.lang.String getVendorId()
Returns the package's vendor-id string or null.

Returns:
A non-null value if IPkgCapabilities.hasVendorId() is true; otherwise a null value.

getMinToolsRev

@Nullable
FullRevision getMinToolsRev()
Returns the package's min-tools-rev or null.

Returns:
A non-null value if IPkgCapabilities.hasMinToolsRev() is true; otherwise a null value.

getMinPlatformToolsRev

@Nullable
FullRevision getMinPlatformToolsRev()
Returns the package's min-platform-tools-rev or null.

Returns:
A non-null value if IPkgCapabilities.hasMinPlatformToolsRev() is true; otherwise null.

isUpdateFor

boolean isUpdateFor(@NonNull
                    IPkgDesc existingDesc)
Indicates whether this package descriptor is an update for the given existing descriptor.

Parameters:
existingDesc - A non-null existing descriptor.
Returns:
True if this package is an update for the given one.