Endpoints introduction

Endpoints are the gateways through which a locally executed test exchanges data with an external AUT. In simpler words, they allow you to test an external application or system as if it were on your machine.

Endpoints that have been added to Ranorex Studio are displayed and managed in the Endpoints pad. Click the endpoints symbol in the menu bar to bring up the Endpoints pad. By default, it appears on the right edge of the screen.

1. Empty Endpoints pad.

2. The endpoints pad displays the endpoint list with three endpoints.

If your endpoint list is empty, you can see a corresponding message and a button to add an endpoint. If you already added at least one endpoint, the endpoint list displays as follows:

1. Refresh and Add endpoint buttons.

2. Search field for endpoints.

3. Click to access this endpoint’s settings.

4. Endpoint name

5. Connection status (Connected/Error/Connecting…)

6. Endpoint ID: IP number for network connections, ID for USB connections.

7. Automation root status symbol (explained in Endpoint settings)

8. Endpoint type (Android, iOS, WebDriver)

Aside from the usual test executable, the /output/ folder also contains shortcuts for each endpoint. These shortcuts allow you to execute the test directly on a specific endpoint. The endpoint is represented in the shortcut’s file name as @<endpoint>.

1. Shortcut for an Android endpoint.

2. Shortcut for an iOS endpoint.

 

Reference

---

You can also manually trigger test runs on endpoints through the command line. The required arguments are listed in Ranorex Studio fundamentals > Test suite > Run tests without Ranorex Studio.