appium-ios-simulator

appium-ios-simulator

Appium API for dealing with iOS simulators. The API enables you to use the following features:

• query locations of Simulator-specific directories and applications
• read/write access to Simulator settings
• full control over starting and stopping simulators
• deal with biometric auth, geolocation settings, application permissions, and others

Usage

async getSimulator(udid)

This is the main entry of this module. This function returns a simulator object (see below) associated with the udid passed in. If an iOS simulator with the given udid does not exist already on this machine, it will throw an error.

If you want to create a new simulator, you can use the createDevice() method of node-simctl.

import { getSimulator } from 'appium-ios-simulator';
import assert from 'node:assert/strict';

const sim = await getSimulator('DAE95172-0788-4A85-8D0D-5C85509109E1');
await sim.run();
assert.equal('Booted', (await sim.stat()).state);
await sim.shutdown();
assert.equal('Shutdown', (await sim.stat()).state);

Third-party tools

The following tools and utilities are not mandatory, but could be used by the appium-ios-simulator, if installed locally, to extend its functionality:

• Mobile Native Foundation
• AppleSimulatorUtils
  • For contacts, camera, faceid, health, homekit, notifications, speech and userTracking permissions

Xcode and iOS versions

Check Xcode wikipedia for more details about Xcode version to iOS version mapping.

Development

Checkout the repository and run

npm install
npm run dev

Use the following commands to run tests:

# unit tests
npm run test
# integration tests
npm run e2e-test

Similar packages

Other packages similar to appium-ios-simulator

node-simctl

node-simctl is a Node.js wrapper around Apple's simctl command-line tool, which is used to control iOS simulators. It provides similar functionalities to appium-ios-simulator, such as starting and stopping simulators, but it directly interfaces with simctl, offering a more low-level control.

ios-sim

ios-sim is a command-line utility to launch iOS simulators and install apps on them. While it provides similar functionalities to appium-ios-simulator, it is more focused on command-line usage rather than being a library for programmatic control.