Skip to main content

Executing appium tests on iOS mobile web

Back to Appium Tutorial Index  

To be able to work with ios simulator we would need -
  • Appium app to launch appium server and analyze application elements
  • xCode to launch various simulators to run tests on emulator / or real devices
Let’s begin with Appium app installation on mac -

Appium app provides ready to run version of appium server. Install appium client and start appium server as described in following steps -
Install latest Appium client for ios from - (You may have issues downloading this file from chrome, FF seems to work without issues)
Once download is over then Control-click appium.dmg > open with >
DMG is a apple disk image. The disk image will be mounted.

Screen Shot 2016-05-31 at 12.31.31.png

Then look for the mounted disk image in your finder (cmd + space), It will appear there. Right click and open. You should also drag it to Applications folder so that you can search it in finder (command + tab) in future.
Screen Shot 2016-05-31 at 12.41.38.png

After app verification you will see a warning > Click Open

Screen Shot 2016-05-31 at 12.44.57.png

You will see a warning for Appium authorization to run iOS simulator > Select Yes
Screen Shot 2016-05-31 at 12.50.06.png

Click the Launch button to launch appium inspector. If everything goes ok then you should see Welcome message

Screen Shot 2016-05-31 at 13.12.25.png

Once you launch an app on emulator then you can click on magnifying glass (appium inspector) to verify application elements.

By default appium app runs the bundled version of appium. If you are running a newest version of appium from source then select it under Preference > Use External Appium Package checkbox

Screen Shot 2016-05-31 at 15.52.57.png

Now we need to install Xcode for OSx
Install Xcode 6.0.0 (or higher) from the App Store. From wikipedia - Xcode is an integrated development environment (IDE) containing a suite of software development tools developed by Apple for developing software for OS X, iOS, WatchOS and tvOS. You could refer Xcode beginners guide to get a gist of Xcode.

If you use xCode version lower than 6.0.0 then you would encounter following error when running test -

org.openqa.selenium.WebDriverException: An unknown server-side error occurred while processing the command. Original error: Tried to use an iOS simulator with xcode version 5.1.1 but only Xcode version 6.0.0 and up are supported (WARNING: The server did not provide any stacktrace information)

Refer the apple simulator user guide to get very detailed info on simulator. You may be specifically interested in how to change simulated device and OS version to be able to test app/web on different versions of device and OS.

Assuming that Xcode is installed, you can launch ios simulator as following -

Xcode > Open Developer Tool > iOS Simulator
Screen Shot 2016-06-01 at 14.10.24.png

To Download other versions of iOS simulator, select Xcode > Preferences > Downloads and select the ios Simulator you want to download -
Screen Shot 2016-06-01 at 14.13.16.png

You can also change the type of simulator launched, for example if iOS simulator launches iPad and you want to use iPhone then you can change the device hardware from top menu as following -

Screen Shot 2016-06-02 at 12.26.48.png

Now head over to testng.xml to execute ios web test :)

Popular posts from this blog

Verify email confirmation using Selenium

Email confirmation seems to be integral part of any registration process. I came across an application which lets you provide your email address. You can follow the sign up link in you mail and then complete the registration process. Lets consider we provide GMail address for it. Now if were to use only Selenium then we would have to follow following steps - Launch GMail using Selenium; Some how search for new mail in the list of available mails; Some how click on it; Parse the mail message; Get the registration link; Follow up with registration process What do you think of an approach in which you can

Using chrome console to test xPath and css selectors

Since the advent of selenium there have been many plugin to test xPath / css selectors but you don’t need any of them if you have chrome browser. Using Chrome console you can test both xPath and css selectors. Launch website to be tested in chrome browser and hit F-12 and you would see chrome console opened in lower pane of application - Hit escape key and console would open another pane to write element locators - And now you can start writing xPath or css selectors in chrome console and test them - The syntax for writing css id - $$(“ ”) And hit the enter key. If your expression is right then html snippet of the application element corresponding to the css selector would be displayed - If you mouse over the html snippet in chrome console then it would highlight the corresponding element in application - If you want to clean console of previously written element selectors then just hit ctrl+L keys and chrome console would be empty again. Pro

Return only first or last element from webelements collection

We often come across situation when there are multiple elements on a page and we probably like to exercise only a few of them using selenium webdriver. May be just first and last element. For example on a search result page we may like to click on only first and last link and not all. This is when Iterables API comes handy. (By the way I am assuming that you have already completed watching selenium training videos :)). Once we have collection of web element then we can use Iterables to get only first or last element as following - Consider that we fetch collection of element as - List< WebElement > webElements = getDriver().findElements(By. id ( "htmlID" ));   Now we can get the first web element from this collection as -  WebElement firstElement = Iterables. getFirst (webElements,  getDriver().findElement(By. id ( "defaultElement" )));   Herein second argument -   (getDriver().findElement(By. id ( "defaultElement" )))    in the me