Getting Started

Getting Started

This guide will help you set up maestro-ios-device and run your first test.

Prerequisites

Before you begin, ensure you have:

  1. macOS 12 (Monterey) or later
  2. Xcode 14 or later installed
  3. An iOS device with Developer Mode enabled

Installation

Install maestro-ios-device using the install script:

curl -fsSL https://devicelab.dev/open-source/install/maestro-ios-device.sh | bash

This will download the binary to ~/.devicelab/bin and add it to your PATH.

Verify Installation

maestro-ios-device --version

Connect Your Device

  1. Connect your iOS device via USB
  2. Trust the computer on your device
  3. Enable Developer Mode in Settings > Privacy & Security

Run Your First Test

Create a simple test file hello.yaml:

appId: com.apple.Preferences
---
- launchApp
- assertVisible: "General"

Run it:

maestro-ios-device test hello.yaml

Next Steps