Fix WebView element access on iOS 26 by including SafariViewService hierarchy (mobile-dev-inc#2872)

* Fix WebView element access on iOS 26 by including SafariViewService hierarchy

* Rebuild iOS runners to include the change

* Run iOS e2e tests on iOS 26.1

* Add webview tests

* Bump runner to macOS 26

No idea if this will solve the test problems. It's a shot in the dark...

---------

Co-authored-by: Dan Caseley <dan@mobile.dev>

Author: leovarmak

.github/workflows/test-e2e.yaml

@@ -254,10 +254,9 @@ jobs:
 
   test-ios:
     name: Test on iOS
-    runs-on: macos-latest
+    runs-on: macos-26
     needs: build
     timeout-minutes: 120
-    #if: ${{ false }}
 
     env:
       MAESTRO_DRIVER_STARTUP_TIMEOUT: 240000 # 240s
@@ -289,7 +288,11 @@ jobs:
           maestro --version
 
       - name: Boot Simulator
-        run: ./.github/scripts/boot_simulator.sh
+        run: |
+          xcrun simctl list runtimes
+          export RUNTIME="iOS26.1"
+          export DEVICE_TYPE="iPhone 17 Pro"
+          ./.github/scripts/boot_simulator.sh
 
       - name: Download apps
         working-directory: ${{ github.workspace }}/e2e
@@ -322,7 +325,7 @@ jobs:
           retention-days: 7
           include-hidden-files: true
 
-      - name: Upload xc test runner logs
+      - name: Upload xctest runner logs
         uses: actions/upload-artifact@v6
         if: success() || failure()
         with:
@@ -331,7 +334,7 @@ jobs:
           retention-days: 7
           include-hidden-files: true
 
-      - name: Upload screen recording of AVD
+      - name: Upload screen recording of Simulator
         uses: actions/upload-artifact@v6
         if: success() || failure()
         with:

e2e/manifest.txt

@@ -4,3 +4,4 @@ https://storage.googleapis.com/mobile.dev/cli_e2e/nowinandroid.apk
 https://storage.googleapis.com/mobile.dev/cli_e2e/demo_app.apk
 https://storage.googleapis.com/mobile.dev/cli_e2e/demo_app.zip
 https://storage.googleapis.com/mobile.dev/cli_e2e/setOrientation.apk
+https://storage.googleapis.com/mobile.dev/cli_e2e/SimpleWebViewApp.zip

e2e/run_tests

@@ -36,27 +36,31 @@ trap 'rm -f pipe' EXIT
 
 export MAESTRO_EXAMPLE="test-value"  # Relied upon in a test
 
-# Run passing tests
 for workspace_dir in ./workspaces/*; do
 
-  # Skip workspaces with no tests for iOS
-  case $(basename "$workspace_dir") in
-  		demo_app|nowinandroid|setOrientation) # demo_app has OOM issues on GHA
+  app_name="$(basename "$workspace_dir")"
+
+  case $app_name in
+      # Skip workspaces with no tests for iOS
+      # demo_app has OOM issues on GHA
+  		demo_app|nowinandroid|setOrientation)
   			if [ "$platform" = "ios" ]; then
   			  continue
   			fi
   			;;
+  	  # Skip workspaces with no tests for Android
+      simple_web_view)
+        if [ "$platform" = "android" ]; then
+          continue
+        fi
+        ;;
+      # Skip web-only workspaces for all mobile tests - those are run by run_tests_web
+      sauce_demo)
+        continue
+        ;;
   esac
 
 	WORKSPACE_PASS=true
-	app_name="$(basename "$workspace_dir")"
-
-	# Skip web-only workspaces for mobile e2e tests
-	case $app_name in
-	  sauce_demo)
-	    continue
-	    ;;
-	esac
 
 	_h1 "run tests for app \"$app_name\" on platform \"$platform\""
 
@@ -81,7 +85,7 @@ for workspace_dir in ./workspaces/*; do
 	###
 	# edge case: some workspaces have no failing flows
 	case $app_name in
-		wikipedia|setOrientation)
+		wikipedia|setOrientation|no-app|simple_web_view)
 			continue
 			;;
 	esac

e2e/workspaces/simple_web_view/webview.yaml

@@ -0,0 +1,13 @@
+appId: com.example.SimpleWebViewApp
+tags:
+  - passing
+  - ios
+---
+- launchApp:
+    clearState: true
+
+- tapOn: Open Login Page
+
+- assertVisible: Login
+- assertVisible: Sign In
+- assertVisible: Forgot your password?

maestro-ios-driver/src/main/resources/driver-iPhoneSimulator/Debug-iphonesimulator/maestro-driver-ios.zip

@@ -52,7 +52,11 @@ struct ViewHierarchyHandler: HTTPHandler {
         let statusBars = logger.measure(message: "Fetch status bar hierarchy") {
             fullStatusBars(springboardApplication)
         } ?? []
-
+        
+        // Fetch Safari WebView hierarchy for iOS 26+ (runs in separate SafariViewService process)
+        let safariWebViewHierarchy = logger.measure(message: "Fetch Safari WebView hierarchy") {
+            getSafariWebViewHierarchy()
+        }
 
         let deviceFrame = springboardApplication.frame
         let deviceAxFrame = [
@@ -70,7 +74,7 @@ struct ViewHierarchyHandler: HTTPHandler {
                 let appWidth = appFrame["Width"], appWidth > 0,
                 let appHeight = appFrame["Height"], appHeight > 0
             else {
-                return AXElement(children: [appHierarchy, AXElement(children: statusBars)].compactMap { $0 })
+                return AXElement(children: [appHierarchy, AXElement(children: statusBars), safariWebViewHierarchy].compactMap { $0 })
             }
 
             let offsetX = deviceWidth - appWidth
@@ -81,9 +85,9 @@ struct ViewHierarchyHandler: HTTPHandler {
 
             let adjustedAppHierarchy = expandElementSizes(appHierarchy, offset: offset)
 
-            return AXElement(children: [adjustedAppHierarchy, AXElement(children: statusBars)].compactMap { $0 })
+            return AXElement(children: [adjustedAppHierarchy, AXElement(children: statusBars), safariWebViewHierarchy].compactMap { $0 })
         } else {
-            return AXElement(children: [appHierarchy, AXElement(children: statusBars)].compactMap { $0 })
+            return AXElement(children: [appHierarchy, AXElement(children: statusBars), safariWebViewHierarchy].compactMap { $0 })
         }
     }
 
@@ -229,6 +233,40 @@ struct ViewHierarchyHandler: HTTPHandler {
 
         return snapshots
     }
+    
+    /// Fetches the Safari WebView hierarchy for iOS 26+ where SFSafariViewController
+    /// runs in a separate process (com.apple.SafariViewService).
+    /// Returns nil if not on iOS 26+, Safari service is not running, or no webviews exist.
+    private func getSafariWebViewHierarchy() -> AXElement? {
+        let systemVersion = ProcessInfo.processInfo.operatingSystemVersion
+        guard systemVersion.majorVersion >= 26 else {
+            return nil
+        }
+        
+        let safariWebService = XCUIApplication(bundleIdentifier: "com.apple.SafariViewService")
+        
+        let isRunning = safariWebService.state == .runningForeground || safariWebService.state == .runningBackground
+        guard isRunning else {
+            return nil
+        }
+        
+        let webViewCount = safariWebService.webViews.count
+        guard webViewCount > 0 else {
+            return nil
+        }
+        
+        NSLog("[Start] Fetching Safari WebView hierarchy (\(webViewCount) webview(s) detected)")
+        
+        do {
+            AXClientSwizzler.overwriteDefaultParameters["maxDepth"] = snapshotMaxDepth
+            let safariHierarchy = try elementHierarchy(xcuiElement: safariWebService)
+            NSLog("[Done] Safari WebView hierarchy fetched successfully")
+            return safariHierarchy
+        } catch {
+            NSLog("[Error] Failed to fetch Safari WebView hierarchy: \(error.localizedDescription)")
+            return nil
+        }
+    }
 
     private func findRecoveryElement(_ element: XCUIElement) throws -> XCUIElement {
         if try element.snapshot().children.count > 1 {