Common Build Infrastructure/Defining Binary Dependencies

From Eclipsepedia

Jump to: navigation, search

There are multiple ways to define your dependencies when doing an Athena build. Below are examples which can be used in your file.

Note that instead of http:// or ftp:// paths, you can also specify /path/to/ Once a zip has been fetched from remote, it will be cached in your downloadsDir for reuse - but you need not reference it by a local path since the build system will check the downloadsDir for a matching zip before attempting to re-download it from remote.

By default, downloadsDir will be /tmp/build/downloads/ (c:\tmp\build\downloads\ on Windows); to set a different location, use the downloadsDir property in your to point to an alternate path.


SDK or Runtime Zips

By default, everything listed in dependencyURLs will be installed automatically. Should you want to override this behaviour, you can define your own buildExtra.xml or testExtra.xml and inject custom steps for unpacking dependencyURLs. Zips containing "master" or "update" in their name will be treated as update sites; all others will be unpacked into eclipse/dropins/.

# CDT master zip is an update site zip w/ p2 metadata and site.xml

Update Sites

Remote Site

Eclipse 3.4 (Ganymede)

Provisioning directly from an update site may fail due to socket timeouts; however, this method can work when the network is cooperative.


Or, specify multiple update sites:


Eclipse 3.5 (Galileo)

With Eclipse 3.5, you can do multiple provisioning installs in a single p2 operation. Note the use of "+" to define which feature.groups to install together. You can still use commas to define sequential operations.


You can also install plugins from, for example, an Orbit update site (MUST BE A p2 REPO, not simply a "Classic" update site):


Remote Zipped Site

As noted above, you can use update site zips as dependencyURLs. However, it's probably better to set them as repositoryURLs since that is what they are. Using the prefix will fetch the specified zip from the mirror deemed to be closest to your IP address, unpack it, and if necessary, generate p2 metadata from the included site.xml file.


Snapshot Dependencies

Creating Snapshots

To provide others with SNAPSHOT builds (usually nightlies), set the following property when running your Athena build (via Hudson or commandline):

export SNAPSHOT="true"
. /opt/public/cbi/build/org.eclipse.dash.common.releng/hudson/

Using Snapshots

To consume others' SNAPSHOT builds, explore their Hudson jobs to find their "Last Successful Build" then "Build Artifacts". Browse their workspace for a generically named zip such as this one:

Then, add this zip to your file via the dependencyURLs or repositoryURLs as appropriate, depending on whether the snapshot zip contains an SDK/runtime or p2 repository (update site).

More information