# appium-xcode

> Interact with Xcode

Latest version **7.1.1** (published 2026-09-01) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install appium-xcode
pnpm add appium-xcode
yarn add appium-xcode
bun add appium-xcode
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 7.1.1 |
| Published | 2026-09-01 |
| First published | 2015-04-06 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^20.19.0 \|\| ^22.12.0 \|\| >=24.0.0 |
| Dependencies | 4 |
| Unpacked size | 72.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 18 |
| Author | Appium Contributors |
| Maintainers | jlipps, nick.mokhnach, kazucocoa, imurchie, dangraham |
| Keywords | appium, ios, xcode |

## Links

- npm: https://www.npmjs.com/package/appium-xcode
- Repository: https://github.com/appium/appium-xcode
- Homepage: https://github.com/appium/appium-xcode#readme
- Issues: https://github.com/appium/appium-xcode/issues
- npm.io page: https://npm.io/package/appium-xcode

## Dependencies (4)

- [semver](https://npm.io/package/semver.md) ^7.0.0
- [asyncbox](https://npm.io/package/asyncbox.md) ^6.4.3
- [teen_process](https://npm.io/package/teen_process.md) ^4.2.0
- [@appium/support](https://npm.io/package/@appium/support.md) ^7.2.6

## Recent versions

- 7.1.1 (latest) — 2026-09-01
- 2.1.0-beta2 (beta) — 2015-08-19
- 7.1.0 — 2026-07-25
- 7.0.0 — 2026-07-24
- 6.2.6 — 2026-07-06
- 6.2.5 — 2026-07-01
- 6.2.4 — 2026-06-29
- 6.2.3 — 2026-06-19
- 6.2.2 — 2026-05-07
- 6.2.1 — 2026-04-29
- 6.2.0 — 2026-04-27
- 6.1.10 — 2026-04-17
- 6.1.9 — 2026-02-16
- 6.1.8 — 2026-01-28
- 6.1.7 — 2026-01-27
- … 86 more at https://npm.io/package/appium-xcode/versions

## README

appium-xcode
===================
[![NPM version](http://img.shields.io/npm/v/appium-xcode.svg)](https://npmjs.org/package/appium-xcode)
[![Downloads](http://img.shields.io/npm/dm/appium-xcode.svg)](https://npmjs.org/package/appium-xcode)

[![Release](https://github.com/appium/appium-xcode/actions/workflows/publish.js.yml/badge.svg?branch=master)](https://github.com/appium/appium-xcode/actions/workflows/publish.js.yml)

ES7 module for interacting with Xcode and Xcode-related functions.
Used by various [Appium](github.com/appium/appium) drivers.

API
===

All functions are `async`, meaning they return promises which can be awaited via `await`.

Most functions are memoized, so after they are called once, they will simply return the same value. Remember that calling `require()` multiple times returns the same instantiation of a module if it has already been instantiated, so the memoization will be preserved across multiple files in the same project.

Some functions have an auto-retry built into them, they will retry silently a number of times. This is because the Xcode commands sometimes just flake and return bad values (or don't return).

### getPath([timeout=15000])
*memoized*

gets path to Xcode Developer root.

### getVersion([parse=false], [retries], [timeout])
*memoized*, *retry*

returns the version of Xcode formatted as a string, for example `6.3.1`, or a version object if `parse` is `true`

### getMaxIOSSDK([num_retries])
*memoized*, *retry*

returns the highest IOS SDK version supported by Xcode.
eg: `'8.3'`

### getMaxTVOSSDK([num_retries])
*memoized*, *retry*

returns highest tvOS SDK version supported by Xcode.
eg: `'10.1'`

Develop
=======

## Test

```
npm test
npm e2e-test
```

Debug
=====

After cloning appium-xcode, execute `npm link` in the appium-xcode directory. Next run `npm link appium-xcode` from the appium directory. This will symlink appium-xcode to node_modules/appium-xcode. If the clone becomes out of date remember to unlink or delete node_modules and reinstall.

For quick debugging you could cd into the node_modules/appium-xcode folder and run `npm install` followed by `npm run build`.

---
_Source: https://npm.io/package/appium-xcode · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._