xcrun simctl & Simuladores iOS

# Lista simuladores bootáveis (Apple Silicon: prefira dispositivos arm64)
xcrun simctl list devices available
 
# Boot + mostra Simulator.app
DEVICE="iPhone 16 Pro"
xcrun simctl boot "$DEVICE" 2>/dev/null || true
open -a Simulator --args -CurrentDeviceUDID "$(xcrun simctl list devices available | rg "$DEVICE" -m 1 | rg -o '[A-F0-9-]{36}')"
 
# Instala um build de desenvolvimento ou artefato .app/.tar.gz do simulador EAS
xcrun simctl install booted ./build/YourApp.app
 
# Captura de tela + logs
xcrun simctl io booted screenshot ./screenshots/home.png
xcrun simctl spawn booted log stream --level debug --predicate 'processImagePath CONTAINS "YourApp"'

#!/usr/bin/env bash
set -euo pipefail
 
APP_NAME="ShopApp"
BUNDLE_ID="com.example.shopapp"
SIM_NAME="iPhone 16 Pro"
ARTIFACT="./ShopApp.app"   # de eas build --profile development --platform ios (simulator)
 
# 1. Resolve UDID
UDID=$(xcrun simctl list devices available -j \
  | jq -r --arg name "$SIM_NAME" '
      .devices | to_entries[].value[] |
      select(.name == $name and .isAvailable == true) | .udid' \
  | head -1)
 
if [[ -z "$UDID" ]]; then
  echo "Simulator not found: $SIM_NAME" >&2
  exit 1
fi
 
# 2. Boot (idempotente) e foca a UI do Simulator
xcrun simctl boot "$UDID" 2>/dev/null || true
open -a Simulator --args -CurrentDeviceUDID "$UDID"
 
# 3. Instalação limpa do cliente de desenvolvimento
xcrun simctl uninstall "$UDID" "$BUNDLE_ID" 2>/dev/null || true
xcrun simctl install "$UDID" "$ARTIFACT"
 
# 4. Lança sem Xcode
xcrun simctl launch "$UDID" "$BUNDLE_ID"
 
# 5. Smoke test de deep link (universal links ainda precisam de device para a cadeia AASA completa)
xcrun simctl openurl "$UDID" "shopapp://orders/42"
 
# 6. Evidência para PR
mkdir -p ./screenshots
xcrun simctl io "$UDID" screenshot "./screenshots/${APP_NAME}-orders.png"
 
# 7. Acompanha logs nativos (Ctrl+C para parar) - execute em um segundo terminal
xcrun simctl spawn "$UDID" log stream \
  --style compact \
  --predicate "processImagePath CONTAINS \"$APP_NAME\"" \
  --level debug

npx expo start --dev-client --clear

# Desliga todos os simuladores (libera RAM antes de eas build --local)
xcrun simctl shutdown all
 
# Apaga Keychain ou cache de Associated Domains travado
xcrun simctl erase booted

# Instala bundle .app (apenas builds de simulador - não IPA de dispositivo)
xcrun simctl install booted /path/Build/Products/Debug-iphonesimulator/MyApp.app
 
# Desinstala por ID do bundle (corresponde a app.config ios.bundleIdentifier)
xcrun simctl uninstall booted com.example.myapp
 
# Lança - imprime PID
xcrun simctl launch booted com.example.myapp
 
# Termina
xcrun simctl terminate booted com.example.myapp

# Filtro compacto amigável para RN
xcrun simctl spawn booted log stream \
  --style compact \
  --predicate 'subsystem == "com.facebook.react.log" OR processImagePath CONTAINS "MyApp"'
 
# Relatórios de crash históricos
xcrun simctl spawn booted log show --last 5m --predicate 'eventType == "logEvent" AND messageType == "error"'
 
# Alias legado (ainda funciona em muitas configurações)
npx react-native log-ios

# Captura de tela PNG
xcrun simctl io booted screenshot ~/Desktop/sim-home.png
 
# Grava vídeo curto (macOS 13+)
xcrun simctl io booted recordVideo ./demo.mov
# Ctrl+C para a gravação
 
# Compara capturas de tela na CI com um caminho base conhecido
mkdir -p artifacts && xcrun simctl io booted screenshot artifacts/ios-tab-bar.png

# Concede permissão de câmera/microfone/fotos para fluxos automatizados
xcrun simctl privacy booted grant camera com.example.myapp
xcrun simctl privacy booted grant photos com.example.myapp
 
# Simula localização
xcrun simctl location booted set 37.7749,-122.4194
 
# Área de transferência (clipboard) para copiar/colar em E2E
xcrun simctl pbcopy booted "coupon-code-123"

# simctl requer Xcode CLT - verifique antes de scriptar CI em Mac auto-hospedado
xcode-select -p
xcrun simctl help
 
# Prefira UDID em vez de nome do dispositivo em scripts - nomes colidem entre runtimes
UDID=$(xcrun simctl list devices available -j | jq -r '...')
 
# Apple Silicon: escolha runtimes de simulador arm64 - x86_64 é mais lento e quebra alguns pods
xcrun simctl list devices available | rg "iPhone 16"