Subversion

Subversion is a centralized version control system developed by Apache. For more information, see the official Subversion website and documentation.

Ranorex Studio uses two applications for Subversion integration, both of which are installed by default with Ranorex Studio:

• SharpSvn: A library set used to work with Subversion.
• TortoiseSVN: A Windows shell extension for Subversion that provides icon overlays to show file status in Ranorex Studio.

If a required prerequisite is missing, Ranorex Studio will display a dialog to assist you:

Before you begin, make sure your Subversion infrastructure is set up and working properly.

To add an existing Ranorex solution to Subversion:

1. Right-click the solution.
2. Go to Source Control.
3. Click Add Solution to Source Control.
   

The Source Control Wizard will be opened. Follow these steps:

1. Select Subversion as the source control provider. 
   
2. Enter the repository URL when prompted by TortoiseSVN. 
   
3. Authenticate on the Subversion server. 
   
4. Select the repository folder where you want to store the solution. 
   
5. Select the files you want to place under source control and clear the files you do not want to include. 
   
6. Add the selected files to source control. 
   
7. Commit the changes to the Subversion server.
   

After completing these steps, your solution is under source control, and your local copy is up to date.

Before you begin, make sure your Subversion infrastructure is set up and working properly.

1. Open the Tools menu, Source Control, and click Checkout...
   
2. In the Source Control Wizard, select Subversion as the source control provider.
   
3. Enter the URL of your repository and specify the checkout directory.
   
4. Enter the repository URL and specify the checkout directory.
   

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.

Ranorex Studio provides options related to Subversion.

To open them:

1. Open the Tools menu.
2. Click Options...
3. In the dialog, select Tools > Subversion Options.

By default, all checkboxes are selected. You can also find the currently used SharpSvn version here.

To use a different version of TortoiseSVN and SharpSvn than the preinstalled versions, follow these steps:

1. Download and install TortoiseSVN from the TortoiseSVN website. 
2. Download the corresponding SharpSvn package. 
3. Make sure the SharpSvn version matches the installed TortoiseSVN version. 
4. Extract the downloaded package. 
5. Copy the extracted folder to:
   RanorexStudioAddInsSourceControlSubversionAddin 
6. Restart Ranorex Studio.