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

Who uses Ranorex