Subversion is a centralized version control system by Apache (https://subversion.apache.org/).
To get more information about Subversion, please have a look at the official Subversion online documentation: http://svnbook.org
Ranorex Studio uses two applications for working with subversion, which are installed with Ranorex Studio by default:
- SharpSvn
- Is a set of libraries for working with Subversion.
- TortoiseSVN
- It is a Windows shell extension for Subversion and provides icon overlays showing the file status in Ranorex Studio.
Ranorex Studio assists you with this dialog in case the required prerequisite is not present on the machine:
Add a Ranorex Solution to Subversion
Please make sure your Subversion infrastructure is set up and working.
To add an existing Ranorex Solution to Subversion, open the context menu of the solution. Go to ‘Source Control’ and click on ‘Add Solution to Source Control’.
To add a new Ranorex Solution to Subversion, check the option Add to Source Control in the New Project dialog.
The Source Control Wizard will be opened. Please follow these instructions:
-
Choose Subversion as Source Control provider.
- TortoiseSVN will ask for the URL of the repository.
- Authenticate yourself on the subversion server.
- Choose the folder in the repository you want to add your solution to.
- Check the files you want to have under source control and uncheck the files you don’t want to have under source control respectively
- The chosen files will be added to source control.
- Now, commit the changes to the Subversion server.
- The commit is done.
After performing these steps, your solution is under source control and your local copy is up to date.
Check out a Ranorex Solution from Subversion
Please make sure your Subversion infrastructure is set up and working.
-
Open Tools menu, move to Source Control, and click Checkout…
-
Choose ‘Subversion’ as Source Control provider in Source Control Wizard.
-
Enter the URL of your repository and specify the checkout directory.
-
The chosen project will be checked out.
Icon overlays in Projects View
Overlay icons are added to the items in the Projects View in Ranorex Studio, as the solution is under source control.
Icon overlays | |
Normal | Not locally modified, no changes waiting for commit. |
Conflicted | Indicates a conflict. |
Modified | Modified, changes are waiting to be committed. |
Added | Marked for addition, waiting to be committed. |
Options
In Ranorex Studio Options you can find options related to Subversion.
Open the main menu item ‘Tools’ and choose ‘Options…’. In the following dialog select folder ‘Tools’ and sub-item ‘Subversion Options’. By default, all checkboxes are checked. The currently used SharpSvn version can be found here.
Using another version of SharpSvn and TortoiseSVN
To use another version of TortoiseSVN and SharpSvn than the preinstalled ones, you have to download and install the version you want to use:
- Download and install TortoiseSVN first from http://tortoisesvn.tigris.org.
- After that download, the corresponding package for SharpSvn from https://sharpsvn.open.collab.net.
- Please make sure you choose the right version of SharpSvn, which matches the TortoiseSVN version.
- Extract the downloaded Version.
- Copy the extracted folder to ‘RanorexStudioAddInsSourceControlSubversionAddin’.
- Once you restart Ranorex Studio, the correct version of SharpSVN will be automatically chosen.