This page shows release notes for major, minor and bugfix releases of Ranorex.

For features planed to be implemented in the near future, see the Product Roadmap.
For releases prior to 2015, see the Release Notes Archive.

Ranorex 7.0.0 Release (March 29, 2017)

Major features

  • WPF: More intelligent and comfortable object recognition for standard and third party controls
    Frequently asked questions
  • Web Testing: Added support for Microsoft Edge, Safari (macOS), Chrome (Linux) and Firefox (Linux) in web test automation through WebDriver integration
  • Test Suite: Improved behavior and structure, both in test suite and report, to better comply with JUnit report format

General changes/Features

  • Introduced new automation root switching, which directs element recognition and test execution to the selected endpoint (mobile device or Selenium hub)
  • Added a warning when performing mouse/pointer actions outside an element's boundaries caused by a relative location
  • The "Open Browser" recording action now allows to turn on "Kill Existing" and "Clear Cookies" options
  • The test suite now provides an option to generate an additional report file in JUnit format
  • Improved merging of repository items into an existing repository if moving/copying a recording from one project to another
  • Introduced "smart folder" in the test suite that allows grouping, iteration, and data binding without counting as a test case
  • Support iterating test cases and smart folders without the need for data binding
  • Improved visual appearance and usability of the Studio start page
  • Ranorex agents no longer use port 29189 for communication, but rely solely on port 8081

Bugs

  • Fixed offset issues with screenshots taken from mobile devices if hidden screenshot capturing is turned off
  • Fixed module group descriptions not being shown in the report
  • Fixed opening compressed reports more than once if they contain read-only files
  • Fixed a possible unhandled exception in Studio when trying to add COM references
  • Fixed problem that user code methods may not be available from a user code library which is also the base class of a recording

Known issues

  • You may experience small performance lags in the test suite editor when copying/moving large structures within a test suite, e.g. when dragging these structures or when navigating through the test suite and pasting the copied nodes.
  • Please note that support for various actions depends on specific WebDriver implementations, which may cause specialized operations to fail on specific browser/platform combinations.
  • The currently released Safari driver implementation is known to be unstable when executing tests. If test runs fail, check the WebDriver log file to find out where the problem occurred.
  • There is a known issue with the IE driver that causes KeySequence actions to be slow and ultimately run into a timeout when automating via WebDriver (see github.com)
  • Object recognition may fail for WPF applications if the application itself hosts a .NET Remoting service

Breaking changes (to 6.X)

  • Nesting a test case in another test case is not allowed anymore -> use smart folders instead of test cases
  • Running Studio or tests on Windows XP will show a technology limitation warning that Windows XP support will be dropped in a future Ranorex version
  • Licensing: when executing multiple test runs in parallel, each run/process requires its own runtime license
  • The report transformation file (xslt) as well as the stylesheet (css) file have changed due to a new layout as well as due to changes in the report data file. Custom reports created with previous versions (e.g. Ranorex 6.2) might not be fully compatible with the new format. Learn how to update your custom report here:
    Upgrading custom report files to 7.0.
  • Changes in the Testing and Reporting API

Ranorex 6.2.1 Release (January 18, 2017)

General changes/Features

  • Improved reliability of Android OS automation
  • The difference image functionality now shows a warning if the images are not of the same size
  • Improved update of Ranorex Studio build error messages if there are errors in user code files

Bugs

  • Fixed broken screenshot paths in report data file when Unicode characters are used
  • Fixed GDI/RawText object recognition issues if Windows 10 Anniversary Update is installed
  • Fixed instrumentation of iOS IPA files containing invalid windows filename/path characters
  • Fixed installation of the unpacked chrome extension when loaded from the default Ranorex installation path
  • Fixed UI layout in "Choose Technology" dialog if manifest files are not installed
  • Fixed Ranorex Studio using statements being reordered after every build
  • Fixed decimal representation of integer values shown by the Ranorex Studio debugger

Ranorex 6.2.0 Release (November 30, 2016)

General changes/Features

Bugs

  • Fixed InvokeAction "CallMethod" on android activity elements
  • Fixed issue where report is not copied when directory is outside of project bin folder
  • Fixed issue where module group is deleted if a recording module with the same name is added
  • Fixed automation projects not running if targeting .NET 4.5.2 with Ranorex Studio
  • Fixed memory leak caused by agent logging (Ranorex Remote Agent 1.0.55)

Known issues

  • GDI/RawText recognition on Windows 10 Anniversary Update may fail or cause errors in applications
  • CEF:
    • Chrome Debugging Protocol in version 1.0 is not supported, because GetNodeFromLocation() function is missing. Therefore tracking is not working
    • Zoom is currently not supported
    • In WPF containers, EnsureVisible might not work as expected if multiple tab controls are used
    • When using Electron with 2 or more tabs/DOMs, recording does not work
    • When using hardware-accelerated rendering, the screenshot creation will generate a black image. Turn off “hidden screenshot capturing” to avoid this behavior

Breaking changes

  • UserCode methods expect a new alias for the System.Windows.Forms namespace. This can cause compile errors in user code classes after an upgrade complaining about "ambiguous references", e.g. between System.Windows.Forms.Control and Ranorex.Control
    -> remove any existing "using System.Windows.Forms;" statement at the top of the file and prefix the ambiguous reference with either "WinForms." (most likely) or "Ranorex." depending on whether you want to reference a System.Windows.Forms or Ranorex type
  • Removed support for Firefox non-ESR (Extended Support Release) versions: 32-37,39
    -> stay with your current Ranorex installation if you need to automate those Firefox versions
  • The binary compatibility for code using the GlueRuleExecutionState class could not be maintained. This class should usually only used by custom technology plugins by classes inheriting from LineageGlueRule
    -> recompile the code with the current Ranorex release

