Getting the iCub software

From Wiki for iCub and Friends
Jump to: navigation, search

This page is no longer relevant. Instructions for getting the software are available here: ICub_Software_Installation



The subversion repository contains the latest version of the code. From time to time we release a snapshot of the whole repository in a single tar file.

Getting the software from the snapshots

Periodic snapshots of the repository are available here: http://wiki.icub.org/iCub/downloads/src/

There are three types of files:

  • iCub-src-x.y.z.tar.gz: the whole iCub repository version x.y.z
  • iCub-dep-x.y.z.txt: a list of the libraries that are required to compile the code in snapshot x.y.z (including yarp version number).

Getting the software using Subversion

These are instructions to get the RobotCub software repository using svn.

Important since August 5th 2009, repositories have been moved to SourceForge (www.sourceforge.net).

These instructions explain how to download the software using svn. We assume you already know what svn is and how to use it.

  Important note for CVS users. To get the software you no longer need to have a 
  user; however you do need one to commit changes to the repository. If you think 
  you need a user follow instructions in Section 6 of the manual ("Prepare your system, 
  get svn").

Getting the repository for Linux

You need an svn client. svn is normally distributed with Linux, use your package manager to install it (Debian/Ubuntu apt-get install subversion).

Pick the location where you would like to download the code.

At the console type:

  svn co https://robotcub.svn.sourceforge.net/svnroot/robotcub/trunk/iCub

this will create in the local directory a new directory called iCub that contains the trunk version of the iCub software.

Getting the repository for Windows

You need an svn client. Among the many alternatives we suggest you get tortoise SVN. Binaries for windows are available here: http://tortoisesvn.net/.

Use file manager to browse to the location where you would like to download the code. Right click on an empty region of the window and select "SVN checkout" from the contextual menu.

Type the following string in the entry "URL of repository":

  https://robotcub.svn.sourceforge.net/svnroot/robotcub/trunk/iCub

No password or username will be required.

For developers: working with branches

Getting a branch (Linux and Windows)

Alternatively, you can retrieve a specific branch of the iCub software. If this is the case, simply substitute the trunk path (https://robotcub.svn.sourceforge.net/svnroot/robotcub/trunk/iCub) with the branch path (https://robotcub.svn.sourceforge.net/svnroot/robotcub/branches/selectedBranch). Available branches can be browsed at https://robotcub.svn.sourceforge.net/svnroot/robotcub/branches. For example you can select the following:

  svn co https://robotcub.svn.sourceforge.net/svnroot/robotcub/branches/iCub2.0

Comparing URL branches and trunk

Comparing different URL versions of the repository (Linux)

If you want to compare two different versions of the svn repository you can run the following command (svn.server.path=https://robotcub.svn.sourceforge.net/svnroot/robotcub):

  svn diff svn.server.path/trunk/iCub svn.server.path/branches/iCub.2.0 --summarize

which will output single file differences with the usual svn syntax (A Added,D Deleted, U Updated). Notice that the "--summarize" option avoids the line-by-line comparison.

Comparing different URL versions of the repository (tortoiseSVN Windows)

The "Changed Files" window

A (network) comparison between repositories (typically trunk and branches) can be performed also with TortoiseSVN by the following procedure:

  • Open a "windows explorer".
  • Right-click on the window (you do not need any SVN repository since the comparison will be done on the URL repositories and not on local files).
  • Click on TortoiseSVN -> Repo-browser (you need to have TortoiseSVN installed).
  • Specify the URL which contains the trunk and the branches, e.g. https://robotcub.svn.sourceforge.net/svnroot/robotcub. This will open a repository browser which can be used to browse both branches and trunk. This command might take some time, since it goes trough the network.
  • Right-click on the first repository that you want to compare and select "Mark for comparison". For example, you can select the iCubPlatform trunk which is located in trunk/iCubPlatform of the https://robotcub.svn.sourceforge.net/svnroot/robotcub repository.
  • Right-click on the second repository (to be compared with the repository selected above) and select "compare URLs". For example, you can select the iCubPlatform1.1 branch which is located in branches/iCubPlatform1.1 of the https://robotcub.svn.sourceforge.net/svnroot/robotcub repository.
  • A window "Changed Files" will be opened containing a summary of the differences between the two URL repositories (Added, Deleted and Modified files). The result might require some time because it requires a comparison between network repositories. Double clicking on a "Modified" file will invoke a file-diff-tool which is practically useless with non-text files.