appium-mac2-driver 4.0.7 → 4.1.1

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [4.1.1](https://github.com/appium/appium-mac2-driver/compare/v4.1.0...v4.1.1) (2026-08-08)
+
+### Bug Fixes
+
+* support WebDriverAgent builds with Xcode 27 ([#411](https://github.com/appium/appium-mac2-driver/issues/411)) ([8cd23fc](https://github.com/appium/appium-mac2-driver/commit/8cd23fc7485b0c6f0a0711374df627376ad4657e))
+
+## [4.1.0](https://github.com/appium/appium-mac2-driver/compare/v4.0.7...v4.1.0) (2026-08-07)
+
+### Features
+
+* locate WKWebView web elements by DOM id via AXDOMIdentifier (opt-in) ([#405](https://github.com/appium/appium-mac2-driver/issues/405)) ([9f7cf35](https://github.com/appium/appium-mac2-driver/commit/9f7cf3570fef0c8a449dcef038563427807e8cd7))
+
 ## [4.0.7](https://github.com/appium/appium-mac2-driver/compare/v4.0.6...v4.0.7) (2026-08-06)
 
 ### Miscellaneous Chores

package/WebDriverAgentMac/IntegrationTests/AMElementAttributesTests.m

@@ -17,6 +17,7 @@
 #import <XCTest/XCTest.h>
 
 #import "AMIntegrationTestCase.h"
+#import "FBConfiguration.h"
 #import "FBTestMacros.h"
 #import "XCUIElement+AMAttributes.h"
 #import "XCUIElement+AMEditable.h"
@@ -76,6 +77,19 @@
   XCTAssertEqual(type, XCUIElementTypeButton);
 }
 
+- (void)testIdentifierAttributeWhileDomIdFallbackIsEnabled
+{
+  XCUIElement *closeButton = [self.testedApplication.buttons matchingIdentifier:@"_XCUI:CloseWindow"].firstMatch;
+  FBConfiguration.sharedConfiguration.useDomIdAsAccessibilityId = YES;
+  @try {
+    // A native identifier must never be replaced by a DOM one
+    NSString *identifier = [closeButton am_wdAttributeValueWithName:@"identifier"];
+    XCTAssertEqualObjects(identifier, @"_XCUI:CloseWindow");
+  } @finally {
+    FBConfiguration.sharedConfiguration.useDomIdAsAccessibilityId = NO;
+  }
+}
+
 - (void)testDisabledAttribute
 {
   NSString *buttonTitle = @"I Am Disabled";

package/WebDriverAgentMac/IntegrationTests/AMFindElementTests.m

@@ -17,6 +17,7 @@
 #import <XCTest/XCTest.h>
 
 #import "AMIntegrationTestCase.h"
+#import "FBConfiguration.h"
 #import "XCUIElement+FBFind.h"
 #import "XCUIElement+FBClassChain.h"
 
@@ -43,6 +44,25 @@
   XCTAssertEqualObjects(matches.firstObject.identifier, @"_XCUI:CloseWindow");
 }
 
+- (void)testSingleDescendantWithIdentifierWhileDomIdFallbackIsEnabled
+{
+  FBConfiguration.sharedConfiguration.useDomIdAsAccessibilityId = YES;
+  @try {
+    // The application under test hosts no web content, so the fallback must find
+    // nothing extra and native identifiers must keep resolving as usual
+    NSArray<XCUIElement *> *matches = [self.testedApplication fb_descendantsMatchingIdentifier:@"_XCUI:CloseWindow"
+                                                                   shouldReturnAfterFirstMatch:NO];
+    XCTAssertEqual(matches.count, 1);
+    XCTAssertEqualObjects(matches.firstObject.identifier, @"_XCUI:CloseWindow");
+
+    NSArray<XCUIElement *> *noMatches = [self.testedApplication fb_descendantsMatchingIdentifier:@"there_is_no_such_dom_id"
+                                                                     shouldReturnAfterFirstMatch:NO];
+    XCTAssertEqual(noMatches.count, 0);
+  } @finally {
+    FBConfiguration.sharedConfiguration.useDomIdAsAccessibilityId = NO;
+  }
+}
+
 - (void)testSingleDescendantWithClassName
 {
   NSArray<XCUIElement *> *matches = [self.testedApplication fb_descendantsMatchingClassName:@"XCUIElementTypeButton"

package/WebDriverAgentMac/WebDriverAgentLib/Categories/XCUIElement+AMAttributes.h

@@ -50,6 +50,16 @@ NS_ASSUME_NONNULL_BEGIN
  */
 - (BOOL)am_hasKeyboardInputFocus;
 
+/**
+ The element's identifier as WebDriver reports it: the standard accessibility
+ identifier, falling back to the WebKit DOM identifier for web nodes, which leave the
+ standard one empty. The fallback only applies while useDomIdAsAccessibilityId is
+ enabled, and only takes a snapshot when it is actually needed.
+
+ @return The identifier. Could be an empty string
+ */
+- (NSString *)am_wdIdentifier;
+
 @end
 
 NS_ASSUME_NONNULL_END

package/WebDriverAgentMac/WebDriverAgentLib/Categories/XCUIElement+AMAttributes.m

@@ -17,6 +17,7 @@
 #import "XCUIElement+AMAttributes.h"
 
 #import "AMGeometryUtils.h"
+#import "AMSnapshotUtils.h"
 #import "FBConfiguration.h"
 #import "FBElementTypeTransformer.h"
 #import "FBElementUtils.h"
@@ -50,7 +51,7 @@
   } else if ([wdAttributeName isEqualToString:FBStringify(XCUIElement, value)]) {
     return [FBElementUtils stringValueWithValue:self.value];
   } else if ([wdAttributeName isEqualToString:FBStringify(XCUIElement, identifier)]) {
-    return self.identifier;
+    return self.am_wdIdentifier;
   }
   // This should not happen
   NSString *description = [NSString stringWithFormat:@"The attribute '%@' is unknown", wdAttributeName];
@@ -59,6 +60,16 @@
                                userInfo:@{}];
 }
 
+- (NSString *)am_wdIdentifier
+{
+  NSString *identifier = self.identifier;
+  // Snapshotting is not free, so only pay for it when the fallback can apply.
+  if (identifier.length > 0 || !FBConfiguration.sharedConfiguration.useDomIdAsAccessibilityId) {
+    return identifier;
+  }
+  return [AMSnapshotUtils wdIdentifierWithSnapshot:[self snapshotWithError:nil]] ?: identifier;
+}
+
 - (NSDictionary<NSString *, NSNumber *> *)am_rect
 {
   return AMCGRectToDict(self.frame);

package/WebDriverAgentMac/WebDriverAgentLib/Categories/XCUIElement+FBFind.m

@@ -9,12 +9,50 @@
 
 #import "XCUIElement+FBFind.h"
 
+#import "AMSnapshotUtils.h"
+
+#import "FBConfiguration.h"
 #import "FBElementTypeTransformer.h"
 #import "FBElementUtils.h"
 #import "FBXPath.h"
 #import "NSPredicate+FBFormat.h"
 #import "XCUIElementQuery+AMHelpers.h"
 
+/**
+ Collects the hashes of snapshot tree nodes whose identifier equals the given value.
+
+ @return YES if the caller should stop descending, which happens as soon as a match is
+ found while only the first one is wanted
+ */
+static BOOL AMCollectIdentifierMatches(id<XCUIElementSnapshot> snapshot,
+                                       NSString *accessibilityId,
+                                       BOOL firstMatchOnly,
+                                       NSMutableSet<NSString *> *matchedHashes)
+{
+  if (nil == snapshot) {
+    return NO;
+  }
+  if ([[AMSnapshotUtils wdIdentifierWithSnapshot:snapshot] isEqualToString:accessibilityId]) {
+    [matchedHashes addObject:[AMSnapshotUtils hashWithSnapshot:snapshot]];
+    if (firstMatchOnly) {
+      return YES;
+    }
+  }
+  for (id<XCUIElementSnapshot> child in snapshot.children) {
+    if (AMCollectIdentifierMatches(child, accessibilityId, firstMatchOnly, matchedHashes)) {
+      return YES;
+    }
+  }
+  return NO;
+}
+
+@interface XCUIElement (FBFindPrivate)
+
+- (NSArray<XCUIElement *> *)am_descendantsMatchingDomIdentifier:(NSString *)accessibilityId
+                                    shouldReturnAfterFirstMatch:(BOOL)shouldReturnAfterFirstMatch;
+
+@end
+
 @implementation XCUIElement (FBFind)
 
 + (NSArray<XCUIElement *> *)fb_extractMatchingElementsFromQuery:(XCUIElementQuery *)query
@@ -95,7 +133,32 @@
   XCUIElementQuery *query = [[self descendantsMatchingType:XCUIElementTypeAny] matchingIdentifier:accessibilityId];
   [result addObjectsFromArray:[self.class fb_extractMatchingElementsFromQuery:query
                                                   shouldReturnAfterFirstMatch:shouldReturnAfterFirstMatch]];
-  return result.copy;
+  if (result.count > 0
+      || !FBConfiguration.sharedConfiguration.useDomIdAsAccessibilityId) {
+    return result.copy;
+  }
+  // WebKit leaves the standard accessibility identifier of web nodes empty, so the
+  // above query cannot match them. Retry through their DOM identifiers.
+  return [self am_descendantsMatchingDomIdentifier:accessibilityId
+                       shouldReturnAfterFirstMatch:shouldReturnAfterFirstMatch];
+}
+
+- (NSArray<XCUIElement *> *)am_descendantsMatchingDomIdentifier:(NSString *)accessibilityId
+                                    shouldReturnAfterFirstMatch:(BOOL)shouldReturnAfterFirstMatch
+{
+  // Walk a single root snapshot in memory and only resolve the matching nodes back
+  // to elements. Binding every descendant up front and snapshotting each one
+  // separately exceeds the request timeout on large web trees.
+  id<XCUIElementSnapshot> rootSnapshot = [self snapshotWithError:nil];
+  if (nil == rootSnapshot) {
+    return @[];
+  }
+  NSMutableSet<NSString *> *matchedHashes = [NSMutableSet set];
+  AMCollectIdentifierMatches(rootSnapshot, accessibilityId, shouldReturnAfterFirstMatch, matchedHashes);
+  return [AMSnapshotUtils elementsWithHashes:matchedHashes.copy
+                                 rootElement:self
+                                rootSnapshot:rootSnapshot
+                       includeOnlyFirstMatch:shouldReturnAfterFirstMatch];
 }
 
 @end

package/WebDriverAgentMac/WebDriverAgentLib/Commands/FBSessionCommands.m

@@ -238,6 +238,7 @@ const static NSString *CAPABILITIES_KEY = @"capabilities";
       AM_BOUND_ELEMENTS_BY_INDEX_SETTING: @(FBSession.activeSession.boundElementsByIndex),
       AM_USE_DEFAULT_UI_INTERRUPTIONS_HANDLING_SETTING: @(!application.am_doesNotHandleUIInterruptions),
       AM_FETCH_FULL_TEXT: @(FBConfiguration.sharedConfiguration.fetchFullText),
+      AM_USE_DOM_ID_AS_ACCESSIBILITY_ID: @(FBConfiguration.sharedConfiguration.useDomIdAsAccessibilityId),
     }
   );
 }