Ranorex 6.1.1 Release (October 19, 2016)

General changes/Features

Bugs

  • Fixed the "name" attribute not returning the specified "rx-name" data value for some SWT widgets (Tree-, Tab-, ListItem)
  • Fixed setting the time value on iOS UIDatePicker controls
  • Fixed screen rectangle calculation of Qt Quick elements hosted within a Qt widget
  • Fixed image based clicks to throw an ImageNotFoundException if the element changes its look on hovering
  • Fixed a possible deadlock in the report infrastructure when starting a test suite
  • Fixed issues with relative paths to custom report templates outside of the project directory
  • Fixed the default value of the "Use Cache" setting for repository entries corresponding to Win32 context menus
  • Fixed possible exceptions being thrown if the solution settings files is read-only and a setting is changed
  • Fixed a possible exception when using custom package sources in Studio's Package Management
  • Fixed a possible NullReferenceException when Studio saves the solution preferences
  • Fixed loading solutions with cyclic references, e.g. where the solution file is referenced in a project
  • Fixed a memory leak when editing large code files in Studio
  • Fixed the solution settings file not being included when zipping a solution
  • Fixed setting the StartUp Project in Studio
  • Fixed the solution settings not being used if a single recording is run
  • Fixed the expanded/collapsed states of entries in the Module Groups view to be correctly saved

Ranorex 6.1.0 Release (September 1, 2016)

General changes/Features

Bugs

  • Fixed Exception when adding keys in license manager if no ranorex runtime is installed
  • Fixed issue where no variable was created when dropping items from spy into code module
  • Fixed AccessViolationException that may be thrown during a test run
  • Fixed XMLException when loading invalid studio layout
  • Fixed caching behaviour resulting in "Failed to update the cached element for folder..."
  • Fixed issue where multiple unused iproxy processes keep running when using iOS automation which could led to unstable usb connection

Known issues

  • Issue where WPF elements could show up multiple times in the UI tree
  • Title could not be retrieved for some form elements on Android 7
  • Ranorex Studio and Tools require hotfix for .Net Framework 4.0 (or 4.5 installed) http://support.microsoft.com/kb/2468871
  • Issue where icons are not updated correctly when adding a new solution to TFS Source Control

Ranorex 6.0.2 Release (August 11, 2016)

General changes/Features

  • Improved support for Windows 10 with Anniversary Update (version 1607)

Bugs

  • Fixed iOS device disconnect when automating controls with a massive amount of characters
  • Fixed support of dynamic accessibility (MSAA) actions and attributes for controls with non-default MSAA implementations
  • Fixed object recognition for SAP modal dialogs running in a "SapGuiServer" process
  • Fixed "Visible" attribute value for cells in some WinForms ListView controls in details mode
  • Fixed recognition of WPF controls with borders that are not using a SolidColorBrush
  • Fixed copying/pasting of multi-line text in the recorder action table pasting only the first line
  • Fixed an InvalidCastException that may be thrown when opening a view in Studio
  • Fixed module groups not being highlighted in module browser when being selected in the test suite
  • Fixed performance issue in Studio when building single projects or adding a new project
  • Fixed Studio loading code-completion information for assemblies in the GAC
  • Fixed the "Show Progress Dialog" checkbox to be unchecked for the test suite when saving test case properties
  • Fixed code files not being added to SVN automatically for projects under source control

Ranorex 6.0.1 Release (June 29, 2016)

General changes/Features

  • When running tests on remote agents and connecting via Remote Desktop (RDP), it is now allowed to close the RDP window without affecting running tests
  • Improved presentation of upgraded files to show a similar structure as in Studio's project browser

Bugs

  • Fixed recognition of Flex applications with SWF version 31
  • Fixed object identification problems with specific GDI controls in 32bit applications on Windows 8 (and higher)
  • Fixed resigning of Xamarin iOS apps so instrumented apps are deployable to iOS devices
  • Fixed instrumented Xamarin apps crashing at startup on 32bit iOS devices
  • Fixed custom report templates not being copied to remote agents
  • Fixed issue where agents could not be discovered in certain domain setups
  • Fixed possibility that a wrong test suite file is used by the remote agent if there are multiple test suite files in the project output directory
  • Fixed ReportEnvironment.ReportZipFilePath to return the correct path to the zipped report
  • Fixed a memory leak (possibly causing OutOfMemoryException) when adding items to a repository
  • Fixed "RxWeb MS Dynamics CRM" weight rule causing an infinite loop for some CRM DOM elements (causing snapshot creation to get stuck)
  • Fixed solution reloading dialogs to pop up repeatedly when virus scanners are scanning the solution file
  • Fixed possible NullReferenceExceptions and InvalidOperationExceptions when closing Studio
  • Fixed a possible InvalidOperationException when the Studio layout is saved
  • Fixed upgrading of solution files if the files have Unix style line endings
  • Fixed possible InvalidOperationExceptions and NullReferenceExceptions when viewing read-only files in Studio
  • Fixed Ranorex Studio to correctly open solutions/projects created with Visual Studio
  • Fixed a possible unhandled Win32Exception when starting a recording without debugger
  • Fixed Studio to load projects containing files without extension
  • Fixed a possible NotImplementedException caused by the Local Variable Pad during debugging
  • Fixed a possible IndexOutOfRangeException when updating the status of Git controlled files in Studio
  • Fixed file views staying read-only after debugging in SVN controlled solutions
  • Fixed a possible exception when renaming a module to an existing test case name
  • Fixed a possible NullReferenceException when opening the properties of a test case
  • Fixed a performance issue when opening test suite/case properties in huge solutions
  • Fixed License Manager Tool crashing on startup if the highest installed .NET Framework is 4.0

