How To Automate iOS App Using Appium

Sidharth Shukla

Posted On: August 17, 2022

view count115978 Views

Read time22 Min Read

Mobile apps have been an inseparable part of daily lives. Every business wants to be part of the ever-growing digital world and stay ahead of the competition by developing unique and stable applications.

Among all the mobile operating systems available in the market, current research states that iOS is the second most popular mobile operating system. There are some strong reasons behind it. Firstly, iOS is not restricted by any zonal or language barrier. Secondly, it supports 40 different languages, giving users a broader option globally.

Apple sells nearly 200 Million iPhones


According to the report, Apple sells nearly 200 Million iPhones annually, and Apple users download an average of 51 apps per minute. Developing an intuitive app is just half the battle won, as the second half can only be won if the app is fully functional and creates a lasting impression on the users. This is why rigorous iOS automation testing of apps becomes an absolute necessity!

To ensure that the iOS app runs flawlessly, you must ensure that mobile app testing is planned and executed perfectly. To achieve it, you need to use a framework like Appium to run iOS app testing on real iOS devices at scale. The result is wider coverage and faster execution with utmost quality.

This mobile app testing tutorial on performing Appium testing of iOS devices will help you answer all questions pertaining to how to automate iOS app using Appium. If you are preparing for an interview you can learn more through Appium Interview Questions.

Types of iOS application testing

There are specifically two types of iOS application testing, either you can test it using the simulator or by using the real device. In most real-time projects, the team prefers to perform regression testing in the iOS simulator, but simulator testing alone is insufficient for QA sign-off. This is why test (or QA) teams prefer to execute one round of Smoke or Sanity on the real devices.

When teams perform iOS testing, they like to run Functional Testing, Performance Testing, Security Testing, and Hardware Testing. It is important to note that Performance, Security, and Hardware Testing are non-functional testing types.

In this Appium testing tutorial, we will perform functional testing on iOS using a real device cloud.

Many mobile app testing frameworks facilitate automated device testing on iOS. However, my personal choice has always been “Appium.” You will know about the USPs of Appium once you read through this blog on how to automate iOS app using Appium.

What is Appium?

Appium is an open source test automation framework , empowers testing for native, web, and hybrid apps across iOS, Android, and Windows platforms. Notably, it offers cross-platform capability, enabling unified testing with a single API across iOS, Android, and Windows devices.

In simple words, it processes the request from the client and forwards it to the simulator and emulator or real devices. The test scripts are automated, and the result is communicated to the client via the server. This emulator vs simulator vs real device testing blog will help you learn more about it.

This enables code reuse between iOS, Android, and Windows test suites. The best part is using programming languages such as JavaScript, Java, Ruby, Python, PHP, and C# for Appium test script design.

As per the official website of Appium, per month, around 416k downloads are done by the users. It has a massive number of users along with community support.



Watch this video to learn about Appium, one of the most popular open-source test automation frameworks for mobile app testing.

Benefits of automating iOS app testing using Appium

As discussed earlier in this blog on how to automate iOS app using Appium, you must have had a little idea about iOS and Appium by now, but the million-dollar question is why Appium?

Appium has shown significant progress and is quickly becoming a preferred automation testing tool for mobile applications, with 35% of the organizations choosing it over other free/open source functional testing tools.

automation testing tool


So, let’s point out some of the significant benefits of iOS Appium automation testing. We have alternatives for iOS automation, but Appium is easy to use and has extensive community support.

  • Cross platform
  • Appium is “cross-platform”. This means you can use the same tests across multiple platforms (iOS, Android, Windows). Not a single line of code change is required when using the APIs. This helps in making the test scripts more modular.

  • Avoid installing extra dependencies
  • From Appium 1.15.0, Appium communicates with a real device via appium-ios-device. You no longer have to install extra dependencies. The official documentation on appium-xcuitest-driver is also helpful in resolving dependencies

  • Support for major iOS versions
  • Appium supports major versions of iOS. iOS version 9.3 and above is supported by Apple XCUITest, and the lower to 9.3 version is supported by Apple’s UI Automator. Learn more about XCUITest through this XCUITest testing tutorial.

  • Avoid recompilation of app
  • Appium does not require recompilation of App. It means we don’t need to implement a thing in the application code. While other frameworks need you to implement some change inside your code. It simply means there is no need to open the project in XCode. Just use the .app file to automate the application

  • Hassle-free execution
  • Appium supports real devices cloud testing and testing on simulators and emulators. It gives the flexibility to execute the automation suite across the platforms.

