Repository navigation
Releases
Releases · omnarayan/Maestro
Maestro with iOS Real Device Support
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-portoption 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.gzBuilding 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.shUsage
# 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.yamlCredits
- Based on https://github.com/mobile-dev-inc/maestro
- Built for iOS real device testing support
Note: This is an experimental build for iOS real device testing.
Maestro 2.0.9 with --driver-host-port support
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-portoption 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.shUsage
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.yamlRestoring Original Version
bash ~/.maestro-backups/backup/restore.shCredits
- Based on https://github.com/mobile-dev-inc/maestro
- Fixes issues: mobile-dev-inc#2339, mobile-dev-inc#1818, mobile-dev-inc#2556, mobile-dev-inc#1485
- Credit to @avinash-bharti for original work in mobile-dev-inc#2339
Note: This is an unofficial release. Official Maestro releases are at https://github.com/mobile-dev-inc/maestro/releases