Overview
Activate App brings the app under test back to the foreground. Use it when the screen has drifted away from your app — for example after opening an external link in a browser, a share sheet, an image viewer, or another app — and you want the test to return to the app to continue. It only re-foregrounds the app; it does not restart it. The app keeps its current state and screen. If you need a clean, from-scratch launch, use Restart App instead.Activate App always targets the configured app under test. You cannot point it at
a different app — to launch a different app, use
Restart App with that app’s bundle
id (iOS) or package name (Android).
How to use
Write a step in plain language that asks to return to the app, for example:Bring the app back to the foregroundReactivate the appReturn to the app under test
Example use cases
- Returning from an external browser opened by an in-app link
- Recovering after a share sheet or system picker closes
- Re-focusing the app after a deep link bounced through another app
