appium-webdriveragent 14.0.0 → 14.1.1

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [14.1.1](https://github.com/appium/WebDriverAgent/compare/v14.1.0...v14.1.1) (2026-06-10)
+
+### Miscellaneous Chores
+
+* address runtime version rather than Xcode for selector based methods ([#1154](https://github.com/appium/WebDriverAgent/issues/1154)) ([6618b0b](https://github.com/appium/WebDriverAgent/commit/6618b0b6ccd06c69fc9e4a0947ef0c88c89b1e48))
+
+## [14.1.0](https://github.com/appium/WebDriverAgent/compare/v14.0.0...v14.1.0) (2026-06-10)
+
+### Features
+
+* Add VoiceOver automation support ([#1153](https://github.com/appium/WebDriverAgent/issues/1153)) ([6b3631a](https://github.com/appium/WebDriverAgent/commit/6b3631aed7a95439b01a9a3bb87189df384dcf06))
+
 ## [14.0.0](https://github.com/appium/WebDriverAgent/compare/v13.3.0...v14.0.0) (2026-06-09)
 
 ### ⚠ BREAKING CHANGES

package/WebDriverAgent.xcodeproj/project.pbxproj

@@ -535,6 +535,11 @@
 		71F5BE50252F14EB00EE9EBA /* FBExceptions.h in Headers */ = {isa = PBXBuildFile; fileRef = 71F5BE4D252F14EB00EE9EBA /* FBExceptions.h */; };
 		71F5BE51252F14EB00EE9EBA /* FBExceptions.m in Sources */ = {isa = PBXBuildFile; fileRef = 71F5BE4E252F14EB00EE9EBA /* FBExceptions.m */; };
 		71F5BE52252F14EB00EE9EBA /* FBExceptions.m in Sources */ = {isa = PBXBuildFile; fileRef = 71F5BE4E252F14EB00EE9EBA /* FBExceptions.m */; };
+		A1B2C3D41F001A00A1B0004 /* XCUIDevice+FBVoiceOver.h in Headers */ = {isa = PBXBuildFile; fileRef = A1B2C3D41F001A00A1B0001 /* XCUIDevice+FBVoiceOver.h */; settings = {ATTRIBUTES = (Public, ); }; };
+		A1B2C3D41F001A00A1B0005 /* XCUIDevice+FBVoiceOver.m in Sources */ = {isa = PBXBuildFile; fileRef = A1B2C3D41F001A00A1B0002 /* XCUIDevice+FBVoiceOver.m */; };
+		A1B2C3D41F001A00A1B0006 /* XCUIDevice+FBVoiceOver.h in Headers */ = {isa = PBXBuildFile; fileRef = A1B2C3D41F001A00A1B0001 /* XCUIDevice+FBVoiceOver.h */; settings = {ATTRIBUTES = (Public, ); }; };
+		A1B2C3D41F001A00A1B0007 /* XCUIDevice+FBVoiceOver.m in Sources */ = {isa = PBXBuildFile; fileRef = A1B2C3D41F001A00A1B0002 /* XCUIDevice+FBVoiceOver.m */; };
+		A1B2C3D41F001A00A1B0008 /* FBVoiceOverTests.m in Sources */ = {isa = PBXBuildFile; fileRef = A1B2C3D41F001A00A1B0003 /* FBVoiceOverTests.m */; };
 		A1B2C3D4E5F600000000001B /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = A1B2C3D4E5F600000000001A /* Assets.xcassets */; };
 		AABBCCDDEEFF001122334457 /* SceneDelegate.m in Sources */ = {isa = PBXBuildFile; fileRef = AABBCCDDEEFF001122334456 /* SceneDelegate.m */; };
 		AD35D06C1CF1C35500870A75 /* WebDriverAgentLib.framework in Copy frameworks */ = {isa = PBXBuildFile; fileRef = EE158A991CBD452B00A3E3F0 /* WebDriverAgentLib.framework */; settings = {ATTRIBUTES = (CodeSignOnCopy, RemoveHeadersOnCopy, ); }; };
@@ -1125,6 +1130,9 @@
 		71F5BE33252E5B2200EE9EBA /* FBElementSwipingTests.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = FBElementSwipingTests.m; sourceTree = "<group>"; };
 		71F5BE4D252F14EB00EE9EBA /* FBExceptions.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = FBExceptions.h; sourceTree = "<group>"; };
 		71F5BE4E252F14EB00EE9EBA /* FBExceptions.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = FBExceptions.m; sourceTree = "<group>"; };
+		A1B2C3D41F001A00A1B0001 /* XCUIDevice+FBVoiceOver.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "XCUIDevice+FBVoiceOver.h"; sourceTree = "<group>"; };
+		A1B2C3D41F001A00A1B0002 /* XCUIDevice+FBVoiceOver.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = "XCUIDevice+FBVoiceOver.m"; sourceTree = "<group>"; };
+		A1B2C3D41F001A00A1B0003 /* FBVoiceOverTests.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = FBVoiceOverTests.m; sourceTree = "<group>"; };
 		A1B2C3D4E5F600000000001A /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; name = Assets.xcassets; path = WebDriverAgentRunner/Assets.xcassets; sourceTree = SOURCE_ROOT; };
 		AABBCCDDEEFF001122334455 /* SceneDelegate.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = SceneDelegate.h; sourceTree = "<group>"; };
 		AABBCCDDEEFF001122334456 /* SceneDelegate.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SceneDelegate.m; sourceTree = "<group>"; };
@@ -1798,6 +1806,8 @@
 				EEDFE1201D9C06F800E6FFE5 /* XCUIDevice+FBHealthCheck.m */,
 				AD6C26961CF2481700F8B5FF /* XCUIDevice+FBHelpers.h */,
 				AD6C26971CF2481700F8B5FF /* XCUIDevice+FBHelpers.m */,
+				A1B2C3D41F001A00A1B0001 /* XCUIDevice+FBVoiceOver.h */,
+				A1B2C3D41F001A00A1B0002 /* XCUIDevice+FBVoiceOver.m */,
 				EEE3763D1D59F81400ED88DD /* XCUIDevice+FBRotation.h */,
 				EEE3763E1D59F81400ED88DD /* XCUIDevice+FBRotation.m */,
 				EE9AB7451CAEDF0C008C271F /* XCUIElement+FBAccessibility.h */,
@@ -2070,6 +2080,7 @@
 				AD76723F1D6B826F00610457 /* FBTypingTest.m */,
 				714CA3C61DC23186000F12C9 /* FBXPathIntegrationTests.m */,
 				71BB58DD2B9631B700CB9BFE /* FBVideoRecordingTests.m */,
+				A1B2C3D41F001A00A1B0003 /* FBVoiceOverTests.m */,
 				71241D7D1FAF084E00B9559F /* FBW3CTouchActionsIntegrationTests.m */,
 				71241D7F1FAF087500B9559F /* FBW3CMultiTouchActionsIntegrationTests.m */,
 				7136C0F8243A182400921C76 /* FBW3CTypeActionsTests.m */,
@@ -2513,6 +2524,7 @@
 				71822777258744CE00661B83 /* DDNumber.h in Headers */,
 				641EE6C82240C5CA00173FCB /* XCTKVOExpectation.h in Headers */,
 				641EE6C92240C5CA00173FCB /* XCUIDevice+FBRotation.h in Headers */,
+				A1B2C3D41F001A00A1B0004 /* XCUIDevice+FBVoiceOver.h in Headers */,
 				641EE6CA2240C5CA00173FCB /* XCEventGenerator.h in Headers */,
 				719DCF162601EAFB000E765F /* FBNotificationsHelper.h in Headers */,
 				71414ED52670A1EE003A8C5D /* LRUCache.h in Headers */,
@@ -2760,6 +2772,7 @@
 				EE35AD591E3B77D600A02D78 /* XCTKVOExpectation.h in Headers */,
 				13DE7A43287C2A8D003243C6 /* FBXCAccessibilityElement.h in Headers */,
 				EEE376431D59F81400ED88DD /* XCUIDevice+FBRotation.h in Headers */,
+				A1B2C3D41F001A00A1B0006 /* XCUIDevice+FBVoiceOver.h in Headers */,
 				EE35AD2E1E3B77D600A02D78 /* XCEventGenerator.h in Headers */,
 				EE9B76A61CF7A43900275851 /* FBConfiguration.h in Headers */,
 				EE35AD571E3B77D600A02D78 /* XCTestSuiteRun.h in Headers */,
@@ -3206,6 +3219,7 @@
 				641EE5F22240C5CA00173FCB /* NSPredicate+FBFormat.m in Sources */,
 				718F49CA23087AD30045FE8B /* FBProtocolHelpers.m in Sources */,
 				641EE5F42240C5CA00173FCB /* XCUIDevice+FBRotation.m in Sources */,
+				A1B2C3D41F001A00A1B0005 /* XCUIDevice+FBVoiceOver.m in Sources */,
 				13815F722328D20400CDAB61 /* FBActiveAppDetectionPoint.m in Sources */,
 				71D475C52538F5A8008D9401 /* XCUIApplicationProcess+FBQuiescence.m in Sources */,
 				641EE5F52240C5CA00173FCB /* XCUIElement+FBUID.m in Sources */,
@@ -3333,6 +3347,7 @@
 				71A224E61DE2F56600844D55 /* NSPredicate+FBFormat.m in Sources */,
 				E444DC85249131B10060D7EB /* DDNumber.m in Sources */,
 				EEE376441D59F81400ED88DD /* XCUIDevice+FBRotation.m in Sources */,
+				A1B2C3D41F001A00A1B0007 /* XCUIDevice+FBVoiceOver.m in Sources */,
 				13815F712328D20400CDAB61 /* FBActiveAppDetectionPoint.m in Sources */,
 				71B49EC81ED1A58100D51AD6 /* XCUIElement+FBUID.m in Sources */,
 				EE158AE21CBD456F00A3E3F0 /* FBRouteRequest.m in Sources */,
@@ -3422,6 +3437,7 @@
 			files = (
 				71241D801FAF087500B9559F /* FBW3CMultiTouchActionsIntegrationTests.m in Sources */,
 				71BB58DE2B9631B700CB9BFE /* FBVideoRecordingTests.m in Sources */,
+				A1B2C3D41F001A00A1B0008 /* FBVoiceOverTests.m in Sources */,
 				71241D7E1FAF084E00B9559F /* FBW3CTouchActionsIntegrationTests.m in Sources */,
 				63FD950221F9D06100A3E356 /* FBImageProcessorTests.m in Sources */,
 				719CD8FF2126C90200C7D0C2 /* FBAutoAlertsHandlerTests.m in Sources */,
@@ -4300,7 +4316,7 @@
 				CLANG_ANALYZER_NONNULL = YES;
 				DEBUG_INFORMATION_FORMAT = dwarf;
 				INFOPLIST_FILE = WebDriverAgentTests/IntegrationApp/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
@@ -4317,7 +4333,7 @@
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ANALYZER_NONNULL = YES;
 				INFOPLIST_FILE = WebDriverAgentTests/IntegrationApp/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",

package/WebDriverAgentLib/Categories/XCUIDevice+FBHelpers.h

@@ -169,7 +169,7 @@ typedef NS_ENUM(NSUInteger, FBUIInterfaceAppearance) {
 #if !TARGET_OS_TV
 /**
  Allows to set a simulated geolocation coordinates.
- Only works since Xcode 14.3/iOS 16.4
+ Only works since iOS 16.4 runtime
 
  @param location The simlated location coordinates to set
  @param error If there is an error, upon return contains an NSError object that describes the problem.
@@ -179,7 +179,7 @@ typedef NS_ENUM(NSUInteger, FBUIInterfaceAppearance) {
 
 /**
  Allows to get a simulated geolocation coordinates.
- Only works since Xcode 14.3/iOS 16.4
+ Only works since iOS 16.4 runtime
 
  @param error If there is an error, upon return contains an NSError object that describes the problem.
  @return The current simulated location or nil in case of failure or if no location has previously been seet
@@ -189,7 +189,7 @@ typedef NS_ENUM(NSUInteger, FBUIInterfaceAppearance) {
 
 /**
  Allows to clear a previosuly set simulated geolocation coordinates.
- Only works since Xcode 14.3/iOS 16.4
+ Only works since iOS 16.4 runtime
 
  @param error If there is an error, upon return contains an NSError object that describes the problem.
  @return YES if the simulated location has been successfully cleared

package/WebDriverAgentLib/Categories/XCUIDevice+FBHelpers.m

@@ -229,7 +229,7 @@ static bool fb_isLocked;
     return [self fb_activateSiriVoiceRecognitionWithText:[NSString stringWithFormat:@"Open {%@}", url] error:error];
   }
 
-  NSString *description = [NSString stringWithFormat:@"Cannot open '%@' with the default application assigned for it. Consider upgrading to Xcode 14.3+/iOS 16.4+", url];
+  NSString *description = [NSString stringWithFormat:@"Cannot open '%@' with the default application assigned for it. This API requires an iOS 16.4+ runtime", url];
   return [[[FBErrorBuilder builder]
            withDescriptionFormat:@"%@", description]
           buildError:error];

package/WebDriverAgentLib/Categories/XCUIDevice+FBVoiceOver.h

@@ -0,0 +1,66 @@
+/**
+ * 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 (FBVoiceOver)
+
+/**
+ Whether VoiceOver control APIs are available in the current OS runtime.
+
+ @return YES if the VoiceOver service is exposed by XCUIDevice
+ */
+- (BOOL)fb_isVoiceOverServiceAvailable;
+
+/**
+ Enable VoiceOver. Only works since iOS 27 runtime.
+
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if VoiceOver has been successfully enabled
+ */
+- (BOOL)fb_enableVoiceOver:(NSError **)error;
+
+/**
+ Disable VoiceOver. Only works since iOS 27 runtime.
+
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if VoiceOver has been successfully disabled
+ */
+- (BOOL)fb_disableVoiceOver:(NSError **)error;
+
+/**
+ Whether VoiceOver is currently enabled. Only works since iOS 27 runtime.
+
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if VoiceOver is enabled
+ */
+- (BOOL)fb_isVoiceOverEnabled:(NSError **)error;
+
+/**
+ Move VoiceOver focus and return speech for the newly focused element.
+ Only works since iOS 27 runtime.
+
+ @param direction One of: forward, backward, in (iOS only), out (iOS only)
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return The spoken utterance or nil in case of failure
+ */
+- (nullable NSString *)fb_voiceOverMove:(NSString *)direction error:(NSError **)error;
+
+/**
+ Return the speech for the currently focused element. Only works since iOS 27 runtime.
+
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return The spoken utterance or nil in case of failure
+ */
+- (nullable NSString *)fb_voiceOverCurrentSpeech:(NSError **)error;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/WebDriverAgentLib/Categories/XCUIDevice+FBVoiceOver.m

@@ -0,0 +1,216 @@
+/**
+ * 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+FBVoiceOver.h"
+
+#import "FBErrorBuilder.h"
+
+static NSString *const FBVoiceOverSDKUnsupportedError =
+@"The current OS runtime does not support VoiceOver control. This API requires an iOS 27+ runtime";
+
+static BOOL FBVoiceOverBuildSDKUnsupportedError(NSError **error)
+{
+  return [[[FBErrorBuilder builder]
+           withDescription:FBVoiceOverSDKUnsupportedError]
+          buildError:error];
+}
+
+static BOOL FBIsVoiceOverServiceAvailable(void)
+{
+  static BOOL isAvailable = NO;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    isAvailable = [XCUIDevice.sharedDevice respondsToSelector:NSSelectorFromString(@"voiceOverService")];
+  });
+  return isAvailable;
+}
+
+static id FBVoiceOverService(NSError **error)
+{
+  if (!FBIsVoiceOverServiceAvailable()) {
+    FBVoiceOverBuildSDKUnsupportedError(error);
+    return nil;
+  }
+  return [XCUIDevice.sharedDevice valueForKey:@"voiceOverService"];
+}
+
+static BOOL FBInvokeVoiceOverBoolMethod(id voiceOverService,
+                                        SEL selector,
+                                        NSError **error)
+{
+  if (![voiceOverService respondsToSelector:selector]) {
+    return FBVoiceOverBuildSDKUnsupportedError(error);
+  }
+
+  NSMethodSignature *signature = [voiceOverService methodSignatureForSelector:selector];
+  NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:signature];
+  [invocation setSelector:selector];
+  [invocation setTarget:voiceOverService];
+  NSError *invokeError = nil;
+  [invocation setArgument:&invokeError atIndex:2];
+  [invocation invoke];
+  if (nil != invokeError) {
+    if (error) {
+      *error = invokeError;
+    }
+    return NO;
+  }
+
+  BOOL result = NO;
+  [invocation getReturnValue:&result];
+  return result;
+}
+
+static id FBInvokeVoiceOverOutputMethod(id voiceOverService,
+                                        SEL selector,
+                                        NSError **error)
+{
+  if (![voiceOverService respondsToSelector:selector]) {
+    FBVoiceOverBuildSDKUnsupportedError(error);
+    return nil;
+  }
+
+  NSMethodSignature *signature = [voiceOverService methodSignatureForSelector:selector];
+  NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:signature];
+  [invocation setSelector:selector];
+  [invocation setTarget:voiceOverService];
+  NSError *invokeError = nil;
+  [invocation setArgument:&invokeError atIndex:2];
+  [invocation invoke];
+  if (nil != invokeError) {
+    if (error) {
+      *error = invokeError;
+    }
+    return nil;
+  }
+
+  id __unsafe_unretained output = nil;
+  [invocation getReturnValue:&output];
+  return output;
+}
+
+static NSString *FBUtteranceFromVoiceOverOutput(id output, NSError **error)
+{
+  if (nil == output) {
+    return nil;
+  }
+
+  if (![output respondsToSelector:NSSelectorFromString(@"utterance")]) {
+    [[[FBErrorBuilder builder]
+      withDescription:@"VoiceOver output does not provide an utterance"]
+     buildError:error];
+    return nil;
+  }
+
+  id utterance = [output valueForKey:@"utterance"];
+  return [utterance isKindOfClass:NSString.class] ? utterance : nil;
+}
+
+static NSString *FBVoiceOverSpeechFromSelector(SEL selector, NSError **error)
+{
+  id service = FBVoiceOverService(error);
+  if (nil == service) {
+    return nil;
+  }
+
+  id output = FBInvokeVoiceOverOutputMethod(service, selector, error);
+  if (nil != error && nil != *error) {
+    return nil;
+  }
+  return FBUtteranceFromVoiceOverOutput(output, error);
+}
+
+static NSDictionary<NSString *, NSString *> *FBVoiceOverMoveSelectors(void)
+{
+  static NSDictionary<NSString *, NSString *> *selectors = nil;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    NSMutableDictionary<NSString *, NSString *> *mapping = [@{
+      @"forward": @"moveForwardAndReturnError:",
+      @"backward": @"moveBackwardAndReturnError:",
+    } mutableCopy];
+#if TARGET_OS_IOS
+    mapping[@"in"] = @"moveInAndReturnError:";
+    mapping[@"out"] = @"moveOutAndReturnError:";
+#endif
+    selectors = mapping.copy;
+  });
+  return selectors;
+}
+
+@implementation XCUIDevice (FBVoiceOver)
+
+- (BOOL)fb_isVoiceOverServiceAvailable
+{
+  return FBIsVoiceOverServiceAvailable();
+}
+
+- (BOOL)fb_enableVoiceOver:(NSError **)error
+{
+  id service = FBVoiceOverService(error);
+  if (nil == service) {
+    return NO;
+  }
+  return FBInvokeVoiceOverBoolMethod(service,
+                                     NSSelectorFromString(@"enableAndReturnError:"),
+                                     error);
+}
+
+- (BOOL)fb_disableVoiceOver:(NSError **)error
+{
+  id service = FBVoiceOverService(error);
+  if (nil == service) {
+    return NO;
+  }
+  return FBInvokeVoiceOverBoolMethod(service,
+                                     NSSelectorFromString(@"disableAndReturnError:"),
+                                     error);
+}
+
+- (BOOL)fb_isVoiceOverEnabled:(NSError **)error
+{
+  id service = FBVoiceOverService(error);
+  if (nil == service) {
+    return NO;
+  }
+
+  if (![service respondsToSelector:NSSelectorFromString(@"isEnabled")] &&
+      ![service respondsToSelector:NSSelectorFromString(@"enabled")]) {
+    return FBVoiceOverBuildSDKUnsupportedError(error);
+  }
+
+  return [[service valueForKey:@"enabled"] boolValue];
+}
+
+- (nullable NSString *)fb_voiceOverMove:(NSString *)direction error:(NSError **)error
+{
+  if (![direction isKindOfClass:NSString.class] || 0 == direction.length) {
+    return [[[FBErrorBuilder builder]
+             withDescription:@"VoiceOver move direction must be a non-empty string"]
+            buildError:error], nil;
+  }
+
+  NSString *normalizedDirection = direction.lowercaseString;
+  NSString *selectorName = FBVoiceOverMoveSelectors()[normalizedDirection];
+  if (nil == selectorName) {
+    NSArray *supportedDirections = [FBVoiceOverMoveSelectors().allKeys sortedArrayUsingSelector:@selector(compare:)];
+    return [[[FBErrorBuilder builder]
+             withDescriptionFormat:@"Unsupported VoiceOver move direction '%@'. Supported directions: %@",
+             direction, supportedDirections]
+            buildError:error], nil;
+  }
+
+  return FBVoiceOverSpeechFromSelector(NSSelectorFromString(selectorName), error);
+}
+
+- (nullable NSString *)fb_voiceOverCurrentSpeech:(NSError **)error
+{
+  return FBVoiceOverSpeechFromSelector(NSSelectorFromString(@"currentSpeechAndReturnError:"), error);
+}
+
+@end

package/WebDriverAgentLib/Commands/FBCustomCommands.m

@@ -26,6 +26,7 @@
 #import "XCUIApplication.h"
 #import "XCUIApplication+FBHelpers.h"
 #import "XCUIDevice+FBHelpers.h"
+#import "XCUIDevice+FBVoiceOver.h"
 #import "XCUIElement.h"
 #import "XCUIElement+FBIsVisible.h"
 #import "XCUIElementQuery.h"
@@ -81,6 +82,16 @@
     [[FBRoute DELETE:@"/wda/simulatedLocation"] respondWithTarget:self action:@selector(handleClearSimulatedLocation:)],
     [[FBRoute DELETE:@"/wda/simulatedLocation"].withoutSession respondWithTarget:self action:@selector(handleClearSimulatedLocation:)],
 #endif
+    [[FBRoute POST:@"/wda/voiceOver/enable"] respondWithTarget:self action:@selector(handleVoiceOverEnable:)],
+    [[FBRoute POST:@"/wda/voiceOver/enable"].withoutSession respondWithTarget:self action:@selector(handleVoiceOverEnable:)],
+    [[FBRoute POST:@"/wda/voiceOver/disable"] respondWithTarget:self action:@selector(handleVoiceOverDisable:)],
+    [[FBRoute POST:@"/wda/voiceOver/disable"].withoutSession respondWithTarget:self action:@selector(handleVoiceOverDisable:)],
+    [[FBRoute GET:@"/wda/voiceOver/enabled"] respondWithTarget:self action:@selector(handleVoiceOverEnabled:)],
+    [[FBRoute GET:@"/wda/voiceOver/enabled"].withoutSession respondWithTarget:self action:@selector(handleVoiceOverEnabled:)],
+    [[FBRoute POST:@"/wda/voiceOver/move"] respondWithTarget:self action:@selector(handleVoiceOverMove:)],
+    [[FBRoute POST:@"/wda/voiceOver/move"].withoutSession respondWithTarget:self action:@selector(handleVoiceOverMove:)],
+    [[FBRoute GET:@"/wda/voiceOver/currentSpeech"] respondWithTarget:self action:@selector(handleVoiceOverCurrentSpeech:)],
+    [[FBRoute GET:@"/wda/voiceOver/currentSpeech"].withoutSession respondWithTarget:self action:@selector(handleVoiceOverCurrentSpeech:)],
     [[FBRoute OPTIONS:@"/*"].withoutSession respondWithTarget:self action:@selector(handlePingCommand:)],
   ];
 }
@@ -611,6 +622,75 @@
 #endif
 #endif
 
++ (id<FBResponsePayload>)fb_handleVoiceOverSpeechResponse:(nullable NSString *)utterance
+                                                      error:(NSError *)error
+{
+  if (nil != error) {
+    return FBResponseWithStatus([FBCommandStatus unknownErrorWithMessage:error.description
+                                                               traceback:nil]);
+  }
+  return FBResponseWithObject(@{
+    @"utterance": utterance ?: NSNull.null,
+  });
+}
+
++ (id<FBResponsePayload>)handleVoiceOverEnable:(FBRouteRequest *)request
+{
+  NSError *error;
+  if (![XCUIDevice.sharedDevice fb_enableVoiceOver:&error]) {
+    return FBResponseWithStatus([FBCommandStatus unknownErrorWithMessage:error.description
+                                                               traceback:nil]);
+  }
+  return FBResponseWithOK();
+}
+
++ (id<FBResponsePayload>)handleVoiceOverDisable:(FBRouteRequest *)request
+{
+  NSError *error;
+  if (![XCUIDevice.sharedDevice fb_disableVoiceOver:&error]) {
+    return FBResponseWithStatus([FBCommandStatus unknownErrorWithMessage:error.description
+                                                               traceback:nil]);
+  }
+  return FBResponseWithOK();
+}
+
++ (id<FBResponsePayload>)handleVoiceOverEnabled:(FBRouteRequest *)request
+{
+  NSError *error;
+  BOOL isEnabled = [XCUIDevice.sharedDevice fb_isVoiceOverEnabled:&error];
+  if (nil != error) {
+    return FBResponseWithStatus([FBCommandStatus unknownErrorWithMessage:error.description
+                                                               traceback:nil]);
+  }
+  return FBResponseWithObject(@{@"enabled": @(isEnabled)});
+}
+
++ (id<FBResponsePayload>)handleVoiceOverMove:(FBRouteRequest *)request
+{
+  NSString *direction = request.arguments[@"direction"];
+  if (nil == direction) {
+    return FBResponseWithStatus([FBCommandStatus invalidArgumentErrorWithMessage:@"The 'direction' argument must be provided"
+                                                                       traceback:nil]);
+  }
+
+  NSError *error;
+  NSString *utterance = [XCUIDevice.sharedDevice fb_voiceOverMove:direction error:&error];
+  if (nil != error) {
+    FBCommandStatus *status = [error.localizedDescription containsString:@"Unsupported VoiceOver move direction"]
+      ? [FBCommandStatus invalidArgumentErrorWithMessage:error.description traceback:nil]
+      : [FBCommandStatus unknownErrorWithMessage:error.description traceback:nil];
+    return FBResponseWithStatus(status);
+  }
+  return [self fb_handleVoiceOverSpeechResponse:utterance error:nil];
+}
+
++ (id<FBResponsePayload>)handleVoiceOverCurrentSpeech:(FBRouteRequest *)request
+{
+  NSError *error;
+  NSString *utterance = [XCUIDevice.sharedDevice fb_voiceOverCurrentSpeech:&error];
+  return [self fb_handleVoiceOverSpeechResponse:utterance error:error];
+}
+
 + (id<FBResponsePayload>)handlePerformAccessibilityAudit:(FBRouteRequest *)request
 {
   NSError *error;

package/WebDriverAgentLib/Info.plist

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

package/WebDriverAgentLib/Utilities/FBCapabilities.h

@@ -24,7 +24,7 @@ extern NSString* const FB_CAP_BUNDLE_ID;
  Usually an URL used as initial link to run Mobile Safari, but could be any other deep link.
  This might also work together with `FB_CAP_BUNLDE_ID`, which tells XCTest to open
  the given deep link in the particular app.
- Only works since iOS 16.4
+ Only works since iOS 16.4 runtime
  */
 extern NSString* const FB_CAP_INITIAL_URL;
 /** Whether to enforrce (re)start of the application under test on session startup */

package/WebDriverAgentLib/Utilities/FBXCTestDaemonsProxy.m

@@ -134,7 +134,7 @@ static void swizzledLaunchApp(id self, SEL _cmd, NSString *path, NSString *bundl
   XCTRunnerDaemonSession *session = [XCTRunnerDaemonSession sharedSession];
   if (![session respondsToSelector:@selector(openURL:usingApplication:completion:)]) {
     return [[[FBErrorBuilder builder]
-      withDescriptionFormat:@"The current Xcode SDK does not support opening of URLs with given application"]
+      withDescriptionFormat:@"The current OS runtime does not support opening URLs with a given application"]
      buildError:error];
   }
 
@@ -161,7 +161,7 @@ static void swizzledLaunchApp(id self, SEL _cmd, NSString *path, NSString *bundl
   XCTRunnerDaemonSession *session = [XCTRunnerDaemonSession sharedSession];
   if (![session respondsToSelector:@selector(openDefaultApplicationForURL:completion:)]) {
     return [[[FBErrorBuilder builder]
-      withDescriptionFormat:@"The current Xcode SDK does not support opening of URLs. Consider upgrading to Xcode 14.3+/iOS 16.4+"]
+      withDescriptionFormat:@"The current OS runtime does not support opening URLs. This API requires an iOS 16.4+ runtime"]
      buildError:error];
   }
 
@@ -189,7 +189,7 @@ static void swizzledLaunchApp(id self, SEL _cmd, NSString *path, NSString *bundl
   XCTRunnerDaemonSession *session = [XCTRunnerDaemonSession sharedSession];
   if (![session respondsToSelector:@selector(setSimulatedLocation:completion:)]) {
     return [[[FBErrorBuilder builder]
-      withDescriptionFormat:@"The current Xcode SDK does not support location simulation. Consider upgrading to Xcode 14.3+/iOS 16.4+"]
+      withDescriptionFormat:@"The current OS runtime does not support location simulation. This API requires an iOS 16.4+ runtime"]
      buildError:error];
   }
   if (![session supportsLocationSimulation]) {
@@ -221,7 +221,7 @@ static void swizzledLaunchApp(id self, SEL _cmd, NSString *path, NSString *bundl
   XCTRunnerDaemonSession *session = [XCTRunnerDaemonSession sharedSession];
   if (![session respondsToSelector:@selector(getSimulatedLocationWithReply:)]) {
     [[[FBErrorBuilder builder]
-      withDescriptionFormat:@"The current Xcode SDK does not support location simulation. Consider upgrading to Xcode 14.3+/iOS 16.4+"]
+      withDescriptionFormat:@"The current OS runtime does not support location simulation. This API requires an iOS 16.4+ runtime"]
      buildError:error];
     return nil;
   }
@@ -255,7 +255,7 @@ static void swizzledLaunchApp(id self, SEL _cmd, NSString *path, NSString *bundl
   XCTRunnerDaemonSession *session = [XCTRunnerDaemonSession sharedSession];
   if (![session respondsToSelector:@selector(clearSimulatedLocationWithReply:)]) {
     return [[[FBErrorBuilder builder]
-        withDescriptionFormat:@"The current Xcode SDK does not support location simulation. Consider upgrading to Xcode 14.3+/iOS 16.4+"]
+        withDescriptionFormat:@"The current OS runtime does not support location simulation. This API requires an iOS 16.4+ runtime"]
        buildError:error];
   }
   if (![session supportsLocationSimulation]) {
@@ -289,7 +289,7 @@ static void swizzledLaunchApp(id self, SEL _cmd, NSString *path, NSString *bundl
   XCTRunnerDaemonSession *session = [XCTRunnerDaemonSession sharedSession];
   if (![session respondsToSelector:@selector(startScreenRecordingWithRequest:withReply:)]) {
     [[[FBErrorBuilder builder]
-      withDescriptionFormat:@"The current Xcode SDK does not support screen recording. Consider upgrading to Xcode 15+/iOS 17+"]
+      withDescriptionFormat:@"The current OS runtime does not support screen recording. This API requires an iOS 17+ runtime"]
      buildError:error];
     return nil;
   }
@@ -331,7 +331,7 @@ static void swizzledLaunchApp(id self, SEL _cmd, NSString *path, NSString *bundl
   XCTRunnerDaemonSession *session = [XCTRunnerDaemonSession sharedSession];
   if (![session respondsToSelector:@selector(stopScreenRecordingWithUUID:withReply:)]) {
     return [[[FBErrorBuilder builder]
-        withDescriptionFormat:@"The current Xcode SDK does not support screen recording. Consider upgrading to Xcode 15+/iOS 17+"]
+        withDescriptionFormat:@"The current OS runtime does not support screen recording. This API requires an iOS 17+ runtime"]
        buildError:error];
 
   }

package/WebDriverAgentLib/WebDriverAgentLib.h

@@ -48,6 +48,7 @@ FOUNDATION_EXPORT const unsigned char WebDriverAgentLib_VersionString[];
 #import <WebDriverAgentLib/XCUIApplication+FBHelpers.h>
 #import <WebDriverAgentLib/XCUIDevice+FBHelpers.h>
 #import <WebDriverAgentLib/XCUIDevice+FBRotation.h>
+#import <WebDriverAgentLib/XCUIDevice+FBVoiceOver.h>
 #import <WebDriverAgentLib/XCUIElement.h>
 #import <WebDriverAgentLib/XCUIElement+FBAccessibility.h>
 #import <WebDriverAgentLib/XCUIElement+FBFind.h>

package/WebDriverAgentTests/IntegrationTests/FBVoiceOverTests.m

@@ -0,0 +1,103 @@
+/**
+ * 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>
+
+#import "FBIntegrationTestCase.h"
+#import "FBMacros.h"
+#import "FBTestMacros.h"
+#import "XCUIDevice+FBVoiceOver.h"
+
+@interface FBVoiceOverTests : FBIntegrationTestCase
+@end
+
+@implementation FBVoiceOverTests
+
+- (void)tearDown
+{
+  if ([XCUIDevice.sharedDevice fb_isVoiceOverServiceAvailable]) {
+    NSError *error = nil;
+    if ([XCUIDevice.sharedDevice fb_isVoiceOverEnabled:&error] && nil == error) {
+      [XCUIDevice.sharedDevice fb_disableVoiceOver:&error];
+    }
+  }
+  [super tearDown];
+}
+
+- (void)testVoiceOverUnavailableOnOlderSDK
+{
+  if ([XCUIDevice.sharedDevice fb_isVoiceOverServiceAvailable]) {
+    return;
+  }
+
+  NSError *error = nil;
+  XCTAssertFalse([XCUIDevice.sharedDevice fb_enableVoiceOver:&error]);
+  XCTAssertNotNil(error);
+  XCTAssertTrue([error.localizedDescription containsString:@"iOS 27"]);
+}
+
+- (void)testVoiceOverEnableDisableAndNavigation
+{
+  if (SYSTEM_VERSION_LESS_THAN(@"27.0")) {
+    return;
+  }
+  if (![XCUIDevice.sharedDevice fb_isVoiceOverServiceAvailable]) {
+    return;
+  }
+
+  [self launchApplication];
+
+  NSError *error = nil;
+  XCTAssertTrue([XCUIDevice.sharedDevice fb_enableVoiceOver:&error]);
+  XCTAssertNil(error);
+  XCTAssertTrue([XCUIDevice.sharedDevice fb_isVoiceOverEnabled:&error]);
+  XCTAssertNil(error);
+
+  NSString *utterance = [XCUIDevice.sharedDevice fb_voiceOverMove:@"forward" error:&error];
+  XCTAssertNil(error);
+  XCTAssertNotNil(utterance);
+  XCTAssertTrue(utterance.length > 0);
+
+  NSString *currentSpeech = [XCUIDevice.sharedDevice fb_voiceOverCurrentSpeech:&error];
+  XCTAssertNil(error);
+  XCTAssertNotNil(currentSpeech);
+  XCTAssertEqualObjects(currentSpeech, utterance);
+
+  XCTAssertTrue([XCUIDevice.sharedDevice fb_disableVoiceOver:&error]);
+  XCTAssertNil(error);
+  XCTAssertFalse([XCUIDevice.sharedDevice fb_isVoiceOverEnabled:&error]);
+  XCTAssertNil(error);
+}
+
+#if TARGET_OS_IOS
+- (void)testVoiceOverMoveBackward
+{
+  if (SYSTEM_VERSION_LESS_THAN(@"27.0")) {
+    return;
+  }
+  if (![XCUIDevice.sharedDevice fb_isVoiceOverServiceAvailable]) {
+    return;
+  }
+
+  [self launchApplication];
+
+  NSError *error = nil;
+  XCTAssertTrue([XCUIDevice.sharedDevice fb_enableVoiceOver:&error]);
+  XCTAssertNil(error);
+
+  XCTAssertNotNil([XCUIDevice.sharedDevice fb_voiceOverMove:@"forward" error:&error]);
+  XCTAssertNil(error);
+
+  NSString *utterance = [XCUIDevice.sharedDevice fb_voiceOverMove:@"backward" error:&error];
+  XCTAssertNil(error);
+  XCTAssertNotNil(utterance);
+  XCTAssertTrue(utterance.length > 0);
+}
+#endif
+
+@end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-webdriveragent",
-  "version": "14.0.0",
+  "version": "14.1.1",
   "description": "Package bundling WebDriverAgent",
   "main": "./build/lib/index.js",
   "types": "./build/lib/index.d.ts",