Introduction

The Fetcher class provides logic for all automated source and package fetching operations used within the SDK. It supports fetching through http, ftp, git and svn sources, as well as unique operations for all of them.

Public Parameters

The following is a list of parameters that may be set according to an application's specific requirements.

• FETCHER_NO_DOWNLOAD: In the case that no download is to be applied, set this value to anything other than "no".

• PKG_NAME: The name of the package to be downloaded. If not set, it will be defined as the output of the "pwd" command.

• PKG_TARBALL: The name of the tarball to be downloaded. If not set, it will be defined as the above parameter's value plus the ".tar.bz2" extension.

• PKG_URL: The url from where to download the tarball.

• PKG_INTERNAL_URL: An internal (possible private) url from where to download the tarball.

• FETCHER_EXTRACT_DIRECTORY_NAME: The name of the directory into which the downloaded package will be extracted. If not defined, this parameter will be set to the PKG_NAME variable mentioned above.

• PKG_TYPE: The type of download to be made. This value can be set manually to either http, ftp, git or svn. If this value is not set, it will try to infer the package type through the provided URL.

• PKG_BRANCH: Specifies the branch containing the source code. Valid when PKG_TYPE is git or svn.

• PKG_SHA1SUM: Optional value that may be set for package integrity checking through its SHA1SUM value.

• PKG_ZIP_STRIP_DIR: The unzip command lacks functionality to replace the extracted directory's name with our preferred src convention. For this reason, this variable must be set in case we're downloading a zip file as a package through the fetcher, with the name of the directory that it extracts, so that it's then moved to the appropriate src directory.

• SVN_AUTH_ARGUMENTS: Arguments that may be required when checking out a svn revision (hence, this variable may only be of use when the PKG_TYPE is set to svn) should be stored in this variable.

• BIN_ARGUMENTS: Arguments that may be required when running a binary installer.

• BIN_ANSWERS: String with anwers to feed into any question an installer binary may have

• FETCHER_DOWNLOAD_RETRY: Boolean variable to enable retry when downloading packages fails (used by autobuilder).

• FETCHER_MAX_DOWNLOAD_RETRIES: Specify the maximum number of retries to execute when downloading packages.

• FETCHER_DOWNLOAD_RETRY_DELAY?: Sets the wait time between the download the packages.

• FETCHER_MAX_DOWNLOAD_RATE: Specify the maximum transfer rate that curl will use to download the packages.