|
| 1 | +#!/bin/bash |
| 2 | + |
| 3 | +# Script to reliably launch iOS Simulator |
| 4 | +# Usage: ./launch-ios-simulator.sh <device_name> <os_version> [timeout_seconds] |
| 5 | +# |
| 6 | +# Examples: |
| 7 | +# ./launch-ios-simulator.sh "iPhone 17" "26.0" |
| 8 | +# ./launch-ios-simulator.sh "iPhone 17" "26.0" 120 |
| 9 | +# |
| 10 | +# Exit codes: |
| 11 | +# 0 - Success |
| 12 | +# 1 - Device not found |
| 13 | +# 2 - Boot timeout |
| 14 | +# 3 - Invalid arguments |
| 15 | + |
| 16 | +set -euo pipefail |
| 17 | + |
| 18 | +# Configuration |
| 19 | +DEVICE_NAME="${1:-}" |
| 20 | +OS_VERSION="${2:-}" |
| 21 | +TIMEOUT="${3:-120}" |
| 22 | +CHECK_INTERVAL=2 |
| 23 | + |
| 24 | +# Colors for output |
| 25 | +RED='\033[0;31m' |
| 26 | +GREEN='\033[0;32m' |
| 27 | +YELLOW='\033[1;33m' |
| 28 | +BLUE='\033[0;34m' |
| 29 | +NC='\033[0m' # No Color |
| 30 | + |
| 31 | +# Helper functions |
| 32 | +log_info() { |
| 33 | + echo -e "${BLUE}ℹ${NC} $1" |
| 34 | +} |
| 35 | + |
| 36 | +log_success() { |
| 37 | + echo -e "${GREEN}✓${NC} $1" |
| 38 | +} |
| 39 | + |
| 40 | +log_warning() { |
| 41 | + echo -e "${YELLOW}⚠${NC} $1" |
| 42 | +} |
| 43 | + |
| 44 | +log_error() { |
| 45 | + echo -e "${RED}✗${NC} $1" >&2 |
| 46 | +} |
| 47 | + |
| 48 | +# Validate arguments |
| 49 | +if [ -z "$DEVICE_NAME" ] || [ -z "$OS_VERSION" ]; then |
| 50 | + log_error "Usage: $0 <device_name> <os_version> [timeout_seconds]" |
| 51 | + log_error "Example: $0 \"iPhone 17\" \"26.0\" 120" |
| 52 | + exit 3 |
| 53 | +fi |
| 54 | + |
| 55 | +log_info "Starting iOS Simulator setup..." |
| 56 | +log_info "Device: $DEVICE_NAME" |
| 57 | +log_info "OS Version: $OS_VERSION" |
| 58 | +log_info "Timeout: ${TIMEOUT}s" |
| 59 | + |
| 60 | +# Kill any stuck simulators |
| 61 | +log_info "Checking for existing Simulator processes..." |
| 62 | +if pgrep -x "Simulator" > /dev/null; then |
| 63 | + log_warning "Found existing Simulator process, shutting down..." |
| 64 | + killall Simulator 2>/dev/null || true |
| 65 | + sleep 2 |
| 66 | +fi |
| 67 | + |
| 68 | +# Find the device UDID |
| 69 | +log_info "Finding device UDID for '$DEVICE_NAME' with iOS $OS_VERSION..." |
| 70 | +DEVICE_UDID=$(xcrun simctl list devices available --json | \ |
| 71 | + jq -r --arg name "$DEVICE_NAME" --arg os "iOS $OS_VERSION" \ |
| 72 | + '.devices[$os] | .[] | select(.name == $name and .isAvailable == true) | .udid' | \ |
| 73 | + head -n 1) |
| 74 | + |
| 75 | +if [ -z "$DEVICE_UDID" ]; then |
| 76 | + log_error "Device '$DEVICE_NAME' with iOS $OS_VERSION not found or not available" |
| 77 | + log_info "Available devices for iOS $OS_VERSION:" |
| 78 | + xcrun simctl list devices available --json | jq -r --arg os "iOS $OS_VERSION" '.devices[$os] | .[] | "\(.name) (\(.udid)) - \(.state)"' |
| 79 | + log_info "" |
| 80 | + log_info "All available iOS versions:" |
| 81 | + xcrun simctl list devices available --json | jq -r '.devices | keys[] | select(startswith("iOS"))' |
| 82 | + exit 1 |
| 83 | +fi |
| 84 | + |
| 85 | +log_success "Found device: $DEVICE_NAME (UDID: $DEVICE_UDID)" |
| 86 | + |
| 87 | +# Check current state |
| 88 | +CURRENT_STATE=$(xcrun simctl list devices --json | \ |
| 89 | + jq -r --arg udid "$DEVICE_UDID" \ |
| 90 | + '.devices[] | .[] | select(.udid == $udid) | .state') |
| 91 | + |
| 92 | +log_info "Current state: $CURRENT_STATE" |
| 93 | + |
| 94 | +# Shutdown if already booted to ensure clean state |
| 95 | +if [ "$CURRENT_STATE" = "Booted" ]; then |
| 96 | + log_warning "Device already booted, shutting down for clean start..." |
| 97 | + xcrun simctl shutdown "$DEVICE_UDID" 2>/dev/null || true |
| 98 | + sleep 2 |
| 99 | +fi |
| 100 | + |
| 101 | +# Boot the simulator |
| 102 | +log_info "Booting simulator..." |
| 103 | +xcrun simctl boot "$DEVICE_UDID" 2>/dev/null || { |
| 104 | + # Check if it's already booting or booted |
| 105 | + CURRENT_STATE=$(xcrun simctl list devices --json | \ |
| 106 | + jq -r --arg udid "$DEVICE_UDID" \ |
| 107 | + '.devices[] | .[] | select(.udid == $udid) | .state') |
| 108 | + |
| 109 | + if [ "$CURRENT_STATE" != "Booted" ] && [ "$CURRENT_STATE" != "Booting" ]; then |
| 110 | + log_error "Failed to boot simulator" |
| 111 | + exit 2 |
| 112 | + fi |
| 113 | +} |
| 114 | + |
| 115 | +# Wait for simulator to boot |
| 116 | +log_info "Waiting for simulator to boot (timeout: ${TIMEOUT}s)..." |
| 117 | +ELAPSED=0 |
| 118 | +while [ $ELAPSED -lt $TIMEOUT ]; do |
| 119 | + STATE=$(xcrun simctl list devices --json | \ |
| 120 | + jq -r --arg udid "$DEVICE_UDID" \ |
| 121 | + '.devices[] | .[] | select(.udid == $udid) | .state') |
| 122 | + |
| 123 | + if [ "$STATE" = "Booted" ]; then |
| 124 | + log_success "Simulator booted successfully!" |
| 125 | + break |
| 126 | + fi |
| 127 | + |
| 128 | + if [ $((ELAPSED % 10)) -eq 0 ] && [ $ELAPSED -gt 0 ]; then |
| 129 | + log_info "Still waiting... (${ELAPSED}s elapsed)" |
| 130 | + fi |
| 131 | + |
| 132 | + sleep $CHECK_INTERVAL |
| 133 | + ELAPSED=$((ELAPSED + CHECK_INTERVAL)) |
| 134 | +done |
| 135 | + |
| 136 | +# Verify boot completed |
| 137 | +FINAL_STATE=$(xcrun simctl list devices --json | \ |
| 138 | + jq -r --arg udid "$DEVICE_UDID" \ |
| 139 | + '.devices[] | .[] | select(.udid == $udid) | .state') |
| 140 | + |
| 141 | +if [ "$FINAL_STATE" != "Booted" ]; then |
| 142 | + log_error "Simulator boot timeout after ${TIMEOUT}s (state: $FINAL_STATE)" |
| 143 | + exit 2 |
| 144 | +fi |
| 145 | + |
| 146 | +# Open Simulator.app (optional, for visibility) |
| 147 | +log_info "Opening Simulator.app..." |
| 148 | +open -a Simulator --args -CurrentDeviceUDID "$DEVICE_UDID" 2>/dev/null || { |
| 149 | + log_warning "Failed to open Simulator.app (non-critical)" |
| 150 | +} |
| 151 | + |
| 152 | +# Wait for SpringBoard to be ready |
| 153 | +log_info "Waiting for SpringBoard to be ready..." |
| 154 | +ELAPSED=0 |
| 155 | +while [ $ELAPSED -lt 30 ]; do |
| 156 | + if xcrun simctl spawn "$DEVICE_UDID" launchctl print system | grep -q "com.apple.springboard"; then |
| 157 | + log_success "SpringBoard is ready!" |
| 158 | + break |
| 159 | + fi |
| 160 | + sleep 1 |
| 161 | + ELAPSED=$((ELAPSED + 1)) |
| 162 | +done |
| 163 | + |
| 164 | +# Final verification |
| 165 | +log_info "Verifying simulator status..." |
| 166 | +xcrun simctl bootstatus "$DEVICE_UDID" -b 2>/dev/null || true |
| 167 | + |
| 168 | +# Print simulator info |
| 169 | +log_success "Simulator is ready!" |
| 170 | +echo "" |
| 171 | +echo "Device Information:" |
| 172 | +echo " Name: $DEVICE_NAME" |
| 173 | +echo " OS Version: iOS $OS_VERSION" |
| 174 | +echo " UDID: $DEVICE_UDID" |
| 175 | +echo " State: $(xcrun simctl list devices --json | jq -r --arg udid "$DEVICE_UDID" '.devices[] | .[] | select(.udid == $udid) | .state')" |
| 176 | +echo "" |
| 177 | + |
| 178 | +# Export UDID for use in subsequent steps |
| 179 | +echo "SIMULATOR_UDID=$DEVICE_UDID" >> "${GITHUB_ENV:-/dev/null}" |
| 180 | +log_success "Simulator UDID exported to GITHUB_ENV" |
| 181 | + |
| 182 | +log_success "Setup complete! Simulator is ready for testing." |
| 183 | +exit 0 |
0 commit comments