In case you are a beginner to Appium you can learn to perform mobile app testing easily through this tutorial.

As stated on the official website of Appium, the Appium team does not test the XCUITest driver against jailbroken devices, so it cannot be guaranteed that it will work as seen on non-jailbroken devices.

Prerequisites for how to automate iOS app using Appium

Before starting the pre-setup, as per my past experiences, I must tell you that it is quite tedious to do the entire setup, so please stay with us and follow all the steps carefully. Remember that all the steps mentioned below are mainly specific to OS, so follow steps respective to your operating system (i.e., macOS, Windows).

  1. First, you must have the Java setup done along with an IDE. We can use any IDE, but I recommend using Eclipse or IntelliJ IDE. I would recommend using Eclipse for the first try or practice.
  2. To set up JDK in the machine, please refer to the official Oracle website. If you already have JDK in your machine, skip this step. Never forget to check your java version in your machine post installation. You can also check the Java version as below once the installation is completed:
  3. Java version

  4. Once your JDK installation along with environment setup is done, the next step is supposed to install Eclipse. For your help, please refer to these blogs on how to install Eclipse and how to install IntelliJ.

You can also subscribe to the LambdaTest YouTube Channel and stay updated with the latest tutorials around Selenium testing, Cypress E2E testing, CI/CD, and more.

Step 1: Install Homebrew

It is a package management software, and to install, follow the instructions on this page:

To check the installed details along with the version, we can type “brew -v” as shown below:

brew -v

Step 2: Install Carthage

The WebDriverAgent requires it. To install it, just type below command:

If it is already installed in your machine, then you will get a message as below:

“carthage 0.38.0 is already installed and up-to-date.”

Step 3: Install Node & Npm

This step is required because Appium is a node application. To install it, run the below command on the terminal.

To verify the installed versions of npm and node, we can use npm -v & node -v as shown below:

brew install node

Step 4: Install authorize-ios

authorize-ios is a little utility that pre-authorizes Instruments to run UIAutomation scripts against iOS devices. It is required to run tests on real devices.

In the terminal, enter the below command to install authorize-ios:

Step 5: Install ios-deploy

Install ios-deploy via Homebrew by running the below command on the terminal:

To verify the installation, we can use ios-deploy –version command in the terminal as below:

ios-deploy –version
Step 6: Install ideviceinstaller

This is the tool for managing apps on iOS device

To check the installation is completed or not, ideviceinstaller –version command can be used as shown below:

ideviceinstaller --version

Step-7: Install Xcode

Xcode is a complete developer toolset for creating apps for Mac, iPhone, iPad, Apple Watch, and Apple TV. Xcode brings user interface design, coding, testing, debugging, and submitting to the App Store into a unified workflow.

For step-by-step guidance on using Xcode to build, test, and submit apps to the App Store, look at XCode documentation. To verify the Xcode installation, we can use the /usr/bin/xcodebuild -version command as shown below:


Step 8: Install XCUITest driver

Appium XCUITest driver is a combined solution, which allows automated black-box testing of iOS and tvOS native applications and WebKit web views. The native testing is based on Apple’s XCTest framework and the fork of Facebook’s WebDriverAgent server.
Web views communication is done via Webkit remote debugger protocol.

The appium-ios-device library ensures real device communication. To install the XCUITest driver, please use the official website. It has the help doc, which can be referred to for common errors or issues faced during the installation.

Step 9: Install Appium and Appium Doctor

To install Appium, please type the below command and use the version of Appium after @ in the below command:

You can check the version of Appium installed by using the command appium –version on the terminal, refer the below screenshot for reference:

 npm install -g appium@version

Appium doctor is a mini software that checks all (well, almost all) of the preconditions for appium to run successfully. In the terminal, enter the following:

We can use the command appium-doctor –version to check the installed version:

appium-doctor --version

Step 10: Install Maven

As we all know, Maven is the dependency management tool, type below command in your terminal:

Don’t forget the setup maven path before checking the version, you can do that by using below command:

Once installation complete do cross-check by typing below command:

Output will look as below:


Step 11: Install TestNG

TestNG is a testing framework that we’ll be using to manage our automated test suite. Launch Eclipse, select “Help” > “Eclipse Marketplace”–>search for TestNG. Learn more about TestNG through this Selenium TestNG tutorial.

We should be able to see the TestNG for Eclipse option with a button as “Install.” Click on the button and complete the installation. For more help, please go through this Appium with TestNG tutorial.

Step 12: Install Appium Desktop

We need to install Appium Desktop so we can use the Appium Inspector to identify the elements on the iOS app for designing test scripts. You can install the Appium Desktop from the official website.

Capabilities setup for real iOS device

This is the most vital step to perform. Below are the mentioned capabilities we require to run our tests.

Now the question is how to get the details that have been mentioned in the above code. Let’s go through them one by one:

  • platformVersion: is the version of iOS our app is running, 12.0.1 in my case.
  • deviceName: is not required, as we have plugged in a real device and will select that device using the udid desired capability. Appium still requires us to supply a value for deviceName, so we use iPhone 8. To know the device name, in the iPhone, we can navigate to“Settings> General > About > Name.”
  • udid: is the unique ID of the device we want to run our test on. Now connect your iPhone to your computer by USB and load up iTunes. We could find our device udid by running the command instruments -s devices in the terminal. Still, since we only have a single device plugged in, we can put in auto, and Appium will automatically find the udid of the device for us and use it. If ”auto” doesn’t work, then do provide your udid.
  • xcodeOrgId & xcodeSigningId: join the Apple Developer Program and locate your apple developer team id; xcodeorgid is the ID of the developer team that signed the certificate used to create the app. xcodeSigningId is the first part of the “Common Name” associated with the developer certificate.

    Since XCode set this up for us, it is almost always iPhone Developer, but it could be something different for you if you are automating a different iOS device.

  • bundleID: it is the special iOS-internal name of our app. The easiest way to get the bundleID is by using iTunesConnect. The steps are as below:
    1. Log into iTunes Connect.
    2. Click My Apps.
    3. Click on an app to find the bundle ID.
    4. The default app page will open, displaying the App ID and bundle ID.
  • App: many websites provide the sample apk, which can be used for testing. If you do not have any .apk or .ipa files, you can run your sample tests on LambdaTest using our sample 🔗 iOS app.
  • noReset: do not forget to use this capability. This approximately saves 2.9 seconds per test by avoiding app installation before every test run.
  • updatedWDABundleId: we need to create a provisioning profile for signing the WebDriverAgentRunner. Launch the Xcode and create a new project, select the team and enter the project name as follows:


Take a look at the “Project” tab of your project settings to confirm that “Automatically manage signing” is selected, and an Xcode Managed Profile is created.

Project” tab

Suppose you manually try to run the WebDriverAgentRunner app on the device. In that case, you will see a popup message:

WebDriverAgentRunner app

You can go to Settings => General => Device Management on the device to trust the developer and allow the WebDriverAgentRunner app to be run.

Copy your bundleId and add the following capability to your Appium Capabilities setup:

If you are unable to do the above steps, then the manual configuration can also be done. To go through the steps, please refer to this document. It has all the steps along with the screenshots.

Identifying the iOS elements