@@ -256,6 +257,10 @@ const static NSString *CAPABILITIES_KEY = @"capabilities";
   if (nil != [settings objectForKey:AM_FETCH_FULL_TEXT]) {
     FBConfiguration.sharedConfiguration.fetchFullText = [settings objectForKey:AM_FETCH_FULL_TEXT];
   }
+  if (nil != [settings objectForKey:AM_USE_DOM_ID_AS_ACCESSIBILITY_ID]) {
+    FBConfiguration.sharedConfiguration.useDomIdAsAccessibilityId =
+      [[settings objectForKey:AM_USE_DOM_ID_AS_ACCESSIBILITY_ID] boolValue];
+  }
 
   return [self handleGetSettings:request];
 }

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/AMSettings.h

@@ -28,4 +28,7 @@ extern NSString* const AM_USE_DEFAULT_UI_INTERRUPTIONS_HANDLING_SETTING;
 /*! Whether to use custom snapshotting mechanism to fetch full element's text payload instead of the first 512 chars  */
 extern NSString* const AM_FETCH_FULL_TEXT;
 
+/*! Whether to expose a WKWebView web element's DOM id as its accessibility id */
+extern NSString* const AM_USE_DOM_ID_AS_ACCESSIBILITY_ID;
+
 NS_ASSUME_NONNULL_END

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/AMSettings.m