Ranorex 6.0.0 Release (May 10, 2016)

Major features

General changes/Features

  • The "Open Browser" action now allows to bind the "Incognito Mode" option for data driven tests
  • The (relative) coordinates for the location of mouse actions are now only shown if the action is selected to avoid misunderstandings
  • It is now possible to drag & drop multiple repository items to a recording at once to add new actions
  • Improved the snapshot creation process by showing its progress and warning user to not manipulate the target application
  • Added functionality to zip the current solution within Ranorex Studio (Tools -> Zip Solution)
  • Upgrading of files, projects, and solutions has improved, creates a backup, and shows an upgrade report
  • The structure of test suite files changed to minimize merge conflicts and improve conflict resolutions when using version control
  • Version numbers in Ranorex binaries are limited to "Major.Minor" now to minimize code changes between service releases
  • Links in Ranorex Studio are now always opened in the system's default browser
  • The device pad in Studio now allows to deploy an app to a device
  • Studio now provides a global switch whether to run test/module execution with or without debugger (default: without debugger)
  • Improved way to move modules into and out of the Setup/Teardown section of a test case
  • Added new functionality to "Auto-Create" parameters and module group variables for unbound module variables in test cases and module groups, respectively
  • The shortcut to add a new module group changed to Ctrl+M
  • The shortcut to run modules (recording and code modules) changed to Ctrl+Shift+R
  • The name of technology limitations is now logged to the report *.data file to allow ignoring the limitation using code
  • The Link role now supports an "Url" attribute containing the URL the link points to
  • The default formatting of duration now only uses milliseconds as a unit for values smaller than 1 second (instead of 10 seconds)
  • Setup now allows to not install manifest files for Ranorex tools, thereby allowing SAP automation on UAC enabled systems
  • Added possibility to change the idle time after which floating licenses are automatically released

Bugs

  • (Invisible) left-to-right and right-to-left marker characters are ignored in RanoreXPaths
  • Fixed a possible memory leak caused by repeatedly connecting to mobile devices
  • Setting an attribute value on iOS UITextField controls now triggers delegates registered on the control
  • The PreferredSize property of Windows Forms controls is no longer shown in Ranorex Spy to avoid frequent problems in AUTs
  • When switching to a custom report template, the template is added to the solution to fix relative issues
  • Made "Jump to Item" work even if the target file is not within an opened solution in Ranorex Studio
  • Fixed report not being generated if specifying a report file without "rxlog" extension from the command line
  • Fixed screenshots not being shown if the report filename is too long
  • Made sure that aborted test runs do return the correct state "Aborted" and not "Success"
  • RanoreXPath changes of a repository item are now correctly saved when clicking on the horizontal scroll bar in the repository editor while editing the path
  • Fixed possible unhandled exception when editing properties of multiple selected repository items at once
  • Fixed "Navigate Back" toolbar entries to have a meaningful text value
  • Fixed code completion in derived classes not always being available for newly created members of base classes
  • Fixed Cut & Paste in test case descriptions to work the same as Copy & Paste (not converting the RichText to plain text)

Known issues

  • Recordings are currently always run as 32bit processes which could cause elements not to be found in .NET applications that specifically target 64bit processors

Breaking changes (to 5.X)

  • The .NET Framework 4.0 (or higher) is now required for both Ranorex tools and runtime (automation of .NET 2.0 applications is still supported)
  • Due to .NET 4.0 being the minimum target for Ranorex projects, Ranorex.Control.InvokeRemotely calls on .NET 2.0 applications may be broken -> all methods used in InvokeRemotely calls need to reside in a separate project/DLL that targets .NET 2.0/3.5
  • Due to the underlying SharpDevelop update within Ranorex Studio, debugging of 64bit applications is not supported any more -> choose "32-bit processor" as Target CPU in your test suite project "Compiling" properties
  • Removed support for SVN 1.6 from Ranorex Studio
  • Studio no longer builds projects that are not part of the solution even if their output assemblies are referenced in the solution -> add all projects you want to be built to the solution
  • Adding and removing test cases to/from a test suite using the Ranorex API now requires a Premium license
  • The Ranorex.Validate.CreateScreenshot enum is now marked as obsolete -> use the Ranorex.Validate.ResultOption enum type instead
  • A few properties in the Ranorex.Plugin.WpfFlavor were marked as obsolete -> use the corresponding properties in the Ranorex.Plugin.UiaFlavor instead
  • We removed methods already marked as obsolete and marked some more methods obsolete in the following classes which are intended for internal use only: Ranorex.Core.StringTools, Ranorex.Core.Util
  • The SubscribeEvent/UnsubscribeEvent methods (together with all dependent framework classes) were removed from Element, Adapter, and all specialized adapter classes, since they were non-functional
  • The formerly embedded manifests for Ranorex tools are now separate files in the installation directory -> for XCOPY deployment one needs to copy all *.manifest files in the Ranorex "<installation folder="">\bin" directory as well</installation>
  • The name of the folder where screenshots are placed for a report had to be changed (to enforce a character limit). The folder name now contains a hash value of the report name and is not equal to the report name any more (still, if the report name is constant, i.e. does not contain placeholders, then the screenshot folder name is also constant) ->
    Option 1: use the Ranorex.Report.Copy method to copy the entire report to another destination
    Option 2: use the compressed report format and (optionally) unzip the report in the destination folder with the Ranorex.ReportViewer.exe using following command line:
    <Ranorex_Installation_Folder>\bin\Ranorex.ReportViewer.exe /unzipreport <reportFileName>.rxzlog
  • For a summary of changed APIs see API changes

