appium-webdriveragent 16.13.6 → 16.14.1

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [16.14.1](https://github.com/appium/WebDriverAgent/compare/v16.14.0...v16.14.1) (2026-10-07)
+
+### Bug Fixes
+
+* report geometry for the selected display ([#1291](https://github.com/appium/WebDriverAgent/issues/1291)) ([43fa6da](https://github.com/appium/WebDriverAgent/commit/43fa6da647fb8adca21fdbd106d8f73d782d6717))
+* skip accessibility idle checks for WebKit services ([#1293](https://github.com/appium/WebDriverAgent/issues/1293)) ([9d06611](https://github.com/appium/WebDriverAgent/commit/9d06611d1f5d342fd16458f707dca3f3e3ec00fc))
+
+## [16.14.0](https://github.com/appium/WebDriverAgent/compare/v16.13.6...v16.14.0) (2026-10-04)
+
+### Features
+
+* support Duo hinge control and secondary display capture ([#1287](https://github.com/appium/WebDriverAgent/issues/1287)) ([76d6aa0](https://github.com/appium/WebDriverAgent/commit/76d6aa03e2423290bb05c436afc153bd32878ce0))
+
 ## [16.13.6](https://github.com/appium/WebDriverAgent/compare/v16.13.5...v16.13.6) (2026-09-30)
 
 ### Bug Fixes

package/README.md

@@ -26,6 +26,14 @@ and start sending [requests](https://github.com/facebook/WebDriverAgent/wiki/Que
 
 More about how to start WebDriverAgent [here](https://github.com/facebook/WebDriverAgent/wiki/Starting-WebDriverAgent).
 
+## Multiple displays
+
+See [Multiple displays](docs/multiple-displays.md) for display selection, capture,
+and active-app detection.
+
+See [Hinge angle](docs/hinge-angle.md) for reading angles, sending simulated hinge
+events, runtime requirements, and physical-device testing feedback.
+
 ## Known Issues
 If you are having some issues please checkout [wiki](https://github.com/facebook/WebDriverAgent/wiki/Common-Issues) first.
 

package/WebDriverAgent.xcodeproj/project.pbxproj

@@ -245,6 +245,7 @@
 		57C72DA18039FED310967F8F /* XCTSourceCodeLocation.h in Headers */ = {isa = PBXBuildFile; fileRef = 81BB54ECBFB5B7B680BB5D4F /* XCTSourceCodeLocation.h */; };
 		57EAF450031647694B6491F8 /* FBConfiguration.m in Sources */ = {isa = PBXBuildFile; fileRef = EE9B76A21CF7A43900275851 /* FBConfiguration.m */; };
 		583AD004FF71CAA305E6DEAF /* XCUIDevice+FBHelpers.m in Sources */ = {isa = PBXBuildFile; fileRef = AD6C26971CF2481700F8B5FF /* XCUIDevice+FBHelpers.m */; };
+		0460879AD6034130AE0A3DEC /* XCUIDevice+FBHinge.m in Sources */ = {isa = PBXBuildFile; fileRef = 8C8E6FD103A84C908F5746EA /* XCUIDevice+FBHinge.m */; };
 		587AA46196BC2C46555C8E44 /* XCUIButtonConsole.h in Headers */ = {isa = PBXBuildFile; fileRef = 1E09842154A44874C4E9CA01 /* XCUIButtonConsole.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		588F51093FD2A5597366C282 /* XCUIElementEventTarget-Protocol.h in Headers */ = {isa = PBXBuildFile; fileRef = 0DC62BF635704E9C72AF533E /* XCUIElementEventTarget-Protocol.h */; };
 		5967912A40E807CDBE87E4B2 /* XCTReportingSessionIssueReporter-Protocol.h in Headers */ = {isa = PBXBuildFile; fileRef = 525D62A58488A52AA1BFE94A /* XCTReportingSessionIssueReporter-Protocol.h */; settings = {ATTRIBUTES = (Public, ); }; };
@@ -327,6 +328,7 @@
 		641EE60A2240C5CA00173FCB /* FBLogger.m in Sources */ = {isa = PBXBuildFile; fileRef = EE9B76A41CF7A43900275851 /* FBLogger.m */; };
 		641EE60B2240C5CA00173FCB /* FBCustomCommands.m in Sources */ = {isa = PBXBuildFile; fileRef = EE9AB7531CAEDF0C008C271F /* FBCustomCommands.m */; };
 		641EE60C2240C5CA00173FCB /* XCUIDevice+FBHelpers.m in Sources */ = {isa = PBXBuildFile; fileRef = AD6C26971CF2481700F8B5FF /* XCUIDevice+FBHelpers.m */; };
+		181F0DBB6D28418680D52128 /* XCUIDevice+FBHinge.m in Sources */ = {isa = PBXBuildFile; fileRef = 8C8E6FD103A84C908F5746EA /* XCUIDevice+FBHinge.m */; };
 		641EE60D2240C5CA00173FCB /* XCTestPrivateSymbols.m in Sources */ = {isa = PBXBuildFile; fileRef = EE6B64FC1D0F86EF00E85F5D /* XCTestPrivateSymbols.m */; };
 		641EE60E2240C5CA00173FCB /* XCUIElement+FBTyping.m in Sources */ = {isa = PBXBuildFile; fileRef = AD76723C1D6B7CC000610457 /* XCUIElement+FBTyping.m */; };
 		641EE60F2240C5CA00173FCB /* XCUIElement+FBAccessibility.m in Sources */ = {isa = PBXBuildFile; fileRef = EE9AB7461CAEDF0C008C271F /* XCUIElement+FBAccessibility.m */; };
@@ -433,6 +435,7 @@
 		641EE6BF2240C5CA00173FCB /* FBKeyboard.h in Headers */ = {isa = PBXBuildFile; fileRef = EE3A18641CDE734B00DE4205 /* FBKeyboard.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		641EE6C02240C5CA00173FCB /* XCUIApplication+FBHelpers.h in Headers */ = {isa = PBXBuildFile; fileRef = AD6C269A1CF2494200F8B5FF /* XCUIApplication+FBHelpers.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		641EE6C22240C5CA00173FCB /* XCUIDevice+FBHelpers.h in Headers */ = {isa = PBXBuildFile; fileRef = AD6C26961CF2481700F8B5FF /* XCUIDevice+FBHelpers.h */; settings = {ATTRIBUTES = (Public, ); }; };
+		95EF6989BCBE4C548C26B140 /* XCUIDevice+FBHinge.h in Headers */ = {isa = PBXBuildFile; fileRef = E7536267DE094076A4EEE1D7 /* XCUIDevice+FBHinge.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		641EE6C32240C5CA00173FCB /* FBClassChainQueryParser.h in Headers */ = {isa = PBXBuildFile; fileRef = 71A7EAF71E224648001DA4F2 /* FBClassChainQueryParser.h */; };
 		641EE6C42240C5CA00173FCB /* FBMacros.h in Headers */ = {isa = PBXBuildFile; fileRef = EE9B76A51CF7A43900275851 /* FBMacros.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		641EE6C52240C5CA00173FCB /* XCTestExpectationDelegate-Protocol.h in Headers */ = {isa = PBXBuildFile; fileRef = EE35ACD91E3B77D600A02D78 /* XCTestExpectationDelegate-Protocol.h */; settings = {ATTRIBUTES = (Public, ); }; };
@@ -887,7 +890,9 @@
 		AD6C26941CF2379700F8B5FF /* FBAlert.h in Headers */ = {isa = PBXBuildFile; fileRef = AD6C26921CF2379700F8B5FF /* FBAlert.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		AD6C26951CF2379700F8B5FF /* FBAlert.m in Sources */ = {isa = PBXBuildFile; fileRef = AD6C26931CF2379700F8B5FF /* FBAlert.m */; };
 		AD6C26981CF2481700F8B5FF /* XCUIDevice+FBHelpers.h in Headers */ = {isa = PBXBuildFile; fileRef = AD6C26961CF2481700F8B5FF /* XCUIDevice+FBHelpers.h */; settings = {ATTRIBUTES = (Public, ); }; };
+		210AB789D14D40308B764DD0 /* XCUIDevice+FBHinge.h in Headers */ = {isa = PBXBuildFile; fileRef = E7536267DE094076A4EEE1D7 /* XCUIDevice+FBHinge.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		AD6C26991CF2481700F8B5FF /* XCUIDevice+FBHelpers.m in Sources */ = {isa = PBXBuildFile; fileRef = AD6C26971CF2481700F8B5FF /* XCUIDevice+FBHelpers.m */; };
+		25C9BDFC65564D78A70231B4 /* XCUIDevice+FBHinge.m in Sources */ = {isa = PBXBuildFile; fileRef = 8C8E6FD103A84C908F5746EA /* XCUIDevice+FBHinge.m */; };
 		AD6C269C1CF2494200F8B5FF /* XCUIApplication+FBHelpers.h in Headers */ = {isa = PBXBuildFile; fileRef = AD6C269A1CF2494200F8B5FF /* XCUIApplication+FBHelpers.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		AD6C269D1CF2494200F8B5FF /* XCUIApplication+FBHelpers.m in Sources */ = {isa = PBXBuildFile; fileRef = AD6C269B1CF2494200F8B5FF /* XCUIApplication+FBHelpers.m */; };
 		AD764F10E2F00090AEB802F2 /* XCUIElement+FBIsVisible.m in Sources */ = {isa = PBXBuildFile; fileRef = EE9AB7481CAEDF0C008C271F /* XCUIElement+FBIsVisible.m */; };
@@ -987,6 +992,7 @@
 		D1172A7F53F89B78D8324A13 /* RouteRequest.m in Sources */ = {isa = PBXBuildFile; fileRef = 374BB11AE4E4243BCA444CF8 /* RouteRequest.m */; };
 		D1212325FDE77754EE503755 /* FBRouteRequest.m in Sources */ = {isa = PBXBuildFile; fileRef = EE9AB7881CAEDF0C008C271F /* FBRouteRequest.m */; };
 		D142183578036F5FD5B9880B /* XCUIDevice+FBHelpers.h in Headers */ = {isa = PBXBuildFile; fileRef = AD6C26961CF2481700F8B5FF /* XCUIDevice+FBHelpers.h */; };
+		2E71304F39B64EDC98EE3974 /* XCUIDevice+FBHinge.h in Headers */ = {isa = PBXBuildFile; fileRef = E7536267DE094076A4EEE1D7 /* XCUIDevice+FBHinge.h */; };
 		D14718959F7D46949859EEE6 /* FBDebugLogDelegateDecorator.m in Sources */ = {isa = PBXBuildFile; fileRef = EE7E27191D06C69F001BEC7B /* FBDebugLogDelegateDecorator.m */; };
 		D1DE06DF54156F744E364B5F /* FBDebugLogDelegateDecorator.h in Headers */ = {isa = PBXBuildFile; fileRef = EE7E27181D06C69F001BEC7B /* FBDebugLogDelegateDecorator.h */; };
 		D203F622C7C0D968F3BD2AAF /* XCUIPlatformApplicationServicesProviding-Protocol.h in Headers */ = {isa = PBXBuildFile; fileRef = 3BA71BCF1FDA482419CA8596 /* XCUIPlatformApplicationServicesProviding-Protocol.h */; };
@@ -1760,7 +1766,9 @@
 		AD6C26921CF2379700F8B5FF /* FBAlert.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = FBAlert.h; path = WebDriverAgentLib/FBAlert.h; sourceTree = SOURCE_ROOT; };
 		AD6C26931CF2379700F8B5FF /* FBAlert.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; lineEnding = 0; name = FBAlert.m; path = WebDriverAgentLib/FBAlert.m; sourceTree = SOURCE_ROOT; xcLanguageSpecificationIdentifier = xcode.lang.objc; };
 		AD6C26961CF2481700F8B5FF /* XCUIDevice+FBHelpers.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "XCUIDevice+FBHelpers.h"; sourceTree = "<group>"; };
+		E7536267DE094076A4EEE1D7 /* XCUIDevice+FBHinge.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "XCUIDevice+FBHinge.h"; sourceTree = "<group>"; };
 		AD6C26971CF2481700F8B5FF /* XCUIDevice+FBHelpers.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = "XCUIDevice+FBHelpers.m"; sourceTree = "<group>"; };
+		8C8E6FD103A84C908F5746EA /* XCUIDevice+FBHinge.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = "XCUIDevice+FBHinge.m"; sourceTree = "<group>"; };
 		AD6C269A1CF2494200F8B5FF /* XCUIApplication+FBHelpers.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "XCUIApplication+FBHelpers.h"; sourceTree = "<group>"; };
 		AD6C269B1CF2494200F8B5FF /* XCUIApplication+FBHelpers.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = "XCUIApplication+FBHelpers.m"; sourceTree = "<group>"; };
 		AD76723B1D6B7CC000610457 /* XCUIElement+FBTyping.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "XCUIElement+FBTyping.h"; sourceTree = "<group>"; };
@@ -2415,7 +2423,9 @@
 				EEDFE11F1D9C06F800E6FFE5 /* XCUIDevice+FBHealthCheck.h */,
 				EEDFE1201D9C06F800E6FFE5 /* XCUIDevice+FBHealthCheck.m */,
 				AD6C26961CF2481700F8B5FF /* XCUIDevice+FBHelpers.h */,
+				E7536267DE094076A4EEE1D7 /* XCUIDevice+FBHinge.h */,
 				AD6C26971CF2481700F8B5FF /* XCUIDevice+FBHelpers.m */,
+				8C8E6FD103A84C908F5746EA /* XCUIDevice+FBHinge.m */,
 				A1B2C3D41F001A00A1B0001 /* XCUIDevice+FBVoiceOver.h */,
 				A1B2C3D41F001A00A1B0002 /* XCUIDevice+FBVoiceOver.m */,
 				EEE3763D1D59F81400ED88DD /* XCUIDevice+FBRotation.h */,
@@ -3178,6 +3188,7 @@
 				641EE6C02240C5CA00173FCB /* XCUIApplication+FBHelpers.h in Headers */,
 				714EAA0E2673FDFE005C5B47 /* FBCapabilities.h in Headers */,
 				641EE6C22240C5CA00173FCB /* XCUIDevice+FBHelpers.h in Headers */,
+				95EF6989BCBE4C548C26B140 /* XCUIDevice+FBHinge.h in Headers */,
 				71D3B3D6267FC7260076473D /* XCUIElement+FBResolve.h in Headers */,
 				641EE6C32240C5CA00173FCB /* FBClassChainQueryParser.h in Headers */,
 				641EE6C42240C5CA00173FCB /* FBMacros.h in Headers */,
@@ -3489,6 +3500,7 @@
 				81231F08969740B0C8C67A30 /* XCUIApplication+FBHelpers.h in Headers */,
 				9AA0E22033281B4EAA78BC51 /* FBCapabilities.h in Headers */,
 				D142183578036F5FD5B9880B /* XCUIDevice+FBHelpers.h in Headers */,
+				2E71304F39B64EDC98EE3974 /* XCUIDevice+FBHinge.h in Headers */,
 				09D97BD46764FD8149747723 /* XCUIElement+FBResolve.h in Headers */,
 				6BF3F57247F59B81B8BCEE7B /* FBClassChainQueryParser.h in Headers */,
 				8AAA33A5B1943B667B0DB05E /* FBMacros.h in Headers */,
@@ -3756,6 +3768,7 @@
 				AD6C269C1CF2494200F8B5FF /* XCUIApplication+FBHelpers.h in Headers */,
 				714D88CC2733FB970074A925 /* FBXMLGenerationOptions.h in Headers */,
 				AD6C26981CF2481700F8B5FF /* XCUIDevice+FBHelpers.h in Headers */,
+				210AB789D14D40308B764DD0 /* XCUIDevice+FBHinge.h in Headers */,
 				71A7EAF91E224648001DA4F2 /* FBClassChainQueryParser.h in Headers */,
 				EE9B76AA1CF7A43900275851 /* FBMacros.h in Headers */,
 				C8FB547922D4C1FC00B69954 /* FBUnattachedAppLauncher.h in Headers */,
@@ -4513,6 +4526,7 @@
 				641EE60B2240C5CA00173FCB /* FBCustomCommands.m in Sources */,
 				71BB58E42B9631F100CB9BFE /* FBScreenRecordingPromise.m in Sources */,
 				641EE60C2240C5CA00173FCB /* XCUIDevice+FBHelpers.m in Sources */,
+				181F0DBB6D28418680D52128 /* XCUIDevice+FBHinge.m in Sources */,
 				641EE60D2240C5CA00173FCB /* XCTestPrivateSymbols.m in Sources */,
 				641EE60E2240C5CA00173FCB /* XCUIElement+FBTyping.m in Sources */,
 				641EE60F2240C5CA00173FCB /* XCUIElement+FBAccessibility.m in Sources */,
@@ -4668,6 +4682,7 @@
 				EDC993E0858F89F73D8E9DF8 /* FBCustomCommands.m in Sources */,
 				45033CF6BD35C16E34BF76CC /* FBScreenRecordingPromise.m in Sources */,
 				583AD004FF71CAA305E6DEAF /* XCUIDevice+FBHelpers.m in Sources */,
+				0460879AD6034130AE0A3DEC /* XCUIDevice+FBHinge.m in Sources */,
 				192CACF49EC3825BA6D2EF4F /* XCTestPrivateSymbols.m in Sources */,
 				53E0F0F38E7847065810FF41 /* XCUIElement+FBTyping.m in Sources */,
 				A5353D849D394BC630839E59 /* XCUIElement+FBAccessibility.m in Sources */,
@@ -4787,6 +4802,7 @@
 				EE9B76A91CF7A43900275851 /* FBLogger.m in Sources */,
 				EE158ABB1CBD456F00A3E3F0 /* FBCustomCommands.m in Sources */,
 				AD6C26991CF2481700F8B5FF /* XCUIDevice+FBHelpers.m in Sources */,
+				25C9BDFC65564D78A70231B4 /* XCUIDevice+FBHinge.m in Sources */,
 				716C9E0227315EFF005AD475 /* XCUIApplication+FBUIInterruptions.m in Sources */,
 				EE6B64FE1D0F86EF00E85F5D /* XCTestPrivateSymbols.m in Sources */,
 				AD76723E1D6B7CC000610457 /* XCUIElement+FBTyping.m in Sources */,

package/WebDriverAgentLib/Categories/XCAXClient_iOS+FBSnapshotReqParams.m

@@ -109,6 +109,14 @@ static id swizzledRequestSnapshotForElement(id self, SEL _cmd, id element, id at
     return original_requestSnapshotForElement(self, _cmd, element, attributes, parameters, error);
   }
 
+  // Remote WKWebView elements belong to a WebKit service, not the host app.
+  // Sending the idle-check AX action to WebContent can crash it (#1290).
+  // Read process metadata only: resolving UI attributes here can reenter
+  // snapshotting. Leave these services on the original snapshot path.
+  if ([application.bundleID hasPrefix:@"com.apple.WebKit."]) {
+    return original_requestSnapshotForElement(self, _cmd, element, attributes, parameters, error);
+  }
+
   NSNumber *pidKey = @(pid);
   @synchronized (unresponsiveApplicationPidsLock) {
     NSDate *markedUnresponsiveAt = unresponsiveApplicationPids[pidKey];

package/WebDriverAgentLib/Categories/XCUIDevice+FBHinge.h

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <XCTest/XCTest.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface XCUIDevice (FBHinge)
+
+/** Whether a hinge and the CoreMotion angle-reading APIs are available. */
+- (BOOL)fb_supportsHingeAngleReading;
+
+/**
+ Whether a hinge and the IOKit APIs needed to attempt injection are available.
+ This does not guarantee event acceptance, particularly on physical devices.
+ */
+- (BOOL)fb_canAttemptSimulatedHingeAngleInjection;
+
+/**
+ Reads the current hinge angle in degrees, including changes made outside WDA.
+ Waits up to 5 seconds for a valid reading. Does not change the hinge angle.
+ @return The angle, or nil with an error if unavailable or reading times out.
+ */
+- (nullable NSNumber *)fb_getSimulatedHingeAngle:(NSError **)error;
+
+/**
+ Sends a simulated hinge angle in degrees (0 = closed, 180 = fully open).
+ This dispatches the event; the display transition completes asynchronously.
+ Verified on the iPhone Duo simulator; physical-device behavior is unverified.
+ Does not change currentDisplayId.
+ */
+- (BOOL)fb_setSimulatedHingeAngle:(double)angle error:(NSError **)error;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/WebDriverAgentLib/Categories/XCUIDevice+FBHinge.m

@@ -0,0 +1,215 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "XCUIDevice+FBHinge.h"
+
+#import <dlfcn.h>
+#import <math.h>
+#import <mach/mach_time.h>
+
+#import "FBErrorBuilder.h"
+
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
+static const NSTimeInterval FBHingeAngleReadingTimeout = 5.0;
+
+typedef CFDataRef (*FBIOCFSerialize)(CFTypeRef object, CFOptionFlags options);
+typedef CFTypeRef (*FBIOHIDEventCreateVendorDefinedEvent)(CFAllocatorRef allocator,
+                                                       uint64_t timestamp,
+                                                       uint32_t usagePage,
+                                                       uint32_t usage,
+                                                       uint32_t version,
+                                                       uint8_t *data,
+                                                       CFIndex length,
+                                                       uint32_t options);
+typedef CFTypeRef (*FBIOHIDEventSystemClientCreate)(CFAllocatorRef allocator);
+typedef void (*FBIOHIDEventSystemClientDispatchEvent)(CFTypeRef client, CFTypeRef event);
+
+@protocol FBAngle <NSObject>
+- (BOOL)isAngleValid;
+- (float)angleDegrees;
+@end
+
+@protocol FBAngleManager <NSObject>
++ (instancetype)new;
++ (BOOL)isAvailable;
++ (BOOL)instancesRespondToSelector:(SEL)selector;
+- (void)startAngleUpdatesToQueue:(NSOperationQueue *)queue handler:(void (^)(id<FBAngle>))handler;
+- (void)stopAngleUpdates;
+@end
+
+static Class<FBAngleManager> FBAngleManagerClass(void)
+{
+  static Class<FBAngleManager> angleManagerClass;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    // This path also loads on physical devices (verified on an iPad mini).
+    // Framework/class presence does not imply that a hinge sensor is available.
+    if (NULL != dlopen("/System/Library/Frameworks/CoreMotion.framework/CoreMotion", RTLD_LAZY)) {
+      angleManagerClass = NSClassFromString(@"CMAngleManager");
+    }
+  });
+  return angleManagerClass;
+}
+
+static BOOL FBHasAvailableHinge(void)
+{
+  Class<FBAngleManager> managerClass = FBAngleManagerClass();
+  return [managerClass respondsToSelector:@selector(isAvailable)] && [managerClass isAvailable];
+}
+
+typedef struct {
+  FBIOCFSerialize serialize;
+  FBIOHIDEventCreateVendorDefinedEvent createEvent;
+  FBIOHIDEventSystemClientCreate createClient;
+  FBIOHIDEventSystemClientDispatchEvent dispatchEvent;
+} FBHingeInjectionAPI;
+
+// Loads and caches the injection APIs; NULL means at least one is unavailable.
+// Resolving these functions does not dispatch an event or confirm its acceptance.
+static const FBHingeInjectionAPI *FBHingeInjectionFunctions(void)
+{
+  static FBHingeInjectionAPI api;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    void *handle = dlopen("/System/Library/Frameworks/IOKit.framework/IOKit", RTLD_LAZY);
+    if (NULL != handle) {
+      api.serialize = (FBIOCFSerialize)dlsym(handle, "IOCFSerialize");
+      api.createEvent = (FBIOHIDEventCreateVendorDefinedEvent)dlsym(handle, "IOHIDEventCreateVendorDefinedEvent");
+      api.createClient = (FBIOHIDEventSystemClientCreate)dlsym(handle, "IOHIDEventSystemClientCreate");
+      api.dispatchEvent = (FBIOHIDEventSystemClientDispatchEvent)dlsym(handle, "IOHIDEventSystemClientDispatchEvent");
+    }
+  });
+  return NULL != api.serialize && NULL != api.createEvent
+    && NULL != api.createClient && NULL != api.dispatchEvent ? &api : NULL;
+}
+#endif
+
+@implementation XCUIDevice (FBHinge)
+
+- (BOOL)fb_supportsHingeAngleReading
+{
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
+  Class<FBAngleManager> managerClass = FBAngleManagerClass();
+  return FBHasAvailableHinge()
+    && [managerClass instancesRespondToSelector:@selector(startAngleUpdatesToQueue:handler:)]
+    && [managerClass instancesRespondToSelector:@selector(stopAngleUpdates)];
+#else
+  return NO;
+#endif
+}
+
+- (BOOL)fb_canAttemptSimulatedHingeAngleInjection
+{
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
+  // Sensor presence and local APIs permit an attempt, not proof that the
+  // device's receiver accepts the vendor event. Physical devices are unverified.
+  return FBHasAvailableHinge() && NULL != FBHingeInjectionFunctions();
+#else
+  return NO;
+#endif
+}
+
+- (nullable NSNumber *)fb_getSimulatedHingeAngle:(NSError **)error
+{
+  if (!self.fb_supportsHingeAngleReading) {
+    [[FBErrorBuilder.builder withDescription:@"Hinge angle reading is unavailable on this device"] buildError:error];
+    return nil;
+  }
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
+  id<FBAngleManager> manager = [FBAngleManagerClass() new];
+  NSOperationQueue *queue = [NSOperationQueue new];
+  queue.maxConcurrentOperationCount = 1;
+  NSCondition *condition = [NSCondition new];
+  __block NSNumber *reading = nil;
+  NSNumber *result;
+  @try {
+    [manager startAngleUpdatesToQueue:queue handler:^(id<FBAngle> angle) {
+      if (![angle respondsToSelector:@selector(isAngleValid)]
+          || ![angle respondsToSelector:@selector(angleDegrees)] || !angle.isAngleValid) {
+        return;
+      }
+      float degrees = angle.angleDegrees;
+      if (!isfinite(degrees)) {
+        return;
+      }
+      [condition lock];
+      if (nil == reading) {
+        reading = @(degrees);
+        [condition signal];
+      }
+      [condition unlock];
+    }];
+    NSDate *deadline = [NSDate dateWithTimeIntervalSinceNow:FBHingeAngleReadingTimeout];
+    [condition lock];
+    while (nil == reading) {
+      if (![condition waitUntilDate:deadline]) {
+        break;
+      }
+    }
+    result = reading;
+    [condition unlock];
+  } @finally {
+    [manager stopAngleUpdates];
+  }
+  if (nil == result) {
+    [[FBErrorBuilder.builder withDescriptionFormat:@"Timed out after %g seconds waiting for a valid hinge angle",
+      FBHingeAngleReadingTimeout] buildError:error];
+  }
+  return result;
+#else
+  return nil;
+#endif
+}
+
+- (BOOL)fb_setSimulatedHingeAngle:(double)angle error:(NSError **)error
+{
+  if (!isfinite(angle) || angle < 0 || angle > 180) {
+    return [[FBErrorBuilder.builder withDescription:@"Hinge angle must be a finite number between 0 and 180 degrees"] buildError:error];
+  }
+  if (!self.fb_canAttemptSimulatedHingeAngleInjection) {
+    return [[FBErrorBuilder.builder withDescription:@"Hinge angle injection requires an available hinge and the IOKit HID APIs"] buildError:error];
+  }
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
+  // WDA's fb_performIOHIDEventWithPage:usage:duration:error: uses XCDeviceEvent
+  // with page, usage, and duration only. The XCDeviceEvent interfaces checked
+  // in Xcode 27.1 provide no way to attach the vendor payload containing the
+  // hinge angle, so this command creates and dispatches an IOKit event directly.
+  const FBHingeInjectionAPI *api = FBHingeInjectionFunctions();
+  // Matches Device Hub's hinge-slider-control payload (Xcode 27.1). It is an
+  // IOCF binary serialization, not an NSPropertyListSerialization binary plist.
+  NSDictionary *payload = @{
+    @"provider": @"com.apple.Virtualization.VirtualMachines",
+    @"source": @"hinge-slider-control",
+    @"type": @"range",
+    @"value": @(angle),
+  };
+  CFDataRef data = api->serialize((__bridge CFTypeRef)payload, 1);
+  if (NULL == data) {
+    return [[FBErrorBuilder.builder withDescription:@"Cannot serialize the simulated hinge event"] buildError:error];
+  }
+  CFTypeRef event = api->createEvent(kCFAllocatorDefault, mach_absolute_time(), 0xff61, 0x5b, 0,
+                                    (uint8_t *)CFDataGetBytePtr(data), CFDataGetLength(data), 0);
+  CFRelease(data);
+  CFTypeRef client = api->createClient(kCFAllocatorDefault);
+  BOOL canDispatch = NULL != event && NULL != client;
+  if (canDispatch) {
+    api->dispatchEvent(client, event);
+  }
+  if (NULL != event) {
+    CFRelease(event);
+  }
+  if (NULL != client) {
+    CFRelease(client);
+  }
+  return canDispatch || [[FBErrorBuilder.builder withDescription:@"Cannot create the simulated hinge HID event or client"] buildError:error];
+#else
+  return NO;
+#endif
+}
+
+@end

package/WebDriverAgentLib/Commands/FBCustomCommands.m

@@ -29,10 +29,12 @@
 #import "XCUIApplication.h"
 #import "XCUIApplication+FBHelpers.h"
 #import "XCUIDevice+FBHelpers.h"
+#import "XCUIDevice+FBHinge.h"
 #import "XCUIDevice+FBVoiceOver.h"
 #import "XCUIElement.h"
 #import "XCUIElement+FBIsVisible.h"
 #import "XCUIElementQuery.h"
+#import "XCUIScreen.h"
 #import "FBUnattachedAppLauncher.h"
 
 @implementation FBCustomCommands
@@ -74,6 +76,10 @@
     [[FBRoute POST:@"/wda/expectNotification"] respondWithTarget:self action:@selector(handleExpectNotification:)],
     [[FBRoute POST:@"/wda/siri/activate"] respondWithTarget:self action:@selector(handleActivateSiri:)],
     [[FBRoute POST:@"/wda/apps/launchUnattached"].withoutSession respondWithTarget:self action:@selector(handleLaunchUnattachedApp:)],
+    [[FBRoute GET:@"/wda/device/hingeAngle"] respondWithTarget:self action:@selector(handleGetSimulatedHingeAngle:)],
+    [[FBRoute GET:@"/wda/device/hingeAngle"].withoutSession respondWithTarget:self action:@selector(handleGetSimulatedHingeAngle:)],
+    [[FBRoute POST:@"/wda/device/hingeAngle"] respondWithTarget:self action:@selector(handleSetSimulatedHingeAngle:)],
+    [[FBRoute POST:@"/wda/device/hingeAngle"].withoutSession respondWithTarget:self action:@selector(handleSetSimulatedHingeAngle:)],
     [[FBRoute GET:@"/wda/device/info"] respondWithTarget:self action:@selector(handleGetDeviceInfo:)],
     [[FBRoute POST:@"/wda/resetAppAuth"] respondWithTarget:self action:@selector(handleResetAppAuth:)],
     [[FBRoute GET:@"/wda/device/info"].withoutSession respondWithTarget:self action:@selector(handleGetDeviceInfo:)],
@@ -157,17 +163,41 @@
 
 + (id<FBResponsePayload>)handleGetScreen:(FBRouteRequest *)request
 {
+  NSError *error = nil;
+  XCUIScreen *screen = [FBScreen currentScreenWithError:&error];
+  if (nil == screen) {
+    return FBResponseWithStatus([FBCommandStatus invalidArgumentErrorWithMessage:error.localizedDescription
+                                                                     traceback:nil]);
+  }
   XCUIApplication *app = XCUIApplication.fb_systemApplication;
-
-  XCUIElement *mainStatusBar = app.statusBars.allElementsBoundByIndex.firstObject;
-  CGSize statusBarSize = (nil == mainStatusBar) ? CGSizeZero : mainStatusBar.frame.size;
-
-#if TARGET_OS_TV || TARGET_OS_WATCH
-  CGSize screenSize = app.frame.size;
-#else
-  CGSize screenSize = FBAdjustDimensionsForApplication(app.wdFrame.size, app.interfaceOrientation);
+  CGSize screenSize = CGSizeMake(CGRectGetWidth(screen.bounds) / screen.scale,
+                                 CGRectGetHeight(screen.bounds) / screen.scale);
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
+  XCUIApplication *activeApp = request.session ? request.session.activeApplication : XCUIApplication.fb_activeApplication;
+  screenSize = FBAdjustDimensionsForApplication(screenSize, activeApp.interfaceOrientation);
 #endif
 
+  // SpringBoard can expose hidden status bars belonging to other displays, and
+  // Duo also exposes full-screen containers for its side-mounted status UI.
+  // Only a visible horizontal bar at the top of this display can be subtracted
+  // from a rectangular viewport.
+  CGSize statusBarSize = CGSizeZero;
+  for (XCUIElement *statusBar in app.statusBars.allElementsBoundByIndex) {
+    // Resolve the element before reading its screen: displayID can be zero on
+    // an unresolved query result even when the bar belongs to the main screen.
+    CGRect frame = statusBar.frame;
+    if (statusBar.screen.displayID != screen.displayID || !statusBar.fb_isVisible) {
+      continue;
+    }
+    if (fabs(CGRectGetMinY(frame)) <= 1 && fabs(CGRectGetMinX(frame)) <= 1
+        && fabs(CGRectGetWidth(frame) - screenSize.width) <= 1
+        && CGRectGetHeight(frame) > 0 && CGRectGetHeight(frame) < screenSize.height
+        && CGRectGetHeight(frame) < CGRectGetWidth(frame)) {
+      statusBarSize = frame.size;
+      break;
+    }
+  }
+
   return FBResponseWithObject(
                               @{
     @"screenSize":@{@"width": @(screenSize.width),
@@ -176,8 +206,8 @@
     @"statusBarSize": @{@"width": @(statusBarSize.width),
                         @"height": @(statusBarSize.height),
     },
-    @"displayId": @([FBScreen displayID]),
-    @"scale": @([FBScreen scale]),
+    @"displayId": @(screen.displayID),
+    @"scale": @(screen.scale),
   });
 }
 
@@ -777,4 +807,35 @@
   return FBResponseWithObject(result);
 }
 
++ (id<FBResponsePayload>)handleGetSimulatedHingeAngle:(FBRouteRequest *)request
+{
+  if (!XCUIDevice.sharedDevice.fb_supportsHingeAngleReading) {
+    return FBResponseWithStatus([FBCommandStatus unsupportedOperationErrorWithMessage:
+      @"Hinge angle reading is unavailable on this device" traceback:nil]);
+  }
+  NSError *error;
+  NSNumber *angle = [XCUIDevice.sharedDevice fb_getSimulatedHingeAngle:&error];
+  return nil == angle ? FBResponseWithUnknownError(error) : FBResponseWithObject(angle);
+}
+
++ (id<FBResponsePayload>)handleSetSimulatedHingeAngle:(FBRouteRequest *)request
+{
+  id angle = request.arguments[@"angle"];
+  if (![angle isKindOfClass:NSNumber.class]
+      || CFGetTypeID((__bridge CFTypeRef)angle) == CFBooleanGetTypeID()
+      || !isfinite([angle doubleValue]) || [angle doubleValue] < 0 || [angle doubleValue] > 180) {
+    return FBResponseWithStatus([FBCommandStatus invalidArgumentErrorWithMessage:
+      @"'angle' must be a finite number between 0 and 180 degrees" traceback:nil]);
+  }
+  if (!XCUIDevice.sharedDevice.fb_canAttemptSimulatedHingeAngleInjection) {
+    return FBResponseWithStatus([FBCommandStatus unsupportedOperationErrorWithMessage:
+      @"Setting a simulated hinge angle requires a compatible foldable device" traceback:nil]);
+  }
+  NSError *error;
+  if (![XCUIDevice.sharedDevice fb_setSimulatedHingeAngle:[angle doubleValue] error:&error]) {
+    return FBResponseWithUnknownError(error);
+  }
+  return FBResponseWithOK();
+}
+
 @end

package/WebDriverAgentLib/Info.plist

@@ -15,11 +15,11 @@
     <key>CFBundlePackageType</key>
     <string>FMWK</string>
     <key>CFBundleShortVersionString</key>
-    <string>16.13.6</string>
+    <string>16.14.1</string>
     <key>CFBundleSignature</key>
     <string>????</string>
     <key>CFBundleVersion</key>
-    <string>16.13.6</string>
+    <string>16.14.1</string>
     <key>NSPrincipalClass</key>
     <string/>
   </dict>

package/WebDriverAgentLib/Routing/FBScreenRecordingRequest.m

@@ -9,6 +9,7 @@
 #import "FBScreenRecordingRequest.h"
 
 #import "FBErrorBuilder.h"
+#import "FBScreen.h"
 #import "XCUIScreen.h"
 
 @implementation FBScreenRecordingRequest
@@ -56,6 +57,10 @@
 
 - (id)toNativeRequestWithError:(NSError **)error
 {
+  XCUIScreen *screen = [FBScreen currentScreenWithError:error];
+  if (nil == screen) {
+    return nil;
+  }
   Class screenRecordingRequestClass = NSClassFromString(@"XCTScreenRecordingRequest");
   if (nil == screenRecordingRequestClass) {
     [[[FBErrorBuilder builder]
@@ -80,8 +85,8 @@
   NSMethodSignature *screenRecordingRequestContructorSignature = [screenRecordingRequestAllocated methodSignatureForSelector:screenRecordingRequestConstructorSelector];
   NSInvocation *screenRecordingRequestInitInvocation = [NSInvocation invocationWithMethodSignature:screenRecordingRequestContructorSignature];
   [screenRecordingRequestInitInvocation setSelector:screenRecordingRequestConstructorSelector];
-  long long mainScreenId = XCUIScreen.mainScreen.displayID;
-  [screenRecordingRequestInitInvocation setArgument:&mainScreenId atIndex:2];
+  long long screenId = screen.displayID;
+  [screenRecordingRequestInitInvocation setArgument:&screenId atIndex:2];
   CGRect fullScreenRect = CGRectNull;
   [screenRecordingRequestInitInvocation setArgument:&fullScreenRect atIndex:3];
   [screenRecordingRequestInitInvocation setArgument:&videoEncoding atIndex:4];

package/WebDriverAgentLib/Utilities/FBActiveAppDetectionPoint.h

@@ -24,14 +24,14 @@ NS_ASSUME_NONNULL_BEGIN
  * Calculates the accessbility element which is located at the given screen coordinates
  *
  * @param point The screen coordinates
- * @returns The retrieved accessbility element or nil if it cannot be detected
+ * @returns The retrieved accessbility element or nil if it cannot be detected or a secondary display is selected
  */
 + (nullable id<FBXCAccessibilityElement>)axElementWithPoint:(CGPoint)point;
 
 /**
  * Retrieves the accessbility element for the current screen point
  *
- * @returns The retrieved accessbility element or nil if it cannot be detected
+ * @returns The retrieved accessbility element or nil if it cannot be detected or a secondary display is selected
  */
 - (nullable id<FBXCAccessibilityElement>)axElement;
 

package/WebDriverAgentLib/Utilities/FBActiveAppDetectionPoint.m

@@ -13,6 +13,10 @@
 #endif
 
 #import "FBErrorBuilder.h"
+#import "FBScreen.h"
+#import "FBConfiguration.h"
+#import "FBExceptions.h"
+#import "XCUIScreen.h"
 #import "FBLogger.h"
 #import "FBXCTestDaemonsProxy.h"
 #import "XCTMessagingChannel_RunnerToDaemon-Protocol.h"
@@ -45,6 +49,22 @@
 
 + (id<FBXCAccessibilityElement>)axElementWithPoint:(CGPoint)point
 {
+  if (nil != FBConfiguration.sharedInstance.currentDisplayId) {
+    NSError *error;
+    XCUIScreen *screen = [FBScreen currentScreenWithError:&error];
+    if (nil == screen) {
+      @throw [NSException exceptionWithName:FBInvalidArgumentException
+                                    reason:error.localizedDescription
+                                  userInfo:nil];
+    }
+    // XCTest's point lookup has no display parameter and always hits the main
+    // display. On Duo this can select the outer SpringBoard while the app is
+    // foreground on the inner display. Let callers use their active-app fallback
+    // instead of treating an element from a different display as authoritative.
+    if (screen.displayID != XCUIScreen.mainScreen.displayID) {
+      return nil;
+    }
+  }
   __block id<FBXCAccessibilityElement> onScreenElement = nil;
   id<XCTMessagingChannel_RunnerToDaemon> proxy = [FBXCTestDaemonsProxy testRunnerProxy];
   dispatch_semaphore_t sem = dispatch_semaphore_create(0);

package/WebDriverAgentLib/Utilities/FBConfiguration.h

@@ -369,7 +369,7 @@ typedef NS_ENUM(NSInteger, FBConfigurationKeyboardPreference) {
 @property (atomic, assign) BOOL enforceCustomSnapshots;
 
 /**
- * The identifier of the display targeted by screenshots.
+ * The identifier of the display targeted by screenshots, MJPEG, and new screen recordings.
  * nil means the main display. Reset to nil for each new session.
  */
 @property (atomic, copy, nullable) NSNumber *currentDisplayId;