Appium Concepts: How to find/query ‘App State’ during runtime(Complete Details) -”.queryAppState()” method
Please go through the below video for complete details:
Topic-1: Introduction:
when performing mobile automation using Appium, understanding the current state of an application during runtime is crucial for debugging and handling test scenarios effectively. Appium provides the .queryAppState() method, which allows testers to determine the current state of an application installed on the device.
1. What is .queryAppState()?
The .queryAppState() method is a built-in Appium command that retrieves the runtime state of a mobile application. This helps in making decisions based on whether an app is running in the foreground, background, or not running at all.
2. App States in Appium
The .queryAppState() method returns an integer that represents different states of the app:
State ValueState Description
0The app is not installed on the device.
1The app is installed but not running.
2The app is running in the background.
3The app is running in the foreground.
4The app is suspended (background but not executing).
3. Syntax of .queryAppState()
The method can be used in both Android (UiAutomator2/XCUITest) and iOS devices.
driver.queryAppState()
Returns below list of states:
Topic-2: State- “NOT_INSTALLED”
Usage: To Verify the app is installed or not
//After installing the WDIO app
driver.installApp(System.getProperty("user.dir")+"/APK_Files/android.wdio.native.app.v1.0.8.apk");
appstatevalue=driver.queryAppState(app_Package);
System.out.println("After installing the WDIO app,but not opened - "+appstatevalue);
Thread.sleep(5000);
Topic-3: State- “NOT_RUNNING”
Usage: To Verify the app is running or not
//Close the app
driver.terminateApp(app_Package);
appstatevalue=driver.queryAppState(app_Package);
System.out.println("WDIO app is closed/not running - "+appstatevalue);Topic-4: State- “RUNNING_IN_BACKGROUND”
Usage: Running the mobile app in background
//Running the WDIO app in background
driver.executeScript("mobile:startActivity", ImmutableMap.of("intent", "com.google.android.deskclock/com.android.deskclock.DeskClock"));
appstatevalue=driver.queryAppState(app_Package);
System.out.println("WDIO app is running background - "+appstatevalue);
Thread.sleep(5000);
Topic-5: State- “RUNNING_IN_BACKGROUND_SUSPENDED”
Usage: To Suspended the app running in the background
driver.executeScript("mobile:startActivity", ImmutableMap.of("intent", "com.google.android.deskclock/com.android.deskclock.DeskClock"));
appstatevalue=driver.queryAppState(app_Package);
System.out.println("WDIO app is running background - "+appstatevalue);
Topic-6: State- “RUNNING_IN_FOREGROUND”
Usage: Run the app in the foreground
driver.executeScript("mobile:startActivity", ImmutableMap.of("intent", "com.google.android.deskclock/com.android.deskclock.DeskClock"));
appstatevalue=driver.queryAppState(app_Package);
System.out.println("WDIO app is running background - "+appstatevalue);
Java Complete code:
package com.appiumguide.appiumconcepts;
import java.net.MalformedURLException;
import java.net.URL;
import java.time.Duration;
import org.testng.annotations.AfterTest;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.Test;
import com.google.common.collect.ImmutableMap;
import io.appium.java_client.android.AndroidDriver;
import io.appium.java_client.android.options.UiAutomator2Options;
import io.appium.java_client.appmanagement.ApplicationState;
/**
* Script Details - Appium Concepts:How to find/query ‘App State’ during runtime(Complete Details) -.queryAppState()
*
* appium-java-client version: 9.3.0
*
* @author 'Ramesh Kodumuru' for AppiumGuide [appiumguide@gmail.com]
*/
public class QueryAppStateTest {
private AndroidDriver driver;
String app_Package="com.wdiodemoapp";
ApplicationState appstatevalue;
@BeforeTest
public void stepup() throws MalformedURLException {
UiAutomator2Options cap =new UiAutomator2Options();
cap.setPlatformName("android");
cap.setAutomationName("uiautomator2");
cap.setDeviceName("Pixel8Pro");
driver=new AndroidDriver(new URL("http://127.0.0.1:4723"), cap);
driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10));
}
@AfterTest
public void teardown() {
if(driver!=null) {
driver.quit();
System.out.println("Test Execution Completed");
}
}
@Test
public void sessionidsample() throws InterruptedException {
Thread.sleep(5000);
//Before installing the WDIO app
appstatevalue=driver.queryAppState(app_Package);
System.out.println("Before installing the WDIO app - "+appstatevalue);
Thread.sleep(5000);
//After installing the WDIO app
driver.installApp(System.getProperty("user.dir")+"/APK_Files/android.wdio.native.app.v1.0.8.apk");
appstatevalue=driver.queryAppState(app_Package);
System.out.println("After installing the WDIO app,but not opened - "+appstatevalue);
Thread.sleep(5000);
//open the app which active on the mobile screen
driver.activateApp(app_Package);
appstatevalue=driver.queryAppState(app_Package);
System.out.println("open the app which active on the mobile screen - "+appstatevalue);
Thread.sleep(5000);
//Running the WDIO app in background
driver.executeScript("mobile:startActivity", ImmutableMap.of("intent", "com.google.android.deskclock/com.android.deskclock.DeskClock"));
appstatevalue=driver.queryAppState(app_Package);
System.out.println("WDIO app is running background - "+appstatevalue);
Thread.sleep(5000);
//open the app which active on the mobile screen
driver.activateApp(app_Package);
appstatevalue=driver.queryAppState(app_Package);
System.out.println("open the app which active on the mobile screen - "+appstatevalue);
Thread.sleep(5000);
//Close the app
driver.terminateApp(app_Package);
appstatevalue=driver.queryAppState(app_Package);
System.out.println("WDIO app is closed/not running - "+appstatevalue);
}
}
Output:
GitHub Link:
No comments:
Post a Comment