Author: Anjali KG

Introduction

Appium for iOS simulator is essential for mobile test automation on macOS, but setting it up can feel overwhelming. Setting up Appium for iOS automation on macOS can feel a bit overwhelming – there are so many tools, environment variables, and hidden gotchas. But don’t worry – we’ve got you covered. 

Whether you’re a QA engineer, SDET, or just starting out with mobile test automation, this guide will walk you through everything you need to run Appium tests on an iOS simulator.

Steps with real examples and tips from the trenches. 

First, Check Your Shell for Appium for iOS Simulator Setup

Your shell controls how environment variables are loaded, and this matters when setting things up.

To find out which shell you’re using, run this in Terminal:

echo $SHELL

You’ll probably see either:

/bin/zsh (Zsh – the default on newer Macs)

/bin/bash (Bash – common on older versions)

Now, Open the Right Config File for Appium for iOS Simulator

Depending on your shell:

For Zsh (most common now):
nano ~/.zshrc

For Bash:
nano ~/.bash_profile

Add Java Path to Run Appium for iOS Simulator

Paste this into your file:

export JAVA_HOME=$(/usr/libexec/java_home) export PATH=$PATH:$JAVA_HOME/bin

Then save and reload your shell config:

source ~/.zshrc  or ~/.bash_profile if you’re using Bash

Step-by-Step Setup

Install Homebrew for Appium for iOS Simulator Dependencies

Homebrew is the package manager that makes everything easier on macOS.

/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)”

Install Node.js and npm

Appium runs on Node.js, so let’s install that next:

brew install node

Check that it worked:

node -v

npm -v

Install Appium for iOS Simulator on macOS

Now that Node is ready, install Appium globally:

npm install -g appium

And confirm it’s installed:

appium -v

Use Appium Doctor to Verify Appium for iOS Simulator Setup

This handy tool checks if your system is Appium-ready:

npm install -g appium-doctor

appium-doctor

Follow the suggestions it gives you – this step saves a lot of future headaches.

Configure Xcode for Appium for iOS Simulator

Install Xcode: Grab the latest version from the Mac App Store and launch it once.

Install Command Line Tools: xcode-select –install

Accept the License Agreement: sudo xcodebuild -license accept

Check Xcode Path

Run: xcode-select -p

You should see: /Applications/Xcode.app/Contents/Developer

If not, fix it: sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

Install iOS Simulators for Appium for iOS Simulator Testing

You’ve got options here:

Via Xcode:
Open Xcode → Settings → Components → Download simulators

Via Terminal:
xcodebuild -downloadPlatform iOS

Open Simulator manually:
open -a Simulator

Confirm iOS SDK is Installed

Check that the SDK is in place:

xcrun –show-sdk-path –sdk iphonesimulator

You should see something like:

/Applications/Xcode.app/…/iPhoneSimulator.sdk

Install Extra iOS Tools for Appium for iOS Simulator

These tools help with device communication and testing – even if you’re only using simulators, it’s good to have them:

brew install carthage brew install ios-deploy brew install libimobiledevice

Troubleshoot Common Issues in Appium for iOS Simulator

Even with a solid setup, things can go sideways. Here are some common problems – and how to fix them.

Problem: “Node Not Found” in Eclipse or IntelliJ

What’s going on? macOS GUI apps don’t load your terminal environment variables.

Fix it:

Open Run > Run Configurations in your IDE

Select your test config

Go to the Environment tab

Add the following:

PATH – Use the value from echo $PATH

NODE_HOME – Path to your Node install

ANDROID_HOME – (Only needed if you’re also testing Android)

Problem: npm ERR! EACCES

This happens when you install npm packages using sudo, which messes up permissions.

Fix it:

sudo chown -R $(whoami):$(id -gn) ~/.npm npm install -g appium

You’re Ready to Automate!

With this setup, your Mac is now fully prepped for running Appium tests on iOS simulators. 

If you’d like to go further:

Build your first test script

Set up real device automation

Or configure Android automation

More Blogs : Key Factors to Consider When Choosing a QA Testing Partner