Reconnect Mobile Session¶

Since version 6.2, Rapise supports reconnecting mobile sessions. This enables many time-saving usage scenarios, as it eliminates the need to relaunch the application and manually perform steps to reach a desired application state.

Maintenance Scenario¶

You run a test, and it fails at some point because an object is not found on screen.
You use the Mobile Spy to reconnect to the application and analyze the cause of the failure.
You use the Mobile Spy to re-learn the object.
You run the test starting exactly from the step where it failed to ensure the test is fixed.

Multi Session Recording Scenario¶

You record the initial steps of a test case.
You run the test to make sure it works as expected (optional).
You start the next recording session and reconnect to the application. This saves time by eliminating the need to launch the application and manually perform steps to prepare it for recording.

Reusing Session to Run Multiple Tests¶

Since launching an application is a time-consuming operation in mobile testing, you can run multiple tests on the same application instance.

You run a test, and it leaves the application running.
You run the next test, and so on.

This approach has both advantages and disadvantages. We do not recommend using it for completely independent test cases. However, it makes sense to use it to break down a long test into separate modules and run them sequentially.

How it Works¶

To leave an application running and save session information, use the AppiumDriver.SaveSession call within the TestFinish block of your test.

Information

In Rapise 8.0+, explicitly calling AppiumDriver.SaveSession() is no longer required.

function TestFinish()
{
    AppiumDriver.SaveSession();
}

To reconnect to the running application, use the AppiumDriver.ReconnectSession call within the TestPrepare block of your test.

function TestPrepare()
{
    AppiumDriver.ReconnectSession();
}

If you want Rapise to launch a new application session when no saved session exists, pass true to the AppiumDriver.ReconnectSession call.

function TestPrepare()
{
    AppiumDriver.ReconnectSession(true);
}

Note: The TestPrepare block is executed when recording or executing a test. It is also executed during selective execution of RVL (Play Selection, Play From Here, etc.).

Active Session¶

When you launch Mobile Spy from the main toolbar, it first checks if the Appium server has active sessions. If active sessions exist, the Spy connects to one of them. You can switch the session using the dropdown on the Spy toolbar.