RANOREX INTERFACES AND CONNECTIVITY USERGUIDE TABLE OF CONTENTS INTERFACES AND CONNECTIVITY ........................................................................................... 4 RANOREX INSTRUMENTATION WIZARD ................................................................................................. 5 Adobe Flash/Flex ................................................................................................................... 14 Mozilla Firefox ....................................................................................................................... 16 Google Chrome/Chromium Edge .......................................................................................... 19 Android apps ......................................................................................................................... 22 iOS apps ................................................................................................................................. 30 TECHNOLOGY INSTRUMENTATION ...................................................................................................... 37 Flash/Flex/Air ........................................................................................................................ 37 Qt testing .............................................................................................................................. 46 Legacy applications ............................................................................................................... 49 SAP applications .................................................................................................................... 50 CEF applications .................................................................................................................... 51 General Troubleshooting ...................................................................................................... 53 SOURCE AND REVISION CONTROL ....................................................................................................... 61 Git .......................................................................................................................................... 61 Subversion ............................................................................................................................. 69 Team Foundation Version Control (TFVC) ............................................................................. 79 Ranorex Magic Merger ......................................................................................................... 87 AZURE DEVOPS INTEGRATION .......................................................................................................... 91 Create ADO project and Git repo .......................................................................................... 92 Add Ranorex Studio solution to DevOps project ................................................................... 98 Set up an Azure Pipelines agent .......................................................................................... 101 Create and execute a pipeline ............................................................................................. 104 CONTINUOUS INTEGRATION & TEST MANAGEMENT ............................................................................. 120 JIRA INTEGRATION ........................................................................................................................ 123 TESTRAIL INTEGRATION ................................................................................................................. 133 Importing, exporting, synchronizing ................................................................................... 136 Running tests and reporting to TestRail ............................................................................. 142 Collaboration ....................................................................................................................... 144 APPLITOOLS EYES INTEGRATION ...................................................................................................... 146 Create tests ......................................................................................................................... 146 Run tests .............................................................................................................................. 151 JENKINS INTEGRATION ................................................................................................................... 153 Install and configure plugins ............................................................................................... 156 Create and set up a Jenkins project .................................................................................... 160 Build a Jenkins project ......................................................................................................... 170 VISUAL STUDIO INTEGRATION ......................................................................................................... 174 SELENIUM WEBDRIVER INTEGRATION .............................................................................................. 184 PLUGINGS ................................................................................................................................... 186 Improved WPF plugin .......................................................................................................... 186 Delphi plugin ....................................................................................................................... 189 Interfaces and connectivity Interfaces and connectivity contain all tools, methods, and concepts which are needed to connect Ranorex to third-party software, hardware systems, and different technologies. A powerful instrumentation wizard supports you in integrating different technologies. Test deployment and remote work with Ranorex are connectivity topics as well as the concept of technology instrumentation. Instrumentation Wizard Technology Instrumentation Source and Revision Control CI & Test Management TestRail Integration Applitools Eyes Integration Visual Studio Integration Selenium WebDriver Integration Plugins Ranorex Instrumentation Wizard Ranorex Studio supports test automation for many different UI technologies. Some of these technologies must be instrumented for best automation results with Ranorex Studio. Instrumenting means that Ranorex Studio installs an add-on or inserts code so it can identify the UI elements of a particular technology. The Ranorex Instrumentation Wizard simplifies this process for the following technologies: • Adobe Flash/Flex • Mozilla Firefox • Google Chrome • Android/iOS apps Note For browsers, we recommend you use the ⇢ Open browser action to automatically instrument Mozilla Firefox or Google Chrome when you start a test. Start the Instrumentation Wizard Here we’ll show you the different ways that you can start the Instrumentation Wizard. From technology limitation warnings Whenever you try to automate one of the above technologies without having instrumented them, a technology limitation warning will appear. It will include a button to directly run the Instrumentation Wizard. Warning for Google Chrome Warning for Mozilla Firefox Warning for Flash/Flex When you create a mobile test When you click Add app… in the mobile test creation dialog, the Instrumentation Wizard starts automatically. This is because apps need to be instrumented before you can deploy them to your mobile device. Add app… button that automatically starts the Instrumentation Wizard. From the settings of an iOS/Android endpoint You can also start the Instrumentation Wizard from the settings of an Android/iOS endpoint. This works the same way as the Add app… button above. Instrument/deploy button in the settings of an Android endpoint From the menu You can also start the Instrumentation Wizard from Tools > Ranorex Instrumentation Wizard. From the Windows Start menu The Instrumentation Wizard is a standalone program and can therefore be started from the Windows Start menu. Command line instrumentation You can also instrument technologies from the command line. The available arguments are listed below. The image shows the Instrumentation Wizard executable in the /bin/ folder of the Ranorex Studio installation. Instrumentation Wizard executable ?|help Displays the general help. Add a page parameter to show the help for the respective technology. Possible page names: android, chrome, firefox, flex, ios. Android arguments (basics) d|device • Name of the mobile device to which you want to deploy an APK. • Not required if deploymode is set to NoDeploy. a|apkfile • Path to the APK that you want to deploy s|skip • True = no instrumentation: only deploys the APK to the device. • False (default) = instruments and then deploys the APK to the device. dm|deploymode • Configures how the APK is deployed. • Parameters: WiFi | Usb | NoDeploy | Auto (default) • NoDeploy = Does not deploy the APK. • Auto = Deploys the APK using the same mode as used for device configuration. o|outfile • Optional path or folder to save the instrumented APK. • You must have read and write permissions for the path/folder. • Adds a suffix to the saved APK to indicate that it’s been instrumented. Overwrites existing instrumented APKs. • If skip is set to true, does nothing. Android arguments (signing APKs) JdkBinPath • Complete installation path of the JDK environment. KeyAlias • Alias of the keystore entity