@@ -19,3 +19,4 @@
 NSString* const AM_BOUND_ELEMENTS_BY_INDEX_SETTING = @"boundElementsByIndex";
 NSString* const AM_USE_DEFAULT_UI_INTERRUPTIONS_HANDLING_SETTING = @"useDefaultUiInterruptionsHandling";
 NSString* const AM_FETCH_FULL_TEXT = @"fetchFullText";
+NSString* const AM_USE_DOM_ID_AS_ACCESSIBILITY_ID = @"useDomIdAsAccessibilityId";

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/AMSnapshotUtils.h

@@ -30,6 +30,33 @@ NS_ASSUME_NONNULL_BEGIN
  */
 + (NSString *)hashWithSnapshot:(id)snapshot;
 
+/**
+ Retrieves the identifier WebDriver clients should observe for the given snapshot.
+ This is the standard accessibility identifier, except for WebKit (WKWebView) web
+ nodes, which leave it empty and publish their HTML `id` through the non-standard
+ AXDOMIdentifier attribute instead. That one is only consulted while the
+ `useDomIdAsAccessibilityId` setting is enabled, so a native identifier is never
+ overridden.
+
+ @param snapshot snapshot instance to retrieve the identifier for
+ @return The identifier value or nil
+ */
++ (nullable NSString *)wdIdentifierWithSnapshot:(nullable id<XCUIElementSnapshot>)snapshot;
+
+/**
+ Resolves snapshot hashes back to live elements below the given root element.
+
+ @param hashes snapshot hashes to resolve, as returned by hashWithSnapshot:
+ @param rootElement the element the hashes were collected from
+ @param rootSnapshot the snapshot of rootElement
+ @param firstMatch whether to only return the first matching element
+ @return The matching elements. Could be empty
+ */
++ (NSArray<XCUIElement *> *)elementsWithHashes:(NSSet<NSString *> *)hashes
+                                   rootElement:(XCUIElement *)rootElement
+                                  rootSnapshot:(id<XCUIElementSnapshot>)rootSnapshot
+                         includeOnlyFirstMatch:(BOOL)firstMatch;
+
 @end
 
 NS_ASSUME_NONNULL_END

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/AMSnapshotUtils.m