Ranorex 5.4.6 Release (March 24, 2016)

General changes/Features

  • Added support for iOS 9.3

Bugs

  • Fixed possible unnecessary creation of a large number of worker threads in Java AUTs when using PopupWatchers or when AppFolder caching is disabled in the repository
  • Fixed Qt recognition of windows created with QWidget::createWindowContainer
  • Fixed recognition of items in standalone toolbars of type "SAP.Toolbar.1"
  • Fixed button rectangle offset issues occurring with some SAP themes
  • Fixed object recognition of popups in IE with enabled addon
  • Fixed report sometimes not being opened after executing a test suite if the test suite Report File Directory points to the Reports directory of the project
  • Fixed repository screenshots sometimes showing Ranorex Studio instead of the actual item if tracking behind Studio
  • Fixed renaming of a solution node in Studio's projects pad from appending or removing "solution" to/from the name
  • Fixed a potential AccessViolationException when quickly closing multiple reports in Ranorex Studio
  • Fixed a potential InvalidOperationException when clicking on "Preview Effective Data Set" in the data source dialog
  • Fixed renaming of data connectors if you just change their name (Apply button did not get enabled)

Ranorex 5.4.5 Release (January 29, 2016)

General changes/Features

  • Added support for instrumenting iOS Swift apps
  • Added support for QQuickWidget and QGraphicsWebView Qt controls

Bugs

  • Fixed unhandled exception on startup of internal PerformanceLogger
  • The 'name' attribute of Java AWT/Swing windows is returned if available, but by default not used in RanoreXPath
  • Fixed unhandled exception in the new recording dialog if a device connection times out
  • Fixed exception when instrumenting an iOS IPA file with a dot in the CFBundleExecutable name of its Info.Plist
  • Fixed instrumentation of iOS IPA files containing additional framework assemblies (Swift, Cocoa, ...)
  • Fixed instrumentation of iOS IPA files with a mobileprovision file containing empty open/close tags
  • Fixed retrieval of dynamic attribute values for QGraphics items
  • Fixed WebDocument.Close method to work for DOMs in Edge
  • Fixed setting the InnerText value of textarea elements in Firefox to work correctly
  • Fixed JS dialog windows in Firefox to be correctly identified
  • Fixed the IE addon not being used for non-top level DOM elements (residing underneath the IE form element)
  • Removing an argument from a user code action using the argument editor no longer causes renaming of other arguments
  • Fixed unhandled exceptions that may be thrown when invoking a touch on an element using Spy's image navigator
  • Fixed a possible NullReferenceException when removing a node in the test suite editor

Ranorex 5.4.4 Release (November 18, 2015)

General changes/Features

  • Updated Firefox addon included in setup to v1.0.2 (for offline installation)
  • Updated the adb (Android Debug Bridge) tool used for USB connections to Android devices to v1.0.32

Bugs

  • Fixed starting and stopping of iOS apps compiled specifically for iOS 9
  • Fixed EnsureVisible on WPF scrollbar using the UIA plugin to cause unnecessary scrolling of parent container

Ranorex 5.4.3 Release (October 20, 2015)

General changes/Features

  • Added support for Android 6

Bugs

  • Fixed a possible deadlock when logging and using Report.Sceenshot/Snapshot from different threads at the same time
  • Fixed updating the cached element of rooted repository folders for child items with "//" (self-or-descendant axis) in their path where the "self" axis contains the result element
  • Fixed object recognition in Firefox 40+ if started in incognito mode
  • Fixed wrong error/warning count in report if TestReport.Save is manually called multiple times
  • Fixed references to CSV data source files sometimes being lost when opening a solution in Ranorex Studio

Ranorex 5.4.2 Release (September 17, 2015)

Ranorex 5.4.2 Release (September 17, 2015)

General changes/Features

  • Added support for Firefox 41 (and higher)
  • Added support for iOS 9
  • Added support for Edge to recording actions
  • Added support for Chromium to recording actions and instrumentation wizard
  • Added API methods to load and save snapshots from code (ElementSnapshot.CreateFromFile/SaveToFile)
  • Added support for Deep Links in RxBrowser on Android

Bugs

  • Fixed WPF object recognition if AUT has registered IPC remoting server channels
  • Fixed validations and string serialization to work correctly with complex Java attributes
  • Fixed geometry issues with Android web automation in RxBrowser with WebView 44 and higher (shipped with Android 5.1.1)
  • Fixed geometry issues with iOS web automation in RxBrowser for special cases e.g. when the title bar is visible
  • Fixed a potential deadlock when tracking/searching an element in IE 8 on Windows 7
  • Fixed automatic naming of repository items for WPF elements to use the AutomationID attribute
  • Fixed floating licenses not being reacquired from the Ranorex License Manager after a network connection loss
  • Fixed the Argument Editor not commiting changes of argument values for user code methods stemming from a base class
  • Fixed report sometimes not being opened after executing a test suite if the test suite Report File Directory points to the Reports directory of the project
  • Fixed the order of projects in a solution file always being reversed when opening a solution

