appium-webdriveragent 4.10.24 → 4.12.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [4.12.0](https://github.com/appium/WebDriverAgent/compare/v4.11.0...v4.12.0) (2023-02-20)
+
+
+### Features
+
+* Add support of the simulated geolocation setting ([#662](https://github.com/appium/WebDriverAgent/issues/662)) ([ebb9e60](https://github.com/appium/WebDriverAgent/commit/ebb9e60d56c0e0db9f509437ed639a3a39f6011b))
+
+## [4.11.0](https://github.com/appium/WebDriverAgent/compare/v4.10.24...v4.11.0) (2023-02-19)
+
+
+### Features
+
+* Add openUrl handler available since Xcode 14.3 ([#661](https://github.com/appium/WebDriverAgent/issues/661)) ([bee564e](https://github.com/appium/WebDriverAgent/commit/bee564e8c6b975aff07fd1244583f0727a0f5470))
+
 ## [4.10.24](https://github.com/appium/WebDriverAgent/compare/v4.10.23...v4.10.24) (2023-02-17)
 
 

package/PrivateHeaders/XCTest/XCTRunnerDaemonSession.h

@@ -10,6 +10,9 @@
 #import <UIKit/UIKit.h>
 
 @class NSMutableDictionary, NSXPCConnection, XCSynthesizedEventRecord;
+#if !TARGET_OS_TV // tvOS does not provide relevant APIs
+@class CLLocation;
+#endif
 @protocol XCTUIApplicationMonitor, XCTAXClient, XCTestManager_ManagerInterface;
 
 // iOS since 10.3
@@ -67,4 +70,14 @@
 - (void)_reportInvalidation;
 - (id)initWithConnection:(id)arg1;
 
+// Since Xcode 14.3
+- (void)openURL:(NSURL *)arg1 usingApplication:(NSString *)arg2 completion:(void (^)(_Bool, NSError *))arg3;
+- (void)openDefaultApplicationForURL:(NSURL *)arg1 completion:(void (^)(_Bool, NSError *))arg2;
+#if !TARGET_OS_TV // tvOS does not provide relevant APIs
+- (void)setSimulatedLocation:(CLLocation *)arg1 completion:(void (^)(_Bool, NSError *))arg2;
+- (void)getSimulatedLocationWithReply:(void (^)(CLLocation *, NSError *))arg1;
+- (void)clearSimulatedLocationWithReply:(void (^)(_Bool, NSError *))arg1;
+@property(readonly) _Bool supportsLocationSimulation;
+#endif
+
 @end

package/WebDriverAgent.xcodeproj/project.pbxproj

@@ -3666,6 +3666,7 @@
 					"-Wno-objc-messaging-id",
 					"-Wno-direct-ivar-access",
 					"-Wno-cast-qual",
+					"-Wno-declaration-after-statement",
 				);
 			};
 			name = Debug;
@@ -3728,6 +3729,7 @@
 					"-Wno-objc-messaging-id",
 					"-Wno-direct-ivar-access",
 					"-Wno-cast-qual",
+					"-Wno-declaration-after-statement",
 				);
 			};
 			name = Release;
@@ -3974,6 +3976,7 @@
 					"-Wno-objc-messaging-id",
 					"-Wno-direct-ivar-access",
 					"-Wno-cast-qual",
+					"-Wno-declaration-after-statement",
 				);
 			};
 			name = Debug;
@@ -4033,6 +4036,7 @@
 					"-Wno-objc-messaging-id",
 					"-Wno-direct-ivar-access",
 					"-Wno-cast-qual",
+					"-Wno-declaration-after-statement",
 				);
 			};
 			name = Release;

package/WebDriverAgentLib/Categories/XCUIDevice+FBHelpers.h

@@ -9,6 +9,10 @@
 
 #import <XCTest/XCTest.h>
 