@@ -16,6 +16,66 @@
 
 #import "AMSnapshotUtils.h"
 
+#import <ApplicationServices/ApplicationServices.h>
+#import <dlfcn.h>
+
+#import "FBConfiguration.h"
+#import "FBLogger.h"
+#import "XCUIElementQuery+AMHelpers.h"
+
+static NSString *const AM_DOM_IDENTIFIER_ATTRIBUTE = @"AXDOMIdentifier";
+
+/**
+ Creates an AXUIElementRef from an accessibility element's remote token. This entry
+ point is not exported in the public link stubs, so it is resolved dynamically. The
+ underscore-prefixed name is the one actually present in the framework.
+ */
+typedef AXUIElementRef _Nullable (*AMCreateWithRemoteTokenFn)(CFDataRef);
+
+static AMCreateWithRemoteTokenFn AMRemoteTokenFn(void)
+{
+  static AMCreateWithRemoteTokenFn fn = NULL;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    fn = (AMCreateWithRemoteTokenFn)(dlsym(RTLD_DEFAULT, "_AXUIElementCreateWithRemoteToken")
+                                     ?: dlsym(RTLD_DEFAULT, "AXUIElementCreateWithRemoteToken"));
+  });
+  return fn;
+}
+
+/**
+ Whether this process may use the public Accessibility API. XCUITest itself does not
+ need it, so an untrusted runner keeps automating native content normally while every
+ AXDOMIdentifier read fails with kAXErrorAPIDisabled. Guarding the read turns a failing
+ syscall per element into a cached boolean. TCC trust is fixed at process start, so the
+ answer cannot change under us.
+ */
+static BOOL AMIsAccessibilityTrusted(void)
+{
+  static BOOL isTrusted = NO;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    isTrusted = AXIsProcessTrusted();
+    if (!isTrusted) {
+      [FBLogger log:@"This process is not trusted for the Accessibility API, so WebKit DOM "
+       @"identifiers cannot be resolved. Grant Accessibility permission to the "
+       @"WebDriverAgentRunner app and restart it to enable useDomIdAsAccessibilityId."];
+    }
+  });
+  return isTrusted;
+}
+
+@interface AMSnapshotUtils ()
+
+/**
+ Reads the non-standard AXDOMIdentifier attribute, where WebKit publishes a web
+ node's HTML `id`. Returns nil for native elements, which report
+ kAXErrorAttributeUnsupported for it.
+ */
++ (nullable NSString *)domIdentifierWithSnapshot:(nullable id)snapshot;
+
+@end
+
 @implementation AMSnapshotUtils
 
 + (NSString *)hashWithSnapshot:(id)snapshot
@@ -24,4 +84,79 @@
   return [token base64EncodedStringWithOptions:0];
 }
 
