mirror of
https://github.com/appium/appium.git
synced 2026-10-29 12:41:58 +08:00
Added changes for decoupling creating session, installing, launching, closing and uninstalling app for iOS and Android using mobile commands
This commit is contained in:
sergio.barros
@@ -6,119 +6,129 @@ import java.net.URL;
|
||||
import java.util.HashMap;
|
||||
import java.util.Map;
|
||||
|
||||
import org.apache.log4j.Logger;
|
||||
import org.openqa.selenium.Platform;
|
||||
import org.openqa.selenium.remote.Command;
|
||||
import org.openqa.selenium.remote.CommandInfo;
|
||||
import org.openqa.selenium.remote.DesiredCapabilities;
|
||||
import org.openqa.selenium.remote.HttpCommandExecutor;
|
||||
import org.openqa.selenium.remote.HttpVerb;
|
||||
import org.openqa.selenium.remote.RemoteWebDriver;
|
||||
import org.openqa.selenium.remote.Response;
|
||||
import org.openqa.selenium.remote.SessionId;
|
||||
import org.openqa.selenium.WebDriverException;
|
||||
|
||||
import com.qa.framework.utils.reporter.Reporter;
|
||||
|
||||
public class LocalWebDriver {
|
||||
public class LocalWebDriver {
|
||||
|
||||
//Set constants
|
||||
private HttpCommandExecutor executor = null;
|
||||
private URL baseURL = null;
|
||||
private final String INSTALLAPPCOMMAND = "INSTALL_APP";
|
||||
private final String UNINSTALLAPPCOMMAND = "UNINSTALL_APP";
|
||||
private final String ISAPPINSTALLEDCOMMAND = "IS_APP_INSTALLED";
|
||||
private HttpCommandExecutor executor = null;
|
||||
private DesiredCapabilities desired = null;
|
||||
private URL seleniumServerURL = null;
|
||||
private RemoteWebDriver remoteWebDriver = null;
|
||||
private Logger logger = Logger.getLogger("WEBDRIVER");
|
||||
|
||||
/**
|
||||
* CONSTRUCTOR:
|
||||
* Constructor:
|
||||
*
|
||||
* @param configurationFilePath the path to the file containing all the config values
|
||||
* @throws MalformedURLException
|
||||
* When constructing the remotewebdriver we have to set launch to false.
|
||||
*/
|
||||
public LocalWebDriver() {
|
||||
|
||||
try {
|
||||
//set the base url for the executor.
|
||||
this.baseURL = new URL("http://127.0.0.1:4444/wd/hub");
|
||||
} catch (MalformedURLException e) {
|
||||
Reporter.error("Unable to create url [" + e.getMessage() + "]");
|
||||
}
|
||||
//configure the end points which we can call.
|
||||
Map<String, CommandInfo> additionalCommands = new HashMap<String, CommandInfo>();
|
||||
additionalCommands.put(INSTALLAPPCOMMAND, new CommandInfo("/app/install/", HttpVerb.POST));
|
||||
additionalCommands.put(ISAPPINSTALLEDCOMMAND, new CommandInfo("/app/installed/", HttpVerb.POST));
|
||||
additionalCommands.put(UNINSTALLAPPCOMMAND, new CommandInfo("/app/uninstall/", HttpVerb.POST));
|
||||
|
||||
executor = new HttpCommandExecutor(additionalCommands, this.baseURL);
|
||||
public LocalWebDriver(URL url, DesiredCapabilities desired){
|
||||
this.desired = desired;
|
||||
//setting the launch to false will stop appium from automatically launching the app.
|
||||
this.desired.setCapability("launch", false);
|
||||
this.remoteWebDriver = new RemoteWebDriver(url, this.desired);
|
||||
}
|
||||
|
||||
/**
|
||||
* This method will use the appPath parameter to install the app on the attached
|
||||
* iOS device. Please make sure the appPath is accessible by the appium server.
|
||||
*
|
||||
* @param appPath to a local (zipped) app file or a url for a zipped app file.
|
||||
*/
|
||||
public void installApp(String appPath){
|
||||
Map<String, String> parameters = new HashMap<String, String>();
|
||||
parameters.put("appPath", appPath);
|
||||
Command command = new Command(new SessionId(""), INSTALLAPPCOMMAND, parameters);
|
||||
try {
|
||||
Response response = executor.execute(command);
|
||||
if(response.getStatus() == 0){
|
||||
Reporter.info(response.getValue().toString());
|
||||
} else {
|
||||
Reporter.error(response.getValue().toString());
|
||||
}
|
||||
} catch (IOException e) {
|
||||
Reporter.error("Unable to install app: " + e.getMessage());
|
||||
|
||||
|
||||
/**
|
||||
* This method will grab the app path from the config and install the app on the attached
|
||||
* iOS device. Please make sure the appPath is accessible by the appium server.
|
||||
*
|
||||
* Please make sure to set the app path using the setApp method.
|
||||
*/
|
||||
public void installApp(){
|
||||
if (desired.getCapability("app") != null){
|
||||
this.installApp(desired.getCapability("app").toString());
|
||||
} else {
|
||||
logger.error("You have to supply the app parameter before calling the install app.");
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* This method will use the bundlId parameter to un-install the app from
|
||||
* the attached iOS device.
|
||||
*
|
||||
* @param bundleId of the app you would like to remove
|
||||
* @return boolean it will return a true if the app was successfully un-installed and false
|
||||
* if it could not found or if the un-install failed.
|
||||
*/
|
||||
public boolean unInstallApp(String bundleId){
|
||||
if (isAppInstalled(bundleId)){
|
||||
Map<String, String> parameters = new HashMap<String, String>();
|
||||
parameters.put("bundleId", bundleId);
|
||||
Command command = new Command(new SessionId(""), UNINSTALLAPPCOMMAND, parameters);
|
||||
try {
|
||||
Response response = executor.execute(command);
|
||||
if(response.getStatus() == 0){
|
||||
Reporter.info(response.getValue().toString());
|
||||
return true;
|
||||
} else {
|
||||
Reporter.info(response.getValue().toString());
|
||||
}
|
||||
} catch (IOException e) {
|
||||
Reporter.error("Unable to uninstall app: " + e.getMessage());
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* This method will use the appPath parameter to install the app on the attached
|
||||
* iOS device. Please make sure the appPath is accessible by the appium server.
|
||||
*
|
||||
* @param appPath to a local (zipped) app file or a url for a zipped app file.
|
||||
*/
|
||||
public void installApp(String appPath){
|
||||
try {
|
||||
Object result = remoteWebDriver.executeScript("mobile: installApp","{\"appPath\":\"" + appPath + "\"}");
|
||||
logger.info(result.toString());
|
||||
} catch (WebDriverException e) {
|
||||
logger.error(e.getMessage());
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* This method will use the bundleId parameter to check if the app is
|
||||
* installed on the attached iOS device
|
||||
*
|
||||
* @param bundleId of the app you would like to check for
|
||||
*
|
||||
* @return boolean true if the app is installed and false if its not.
|
||||
*/
|
||||
public boolean isAppInstalled(String bundleId){
|
||||
Map<String, String> parameters = new HashMap<String, String>();
|
||||
parameters.put("bundleId", bundleId);
|
||||
Command command = new Command(new SessionId(""), ISAPPINSTALLEDCOMMAND, parameters);
|
||||
try {
|
||||
Response response = executor.execute(command);
|
||||
if(response.getValue().equals(true)){
|
||||
Reporter.info("Found the app with bundleID: " + bundleId);
|
||||
/**
|
||||
* This method will launch the app using mobile command
|
||||
*/
|
||||
public void launchApp(){
|
||||
try {
|
||||
Object result = remoteWebDriver.executeScript("mobile: launchApp");
|
||||
logger.info(result.toString());
|
||||
} catch (WebDriverException e) {
|
||||
logger.error(e.getMessage());
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* This method will close the app using mobile command
|
||||
*/
|
||||
public void closeApp(){
|
||||
try {
|
||||
Object result = remoteWebDriver.executeScript("mobile: closeApp");
|
||||
logger.info(result.toString());
|
||||
} catch (WebDriverException e) {
|
||||
logger.error(e.getMessage());
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* This method will use the bundlId parameter to un-install the app from
|
||||
* the attached iOS device.
|
||||
*
|
||||
* @param bundleId of the app you would like to remove (e.g. com.gamesys.jackpotjoy)
|
||||
*/
|
||||
public void unInstallApp(String bundleId){
|
||||
try {
|
||||
Object result = remoteWebDriver.executeScript("mobile: removeApp","{\"bundleId\":\"" + bundleId + "\"}");
|
||||
logger.info(result.toString());
|
||||
} catch (WebDriverException e) {
|
||||
logger.error(e.getMessage());
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* This method will use the bundleId parameter to check if the app is
|
||||
* installed on the attached iOS device
|
||||
*
|
||||
* @param bundleId of the app you would like to check for (e.g. com.gamesys.jackpotjoy)
|
||||
*
|
||||
* @return boolean true if the app is installed and false if its not.
|
||||
*/
|
||||
public boolean isAppInstalled(String bundleId){
|
||||
try {
|
||||
Object result = remoteWebDriver.executeScript("mobile: isAppInstalled","{\"bundleId\":\"" + bundleId + "\"}");
|
||||
if (result.toString().toLowerCase().equals("true")) {
|
||||
return true;
|
||||
} else if (result.toString().toLowerCase().equals("false")) {
|
||||
return false;
|
||||
} else {
|
||||
Reporter.info("No app found with bundleID: " + bundleId);
|
||||
logger.info(result.toString());
|
||||
return false;
|
||||
}
|
||||
} catch (IOException e) {
|
||||
Reporter.error("Unable to check if app is installed: " + e.getMessage());
|
||||
} catch (WebDriverException e) {
|
||||
logger.error(e.getMessage());
|
||||
}
|
||||
return false;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user