Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.

BuildRetrievalError

public class BuildRetrievalError
extends HarnessException

java.lang.Object
↳	com.android.tradefed.error.HarnessException
	↳	com.android.tradefed.build.BuildRetrievalError

A fatal error occurred while retrieving the build for testing.

Summary

Public constructors
`BuildRetrievalError(String reason)` Constructs a new `BuildRetrievalError` with a meaningful error message.
`BuildRetrievalError(String reason, ErrorIdentifier errorId)` Constructs a new `BuildRetrievalError` with a meaningful error message.
`BuildRetrievalError(String reason, Throwable cause)` Constructs a new `BuildRetrievalError` with a meaningful error message, and a cause.
`BuildRetrievalError(String reason, Throwable cause, IBuildInfo build)` Constructs a new `BuildRetrievalError` with a meaningful error message, a cause, and build details.
`BuildRetrievalError(String reason, Throwable cause, ErrorIdentifier errorId)` Constructs a new `BuildRetrievalError` with a meaningful error message, and a cause.
`BuildRetrievalError(String reason, Throwable cause, ErrorIdentifier errorId, IBuildInfo build)` Constructs a new `BuildRetrievalError` with a meaningful error message, a cause, and build details.

Public methods
`IBuildInfo`	`getBuildInfo()` Return details about the build that was attempted to be retrieved.
`void`	`setBuildInfo(IBuildInfo build)` Set the build info.

Public constructors

BuildRetrievalError

public BuildRetrievalError (String reason)

Constructs a new BuildRetrievalError with a meaningful error message.

Parameters
`reason`	`String`: a error message describing the cause of the error

BuildRetrievalError

public BuildRetrievalError (String reason, 
                ErrorIdentifier errorId)

Constructs a new BuildRetrievalError with a meaningful error message.

Parameters
`reason`	`String`: a error message describing the cause of the error
`errorId`	`ErrorIdentifier`: the error identifier for this error.

BuildRetrievalError

public BuildRetrievalError (String reason, 
                Throwable cause)

Constructs a new BuildRetrievalError with a meaningful error message, and a cause.

Parameters
`reason`	`String`: a detailed error message.
`cause`	`Throwable`: a `Throwable` capturing the original cause of the ProvideBuildError

BuildRetrievalError

public BuildRetrievalError (String reason, 
                Throwable cause, 
                IBuildInfo build)

Constructs a new BuildRetrievalError with a meaningful error message, a cause, and build details.

Parameters
`reason`	`String`: a detailed error message.
`cause`	`Throwable`: a `Throwable` capturing the original cause of the ProvideBuildError
`build`	`IBuildInfo`: details about the build that was attempted to be retrieved

BuildRetrievalError

public BuildRetrievalError (String reason, 
                Throwable cause, 
                ErrorIdentifier errorId)

Constructs a new BuildRetrievalError with a meaningful error message, and a cause.

Parameters
`reason`	`String`: a detailed error message.
`cause`	`Throwable`: a `Throwable` capturing the original cause of the ProvideBuildError
`errorId`	`ErrorIdentifier`: the error identifier for this error.

BuildRetrievalError

public BuildRetrievalError (String reason, 
                Throwable cause, 
                ErrorIdentifier errorId, 
                IBuildInfo build)

Constructs a new BuildRetrievalError with a meaningful error message, a cause, and build details.

Parameters
`reason`	`String`: a detailed error message.
`cause`	`Throwable`: a `Throwable` capturing the original cause of the ProvideBuildError
`errorId`	`ErrorIdentifier`: the error identifier for this error.
`build`	`IBuildInfo`: details about the build that was attempted to be retrieved

Public methods

getBuildInfo

public IBuildInfo getBuildInfo ()

Return details about the build that was attempted to be retrieved.

The returned IBuildInfo will never be null but it may be missing data such as build_id, etc

Returns
`IBuildInfo`	the `IBuildInfo`

setBuildInfo

public void setBuildInfo (IBuildInfo build)

Set the build info.

Parameters
`build`	`IBuildInfo`: the `IBuildInfo`