++ (nullable NSString *)wdIdentifierWithSnapshot:(nullable id<XCUIElementSnapshot>)snapshot
+{
+  NSString *identifier = snapshot.identifier;
+  if (identifier.length > 0
+      || !FBConfiguration.sharedConfiguration.useDomIdAsAccessibilityId) {
+    return identifier;
+  }
+  return [self domIdentifierWithSnapshot:snapshot] ?: identifier;
+}
+
++ (NSArray<XCUIElement *> *)elementsWithHashes:(NSSet<NSString *> *)hashes
+                                   rootElement:(XCUIElement *)rootElement
+                                  rootSnapshot:(id<XCUIElementSnapshot>)rootSnapshot
+                         includeOnlyFirstMatch:(BOOL)firstMatch
+{
+  if (0 == hashes.count) {
+    return @[];
+  }
+
+  NSMutableArray<XCUIElement *> *matchingElements = [NSMutableArray array];
+  if ([hashes containsObject:[self hashWithSnapshot:rootSnapshot]]) {
+    [matchingElements addObject:rootElement];
+    if (firstMatch) {
+      return matchingElements.copy;
+    }
+  }
+  NSPredicate *predicate = [NSPredicate predicateWithBlock:^BOOL(id snapshot, NSDictionary *bindings) {
+    return [hashes containsObject:[self hashWithSnapshot:snapshot]];
+  }];
+  [matchingElements addObjectsFromArray:[[rootElement descendantsMatchingType:XCUIElementTypeAny]
+                                         matchingPredicate:predicate].am_allMatches];
+  return firstMatch && matchingElements.count > 0
+    ? @[matchingElements.firstObject]
+    : matchingElements.copy;
+}
+
++ (nullable NSString *)domIdentifierWithSnapshot:(nullable id)snapshot
+{
+  if (nil == snapshot || !AMIsAccessibilityTrusted()) {
+    return nil;
+  }
+  AMCreateWithRemoteTokenFn createRef = AMRemoteTokenFn();
+  if (NULL == createRef) {
+    return nil;
+  }
+
+  @try {
+    NSData *token = [[snapshot valueForKey:@"_accessibilityElement"] valueForKey:@"_token"];
+    if (![token isKindOfClass:NSData.class]) {
+      return nil;
+    }
+    AXUIElementRef ref = createRef((__bridge CFDataRef)token);
+    if (NULL == ref) {
+      return nil;
+    }
+    CFTypeRef value = NULL;
+    AXError err = AXUIElementCopyAttributeValue(ref,
+                                                (__bridge CFStringRef)AM_DOM_IDENTIFIER_ATTRIBUTE,
+                                                &value);
+    CFRelease(ref);
+    if (kAXErrorSuccess != err || NULL == value) {
+      return nil;
+    }
+    NSString *result = [(__bridge id)value isKindOfClass:NSString.class]
+      ? [(__bridge NSString *)value copy]
+      : nil;
+    CFRelease(value);
+    return result.length > 0 ? result : nil;
+  } @catch (NSException *e) {
+    // Only the private _accessibilityElement._token key path may throw here
+    [FBLogger logFmt:@"Cannot retrieve the DOM identifier of a snapshot. Original error: %@", e.reason];
+    return nil;
+  }
+}
+
 @end

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/FBConfiguration.h

@@ -33,6 +33,9 @@ NS_ASSUME_NONNULL_BEGIN
 /*! Whether to use custom snapshotting mechanism to fetch full element's text payload instead of the first 512 chars  */
 @property BOOL fetchFullText;
 
+/*! Whether to expose a WKWebView web element's DOM id as its accessibility id */
+@property BOOL useDomIdAsAccessibilityId;
+
 /**
  The range of ports that the HTTP Server should attempt to bind on launch
  */

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/FBConfiguration.m

@@ -12,6 +12,7 @@
 static NSUInteger const DefaultStartingPort = 10100;
 static NSUInteger const DefaultPortRange = 100;
 static BOOL FBFetchFullText = NO;
+static BOOL FBUseDomIdAsAccessibilityId = NO;
 
 @implementation FBConfiguration
 
@@ -86,6 +87,16 @@ static FBConfiguration *instance;
   FBFetchFullText = fetchFullText;
 }
 
