Change list

Added support for the /homescreen endpoint that is part of the new XCUITest driver. See appium/appium-xcuitest-driver#72 and appium/appium-base-driver#68

Types of changes

What types of changes are you proposing/introducing to Java client?
Put an x in the boxes that apply

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

Details

This method will call the /homescreen endpoint defined in WebDriverAgent https://github.com/facebook/WebDriverAgent

Unlike runAppInBackground(), the homeScreen() method will background the application until a user calls launchApp(). This allows the user to automate other parts of the simulator before running their tests or as part of their tests. This is now possible to do in XCUITestDriver. Examples of where this may be useful is when the user wants to modify settings before or during their tests or perform a Spotlight Search for something in their application.

Sample usage

// Create IOSDriver
IOSDriver<IOSElement> myDriver = new IOSDriver<IOSElement>(remoteAddress, capabilities);
// Simulate tapping the "Home" button on an iOS Device
myDriver.homeScreen();
// Do stuff on home screen
// Resume app
myDriver.launchApp()