+#if !TARGET_OS_TV
+#import <CoreLocation/CoreLocation.h>
+#endif
+
 NS_ASSUME_NONNULL_BEGIN
 
 typedef NS_ENUM(NSUInteger, FBUIInterfaceAppearance) {
@@ -71,8 +75,9 @@ typedef NS_ENUM(NSUInteger, FBUIInterfaceAppearance) {
 - (nullable NSString *)fb_wifiIPAddress;
 
 /**
- Opens the particular url scheme using Siri voice recognition helpers.
- This will only work since XCode 8.3/iOS 10.3
+ Opens the particular url scheme using the default application assigned to it.
+ This API only works since XCode 14.3/iOS 16.4
+ Older Xcode/iOS version try to use Siri fallback.
  
  @param url The url scheme represented as a string, for example https://apple.com
  @param error If there is an error, upon return contains an NSError object that describes the problem.
@@ -80,6 +85,17 @@ typedef NS_ENUM(NSUInteger, FBUIInterfaceAppearance) {
  */
 - (BOOL)fb_openUrl:(NSString *)url error:(NSError **)error;
 
+/**
+ Opens the particular url scheme using the given application
+ This API only works since XCode 14.3/iOS 16.4
+
+ @param url The url scheme represented as a string, for example https://apple.com
+ @param bundleId The bundle identifier of an application to use in order to open the given URL
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if the operation was successful
+ */
+- (BOOL)fb_openUrl:(NSString *)url withApplication:(NSString *)bundleId error:(NSError **)error;
+
 /**
  Presses the corresponding hardware button on the device with duration.
 
@@ -142,6 +158,36 @@ typedef NS_ENUM(NSUInteger, FBUIInterfaceAppearance) {
  */
 - (nullable NSNumber *)fb_getAppearance;
 
+#if !TARGET_OS_TV
+/**
+ Allows to set a simulated geolocation coordinates.
+ Only works since Xcode 14.3/iOS 16.4
+
+ @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.
+ @return YES if the simulated location has been successfully set
+ */
+- (BOOL)fb_setSimulatedLocation:(CLLocation *)location error:(NSError **)error;
+
+/**
+ Allows to get a simulated geolocation coordinates.
+ Only works since Xcode 14.3/iOS 16.4
+
+ @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
+ */
+- (nullable CLLocation *)fb_getSimulatedLocation:(NSError **)error;
+
+/**
+ Allows to clear a previosuly set simulated geolocation coordinates.
+ Only works since Xcode 14.3/iOS 16.4
+
+ @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
+ */
+- (BOOL)fb_clearSimulatedLocation:(NSError **)error;
+#endif
+
 @end
 
 NS_ASSUME_NONNULL_END

package/WebDriverAgentLib/Categories/XCUIDevice+FBHelpers.m

@@ -21,6 +21,7 @@
 #import "FBScreenshot.h"
 #import "FBXCDeviceEvent.h"
 #import "FBXCodeCompatibility.h"
+#import "FBXCTestDaemonsProxy.h"
 #import "XCUIDevice.h"
 
 static const NSTimeInterval FBHomeButtonCoolOffTime = 1.;
@@ -157,20 +158,38 @@ static bool fb_isLocked;
             buildError:error];
   }
 
+  NSError *err;
+  if ([FBXCTestDaemonsProxy openDefaultApplicationForURL:parsedUrl error:&err]) {
+    return YES;
+  }
+  if (![err.description containsString:@"does not support"]) {
+    if (error) {
+      *error = err;
+    }
+    return NO;
+  }
+
   id siriService = [self valueForKey:@"siriService"];
   if (nil != siriService) {
     return [self fb_activateSiriVoiceRecognitionWithText:[NSString stringWithFormat:@"Open {%@}", url] error:error];
   }
-#pragma clang diagnostic push
-#pragma clang diagnostic ignored "-Wdeprecated-declarations"
-  // The link never gets opened by this method: https://forums.developer.apple.com/thread/25355
-  if (![[UIApplication sharedApplication] openURL:parsedUrl]) {
-#pragma clang diagnostic pop
+
+  NSString *description = [NSString stringWithFormat:@"Cannot open '%@' with the default application assigned for it. Consider upgrading to Xcode 14.3+/iOS 16.4+", url];
+  return [[[FBErrorBuilder builder]
+           withDescriptionFormat:@"%@", description]
+          buildError:error];;
+}
+
+- (BOOL)fb_openUrl:(NSString *)url withApplication:(NSString *)bundleId error:(NSError **)error
+{
+  NSURL *parsedUrl = [NSURL URLWithString:url];
+  if (nil == parsedUrl) {
     return [[[FBErrorBuilder builder]
-             withDescriptionFormat:@"The URL %@ cannot be opened", url]
+             withDescriptionFormat:@"'%@' is not a valid URL", url]
             buildError:error];
   }