+- (BOOL)useDomIdAsAccessibilityId
+{
+  return FBUseDomIdAsAccessibilityId;
+}
+
+- (void)setUseDomIdAsAccessibilityId:(BOOL)useDomIdAsAccessibilityId
+{
+  FBUseDomIdAsAccessibilityId = useDomIdAsAccessibilityId;
+}
+
 - (NSRange)bindingPortRange
 {
   // 'WebDriverAgent --port 8080' can be passed via the arguments to the process

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/FBXPath.m

@@ -184,7 +184,7 @@ static NSString *const kXMLIndexPathKey = @"private_indexPath";
     return @[];
   }
 
-  NSMutableArray<NSString *> *hashes = [NSMutableArray array];
+  NSMutableSet<NSString *> *hashes = [NSMutableSet set];
   for (NSXMLNode *node in nodes) {
     if (![node isKindOfClass:NSXMLElement.class]) {
       continue;
@@ -195,21 +195,10 @@ static NSString *const kXMLIndexPathKey = @"private_indexPath";
     }
     [hashes addObject:attrValue];
   }
-  NSMutableArray<XCUIElement *> *matchingElements = [NSMutableArray array];
-  NSString *selfHash = [AMSnapshotUtils hashWithSnapshot:rootSnapshot];
-  if ([hashes containsObject:selfHash]) {
-    [matchingElements addObject:rootElement];
-    if (firstMatch) {
-      return matchingElements.copy;
-    }
-  }
-  NSPredicate *predicate = [NSPredicate predicateWithBlock:^BOOL(id snapshot, NSDictionary *bindings) {
-    return [hashes containsObject:[AMSnapshotUtils hashWithSnapshot:snapshot]];
-  }];
-  [matchingElements addObjectsFromArray:[[rootElement descendantsMatchingType:XCUIElementTypeAny] matchingPredicate:predicate].am_allMatches];
-  return firstMatch && matchingElements.count > 0
-    ? @[matchingElements.firstObject]
-    : matchingElements.copy;
+  return [AMSnapshotUtils elementsWithHashes:hashes.copy
+                                 rootElement:rootElement
+                                rootSnapshot:rootSnapshot
+                       includeOnlyFirstMatch:firstMatch];
 }
 
 + (NSXMLDocument *)xmlRepresentationWithSnapshot:(id<XCUIElementSnapshot>)root
@@ -366,7 +355,7 @@ static NSString *const FBAbstractMethodInvocationException = @"AbstractMethodInv
 
 + (NSString *)valueForElement:(id<XCUIElementSnapshot>)element
 {
-  return element.identifier;
+  return [AMSnapshotUtils wdIdentifierWithSnapshot:element];
 }
 
 @end

package/WebDriverAgentMac/WebDriverAgentMac.xcodeproj/project.pbxproj

@@ -1367,6 +1367,7 @@
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
 				MACOSX_DEPLOYMENT_TARGET = 10.15;
+				"MACOSX_DEPLOYMENT_TARGET[sdk=macosx27.*]" = 12.0;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				ONLY_ACTIVE_ARCH = YES;
@@ -1420,6 +1421,7 @@
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
 				MACOSX_DEPLOYMENT_TARGET = 10.15;
+				"MACOSX_DEPLOYMENT_TARGET[sdk=macosx27.*]" = 12.0;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				MTL_FAST_MATH = YES;
 				SDKROOT = macosx;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "appium-mac2-driver",
-  "version": "4.0.7",
+  "version": "4.1.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "appium-mac2-driver",
-      "version": "4.0.7",
+      "version": "4.1.1",
       "license": "Apache-2.0",
       "dependencies": {
         "@appium/strongbox": "^1.0.0-rc.1",
@@ -492,9 +492,9 @@
       }
     },
     "node_modules/bare-url": {
-      "version": "2.4.7",
-      "resolved": "https://registry.npmjs.org/bare-url/-/bare-url-2.4.7.tgz",
-      "integrity": "sha512-o8CRCiJtib+ycO3mE4A5UChtGX4dDP2XxsWVu9P+Zc3H8tcmKwNVEDoDTXmwN+uuMhfKeT7/i7Y26xS8W7ohoA==",
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/bare-url/-/bare-url-2.5.1.tgz",
+      "integrity": "sha512-cD5ciQuKlx+eumTCfqbfiL+fhQm+dHbVNB/cX4+d+I/nx4JsVop9VoFEPAs5RJ6I84QR6bZIBjpd2kjDOYeWcg==",
       "license": "Apache-2.0",
       "dependencies": {
         "bare-path": "^3.0.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-mac2-driver",
-  "version": "4.0.7",
+  "version": "4.1.1",
   "description": "XCTest-based Appium driver for macOS apps automation",
   "keywords": [
     "XCTest",