Package Exports

node-devicectl
node-devicectl/build/lib/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (node-devicectl) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

node-devicectl

Node.js wrapper around Apple's devicectl tool, the command-line utility to control iOS devices. devicectl is run as a sub-command of xcrun and requires Xcode 15+ and iOS 17+.

Installation

Install through npm.

npm install node-devicectl

API

The module exports a single class Devicectl. This class contains methods which wrap various devicectl subcommands.

Advanced Usage

Any devicectl subcommand could be called via execute method, which accepts the subcommand itself as the first argument and the set of options. For example:

import { Devicectl } from 'node-devicectl';

const devicectl = new Devicectl('device-udid');
const processes = await devicectl.listProcesses();
await devicectl.launchApp('com.example.app', {
  env: { DEBUG: '1' },
  terminateExisting: true
});

Requirements

Xcode 15+
iOS 17+
Node.js 20.19.0+ || 22.12.0+ || 24.0.0+

License

Apache-2.0