-  return YES;
+
+  return [FBXCTestDaemonsProxy openURL:parsedUrl usingApplication:bundleId error:error];
 }
 
 - (BOOL)fb_activateSiriVoiceRecognitionWithText:(NSString *)text error:(NSError **)error
@@ -336,4 +355,21 @@ static bool fb_isLocked;
   : nil;
 }
 
+#if !TARGET_OS_TV
+- (BOOL)fb_setSimulatedLocation:(CLLocation *)location error:(NSError **)error
+{
+  return [FBXCTestDaemonsProxy setSimulatedLocation:location error:error];
+}
+
+- (nullable CLLocation *)fb_getSimulatedLocation:(NSError **)error
+{
+  return [FBXCTestDaemonsProxy getSimulatedLocation:error];
+}
+
+- (BOOL)fb_clearSimulatedLocation:(NSError **)error
+{
+  return [FBXCTestDaemonsProxy clearSimulatedLocation:error];
+}
+#endif
+
 @end

package/WebDriverAgentLib/Commands/FBCustomCommands.m

@@ -66,6 +66,14 @@
     [[FBRoute POST:@"/wda/device/appearance"].withoutSession respondWithTarget:self action:@selector(handleSetDeviceAppearance:)],
     [[FBRoute GET:@"/wda/device/location"] respondWithTarget:self action:@selector(handleGetLocation:)],
     [[FBRoute GET:@"/wda/device/location"].withoutSession respondWithTarget:self action:@selector(handleGetLocation:)],
+#if !TARGET_OS_TV // tvOS does not provide relevant APIs
+    [[FBRoute GET:@"/wda/simulatedLocation"] respondWithTarget:self action:@selector(handleGetSimulatedLocation:)],
+    [[FBRoute GET:@"/wda/simulatedLocation"].withoutSession respondWithTarget:self action:@selector(handleGetSimulatedLocation:)],
+    [[FBRoute POST:@"/wda/simulatedLocation"] respondWithTarget:self action:@selector(handleSetSimulatedLocation:)],
+    [[FBRoute POST:@"/wda/simulatedLocation"].withoutSession respondWithTarget:self action:@selector(handleSetSimulatedLocation:)],
+    [[FBRoute DELETE:@"/wda/simulatedLocation"] respondWithTarget:self action:@selector(handleClearSimulatedLocation:)],
+    [[FBRoute DELETE:@"/wda/simulatedLocation"].withoutSession respondWithTarget:self action:@selector(handleClearSimulatedLocation:)],
+#endif
     [[FBRoute OPTIONS:@"/*"].withoutSession respondWithTarget:self action:@selector(handlePingCommand:)],
   ];
 }
@@ -106,9 +114,9 @@
   BOOL isDismissed = [request.session.activeApplication fb_dismissKeyboardWithKeyNames:request.arguments[@"keyNames"]
                                                                                  error:&error];
   return isDismissed
-    ? FBResponseWithOK()
-    : FBResponseWithStatus([FBCommandStatus invalidElementStateErrorWithMessage:error.description
-                                                                      traceback:nil]);
+  ? FBResponseWithOK()
+  : FBResponseWithStatus([FBCommandStatus invalidElementStateErrorWithMessage:error.description
+                                                                    traceback:nil]);
 }
 
 + (id<FBResponsePayload>)handlePingCommand:(FBRouteRequest *)request
@@ -123,12 +131,12 @@
   FBSession *session = request.session;
   CGSize statusBarSize = [FBScreen statusBarSizeForApplication:session.activeApplication];
   return FBResponseWithObject(
-  @{
+                              @{
     @"statusBarSize": @{@"width": @(statusBarSize.width),
                         @"height": @(statusBarSize.height),
-                        },
+    },
     @"scale": @([FBScreen scale]),
-    });
+  });
 }
 
 + (id<FBResponsePayload>)handleLock:(FBRouteRequest *)request
@@ -325,7 +333,7 @@
   CLAuthorizationStatus authStatus;
   if ([locationManager respondsToSelector:@selector(authorizationStatus)]) {
     NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:[[locationManager class]
-      instanceMethodSignatureForSelector:@selector(authorizationStatus)]];
+                                                                            instanceMethodSignatureForSelector:@selector(authorizationStatus)]];
     [invocation setSelector:@selector(authorizationStatus)];
     [invocation setTarget:locationManager];
     [invocation invoke];
