Welcome to the Ranorex Support Portal


In this chapter

About Git and Ranorex Studio

Git is a distributed version control system which is free and open source.

In order to use Git as a source control provider in Ranorex Studio, the following preconditions have to be fulfilled in the given order:

Please make sure you choose to ‘Use Git from the Windows Command Prompt’ during Git installation!

This image has an empty alt attribute; its file name is E4010-0000010.png
  • TortoiseGit needs to be installed
    Download TortoiseGit here: https://tortoisegit.org/downloadTortoiseGit is a Windows shell interface to Git and is needed, for example, to overlay icons which show the file status.

Ranorex Studio will assist you with this dialog in case the required prerequisite is not present on the machine:

Add a Ranorex Solution to Git

Please make sure your Git infrastructure is set up and working.

To add an existing Ranorex Solution to Git, open the context menu of the solution. Go to ‘Source Control’ and select ‘Add Solution to Source Control’.

To add a new Ranorex Solution to Git, check the option ‘Add to Source Control’ in the ‘New Project’ dialog.

The ‘Source Control Wizard’ will be opened.
Please follow these instructions:

  1. Choose Git as Source Control provider.

  1. The Ranorex solution is automatically configured as a new local Git repository. All files are indicated with a plus sign in the projects view.

  1. To commit the current state to the local repository click Commit… in the context menu of the solution.

  1. After the commit a check symbol is shown in the projects view.

All further Git related steps should be defined in your workflow.

Check out a Ranorex Solution from Git

Please make sure your Git infrastructure is set up and working.

  1. Go to Tools > Source Control > Checkout

  1. Choose Git in the Source Control Wizard.

  1. TortoiseGit will ask you for the path to the repository and where you would like to store the files on your local machine. Fill in the URL to the Git repository as well as the path to the local directory and click OK.

  1. The whole repository will be cloned to the local folder. After a successful clone this dialog will be shown.

  1. In case your repository includes a Ranorex Solution in its root, this solution will be opened automatically. If this is not the case, you have to open the Ranorex Solution manually from the file System.

After opening the Ranorex Solution from the local folder you see the icon overlays in Projects View.

All further Git related steps should be defined in your workflow.

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
NormalNot locally modified, no changes waiting for commit.
ConflictedIndicates a conflict.
ModifiedModified, changes are waiting to be committed.
AddedMarked for addition, waiting to be committed.



Get the latest test automation information right in your mailbox.


© 2024 Ranorex GmbH. All Rights Reserved