Skip to main content

Git

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

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

  • Git needs to be installed, download Git for Windows here: https://git-scm.com/download/win

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

    image.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 that show the file status.

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

E4010-0000020.png

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’.

E4010-0000030.png

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

E4010-0000040.png

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

  1. Choose Git as Source Control provider.
    E4010-0000050.png

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

  3. To commit the current state to the local repository click Commit… in the context menu of the solution.
    E4010-0000070.png

  4. After the commit a check symbol is shown in the projects view.
    E4010-0000080.png

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…
    E4010-0000090.png

  2. Choose Git in the Source Control Wizard.
    E4010-0000050.png

  3. 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.
    E4010-0000100.png

  4. The whole repository will be cloned to the local folder. After a successful clone, this dialog will be shown.
    E4010-0000110.png

  5. 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.

E4010-0000080.png

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
E4010-0000120.png Normal Not locally modified, no changes waiting for commit.
E4010-0000130.png Conflicted Indicates a conflict.
E4010-0000140.png Modified Modified, changes are waiting to be committed.
E4010-0000150.png Added Marked for addition, waiting to be committed.

 

 

Related to

Was this article helpful?