@@ -379,8 +387,8 @@
   }
 
   FBUIInterfaceAppearance appearance = [name isEqualToString:@"light"]
-    ? FBUIInterfaceAppearanceLight
-    : FBUIInterfaceAppearanceDark;
+  ? FBUIInterfaceAppearanceLight
+  : FBUIInterfaceAppearanceDark;
   NSError *error;
   if (![XCUIDevice.sharedDevice fb_setAppearance:appearance error:&error]) {
     return FBResponseWithStatus([FBCommandStatus unknownErrorWithMessage:error.description
@@ -397,7 +405,7 @@
   NSString *currentLocale = [[NSLocale autoupdatingCurrentLocale] localeIdentifier];
 
   NSMutableDictionary *deviceInfo = [NSMutableDictionary dictionaryWithDictionary:
-  @{
+                                     @{
     @"currentLocale": currentLocale,
     @"timeZone": self.timeZone,
     @"name": UIDevice.currentDevice.name,
@@ -490,4 +498,50 @@
   return [localTimeZone name];
 }
 
+#if !TARGET_OS_TV // tvOS does not provide relevant APIs
++ (id<FBResponsePayload>)handleGetSimulatedLocation:(FBRouteRequest *)request
+{
+  NSError *error;
+  CLLocation *location = [XCUIDevice.sharedDevice fb_getSimulatedLocation:&error];
+  if (nil == location) {
+    return FBResponseWithStatus([FBCommandStatus unknownErrorWithMessage:error.description
+                                                               traceback:nil]);
+  }
+  return FBResponseWithObject(@{
+    @"latitude": @(location.coordinate.latitude),
+    @"longiture": @(location.coordinate.longitude),
+    @"altitude": @(location.altitude),
+  });
+}
+
++ (id<FBResponsePayload>)handleSetSimulatedLocation:(FBRouteRequest *)request
+{
+  NSNumber *longitude = request.arguments[@"longitude"];
+  NSNumber *latitude = request.arguments[@"latitude"];
+
+  if (nil == longitude || nil == latitude) {
+    return FBResponseWithStatus([FBCommandStatus invalidArgumentErrorWithMessage:@"Both latitude and longitude must be provided"
+                                                                       traceback:nil]);
+  }
+  NSError *error;
+  CLLocation *location = [[CLLocation alloc] initWithLatitude:latitude.doubleValue
+                                                    longitude:longitude.doubleValue];
+  if (![XCUIDevice.sharedDevice fb_setSimulatedLocation:location error:&error]) {
+    return FBResponseWithStatus([FBCommandStatus unknownErrorWithMessage:error.description
+                                                               traceback:nil]);
+  }
+  return FBResponseWithOK();
+}
+
++ (id<FBResponsePayload>)handleClearSimulatedLocation:(FBRouteRequest *)request
+{
+  NSError *error;
+  if (![XCUIDevice.sharedDevice fb_clearSimulatedLocation:&error]) {
+    return FBResponseWithStatus([FBCommandStatus unknownErrorWithMessage:error.description
+                                                               traceback:nil]);
+  }
+  return FBResponseWithOK();
+}
+#endif
+
 @end

package/WebDriverAgentLib/Commands/FBSessionCommands.m

@@ -66,9 +66,16 @@
   if (!urlString) {
     return FBResponseWithStatus([FBCommandStatus invalidArgumentErrorWithMessage:@"URL is required" traceback:nil]);
   }
+  NSString* bundleId = request.arguments[@"bundleId"];
   NSError *error;
-  if (![XCUIDevice.sharedDevice fb_openUrl:urlString error:&error]) {
-    return FBResponseWithUnknownError(error);
+  if (nil == bundleId) {
+    if (![XCUIDevice.sharedDevice fb_openUrl:urlString error:&error]) {
+      return FBResponseWithUnknownError(error);
+    }
+  } else {
+    if (![XCUIDevice.sharedDevice fb_openUrl:urlString withApplication:bundleId error:&error]) {
+      return FBResponseWithUnknownError(error);
+    }
   }
   return FBResponseWithOK();
 }

package/WebDriverAgentLib/Routing/FBResponsePayload.m

@@ -24,7 +24,7 @@
 
 NSString *arbitraryAttrPrefix = @"attribute/";
 
-id<FBResponsePayload> FBResponseWithOK()
+id<FBResponsePayload> FBResponseWithOK(void)
 {
   return FBResponseWithStatus(FBCommandStatus.ok);
 }

package/WebDriverAgentLib/Utilities/FBClassChainQueryParser.m

@@ -502,7 +502,9 @@ static NSNumberFormatter *numberFormatter = nil;
   return [[FBErrorBuilder.builder withDescription:fullDescription] build];
 }
 
-+ (nullable FBClassChain*)compiledQueryWithTokenizedQuery:(NSArray<FBBaseClassChainToken *> *)tokenizedQuery originalQuery:(NSString *)originalQuery error:(NSError **)error
++ (nullable FBClassChain*)compiledQueryWithTokenizedQuery:(NSArray<FBBaseClassChainToken *> *)tokenizedQuery
+                                            originalQuery:(NSString *)originalQuery
+                                                    error:(NSError **)error
 {
   NSMutableArray *result = [NSMutableArray array];
   XCUIElementType chainElementType = XCUIElementTypeAny;
@@ -514,8 +516,10 @@ static NSNumberFormatter *numberFormatter = nil;
   for (FBBaseClassChainToken *token in tokenizedQuery) {
     if ([token isKindOfClass:FBClassNameToken.class]) {
       if (isTypeSet) {
-        NSString *description = [NSString stringWithFormat:@"Unexpected token '%@'. The type name can be set only once.", token.asString];
-        *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        if (error) {
+          NSString *description = [NSString stringWithFormat:@"Unexpected token '%@'. The type name can be set only once.", token.asString];
+          *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        }
         return nil;
       }
       @try {
@@ -523,16 +527,20 @@ static NSNumberFormatter *numberFormatter = nil;
         isTypeSet = YES;
       } @catch (NSException *e) {
         if ([e.name isEqualToString:FBInvalidArgumentException]) {
-          NSString *description = [NSString stringWithFormat:@"'%@' class name is unknown to WDA", token.asString];
-          *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+          if (error) {
+            NSString *description = [NSString stringWithFormat:@"'%@' class name is unknown to WDA", token.asString];
+            *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+          }
           return nil;
         }
         @throw e;
       }
     } else if ([token isKindOfClass:FBStarToken.class]) {
       if (isTypeSet) {
-        NSString *description = [NSString stringWithFormat:@"Unexpected token '%@'. The type name can be set only once.", token.asString];
-        *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        if (error) {
+          NSString *description = [NSString stringWithFormat:@"Unexpected token '%@'. The type name can be set only once.", token.asString];
+          *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        }
         return nil;
       }
       chainElementType = XCUIElementTypeAny;
@@ -540,7 +548,9 @@ static NSNumberFormatter *numberFormatter = nil;
     } else if ([token isKindOfClass:FBDescendantMarkerToken.class]) {
       if (isDescendantSet) {
         NSString *description = [NSString stringWithFormat:@"Unexpected token '%@'. Descendant markers cannot be duplicated.", token.asString];
-        *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        if (error) {
+          *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        }
         return nil;
       }
       isTypeSet = NO;
@@ -550,12 +560,16 @@ static NSNumberFormatter *numberFormatter = nil;
     } else if ([token isKindOfClass:FBAbstractPredicateToken.class]) {
       if (isPositionSet) {
         NSString *description = [NSString stringWithFormat:@"Predicate value '%@' must be set before position value.", token.asString];
-        *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        if (error) {
+          *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        }
         return nil;
       }
       if (!((FBAbstractPredicateToken *)token).isParsingCompleted) {
         NSString *description = [NSString stringWithFormat:@"Cannot find the end of '%@' predicate value.", token.asString];
-        *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        if (error) {
+          *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        }
         return nil;
       }
       NSPredicate *value = [NSPredicate fb_snapshotBlockPredicateWithPredicate:[NSPredicate predicateWithFormat:token.asString]];
@@ -567,13 +581,17 @@ static NSNumberFormatter *numberFormatter = nil;
     } else if ([token isKindOfClass:FBNumberToken.class]) {
       if (isPositionSet) {
         NSString *description = [NSString stringWithFormat:@"Position value '%@' is expected to be set only once.", token.asString];
-        *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        if (error) {
+          *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        }
         return nil;
       }
       NSNumber *position = [numberFormatter numberFromString:token.asString];
       if (nil == position || 0 == position.intValue) {
         NSString *description = [NSString stringWithFormat:@"Position value '%@' is expected to be a valid integer number not equal to zero.", token.asString];
-        *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        if (error) {
+          *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+        }
         return nil;
       }
       chainElementPosition = position;
@@ -602,8 +620,10 @@ static NSNumberFormatter *numberFormatter = nil;
     if (isTypeSet) {
       [result addObject:[[FBClassChainItem alloc] initWithType:chainElementType position:chainElementPosition predicates:predicates.copy isDescendant:YES]];
     } else {
-      NSString *description = @"Descendants lookup modifier '**/' should be followed with the actual element type";
-      *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+      if (error) {
+        NSString *description = @"Descendants lookup modifier '**/' should be followed with the actual element type";
+        *error = [self.class compilationErrorWithQuery:originalQuery description:description];
+      }
       return nil;
     }
   } else {

package/WebDriverAgentLib/Utilities/FBRuntimeUtils.m

@@ -47,7 +47,7 @@ void *FBRetrieveSymbolFromBinary(const char *binary, const char *name)
 
 static NSString *sdkVersion = nil;
 static dispatch_once_t onceSdkVersionToken;
-NSString * _Nullable FBSDKVersion()
+NSString * _Nullable FBSDKVersion(void)
 {
   dispatch_once(&onceSdkVersionToken, ^{
     NSString *sdkName = [[NSBundle mainBundle] infoDictionary][@"DTSDKName"];

package/WebDriverAgentLib/Utilities/FBXCTestDaemonsProxy.h

@@ -8,15 +8,17 @@
  */
 
 #import <XCTest/XCTest.h>
+
+#if !TARGET_OS_TV
+#import <CoreLocation/CoreLocation.h>
+#endif
+
 #import "XCSynthesizedEventRecord.h"
 
 NS_ASSUME_NONNULL_BEGIN
 
 @protocol XCTestManager_ManagerInterface;
 
-/**
- Temporary class used to abstract interactions with TestManager daemon between Xcode 8.2.1 and Xcode 8.3-beta
- */
 @interface FBXCTestDaemonsProxy : NSObject
 
 + (id<XCTestManager_ManagerInterface>)testRunnerProxy;
@@ -28,6 +30,15 @@ NS_ASSUME_NONNULL_BEGIN
 + (BOOL)synthesizeEventWithRecord:(XCSynthesizedEventRecord *)record
                             error:(NSError *__autoreleasing*)error;
 
++ (BOOL)openURL:(NSURL *)url usingApplication:(NSString *)bundleId error:(NSError **)error;
++ (BOOL)openDefaultApplicationForURL:(NSURL *)url error:(NSError **)error;
+
+#if !TARGET_OS_TV
++ (BOOL)setSimulatedLocation:(CLLocation *)location error:(NSError **)error;
++ (nullable CLLocation *)getSimulatedLocation:(NSError **)error;
++ (BOOL)clearSimulatedLocation:(NSError **)error;
+#endif
+
 @end
 
 NS_ASSUME_NONNULL_END

package/WebDriverAgentLib/Utilities/FBXCTestDaemonsProxy.m

@@ -12,6 +12,7 @@
 #import <objc/runtime.h>
 
 #import "FBConfiguration.h"
+#import "FBErrorBuilder.h"
 #import "FBLogger.h"
 #import "FBRunLoopSpinner.h"
 #import "XCTestDriver.h"
@@ -96,4 +97,157 @@ static dispatch_once_t onceTestRunnerDaemonClass;
   return didSucceed;
 }
 
++ (BOOL)openURL:(NSURL *)url usingApplication:(NSString *)bundleId error:(NSError *__autoreleasing*)error
+{
+  XCTRunnerDaemonSession *session = [FBXCTRunnerDaemonSessionClass sharedSession];
+  if (![session respondsToSelector:@selector(openURL:usingApplication:completion:)]) {
+    if (error) {
+      [[[FBErrorBuilder builder]
+        withDescriptionFormat:@"The current Xcode SDK does not support opening of URLs with given application"]
+       buildError:error];
+    }
+    return NO;
+  }
+
+  __block BOOL didSucceed = NO;
+  [FBRunLoopSpinner spinUntilCompletion:^(void(^completion)(void)){
+    [session openURL:url usingApplication:bundleId completion:^(bool result, NSError *invokeError) {
+      if (error) {
+        *error = invokeError;
+      }
+      didSucceed = invokeError == nil && result;
+      completion();
+    }];
+  }];
+  return didSucceed;
+}
+
++ (BOOL)openDefaultApplicationForURL:(NSURL *)url error:(NSError *__autoreleasing*)error
+{
+  XCTRunnerDaemonSession *session = [FBXCTRunnerDaemonSessionClass sharedSession];
+  if (![session respondsToSelector:@selector(openDefaultApplicationForURL:completion:)]) {
+    if (error) {
+      [[[FBErrorBuilder builder]
+        withDescriptionFormat:@"The current Xcode SDK does not support opening of URLs. Consider upgrading to Xcode 14.3+/iOS 16.4+"]
+       buildError:error];
+    }
+    return NO;
+  }
+
+  __block BOOL didSucceed = NO;
+  [FBRunLoopSpinner spinUntilCompletion:^(void(^completion)(void)){
+    [session openDefaultApplicationForURL:url completion:^(bool result, NSError *invokeError) {
+      if (error) {
+        *error = invokeError;
+      }
+      didSucceed = invokeError == nil && result;
+      completion();
+    }];
+  }];
+  return didSucceed;
+}
+
+#if !TARGET_OS_TV
++ (BOOL)setSimulatedLocation:(CLLocation *)location error:(NSError *__autoreleasing*)error
+{
+  XCTRunnerDaemonSession *session = [FBXCTRunnerDaemonSessionClass sharedSession];
+  if (![session respondsToSelector:@selector(setSimulatedLocation:completion:)]) {
+    if (error) {
+      [[[FBErrorBuilder builder]
+        withDescriptionFormat:@"The current Xcode SDK does not support location simulation. Consider upgrading to Xcode 14.3+/iOS 16.4+"]
+       buildError:error];
+    }
+    return NO;
+  }
+  if (![session supportsLocationSimulation]) {
+    if (error) {
+      [[[FBErrorBuilder builder]
+        withDescriptionFormat:@"Your device does not support location simulation"]
+       buildError:error];
+    }
+    return NO;
+  }
+
+  __block BOOL didSucceed = NO;
+  [FBRunLoopSpinner spinUntilCompletion:^(void(^completion)(void)){
+    [session setSimulatedLocation:location completion:^(bool result, NSError *invokeError) {
+      if (error) {
+        *error = invokeError;
+      }
+      didSucceed = invokeError == nil && result;
+      completion();
+    }];
+  }];
+  return didSucceed;
+}
+
++ (nullable CLLocation *)getSimulatedLocation:(NSError *__autoreleasing*)error;
+{
+  XCTRunnerDaemonSession *session = [FBXCTRunnerDaemonSessionClass sharedSession];
+  if (![session respondsToSelector:@selector(getSimulatedLocationWithReply:)]) {
+    if (error) {
+      [[[FBErrorBuilder builder]
+        withDescriptionFormat:@"The current Xcode SDK does not support location simulation. Consider upgrading to Xcode 14.3+/iOS 16.4+"]
+       buildError:error];
+    }
+    return nil;
+  }
+  if (![session supportsLocationSimulation]) {
+    if (error) {
+      [[[FBErrorBuilder builder]
+        withDescriptionFormat:@"Your device does not support location simulation"]
+       buildError:error];
+    }
+    return nil;
+  }
+
+  __block CLLocation *location = nil;
+  [FBRunLoopSpinner spinUntilCompletion:^(void(^completion)(void)){
+    [session getSimulatedLocationWithReply:^(CLLocation *reply, NSError *invokeError) {
+      if (error) {
+        *error = invokeError;
+      }
+      if (nil == invokeError) {
+        location = reply;
+      }
+      completion();
+    }];
+  }];
+  return location;
+}
+
++ (BOOL)clearSimulatedLocation:(NSError *__autoreleasing*)error
+{
+  XCTRunnerDaemonSession *session = [FBXCTRunnerDaemonSessionClass sharedSession];
+  if (![session respondsToSelector:@selector(clearSimulatedLocationWithReply:)]) {
+    if (error) {
+      [[[FBErrorBuilder builder]
+        withDescriptionFormat:@"The current Xcode SDK does not support location simulation. Consider upgrading to Xcode 14.3+/iOS 16.4+"]
+       buildError:error];
+    }
+    return NO;
+  }
+  if (![session supportsLocationSimulation]) {
+    if (error) {
+      [[[FBErrorBuilder builder]
+        withDescriptionFormat:@"Your device does not support location simulation"]
+       buildError:error];
+    }
+    return NO;
+  }
+
+  __block BOOL didSucceed = NO;
+  [FBRunLoopSpinner spinUntilCompletion:^(void(^completion)(void)){
+    [session clearSimulatedLocationWithReply:^(bool result, NSError *invokeError) {
+      if (error) {
+        *error = invokeError;
+      }
+      didSucceed = invokeError == nil && result;
+      completion();
+    }];
+  }];
+  return didSucceed;
+}
+#endif
+
 @end

package/WebDriverAgentTests/IntegrationTests/XCUIDeviceHelperTests.m

@@ -118,15 +118,57 @@
   XCTAssertNil(error);
 }
 
-- (void)disabled_testUrlSchemeActivation
+- (void)testUrlSchemeActivation
 {
-  // This test is not stable on CI because of system slowness
+  if (SYSTEM_VERSION_LESS_THAN(@"16.4")) {
+    return;
+  }
+
   NSError *error;
   XCTAssertTrue([XCUIDevice.sharedDevice fb_openUrl:@"https://apple.com" error:&error]);
   FBAssertWaitTillBecomesTrue([FBApplication.fb_activeApplication.bundleID isEqualToString:@"com.apple.mobilesafari"]);
   XCTAssertNil(error);
 }
 
+- (void)testUrlSchemeActivationWithApp
+{
+  if (SYSTEM_VERSION_LESS_THAN(@"16.4")) {
+    return;
+  }
+
+  NSError *error;
+  XCTAssertTrue([XCUIDevice.sharedDevice fb_openUrl:@"https://apple.com"
+                                    withApplication:@"com.apple.mobilesafari"
+                                              error:&error]);
+  FBAssertWaitTillBecomesTrue([FBApplication.fb_activeApplication.bundleID isEqualToString:@"com.apple.mobilesafari"]);
+  XCTAssertNil(error);
+}
+
+#if !TARGET_OS_TV
+- (void)testSimulatedLocationSetup
+{
+  if (SYSTEM_VERSION_LESS_THAN(@"16.4")) {
+    return;
+  }
+
+  CLLocation *simulatedLocation = [[CLLocation alloc] initWithLatitude:50 longitude:50];
+  NSError *error;
+  XCTAssertTrue([XCUIDevice.sharedDevice fb_setSimulatedLocation:simulatedLocation error:&error]);
+  XCTAssertNil(error);
+  CLLocation *currentLocation = [XCUIDevice.sharedDevice fb_getSimulatedLocation:&error];
+  XCTAssertNil(error);
+  XCTAssertNotNil(currentLocation);
+  XCTAssertEqualWithAccuracy(simulatedLocation.coordinate.latitude, currentLocation.coordinate.latitude, 0.1);
+  XCTAssertEqualWithAccuracy(simulatedLocation.coordinate.longitude, currentLocation.coordinate.longitude, 0.1);
+  XCTAssertTrue([XCUIDevice.sharedDevice fb_clearSimulatedLocation:&error]);
+  XCTAssertNil(error);
+  currentLocation = [XCUIDevice.sharedDevice fb_getSimulatedLocation:&error];
+  XCTAssertNil(error);
+  XCTAssertNotEqualWithAccuracy(simulatedLocation.coordinate.latitude, currentLocation.coordinate.latitude, 0.1);
+  XCTAssertNotEqualWithAccuracy(simulatedLocation.coordinate.longitude, currentLocation.coordinate.longitude, 0.1);
+}
+#endif
+
 - (void)testPressingUnsupportedButton
 {
   NSError *error;

package/WebDriverAgentTests/UnitTests/FBXPathTests.m

@@ -29,7 +29,7 @@
   xmlTextWriterPtr writer = xmlNewTextWriterDoc(&doc, 0);
   NSMutableDictionary *elementStore = [NSMutableDictionary dictionary];
   int buffersize;
-  xmlChar *xmlbuff;
+  xmlChar *xmlbuff = NULL;
   int rc = xmlTextWriterStartDocument(writer, NULL, "UTF-8", NULL);
   if (rc >= 0) {
     rc = [FBXPath xmlRepresentationWithRootElement:element

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-webdriveragent",
-  "version": "4.10.24",
+  "version": "4.12.0",
   "description": "Package bundling WebDriverAgent",
   "main": "./build/index.js",
   "scripts": {