zig-mobile-runner 0.1.0

package/scripts/create-ios-demo-app.sh

@@ -0,0 +1,261 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SOURCE="${BASH_SOURCE[0]}"
+while [[ -h "$SOURCE" ]]; do
+  SOURCE_DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
+  SOURCE="$(readlink "$SOURCE")"
+  if [[ "$SOURCE" != /* ]]; then
+    SOURCE="$SOURCE_DIR/$SOURCE"
+  fi
+done
+
+ROOT="$(cd -P "$(dirname "$SOURCE")/.." && pwd)"
+OUT=""
+APP_NAME="ZMRDemo"
+BUNDLE_ID="com.example.mobiletest"
+DEPLOYMENT_TARGET="16.0"
+
+usage() {
+  cat <<'USAGE'
+Usage:
+  scripts/create-ios-demo-app.sh --out <dir> [options]
+
+Creates a small public SwiftUI iOS simulator demo app and installs the ZMR
+XCTest shim into it. The generated app is intentionally generic and contains no
+private app references.
+
+Options:
+  --out <dir>                  Output app repository directory. Required.
+  --name <name>                App target name. Default: ZMRDemo.
+  --bundle-id <id>             App bundle id. Default: com.example.mobiletest.
+  --deployment-target <ver>    iOS deployment target. Default: 16.0.
+  -h, --help                   Show this help.
+
+After generation:
+  cd <dir>
+  xcodebuild -project ios/ZMRDemo.xcodeproj -scheme ZMRDemo -destination 'generic/platform=iOS Simulator' -derivedDataPath DerivedData build
+  xcrun simctl install booted DerivedData/Build/Products/Debug-iphonesimulator/ZMRDemo.app
+  zmr run .zmr/ios-shim-smoke.json --platform ios --device booted --app-id com.example.mobiletest --ios-shim ./.zmr/ios-shim --trace-dir traces/zmr-ios-demo
+USAGE
+}
+
+die() {
+  echo "error: $*" >&2
+  exit 2
+}
+
+require_value() {
+  local flag="$1"
+  local value="${2-}"
+  if [[ -z "$value" || "$value" == --* ]]; then
+    die "$flag requires a value"
+  fi
+  printf '%s\n' "$value"
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --out)
+      OUT="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --name)
+      APP_NAME="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --bundle-id)
+      BUNDLE_ID="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --deployment-target)
+      DEPLOYMENT_TARGET="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      die "unknown argument: $1"
+      ;;
+  esac
+done
+
+[[ -n "$OUT" ]] || die "--out is required"
+[[ "$APP_NAME" =~ ^[A-Za-z_][A-Za-z0-9_]*$ ]] || die "--name must be a valid Swift identifier"
+if ! ruby -e 'require "xcodeproj"' >/dev/null 2>&1; then
+  die "Ruby gem xcodeproj is required. Install it with: gem install xcodeproj"
+fi
+
+mkdir -p "$OUT/ios/$APP_NAME"
+OUT="$(cd "$OUT" && pwd)"
+PROJECT_PATH="$OUT/ios/$APP_NAME.xcodeproj"
+SOURCE_DIR="$OUT/ios/$APP_NAME"
+TEST_SCHEME="${APP_NAME}ZMRUITests"
+
+cat > "$SOURCE_DIR/${APP_NAME}App.swift" <<EOF
+import SwiftUI
+
+@main
+struct ${APP_NAME}App: App {
+    var body: some Scene {
+        WindowGroup {
+            ContentView()
+        }
+    }
+}
+EOF
+
+cat > "$SOURCE_DIR/ContentView.swift" <<'EOF'
+import SwiftUI
+
+struct ContentView: View {
+    @State private var input = ""
+    @State private var status = "Ready"
+    @FocusState private var inputFocused: Bool
+
+    var body: some View {
+        VStack(spacing: 20) {
+            Text("ZMR iOS Demo")
+                .font(.title)
+                .accessibilityIdentifier("demo_title")
+
+            Button("Continue") {
+                status = "Continue tapped"
+                inputFocused = true
+            }
+            .buttonStyle(.borderedProminent)
+            .accessibilityIdentifier("continue_button")
+
+            TextField("Type here", text: $input)
+                .textFieldStyle(.roundedBorder)
+                .focused($inputFocused)
+                .accessibilityIdentifier("demo_input")
+                .padding(.horizontal, 32)
+
+            Text(status)
+                .accessibilityIdentifier("demo_status")
+        }
+        .padding()
+        .onOpenURL { _ in
+            status = "Deep link opened"
+        }
+    }
+}
+EOF
+
+cat > "$SOURCE_DIR/Info.plist" <<EOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleDevelopmentRegion</key>
+  <string>\$(DEVELOPMENT_LANGUAGE)</string>
+  <key>CFBundleExecutable</key>
+  <string>\$(EXECUTABLE_NAME)</string>
+  <key>CFBundleIdentifier</key>
+  <string>\$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+  <key>CFBundleInfoDictionaryVersion</key>
+  <string>6.0</string>
+  <key>CFBundleName</key>
+  <string>\$(PRODUCT_NAME)</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  <key>CFBundleShortVersionString</key>
+  <string>1.0</string>
+  <key>CFBundleURLTypes</key>
+  <array>
+    <dict>
+      <key>CFBundleURLName</key>
+      <string>${BUNDLE_ID}</string>
+      <key>CFBundleURLSchemes</key>
+      <array>
+        <string>exampleapp</string>
+      </array>
+    </dict>
+  </array>
+  <key>CFBundleVersion</key>
+  <string>1</string>
+  <key>UILaunchScreen</key>
+  <dict/>
+</dict>
+</plist>
+EOF
+
+ruby - "$PROJECT_PATH" "$APP_NAME" "$BUNDLE_ID" "$DEPLOYMENT_TARGET" <<'RUBY'
+require "fileutils"
+require "xcodeproj"
+
+project_path, app_name, bundle_id, deployment_target = ARGV
+project = Xcodeproj::Project.new(project_path)
+target = project.new_target(:application, app_name, :ios, deployment_target)
+group = project.main_group.new_group(app_name, app_name)
+
+["#{app_name}App.swift", "ContentView.swift"].each do |source|
+  file_ref = group.new_file(source)
+  target.add_file_references([file_ref])
+end
+group.new_file("Info.plist")
+
+target.build_configurations.each do |configuration|
+  settings = configuration.build_settings
+  settings["PRODUCT_BUNDLE_IDENTIFIER"] = bundle_id
+  settings["PRODUCT_NAME"] = "$(TARGET_NAME)"
+  settings["SWIFT_VERSION"] = "5.0"
+  settings["GENERATE_INFOPLIST_FILE"] = "NO"
+  settings["INFOPLIST_FILE"] = "#{app_name}/Info.plist"
+  settings["TARGETED_DEVICE_FAMILY"] = "1,2"
+  settings["CODE_SIGNING_ALLOWED"] = "NO"
+end
+
+project.save
+scheme_dir = File.join(project.path, "xcshareddata/xcschemes")
+FileUtils.mkdir_p(scheme_dir)
+scheme_path = File.join(scheme_dir, "#{app_name}.xcscheme")
+File.write(scheme_path, <<~XML)
+  <?xml version="1.0" encoding="UTF-8"?>
+  <Scheme LastUpgradeVersion = "1600" version = "1.7">
+    <BuildAction parallelizeBuildables = "YES" buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+        <BuildActionEntry buildForTesting = "YES" buildForRunning = "YES" buildForProfiling = "YES" buildForArchiving = "YES" buildForAnalyzing = "YES">
+          <BuildableReference BuildableIdentifier = "primary" BlueprintIdentifier = "#{target.uuid}" BuildableName = "#{app_name}.app" BlueprintName = "#{app_name}" ReferencedContainer = "container:#{File.basename(project.path)}">
+          </BuildableReference>
+        </BuildActionEntry>
+      </BuildActionEntries>
+    </BuildAction>
+    <LaunchAction buildConfiguration = "Debug" selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB" selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB" launchStyle = "0" useCustomWorkingDirectory = "NO" ignoresPersistentStateOnLaunch = "NO" debugDocumentVersioning = "YES" debugServiceExtension = "internal" allowLocationSimulation = "YES">
+      <BuildableProductRunnable runnableDebuggingMode = "0">
+        <BuildableReference BuildableIdentifier = "primary" BlueprintIdentifier = "#{target.uuid}" BuildableName = "#{app_name}.app" BlueprintName = "#{app_name}" ReferencedContainer = "container:#{File.basename(project.path)}">
+        </BuildableReference>
+      </BuildableProductRunnable>
+    </LaunchAction>
+    <ProfileAction buildConfiguration = "Release" shouldUseLaunchSchemeArgsEnv = "YES" savedToolIdentifier = "" useCustomWorkingDirectory = "NO" debugDocumentVersioning = "YES">
+      <BuildableProductRunnable runnableDebuggingMode = "0">
+        <BuildableReference BuildableIdentifier = "primary" BlueprintIdentifier = "#{target.uuid}" BuildableName = "#{app_name}.app" BlueprintName = "#{app_name}" ReferencedContainer = "container:#{File.basename(project.path)}">
+        </BuildableReference>
+      </BuildableProductRunnable>
+    </ProfileAction>
+  </Scheme>
+XML
+RUBY
+
+"$ROOT/scripts/install-ios-shim.sh" \
+  --app-root "$OUT" \
+  --scheme "$TEST_SCHEME" \
+  --test-target "$TEST_SCHEME" \
+  --project "ios/$APP_NAME.xcodeproj" \
+  --app-target "$APP_NAME" \
+  --bundle-id "$BUNDLE_ID" \
+  --test-bundle-id "$BUNDLE_ID.zmr-uitests" \
+  --deployment-target "$DEPLOYMENT_TARGET" \
+  --patch-xcodeproj
+
+cp "$ROOT/examples/ios-smoke.json" "$OUT/.zmr/ios-smoke.json"
+cp "$ROOT/examples/ios-shim-smoke.json" "$OUT/.zmr/ios-shim-smoke.json"
+
+echo "created iOS demo app at $OUT"
+echo "project: $PROJECT_PATH"
+echo "app scheme: $APP_NAME"
+echo "shim scheme: $TEST_SCHEME"
+echo "bundle id: $BUNDLE_ID"

package/scripts/demo-android-real.sh

@@ -0,0 +1,232 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SOURCE="${BASH_SOURCE[0]}"
+while [[ -h "$SOURCE" ]]; do
+  SOURCE_DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
+  SOURCE="$(readlink "$SOURCE")"
+  if [[ "$SOURCE" != /* ]]; then
+    SOURCE="$SOURCE_DIR/$SOURCE"
+  fi
+done
+
+ROOT="$(cd -P "$(dirname "$SOURCE")/.." && pwd)"
+OUT="/tmp/zmr-android-demo-$(date +%Y%m%d-%H%M%S)"
+APP_ID="com.example.mobiletest"
+DEVICE="emulator-5554"
+AVD=""
+RUNS="1"
+TRACE_ROOT=""
+API="35"
+BUILD_TOOLS="35.0.1"
+ANDROID_SDK="${ANDROID_HOME:-$HOME/Library/Android/sdk}"
+ADB="${ADB:-adb}"
+EMULATOR="${EMULATOR:-emulator}"
+AUTO_BOOT_EMULATOR=1
+DRY_RUN=0
+
+usage() {
+  cat <<'USAGE'
+Usage:
+  scripts/demo-android-real.sh [options]
+
+Creates a generic public Android demo app, installs it on an Android
+emulator/device, and runs the ZMR Android smoke scenario with trace output.
+
+Options:
+  --out <dir>               Demo app output directory. Default: /tmp/zmr-android-demo-<timestamp>.
+  --app-id <id>             Android application id. Default: com.example.mobiletest.
+  --device <serial>         Android device/emulator serial. Default: emulator-5554.
+  --avd <name>              AVD to boot when the requested device is not ready.
+  --runs <n>                Scenario run count. Default: 1.
+  --trace-root <dir>        Trace output directory. Default: <out>/traces/pilot.
+  --api <level>             Android platform API level. Default: 35.
+  --build-tools <ver>       Android build-tools version. Default: 35.0.1.
+  --android-sdk <path>      Android SDK root. Default: ANDROID_HOME or ~/Library/Android/sdk.
+  --adb <path>              adb path. Default: adb.
+  --emulator <path>         emulator path. Default: emulator.
+  --no-auto-boot-emulator   Require an already ready device/emulator.
+  --dry-run                 Print commands without executing them.
+  -h, --help                Show this help.
+USAGE
+}
+
+die() {
+  echo "error: $*" >&2
+  exit 2
+}
+
+require_value() {
+  local flag="$1"
+  local value="${2-}"
+  if [[ -z "$value" || "$value" == --* ]]; then
+    die "$flag requires a value"
+  fi
+  printf '%s\n' "$value"
+}
+
+quote_cmd() {
+  local quoted=()
+  local arg
+  for arg in "$@"; do
+    quoted+=("$(printf '%q' "$arg")")
+  done
+  printf '%s\n' "${quoted[*]}"
+}
+
+run() {
+  echo "+ $(quote_cmd "$@")"
+  if [[ "$DRY_RUN" -eq 0 ]]; then
+    "$@"
+  fi
+}
+
+run_allow_fail() {
+  echo "+ $(quote_cmd "$@")"
+  if [[ "$DRY_RUN" -eq 0 ]]; then
+    "$@" >/dev/null 2>&1 || true
+  fi
+}
+
+run_background() {
+  echo "+ $(quote_cmd "$@") &"
+  if [[ "$DRY_RUN" -eq 0 ]]; then
+    "$@" &
+  fi
+}
+
+device_ready() {
+  echo "+ $(quote_cmd "$ADB" -s "$DEVICE" get-state)"
+  if [[ "$DRY_RUN" -eq 1 ]]; then
+    return 1
+  fi
+  local state
+  state="$("$ADB" -s "$DEVICE" get-state 2>/dev/null | tr -d '\r' || true)"
+  [[ "$state" == "device" ]]
+}
+
+ensure_android_device_ready() {
+  if device_ready; then
+    return 0
+  fi
+
+  if [[ "$AUTO_BOOT_EMULATOR" -eq 0 ]]; then
+    die "device $DEVICE is not ready and auto boot is disabled"
+  fi
+  [[ -n "$AVD" ]] || die "device $DEVICE is not ready; pass --avd <name> to boot an emulator or start a device manually"
+
+  echo "+ auto boot Android emulator $AVD when $DEVICE is not ready"
+  run_background "$ROOT/scripts/android-emulator.sh" boot --avd "$AVD" --device "$DEVICE"
+  run "$ROOT/scripts/android-emulator.sh" wait-ready --device "$DEVICE"
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --out)
+      OUT="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --app-id)
+      APP_ID="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --device)
+      DEVICE="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --avd)
+      AVD="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --runs)
+      RUNS="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --trace-root)
+      TRACE_ROOT="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --api)
+      API="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --build-tools)
+      BUILD_TOOLS="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --android-sdk)
+      ANDROID_SDK="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --adb)
+      ADB="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --emulator)
+      EMULATOR="$(require_value "$1" "${2-}")"
+      shift 2
+      ;;
+    --no-auto-boot-emulator)
+      AUTO_BOOT_EMULATOR=0
+      shift
+      ;;
+    --dry-run)
+      DRY_RUN=1
+      shift
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      die "unknown argument: $1"
+      ;;
+  esac
+done
+
+[[ -n "$OUT" ]] || die "--out must not be empty"
+[[ "$APP_ID" =~ ^[A-Za-z][A-Za-z0-9_]*(\.[A-Za-z][A-Za-z0-9_]*)+$ ]] || die "--app-id must be a Java-style package id"
+[[ "$RUNS" =~ ^[0-9]+$ && "$RUNS" -ge 1 ]] || die "--runs must be a positive integer"
+[[ "$API" =~ ^[0-9]+$ ]] || die "--api must be an integer"
+[[ -n "$BUILD_TOOLS" ]] || die "--build-tools must be non-empty"
+
+if [[ -z "$TRACE_ROOT" ]]; then
+  TRACE_ROOT="$OUT/traces/pilot"
+fi
+
+APK="$OUT/build/app-debug.apk"
+SCENARIO="$OUT/.zmr/android-smoke.json"
+
+echo "Android real demo app: $OUT"
+echo "Android real demo traces: $TRACE_ROOT"
+if [[ "$DRY_RUN" -eq 1 ]]; then
+  echo "DRY RUN: commands will be printed but not executed"
+fi
+
+run "$ROOT/scripts/create-android-demo-app.sh" \
+  --out "$OUT" \
+  --app-id "$APP_ID" \
+  --api "$API" \
+  --build-tools "$BUILD_TOOLS" \
+  --android-sdk "$ANDROID_SDK"
+
+ensure_android_device_ready
+
+run_allow_fail "$ADB" -s "$DEVICE" uninstall "$APP_ID"
+run "$ADB" -s "$DEVICE" install -r "$APK"
+
+run "$ROOT/scripts/benchmark.sh" \
+  --zmr "$SCENARIO" \
+  --device "$DEVICE" \
+  --app-id "$APP_ID" \
+  --runs "$RUNS" \
+  --trace-root "$TRACE_ROOT" \
+  --min-pass-rate 100 \
+  --max-failures 0
+
+cat <<EOF
+
+Android real demo complete.
+App directory: $OUT
+Trace directory: $TRACE_ROOT
+EOF