Programming Howto:SVN Client Setup

From BCI2000 Wiki
Revision as of 19:24, 10 May 2007 by Atennissen (talk | contribs)
Jump to navigation Jump to search

Setting up TortoiseSVN to access the BCI2000 code repository

To set up TortoiseSVN and download the BCI2000 source code to your computer, follow these steps:

  • Download the latest stable version from http://tortoisesvn.net/, and execute the installer program. This page has been written for version 1.40, but should be pretty independent of TortoiseSVN's version number.
  • Create or pick an empty folder located on your machine’s harddrive. This will hold your working copy of the BCI2000 source tree, in an automatically created subfolder called "BCI2000."
  • Right-click the folder you picked in the last step. From the context menu, choose the "SVN Checkout..." option – a dialog window appears.
  • In the dialog window, enter the repository URL: http://www.bci2000.org/svn/trunk, choose "HEAD revision", and click OK.
  • You will be prompted for your user name and password. This account is the same that you use to log into Trac and into this Wiki.

Checking out older versions

If you think that the current version of BCI2000 is not working properly, or would like to work with an older version for some other reason, you may enter a "Revision number" into the checkout dialog. The "Show Log" button will provide you with an overview of the latest changes and their associated revision numbers.

Working on Branches

Branches are versions of the source code that are developed in parallel to the main code version, e.g. to incorporate new features without affecting the stable version that is intended for end users. To check out a branch called "myBranch", the repository URL would be: http://www.bci2000.org/svn/branches/myBranch. Otherwise, the checkout process remains the same.

Troubleshooting

  • When trying to checkout, update, or commit, you get an error message: "PROPFIND request failed", "OPTIONS request failed", "could not connect to server", or the like.
Quite likely, you are behind a firewall, and internet access is over a proxy server.
To configure TortoiseSVN for use with a proxy server, right-click your desktop, choose TortoiseSVN->Settings->Network, check "Enable Proxy" and enter the appropriate information. If unsure, contact your local system administrator.
  • You configured TortoiseSVN for use with a proxy server as described above. Now, checking out works fine, however on updates or commits, you get strange errors about failed requests.
Your proxy server is not forwarding SVN's WebDAV requests correctly.
To keep the proxy from interfering with the protocol, change your setup to use an encrypted connection:
  • Right-click on your source tree's top folder, choose TortoiseSVN->Relocate.
  • In the "to URL" edit field, modify http:// to read https://.
  • On the first connection, TortoiseSVN will display a warning message: TortoiseCertificateWarning.PNG
Click "Accept permanently" to continue.

See also