Ranorex 5.4.1 Release (August 25, 2015)

General changes/Features

  • Added support for Firefox 40
  • The report now signals modules with errors using an error icon
  • Spy now allows canceling the element tree UI update (useful when a search results into many elements being found)
  • The test progress window opacity can now be set (using the ProgressForm.Instance.SetOpacity(int) method)
  • Updated the apktool used for instrumenting Android apps to v2.0.1
  • Added support for Qt 4.6/4.7 x64-msvc
  • Changed the behavior of links on the Ranorex Studio start page to open with the system's default browser

Bugs

  • Fixed mouse moves/clicks possibly throwing an exception for menu items in multi-monitor scenarios if monitors are not aligned
  • Added overload for Configuration indexer to allow building with default references (e.g. Configuration.Current["configName"])
  • Fixed Imaging.Find method returning only a single match in most cases
  • Fixed setting the Form.State property for Windows 10 Modern UI Apps when the app is minimized
  • Fixed JavaFX elements reflecting table cells not returning useful text
  • Fixed connection losses to SWT applications caused by unhandled runtime errors
  • Fixed a possible memory leak in the "RunMobileApp" recording action
  • Fixed the touch coordinate calculation on iOS when the system title bar is visible
  • Fixed recognition of Accessible.Name/Description in QtQuick applications if set via QML
  • Fixed the application icon for some Windows Modern UI Apps being distorted or not correctly colored
  • Fixed the WebDocument.Browser property to correctly return the associated Form element for Edge DOMs
  • Fixed web elements getting invalid after 5 minutes of idle time
  • Fixed EnsureVisible to select the correct IE browser tab page if the DOM title is empty
  • Fixed Chrome DOMs sometimes showing up twice in Spy if an empty tab is open
  • Fixed the TextArea.MaxLength attribute sometimes not returning a value for IE DOMs
  • Fixed getting control names for 64bit Delphi applications
  • Fixed an unhandled exception when trying to close the Licensing application and an invalid Floating license server is configured
  • Fixed the variable editor in recordings to create variables with the same name (causing an exception on closing the editor dialog)
  • Fixed the variable editor dialog not responding in Spy if "Always on Top" is enabled on Windows 8 or higher
  • Fixed validation screenshots in repositories to not get a new unique ID on copying the associated repository item, causing renaming, finding references, and cleanup to not work correctly
  • Fixed the "Show Progress Dialog" test suite option to get disabled if you change properties of a test case
  • Fixed a few rare cases where updates were not correctly applied when editing repository items in Spy
  • Fixed test modules not being opened when double-clicking them in the test suite view if they reside in a referenced project
  • Fixed a potential Studio hang when rebuilding a solution with a lot of project references
  • Fixed a rare case where bindings are lost if editing test case properties
  • Fixed a performance and memory issue when opening the Manage Data Sources dialog for test suites having a lot of connectors
  • Fixed Excel connector auto-range to not include ranges without real values (e.g. formatting only)
  • Fixed regression that the value of the parameter is used instead of the data column value, when a test case uses a data column and a parameter with the same name is defined in it or one of its parent test cases

Breaking changes (to 5.4.0)

  • The support for Firefox 40 (and higher) and Chrome got consolidated to a common technical base implementation. Consequently, all attribute values returned for those browsers are identical now. This caused the following breaking changes within Firefox support: InnerText always returns an empty string (instead of former null) if not set. TagValue always returns null (instead of former empty string) if not set.

Ranorex 5.4.0 Release (July 02, 2015)

Major features

  • Added native support for Java SWT
  • Added native support for JavaFx (version 2.0 and higher)
  • Added support for Windows Apps in Windows 10
  • Added preliminary support for the Microsoft Edge browser

General changes/Features

  • Added possibility to mask confidential data used in actions and variables within the recorder and the report
  • Image validations can now log the actual similarity of the images to the report
  • Image comparisons can now log difference images to the report
  • Added a Validate.Fail method that facilitates marking a test case as failed using code
  • Added "VersionCode" and "VersionName" attributes to the iOS/Android MobileApp capability providing the apps version
  • Added possibility to mock GPS location on Android devices
  • Added possibility to enable/disable Bluetooth on Android devices
  • The "Run Mobile App" action now allows to specify whether to restart the app or just bring it to the foreground
  • The instrumentation wizard now allows deploying the RxBrowser and Ranorex service app also onto iOS
  • Improved error messages and tracing for iOS app instrumentation
  • Added support for Firefox 39
  • WinForms ListView items now provide attributes "GroupHeader" and "GroupName" to identify the group they belong to
  • Added support for left-handed copy & paste shortcuts (Ctrl+Insert & Shift+Insert)
  • Floating licenses are now automatically released after 5 minutes of idle time (newest Ranorex License Manager required)
  • When selecting a user code action, the linked repository item is now selected in the repository editor
  • The "Open Browser" recorder action now allows clearing the browser cache and starting in incognito mode
  • The Host.Local.OpenBrowser method additionally allows to clear browser cookies
  • Added an option to select how action time is displayed in the report (relative time or wall clock)
  • The data binding information logged to the report is now collapsible
  • Studio now disallows naming new files/classes in a way which can cause compile conflicts with Ranorex API classes (e.g. "Validate")
  • Added a test suite property that allows changing the quality of tracing screenshots

