Introduction | Ranorex
HomeUser GuideRanorex Studio AdvancedRanorex SpyIntroduction

Ranorex Spy

Independent if started from within Ranorex Studio, or as a stand-alone tool, the Ranorex Spy provides all the functionality needed to explore and analyze desktop and mobile applications or websites under test – including their controls and UI elements. After starting Ranorex Spy, the element browser contains all currently running applications from your Windows desktop and mobile devices. Because of this exploration, you can derive the corresponding RanoreXPath of every identified UI-element and apply it to your automated software testing within Ranorex Studio.

In this chapter

    Necessary knowledge

    This advanced topic is strongly connected to the concept of RanoreXPath and the topic of UI-elements. Therefore, we recommend making yourself familiar with these two topics, prior to reading through this user guide chapter.

    Further reading

    The advanced concept of RanoreXPath is introduced and explained in detail beginning with > Ranorex Studio advanced > RanoreXPath > ⇢ Introduction.

    Further reading

    The advanced concept of UI-elements is introduced and explained in detail beginning with > Ranorex Studio advanced > UI-elements > ⇢ Introduction.

    Starting Ranorex Spy

    Ranorex Spy can be started from within Ranorex Studio, or as a stand-alone tool from within the Windows operating system.

    Starting Ranorex Spy from within Ranorex Studio

    Starting Ranorex Spy from within Ranorex Studio

    Start Ranorex Spy with the button in the Studio toolbar
    Start Ranorex Spy with the corresponding menu item in the Studio View menu

    Starting Ranorex Spy from within the repository

    Starting Ranorex Spy from within the repository

    Open Ranorex Spy with the EDIT IN SPY button in the repository item line
    Starting standalone version of Ranorex Spy

    Starting standalone version of Ranorex Spy

    Open Ranorex Spy as standalone version from within the Windows Start menu
    tipp icon

    Hint

    Ranorex Spy is currently available as 32-bit and as a 64-bit version. When started from within Ranorex Studio, the 32-bit version is started. When started as a stand-alone version, the architecture selection is your choice.

    Ranorex Spy working environment

    The Spy working environment looks a little different depending on from where it was started (stand-alone v.s. from within Ranorex Studio). This section introduces the basic working environment with its 6 main areas in an overview. The detailed description follows in the subsequent chapters where functions and applications are introduced with examples.

    Ranorex Spy working environment - overview

    Ranorex Spy working environment – overview

    Browser / repository selector: The stand-alone version of Spy is able to load and handle self-contained repositories. Here you can switch between the two modes
    Track button & RanoreXPath information. The track button is used to track, identify and add new UI-elements where the RanoreXPath line displays their uniqe specification
    Switch between UI-element browser tree and the path editor: both working environments are explained in detail further on
    UI-element browser tree: tree-like overview of UI-elements identified within the graphical user interface
    UI-element details: detailed information of UI-elements including properties and graphical information
    Image navigation area: enables to navigate through UI-elements