Skip to content

Releases

Maestro with iOS Real Device Support

Choose a tag to compare

iOS Real Device Testing Support

This release adds support for running Maestro tests on physical iOS devices using the --driver-host-port flag.

What's New

  • ✨ Support for physical iOS devices (not just simulators)
  • 🔧 --driver-host-port option to connect to external XCTest servers
  • 🚀 No Apple Team ID required when using custom driver port
  • 📱 Works with port forwarding for real device communication

Installation

# Download and extract the JARs
curl -L https://github.com/omnarayan/Maestro/releases/download/$TAG/maestro-jars.tar.gz -o maestro-jars.tar.gz
tar -xzf maestro-jars.tar.gz

# Copy to your Maestro installation
cp maestro-*.jar ~/.maestro/lib/

# Download and extract the iOS XCTest runner source code
curl -L https://github.com/omnarayan/Maestro/releases/download/$TAG/maestro-ios-xctest-runner-source.tar.gz -o maestro-ios-xctest-runner-source.tar.gz
tar -xzf maestro-ios-xctest-runner-source.tar.gz

Building XCTest Runner for Your Device

# Navigate to the extracted source directory
cd maestro-ios-xctest-runner

# Build for your real device (replace with your Team ID and device UDID)
DESTINATION="platform=iOS,id=<device-udid>" \
DERIVED_DATA_PATH="driver-iphoneos" \
DEVELOPMENT_TEAM=<your-team-id> \
bash build-maestro-ios-runner.sh

Usage

# Start the XCTest server on your physical device
cd maestro-ios-xctest-runner/driver-iphoneos/Build/Products
xcodebuild test-without-building \
  -xctestrun maestro-driver-ios_*.xctestrun \
  -destination "platform=iOS,id=<device-udid>"

# In another terminal, set up port forwarding (port 22087 to 7005)
# Use iproxy or pymobiledevice3 for port forwarding

# Run tests with custom driver port
maestro --driver-host-port 7005 --platform ios --udid <device-udid> test flow.yaml

Credits


Note: This is an experimental build for iOS real device testing.

Maestro 2.0.9 with --driver-host-port support

Choose a tag to compare

@github-actions github-actions released this 10 Nov 08:19

Multi-Device Port Support

This unofficial release adds the --driver-host-port CLI option to enable concurrent testing on multiple devices/simulators.

What's New

  • ✨ New --driver-host-port option to specify custom AndroidDriver port
  • 🚀 Run tests in parallel on multiple devices without port conflicts
  • 🔧 Works with both Android devices and iOS simulators

Installation

For users with Maestro already installed:

# Download the upgrade script
curl -fsSL https://raw.githubusercontent.com/omnarayan/Maestro/feature/driver-host-port/upgrade-maestro-ports.sh -o upgrade-maestro-ports.sh

# Run the upgrade
bash upgrade-maestro-ports.sh

Usage

Run tests on multiple devices simultaneously:

# Terminal 1 - Device 1
maestro --driver-host-port 7005 --device device1 test auth.yaml

# Terminal 2 - Device 2
maestro --driver-host-port 7006 --device device2 test products.yaml

Restoring Original Version

bash ~/.maestro-backups/backup/restore.sh

Credits


Note: This is an unofficial release. Official Maestro releases are at https://github.com/mobile-dev-inc/maestro/releases