Bugs

  • Fixed Studio to create the Ranorex sample projects in the user-specific default project location
  • Fixed EnsureVisible for some Android material style apps
  • Fixed a potential exception when replaying a touch on the RxBrowser Android app
  • The element tree created by the WPF plugin no longer contains duplicate entries (which caused snapshot creation to take very long time)
  • Fixed the "Connection to License Manager Lost" dialog being on top of all applications instead of only modal for the Ranorex application
  • Fixed the "New File" dialog in Studio jumping to the start of the file name when a space is entered
  • The test suite file no longer contains references to assemblies from projects which are not actually referenced by the test suite project
  • Fixed changes in the test suite properties dialog being saved although you hit cancel
  • Fixed the Variables dialog in Spy's repository editor not being shown correctly on Windows 8 (and higher) if "Always On Top" is enabled

Known issues

  • Due to additional processing needed to filter the element tree, the WPF plugin may be slower when compared to previous versions
  • If a test case uses a data column and a parameter with the same name is defined in it or one of its parent test cases, the value of the parameter is used instead of the data column value
  • The logging of the KeySequence action omits the tick (') characters around the actual value, causing a change of the associated code file

Breaking changes (to 5.3)

  • The .NET 4.0 Framework is automatically installed by the Ranorex setup executable -> for now, you can use the Ranorex-5.4.0.msi file to install Ranorex without installing prerequisites. The .NET 4.0 Framework will be required for the next major version, though
  • As the native Java SWT support is switched on by default, existing RanoreXPaths formerly created on Java SWT applications no longer work -> it is highly recommended to use the new native support for Java SWT which should highly increase object recognition stability. As a short-term alternative you can enable the old legacy behavior by enabling the "Use Java SWT legacy automation mode" plugin setting
  • As the WPF plugin no longer creates duplicate elements, RanoreXPaths formerly created on such duplicated elements are now invalid. This should not be the case for automatically created RanoreXPaths, but only for manually altered ones -> fix such RanoreXPaths by tracking the respective WPF element again
  • In reports, the data binding information containing all data row values is now collapsed by default. Still, all values of bound variables are logged as the first message for every module -> if you want the data binding information not to be collapsed, create a custom report and change the '<xsl:template match="datarow|params">' part of the RanorexReport5.xsl file to fit your needs </xsl:template>
  • Some Ranorex classes in the Ranorex.Core assembly, which were public, but not documented and not intended for public use,were moved to Library DLLs -> if you use such internal APIs, you have to add references to the Ranorex.Libs.* assemblies in order to build your Ranorex projects. Note though, that some of these APIs are marked as obsolete and will be removed in future versions of Ranorex
  • Ranorex now ignores all controls where a Ranorex internal control is hosted, e.g. all controls in a process that shows the test suite progress window. If you have an AUT hosted by the same process that drives the test, the AUT will not be recognized -> separate AUT and testing in two independent processes

Ranorex 5.3.5 Release (December 02, 2015)

General changes/Features

  • Added support for Firefox 41 (and higher)
  • Updated Firefox addon included in setup to v1.0.2 (for offline installation)
  • Added support for iOS 9
  • Added support for Android 6
  • Updated the adb (Android Debug Bridge) tool used for USB connections to Android devices to v1.0.32

Bugs

  • Fixed starting and stopping of iOS apps compiled specifically for iOS 9
  • Fixed object recognition in Firefox 40+ if started in incognito mode
  • Fixed wrong error/warning count in report if TestReport.Save is manually called multiple times
  • Fixed the order of projects in a solution file always being reversed when opening a solution
  • Fixed references to CSV data source files sometimes being lost when opening a solution in Ranorex Studio

Ranorex 5.3.4 Release (September 08, 2015)

General changes/Features

  • Added support for Firefox 40
  • Added support for Qt 4.6/4.7 x64-msvc

Bugs

  • Fixed mouse moves/clicks possibly throwing an exception for menu items in multi-monitor scenarios if monitors are not aligned
  • Fixed a possible memory leak in the "RunMobileApp" recording action
  • Fixed recognition of Accessible.Name/Description in QtQuick applications if set via QML
  • Fixed web elements getting invalid after 5 minutes of idle time
  • Fixed EnsureVisible to select the correct IE browser tab page if the DOM title is empty
  • Fixed Chrome DOMs sometimes showing up twice in Spy if an empty tab is open
  • Fixed the TextArea.MaxLength attribute sometimes not returning a value for IE DOMs
  • Fixed getting control names for 64bit Delphi applications
  • Fixed the report sometimes not being opened after executing a test suite if the test suite Report File Directory points to the Reports directory of the project
  • Fixed validation screenshots in repositories to not get a new unique ID on copying the associated repository item, causing renaming, finding references, and cleanup to not work correctly
  • Fixed the variable editor dialog not responding in Spy if "Always on Top" is enabled on Window 8 or higher
  • Fixed a few rare cases where updates were not correctly applied when editing repository items in Spy
  • Fixed test modules not being opened when double-clicking them in the test suite view if they reside in a referenced project
  • Fixed a rare case where bindings are lost if editing test case properties
  • Fixed a performance and memory issue when opening the Manage Data Sources dialog for test suites having a lot of connectors

Ranorex 5.3.3 Release (June 24, 2015)

General changes/Features

  • Added support for Firefox 39
  • The recorder action table now allows inserting new actions via its context menu

Bugs

  • Fixed the PopupWatcher callbacks to be called with an active cache session, resulting in UI changes not to be propagated
  • Flex 4.X tooltips are now directly available as elements
  • Fixed geometry issues with Chrome in Device Emulation mode
  • Fixed Delphi control names being truncated in some cases
  • Fixed an unhandled exception during AUT assembly resolving when automating WinForms applications
  • Fixed replay of drag & drop actions when the operation involves different top-level windows
  • Fixed recording of double clicks where a single click is forwarded to the AUT if object recognition is slow
  • Fixed the Spy element tree sometimes not correctly scrolling to the selected element when tracking
  • Fixed an unhandled exception when adding a user code method with the "out" keyword
  • Fixed an unhandled exception when starting the debugger on some machines

Ranorex 5.3.2 Release (April 20, 2015)

General changes/Features

  • Added support for iOS 8.3
  • Added support for Firefox 38
  • Added support for Chromium web browser
  • Added QtItem capability providing common attributes for Qt list/tree items and cells

Bugs

  • Fixed Ranorex launch URL's on iOS being forwarded to the app under test (instead of just starting the app)
  • Fixed temporary IDs (internally used by Ranorex) not being cleaned up when raising a JS event on a web element in IE 7 and older
  • Fixed UID RanoreXPath generation for some combinations of nested frames and iframes
  • Fixed object recognition only partially working for some ActiveX controls embedded in IE
  • Fixed the AutomationId attribute value being unavailable when the associated property was assigned by a template
  • Increased the maximum number of active touch pointers from 4 to 16 (for recording and playback)
  • Fixed a possible unhandled exception when closing Studio while a project is being loaded
  • Fixed poor performance when debugging 64bit projects
  • Fixed a possible memory leak when executing a test suite with a lot of module groups
  • Fixed breaking change introduced with 5.3.1 where data connectors are no longer reloaded for every test case

Known issues

Ranorex 5.3.1 Release (March 24, 2015)

General changes/Features

  • Added support for Firefox 37
  • Android APK instrumentation now supports activity-alias for main activities
  • WPF elements now provide their back-, foreground, and border colors
  • The WPF plugin now allows adding white-listed instance properties as dynamic attributes
  • WPF elements no longer provide attributes which are not serializable, nor inherit from DependencyObject
  • Data sources are only loaded once per test suite

Bugs

  • Fixed recognition of Flex applications with SWF version 28
  • Made Android OS automation work on machines with tighter security settings
  • Fixed communication issue with instrumented APKs on some Android 5.1 images
  • Fixed recording actions on iOS apps that are not launchable
  • Paths generated for WPF elements no longer contain internally used UIDs
  • Fixed a race condition in Studio causing it to no longer respond if the module browser is not visible
  • Fixed Studio sometimes not being able to play a code module on Windows XP
  • Changed the debugger console window to allow accessing local instance members without using "this"
  • No error message is logged any more if a referenced assembly cannot be loaded when running a test suite and all modules are found
  • Fixed memory fragmentation with large Excel data connectors
  • Fixed potential memory leak caused by data sources in parent/child test case structures
  • The use of "Auto-Load data when Test Suite Opens" on data sources should no longer cause adverse performance or memory issues

Ranorex 5.3.0 Release (February 18, 2015)

Major features

  • Added native support for automating WPF applications (UI Automation is no longer required)
  • Added support for automating Android system controls (outside of app contexts)
  • iOS apps (IPA files) can now be instrumented directly from Windows operating systems
  • Introduced a new iOS service app which allows starting/stopping of apps via WiFi

General changes/Features

  • Ranorex license and licensee information is now shown on the Studio start page
  • Double clicking the data binding column of a module in the test suite editor now opens the data binding of the respective test case
  • Added a new wizard-based workflow to start a new recording
  • InvokeAction recorder actions now also allow typed arguments (just like UserCode actions)
  • Added the possibility to assign the return value of InvokeAction and UserCode recorder actions to variables
  • User code methods available in a module (and its base classes) can now be selected directly when adding a new action
  • Changed the default key sequence split time from 500ms to 1s to reduce the number of separate key sequence actions recorded
  • Improved screenshot navigation in Spy by allowing instant navigation to clicked element
  • Added a context menu entry to group multiple repository items into a new rooted folder
  • When jumping to a repository item from a report and editing it, the data values used at runtime are shown and used for variables
  • Added a Report.Link method which allows adding a link to files within the report
  • Added public user API to get more properties of test suite activity classes, mainly used for reporting
  • Added a convenient user API to add devices temporarily from user code
  • Added the possibility to generate IME actions (like "Go" or "Done") on Android using the Mobile Key Press action
  • The mobile connection management now uses DNS names whenever possible instead of IP addresses
  • The Android service APK now provides a menu item to close the service and an option to keep the device awake
  • Updated the apktool used for instrumenting Android apps to v2.0.0RC3
  • Added support for Firefox 36
  • Installing the Flash Debug Player can now be done separately for Firefox/Safari and Chrome
  • Made Ranorex Studio able to open solutions created with Visual Studio 2012/2013

Bugs

  • Fixed error tracing screenshots for mobile elements sometimes showing a screenshot of the desktop
  • Fixed detection of iTunes 12.0.X to support USB connections to iOS devices
  • Fixed the Android ResourceId attribute sometimes not being stable
  • Made recording of page switches on iOS UIPageControl device/resolution independent
  • Fixed an EXC_BAD_ACCESS exception when opening an UIPickerView in an instrumented iOS app
  • Made HTML 5 adapters (e.g. VideoTag) inherit from the WebElement adapter providing all base capabilities
  • Code run by the ExecuteScript action can now access JS objects created by the page in Chrome versions >=39
  • Technology limitations for the Ranorex Firefox add-on are no longer shown for XUL-hosted applications
  • Fixed the geometry of Flex 3.X TileList item elements
  • Fixed QtElement.AccessibleName/AccessibleDescription to return the same values as Qt's MSAA implementation
  • Fixed a bug where tracking of Qt menu items did not work correctly in some cases
  • Fixed a possible unhandled exception when automating an SAP application while it is shutting down
  • Fixed recognition of embedded SAP frontend controls
  • The "Merge Keyboard Items" functionality is no longer available for key sequence actions not linked to the same repository item
  • Recording a validation action after inserting a delay action manually no longer changes the duration of the delay action
  • Fixed the report file placeholder %X to work correctly when specifying a report file name with the "/rf" command line argument
  • Fixed the report file placeholders to work correctly for zipped reports when using the "/zr /zrf" command line arguments
  • Made the report file directory work case insensitively
  • Fixed possible exception when a breakpoint in optimized code is hit by the debugger
  • StackOverflowExceptions in user code are now correctly caught and handled by the debugger
  • Minimized type conflict warnings for linked repositories which stem from a linked reference assembly
  • Fixed an unhandled exception when clicking on the very first header cell in the SQL Query Designer table
  • Fixed the schema (XSD) for report (*.rxlog.data) files to be valid for some custom report settings

Breaking changes (to 5.2)

  • The limitation of node-locked licenses not being allowed on virtual machines is now enforced -> use a floating license instead to execute Ranorex on a virtual machine
  • iOS apps instrumented with 5.2 are not compatible with this Ranorex version -> re-instrument the iOS app with the current Ranorex version
  • Starting and stopping iOS apps now requires the Ranorex Service app running on the device -> install the Ranorex Service app on the device and make sure the service app is in the foreground to start instrumented apps
  • The internal API class RemoteEndpointFactory was replaced by the public RemoteServiceLocator class -> use the new public API class RemoteServiceLocator instead of the former internal API
  • The new mobile device configuration cannot be read by older Ranorex versions (no forward compatibility) -> do not use older Ranorex versions with the new device configuration, i.e. use the same Ranorex version to create and execute test
  • The following public API methods/properties in the TestReport class dealing with report file placeholders were removed, because using those methods may corrupt report functionality: ResolvePlaceholders, HasStatusPlaceholders, UpdateStatusPlaceholders
  • Removed support for Firefox non-ESR (Extended Support Release) versions: 25,26,27,28,29,30

Ranorex 5.2.4 Release (May 27, 2015)

General changes/Features

  • Added support for Firefox 38
  • Added support for Chromium web browser
  • Added QtItem capability providing common attributes for Qt list/tree items and cells

Bugs

  • Fixed issue that caused UIAlertView buttons to disappear on iOS 8.3 when Ranorex fetched the UITree
  • Fixed recognition of Flex applications with SWF version 28
  • Fixed temporary IDs (internally used by Ranorex) not being cleaned up when raising a JS event on a web element in IE 7 and below
  • Fixed UID RanoreXPath generation for some combinations of nested frames and iframes
  • Increased the maximum number of active touch pointers from 4 to 16 (for recording and playback)

Ranorex 5.2.3 Release (February 24, 2015)

General changes/Features

  • Added support for Firefox 36
  • Added support for Firefox 37
  • Installing the Flash Debug Player can now be done separately for Firefox/Safari and Chrome

Bugs

  • Fixed the geometry of Flex 3.X TileList item elements
  • Fixed detection of iTunes 12.0.X to support USB connections to iOS devices
  • Fixed an EXC_BAD_ACCESS exception when opening an UIPickerView in an instrumented iOS app
  • Fixed QtElement.AccessibleName/AccessibleDescription to return the same values as Qt's MSAA implementation
  • Fixed a bug where tracking of Qt menu items did not work correctly in some cases
  • Fixed a possible unhandled exception when automating an SAP application while it is shutting down
  • Fixed recognition of embedded SAP frontend controls

Ranorex 5.2.2 Release (January 12, 2015)

General changes/Features

  • Added support for Firefox 35

Bugs

  • Fixed DeviceOrientation attribute of iOS MobileApp elements to always return a correct value
  • Fixed issue that caused instrumented iOS apps to call tableView:cellForRowAtIndexpath: although the table was empty (zero sections)
  • Fixed Swipe action on iOS to work correctly on nested controls
  • Fixed an unhandled exception when trying to set a text attribute of an iOS element to an empty string
  • Fixed validations to work correctly with complex Java attributes
  • Fixed recognition of WPF popups hosted by a WinForms application
  • Fixed recognition of columns and text content within Qt tree items without display role
  • Fixed recognition of header and first column cells in Qt tables
  • Fixed Delphi control names encoded in ANSI to be recognized correctly for older Delphi versions
  • Fixed unhandled exception when trying to include a recording into a project and the repository cannot be found
  • Fixed Studio to correctly save all settings when the user logs out or reboots the machine without closing Studio first
  • Fixed all command line arguments specified in a project to be passed correctly to the executable when debugging

2014 and earlier

For releases prior to 2015, see the Release Notes Archive.