In this section of this blog on how to automate iOS app using Appium, we will learn how to identify the iOS elements. To identify elements in iOS devices, we need to download and install the Appium Desktop application and use the Appium Desktop Inspector functionality.

  1. If you have installed Appium Desktop, then we can start by clicking on the Start Server button inside of Appium Desktop as shown below.
  2. installed Appium Desktop

  3. Click the search icon from the right-up corner.
  4. right-up corner

  5. Add correct desired capabilities per your device/emulator and application. Then click on the Start Session button.
  6. Add desired capabilities

  7. It will open the App screen, App Source (the hierarchy of elements), and Selected Element Pane (The attributes and associated values of the element). You can use this to create locators which will uniquely identify the element.
  8. You can provide a .ipa file in desired capabilities inside Appium Inspector, which will install and launch the app. Refer to the screenshots below, which we have used to test .ipa and passed in the value against “app.” Use all the fields of desired capabilities discussed in this blog on how to automate iOS app using Appium. The best thing about the Appium Inspector is that you can verify your written locator on screen. Check the below screenshots.
  9. Appium Inspecter

  10. If your locator is correct, it will highlight the associated element, which is the same for Android and iOS.

locator is correct

Some of the most used locator strategies are mentioned below.

Accessibility ID Reads a unique identifier for a UI element. For XCUITest, it is the element’s accessibility-id attribute. For Android, it is the element’s content-desc attribute.
Class name For iOS, it is the full name of the XCUI element and begins with XCUIElementType. For Android, it is the full name of the UIAutomator2 class (e.g., android.widget.TextView)
ID Native element identifier. resource-id for Android; name for iOS.
Name Name of element.
XPath Searches the app XML source using xpath (not recommended, has performance issues).
Image Locates an element by matching it with a base 64 encoded image file.
iOS UIAutomation When automating an iOS application, Apple’s Instruments framework can be used to find elements.

In most real time projects, one public webelement is created, and element identification for Android and iOS is mentioned, as shown below. The nameOfMobileElement mentioned below is just an example. You can replace the same with the name of the locator used to identify the webelement of the targeted mobile app. We have identified the iOS element using iOSNsPredicate.

We can also use XPath as mentioned below for identification in iOS, in-fact all type of axes methods in XPath can be used to identify the element uniquely:

Though in my past experiences the most used identification I have used is accessibility as below, “GO TO APP” is just an example, it should be replaced with the accessibility for the app used for testing:

While identifying iOS elements, we need to remember that the element should always be unique and try the locators first and give XPath identification the least priority. I would suggest not using XPath locators unless there is no other alternative.

In general, XPath locators might be much slower than other locators like accessibility id, class name, and predicate (up to 100 times slower in some special cases). They are so slow because Apple’s XCTest framework does not natively support the XPath location.

Demo Code for automating iOS app using Appium

Before running the tests, we need to perform below two steps:

Step 1: Make sure the device which will be used for testing is unlocked, and if it asks you to “Trust the Computer”, tap the button to trust our Mac. You’ll need to do this the first time, and it won’t ask for it.

Step 2: Start the Appium server.

In the above code, the Test method we have used is testClickAnElement(), and the element we are trying to click is from the iOS app shared in this post on how to automate iOS app using Appium.

How To Automate iOS App Using Appium

Troubleshooting Tips

  1. Make sure UDID is correct by checking it in XCode Organizer or iTunes. It is a long string (approx 20+ chars).
  2. Make sure the following settings are enabled on your device:
  3. A. Settings -> Developer -> Enable UI Automation
    B. Settings -> Safari -> Advanced -> Web Inspector and Remote

  4. Consider generating a provisioning profile with a .xctrunner identifier if you do not want to generate a wildcard one for manual configuration. The .xctrunner config support has been added since XCode 11.
  5. Make sure the provisioning profile has an iOS Distribution certificate. An active XCode/xcodebuild connection/session is necessary to interact with WebDriverAgentRunner because of Apple’s security design. The certificate affects the limitation.
  6. The keyboard preference in the device under test is Apple’s official one, and the input language is set to English to send texts to XCUIElementTypeSecureTextField, as Non-official or non-English keyboards may not be able to send keys to XCUIElementTypeSecureTextField.


