Checking out Tortoise SVN Client

  1. Click on the Source Code tab
  2. On the right hand side of the page there is a section called Source Control Setup
  3. Click on the link for Subversion
  4. There will be a popup with credentials and information - The URL that is listed in that page will be used to download the files in later steps. SourceCode.png
  5. Click on the Using SVN with CodePlex. page and follow the link to download and install Tortoise SVN. ( I downloaded the 64 bit client *.msi file ).
  6. Follow the setup wizard which installs a command script to your machine. At the end of the setup you will need to reboot your machine.
  7. After restart, open Windows Explorer.
  8. Create a directory for your project
  9. Right click on the directory and you should see two new options on the menu SVN Checkout... and Tortoise SVN. If you don't see these option, Tortoise did not install properly. You may have to run the install again to repair it, or uninstall and install again. There is a note on the download site that there is a known bug with install and it might take a couple of tries to install it... It took me 3
  10. Click on the SVN Checkout... option on the right click menu. You should see a popup for checking out the source tree. SVNCheckout.png
    1. Paste the Url previously mentioned in step 4. Or type in https://bostonazure.svn.codeplex.com/svn/BostonAzureSite
    2. To check that you have the right path, you can click on the folder button .... You should see two subfolders (source and test)
    3. Make sure your checkout directory is set to the directory that you created in the previous step
    4. Checkout Depth should be set to "Fully recursive"
    5. Omit externals is unchecked
    6. Revision should be set to HEAD
    7. Click OK to start checkout.
    8. Checkout will take a few minutes since there are many images from firestarter. See dicussion board for project ideas to move images into blob storage
  11. When checkout is finished you can double click on the BostonAzureSite.sln file to launch it in Visual Studio or Visual Web Developer Express
  12. F5 to run the application.

Updating Source

Once you've got a tree checked out locally, you'll want to update the code tree on a regular basis (maybe not so much at first, but as people start to contribute, you want to make sure you're code is in sync). When you right click on your project directory folder, you will now see 3 options: SN Update, SVN Commit... and Tortoise SVN. The Tortoise SVN menu option contains a submenu of SVN tools for managing and merging files.

To update:
  1. Click on the root folder of the project in Windows Explorer and click on the SVN Update option.
  2. SVN will take care of merging changes with your local files.
  3. If there are conflicts SVN will mark files and inform you. You can use the Merge... tool that can be found on the Tortoise SVN menu in Windows Explorer SVNTools.png

Checking in code

Currently you must have the proper credentials to check in code. If you are able to check in code, here's how
  1. It's always good measure to do an update on your local source tree to see if there have been any changes and conflicts. SVN will complain and prevent you from checking in any files if you have a conflict or a file is out of date when you try to check in code that has not been made up to date.
  2. Right click on a file, subfolder or root folder of your local source tree.
  3. A popup will display any files that are out of sync. Additionally, there are options to add new files (unversioned) to the codeplex project. Do Not Ever check in compiled files or output files that were created during compilation. SVNCommit.png
  4. Select the files that you want to check, add a commetn in and click OK button
  5. SVN may prompt you for credentials for check in.

Applying patches

TBD

Last edited Jun 24, 2010 at 3:48 PM by joanlinskey, version 4

Comments

No comments yet.