Please post your Web Driver questions in official Web Driver forum

Monday, June 20, 2016

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 - http://appium.io/downloads.html (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 > DiskImageMounter.app
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 :)
Fork me on GitHub