Given that Appium uses instruments underneath, we have all of the limitations of using Apple’s automation framework. This includes:

  • A slower response time between actions, automation that can only run over a USB tether, and only one device can execute automation simultaneously per host.
  • Each physical device or simulator requires a separate host running on a Mac to communicate with each device. This is due to the hosts being the one who determines where the commands are communicated, regardless of what parameters are passed into the automation. This may be a bug in the Appium infrastructure or requires a special command to determine the device to execute from the automation code.
  • The Instruments log files are not returned as part of the test, and the data given back to the running test is much less than what is seen in a typical Instruments test case.

How to automate iOS app using Appium on a real device cloud?

In this blog on how to automate iOS app using Appium, you must have realized that testing on real devices is not a cakewalk, especially iOS real device testing is tedious. The important thing is that real iOS device testing can only take place on a Mac, so we can’t even perform real iOS device testing without a Mac.

As a result, most organizations prefer to use real cloud devices for testing. You can try LambdaTest cloud devices, which are quite easy to use, and we can avoid setting up all the prerequisites on local machines.

LambdaTest provides a cloud-based solution for mobile automation testing. It lets you automate native and hybrid mobile apps on an online device farm of 3000+ real iOS. It is a scalable, secure, and high-performing Appium testing platform that empowers development and testing teams to accelerate their release cycles.

Below we have executed the test suite using LambdaTest real cloud devices. Just use the below code along with your username and password. We used the iPhone 12 for our test run. You can use the model as per the requirement.

In the above script, we have first done the capabilities setup and then automated the iOS app with two steps:

The first one is to open the browser and the second one is to click on the text box and then enter text “LambdaTest” on the text box. For ease of execution, we have used thread.sleep in this blog on how to automate iOS app using Appium. You can ignore the same while executing in your setup.

  1. To execute the same, you need to use the below two commands on your terminal:
  2. Once you execute the command, you should get the Build Success message as below:
  3. Build Success message

    After that, we need to execute the test cases using the below command on the terminal:

  4. Once the above command executes successfully, we must go to the LambdaTest website and validate the runs. Navigate to the Real Device ⇒ App Automation Section. You should be able to see “Java Vanilla – iOS” as shown below:
  5. validate the runs

  6. Now click on the recent execution. You will be redirected to the build view page, where all the details about the execution will be displayed along with the video:
  7. details about the execution

  8. In the above, we can check the Test Logs and Network details. Isn’t it relatively easy to run the automation suite on real cloud devices compared to doing the entire setup on a local machine? The best part is selecting any iPhone model required for your testing.

Note: Boost your Testing efficiency by ultimate guide of Appium Commands Cheat Sheet for Developers.


With this, we have concluded this tutorial on how to automate iOS app using Appium. As per my suggestion, we should only consider real iOS devices for Sanity or Smoke suite execution. For regression, it is always advised to use either simulators or cloud devices.

Though we have simulators, we should never release a product without being tested on real devices, so better to prepare an automation suite and run the real devices on the cloud, saving time and ensuring quality.

We can address most app-related issues by ensuring that the app works on a real device. iOS testing with Appium will help provide that confidence in the product and confirm the app’s success when it is released to users.

Happy testing, and do share what should be the next topic you want to learn.

Frequently Asked Questions (FAQs)

Can we automate iOS app using Appium?

Appium is the fastest and most reliable cross-platform test automation tool to execute tests across iOS, Android, and Windows devices. Appium targets mobile testing needs with code quality, reliability, speed, automation power, and open source philosophy.

Is it possible to automate iOS app in Windows?

The best way to start with automation in Windows is to have an understanding of the iOS Simulator and its features. The simulator allows you to test your app on different devices and operating systems. You can simulate certain events on the device and test the appropriate responses for your app. The other way to do it is to use a cloud testing platform like LambdaTest.

Author Profile Author Profile Author Profile

Author’s Profile

Sidharth Shukla

Siddharth is the founder and author of and has conducted training sessions on UI/API automation with CICD integration. He also works closely with companies to help them develop new automation tool

Blogs: 3