killApp

Terminate app on Android with killApp (stopApp on iOS and Web) to test restarts.

The killApp command kills the app on Android. On iOS and Web, it's just an alias for stopApp.

- killApp

Killing the app on Android triggers a System-initiated Process Death. It is the equivalent of calling:

adb shell am kill {package name}

Here is an example how to fully reproduce a System-initiated Process Death:

trigger-process-death.yaml

appId: com.example
---
- pressKey: Home # Puts the app into the background
- killApp # Kills the app (adb shell am kill)
- launchApp: # Relaunches the app
    stopApp: false # Without adb shell am stop

It is advised to use this set of commands as a subFlow (e.g. trigger-process-death.yaml) and re-use it via runFlow in every other test, to re-check the data of the screen under test after the System-initiated Process Death:

appId: com.example
---
- launchApp
- tapOn:
    id: "com.example:id/enter_name"
- inputText: "John Doe"
- tapOn:
    id: "com.example:id/next"
- assertVisible:
    id: "com.example:id/show_name"
    text: "Name = John Doe"
    enabled: true
- runFlow: trigger-process-death.yaml
- assertVisible:
    id: "com.example:id/show_name"
    text: "Name = John Doe"
    label: "Asserts that \"Name = John Doe\" meaning the screen kept its data after System-initiated Process Death"
    enabled: true
- stopApp