- 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.
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.
After app verification you will see a warning > Click Open
You will see a warning for Appium authorization to run iOS simulator > Select Yes
Click the Launch button to launch appium inspector. If everything goes ok then you should see Welcome message
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
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
To Download other versions of iOS simulator, select Xcode > Preferences > Downloads and select the ios Simulator you want to download -
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 -