@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBReflectionUtils.m

@@ -0,0 +1,31 @@
+/**
+ * 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 "FBReflectionUtils.h"
+
+#import <objc/runtime.h>
+
+void FBReplaceMethod(Class class, SEL originalSelector, SEL swizzledSelector) {
+  Method originalMethod = class_getInstanceMethod(class, originalSelector);
+  Method swizzledMethod = class_getInstanceMethod(class, swizzledSelector);
+
+  BOOL didAddMethod =
+  class_addMethod(class,
+                  originalSelector,
+                  method_getImplementation(swizzledMethod),
+                  method_getTypeEncoding(swizzledMethod));
+
+  if (didAddMethod) {
+    class_replaceMethod(class,
+                        swizzledSelector,
+                        method_getImplementation(originalMethod),
+                        method_getTypeEncoding(originalMethod));
+  } else {
+    method_exchangeImplementations(originalMethod, swizzledMethod);
+  }
+}

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBRunLoopSpinner.h

@@ -0,0 +1,77 @@
+/**
+ * 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 <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+typedef BOOL (^FBRunLoopSpinnerBlock)(void);
+typedef __nullable id (^FBRunLoopSpinnerObjectBlock)(void);
+
+@interface FBRunLoopSpinner : NSObject
+
+/**
+ Dispatches block and spins the run loop until `completion` block is called.
+
+ @param block the block to wait for to finish.
+ */
++ (void)spinUntilCompletion:(void (^)(void(^completion)(void)))block;
+
+/**
+ Updates the error message to print in the event of a timeout.
+
+ @param timeoutErrorMessage the Error Message to print.
+ @return the receiver, for chaining.
+ */
+- (instancetype)timeoutErrorMessage:(NSString *)timeoutErrorMessage;
+
+/**
+ Updates the timeout of the receiver.
+
+ @param timeout the amount of time to wait before timing out.
+ @return the receiver, for chaining.
+ */
+- (instancetype)timeout:(NSTimeInterval)timeout;
+
+/**
+ Updates the interval of the receiver.
+
+ @param interval the amount of time to wait before checking condition again.
+ @return the receiver, for chaining.
+ */
+- (instancetype)interval:(NSTimeInterval)interval;
+
+/**
+ Spins the Run Loop until `untilTrue` returns YES or a timeout is reached.
+
+ @param untilTrue the condition to meet.
+ @return YES if the condition was met, NO if the timeout was reached first.
+ */
+- (BOOL)spinUntilTrue:(FBRunLoopSpinnerBlock)untilTrue;
+
+/**
+ Spins the Run Loop until `untilTrue` returns YES or a timeout is reached.
+
+ @param untilTrue the condition to meet.
+ @param error to fill in case of timeout.
+ @return YES if the condition was met, NO if the timeout was reached first.
+ */
+- (BOOL)spinUntilTrue:(FBRunLoopSpinnerBlock)untilTrue error:(NSError **)error;
+
+/**
+ Spins the Run Loop until `untilNotNil` returns non nil value or a timeout is reached.
+
+ @param untilNotNil the condition to meet.
+ @param error to fill in case of timeout.
+ @return YES if the condition was met, NO if the timeout was reached first.
+ */
+- (nullable id)spinUntilNotNil:(FBRunLoopSpinnerObjectBlock)untilNotNil error:(NSError **)error;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBRunLoopSpinner.m

@@ -0,0 +1,94 @@
+/**
+ * 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 "FBRunLoopSpinner.h"
+
+#import <stdatomic.h>
+
+#import "FBErrorBuilder.h"
+
+static const NSTimeInterval FBWaitInterval = 0.1;
+
+@interface FBRunLoopSpinner ()
+@property (nonatomic, copy) NSString *timeoutErrorMessage;
+@property (nonatomic, assign) NSTimeInterval timeout;
+@property (nonatomic, assign) NSTimeInterval interval;
+@end
+
+@implementation FBRunLoopSpinner
+
++ (void)spinUntilCompletion:(void (^)(void(^completion)(void)))block
+{
+  __block volatile atomic_bool didFinish = false;
+  block(^{
+    atomic_fetch_or(&didFinish, true);
+  });
+  while (!atomic_fetch_and(&didFinish, false)) {
+    [[NSRunLoop currentRunLoop] runUntilDate:[NSDate dateWithTimeIntervalSinceNow:FBWaitInterval]];
+  }
+}
+
+- (instancetype)init
+{
+  self = [super init];
+  if (self) {
+    _interval = FBWaitInterval;
+    _timeout = 60;
+  }
+  return self;
+}
+
+- (instancetype)timeoutErrorMessage:(NSString *)timeoutErrorMessage
+{
+  self.timeoutErrorMessage = timeoutErrorMessage;
+  return self;
+}
+
+- (instancetype)timeout:(NSTimeInterval)timeout
+{
+  self.timeout = timeout;
+  return self;
+}
+
+- (instancetype)interval:(NSTimeInterval)interval
+{
+  self.interval = interval;
+  return self;
+}
+
+- (BOOL)spinUntilTrue:(FBRunLoopSpinnerBlock)untilTrue
+{
+  return [self spinUntilTrue:untilTrue error:nil];
+}
+
+- (BOOL)spinUntilTrue:(FBRunLoopSpinnerBlock)untilTrue error:(NSError **)error
+{
+  NSDate *timeoutDate = [NSDate dateWithTimeIntervalSinceNow:self.timeout];
+  while (!untilTrue()) {
+    [[NSRunLoop currentRunLoop] runUntilDate:[NSDate dateWithTimeIntervalSinceNow:self.interval]];
+    if (timeoutDate.timeIntervalSinceNow < 0) {
+      return
+      [[[FBErrorBuilder builder]
+        withDescription:(self.timeoutErrorMessage ?: @"FBRunLoopSpinner timeout")]
+       buildError:error];
+    }
+  }
+  return YES;
+}
+
+- (id)spinUntilNotNil:(FBRunLoopSpinnerObjectBlock)untilNotNil error:(NSError **)error
+{
+  __block id object;
+  [self spinUntilTrue:^BOOL{
+    object = untilNotNil();
+    return object != nil;
+  } error:error];
+  return object;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBRuntimeUtils.h

@@ -0,0 +1,79 @@
+/**
+ * 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 <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Returns array of classes that conforms to given protocol
+ */
+NSArray<Class> *FBClassesThatConformsToProtocol(Protocol *protocol);
+
+/**
+ Method used to retrieve pointer for given symbol 'name' from given 'binary'
+
+ @param binary path to binary we want to retrieve symbols pointer from
+ @param name name of the symbol
+ @return pointer to symbol
+ */
+void *FBRetrieveSymbolFromBinary(const char *binary, const char *name);
+
+/**
+ Get the compiler SDK version as string.
+
+ @return SDK version as string, for example "10.0" or nil if it cannot be received
+ */
+NSString * _Nullable FBSDKVersion(void);
+
+/**
+ Check if the compiler SDK version is less than the given version.
+ The current iOS version is taken instead if SDK version cannot be retrieved.
+
+ @param expected the expected version to compare with, for example '10.3'
+ @return YES if the given version is less than the SDK version used for WDA compilation
+ */
+BOOL isSDKVersionLessThan(NSString *expected);
+
+/**
+ Check if the compiler SDK version is less or equal to the given version.
+ The current iOS version is taken instead if SDK version cannot be retrieved.
+
+ @param expected the expected version to compare with, for example '10.3'
+ @return YES if the given version is less or equal to the SDK version used for WDA compilation
+ */
+BOOL isSDKVersionLessThanOrEqualTo(NSString *expected);
+
+/**
+ Check if the compiler SDK version is equal to the given version.
+ The current iOS version is taken instead if SDK version cannot be retrieved.
+
+ @param expected the expected version to compare with, for example '10.3'
+ @return YES if the given version is equal to the SDK version used for WDA compilation
+ */
+BOOL isSDKVersionEqualTo(NSString *expected);
+
+/**
+ Check if the compiler SDK version is greater or equal to the given version.
+ The current iOS version is taken instead if SDK version cannot be retrieved.
+
+ @param expected the expected version to compare with, for example '10.3'
+ @return YES if the given version is greater or equal to the SDK version used for WDA compilation
+ */
+BOOL isSDKVersionGreaterThanOrEqualTo(NSString *expected);
+
+/**
+ Check if the compiler SDK version is greater than the given version.
+ The current iOS version is taken instead if SDK version cannot be retrieved.
+
+ @param expected the expected version to compare with, for example '10.3'
+ @return YES if the given version is greater than the SDK version used for WDA compilation
+ */
+BOOL isSDKVersionGreaterThan(NSString *expected);
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBRuntimeUtils.m

@@ -0,0 +1,112 @@
+/**
+ * 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 "FBRuntimeUtils.h"
+
+#import "FBMacros.h"
+#import "XCUIDevice.h"
+
+#include <dlfcn.h>
+#import <objc/runtime.h>
+
+NSArray<Class> *FBClassesThatConformsToProtocol(Protocol *protocol)
+{
+  Class *classes = NULL;
+  NSMutableArray *collection = [NSMutableArray array];
+  int numClasses = objc_getClassList(NULL, 0);
+  if (numClasses == 0 ) {
+    return @[];
+  }
+
+  classes = (__unsafe_unretained Class*)malloc(sizeof(Class) * numClasses);
+  numClasses = objc_getClassList(classes, numClasses);
+  for (int index = 0; index < numClasses; index++) {
+    Class aClass = classes[index];
+    if (class_conformsToProtocol(aClass, protocol)) {
+      [collection addObject:aClass];
+    }
+  }
+  free(classes);
+  return collection.copy;
+}
+
+void *FBRetrieveSymbolFromBinary(const char *binary, const char *name)
+{
+  void *handle = dlopen(binary, RTLD_LAZY);
+  NSCAssert(handle, @"%s could not be opened", binary);
+  void *pointer = dlsym(handle, name);
+  NSCAssert(pointer, @"%s could not be located", name);
+  return pointer;
+}
+
+static NSString *sdkVersion = nil;
+static dispatch_once_t onceSdkVersionToken;
+NSString * _Nullable FBSDKVersion(void)
+{
+  dispatch_once(&onceSdkVersionToken, ^{
+    NSString *sdkName = [[NSBundle mainBundle] infoDictionary][@"DTSDKName"];
+    if (sdkName) {
+      // the value of DTSDKName looks like 'iphoneos9.2'
+      NSRange versionRange = [sdkName rangeOfString:@"\\d+\\.\\d+" options:NSRegularExpressionSearch];
+      if (versionRange.location != NSNotFound) {
+        sdkVersion = [sdkName substringWithRange:versionRange];
+      }
+    }
+  });
+  return sdkVersion;
+}
+
+BOOL isSDKVersionLessThan(NSString *expected)
+{
+  NSString *version = FBSDKVersion();
+  if (nil == version) {
+    return SYSTEM_VERSION_LESS_THAN(expected);
+  }
+  NSComparisonResult result = [version compare:expected options:NSNumericSearch];
+  return result == NSOrderedAscending;
+}
+
+BOOL isSDKVersionLessThanOrEqualTo(NSString *expected)
+{
+  NSString *version = FBSDKVersion();
+  if (nil == version) {
+    return SYSTEM_VERSION_LESS_THAN_OR_EQUAL_TO(expected);
+  }
+  NSComparisonResult result = [version compare:expected options:NSNumericSearch];
+  return result == NSOrderedAscending || result == NSOrderedSame;
+}
+
+BOOL isSDKVersionEqualTo(NSString *expected)
+{
+  NSString *version = FBSDKVersion();
+  if (nil == version) {
+    return SYSTEM_VERSION_EQUAL_TO(expected);
+  }
+  NSComparisonResult result = [version compare:expected options:NSNumericSearch];
+  return result == NSOrderedSame;
+}
+
+BOOL isSDKVersionGreaterThanOrEqualTo(NSString *expected)
+{
+  NSString *version = FBSDKVersion();
+  if (nil == version) {
+    return SYSTEM_VERSION_GREATER_THAN_OR_EQUAL_TO(expected);
+  }
+  NSComparisonResult result = [version compare:expected options:NSNumericSearch];
+  return result == NSOrderedDescending || result == NSOrderedSame;
+}
+
+BOOL isSDKVersionGreaterThan(NSString *expected)
+{
+  NSString *version = FBSDKVersion();
+  if (nil == version) {
+    return SYSTEM_VERSION_GREATER_THAN(expected);
+  }
+  NSComparisonResult result = [version compare:expected options:NSNumericSearch];
+  return result == NSOrderedDescending;
+}

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBScreen.h

@@ -0,0 +1,22 @@
+/**
+ * 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 FBScreen : NSObject
+
+/**
+ The scale factor of the main device's screen
+ */
++ (double)scale;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBScreen.m

@@ -0,0 +1,21 @@
+/**
+ * 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 "FBScreen.h"
+#import "XCUIElement+FBIsVisible.h"
+#import "FBXCodeCompatibility.h"
+#import "XCUIScreen.h"
+
+@implementation FBScreen
+
++ (double)scale
+{
+  return [XCUIScreen.mainScreen scale];
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBScreenshot.h

@@ -0,0 +1,44 @@
+/**
+ * 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>
+@class UTType;
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface FBScreenshot : NSObject
+
+/**
+ Retrieves non-scaled screenshot of the whole screen
+
+ @param quality The number in range 0-3, where 0 is PNG (lossless), 3 is HEIC (lossless), 1- low quality JPEG and 2 - high quality JPEG
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return Device screenshot as PNG-encoded data or nil in case of failure
+ */
++ (nullable NSData *)takeInOriginalResolutionWithQuality:(NSUInteger)quality
+                                                   error:(NSError **)error;
+
+/**
+ Retrieves non-scaled screenshot of the whole screen
+
+ @param screenID The screen identifier to take the screenshot from
+ @param compressionQuality Normalized screenshot quality value in range 0..1, where 1 is the best quality
+ @param uti UTType... constant, which defines the type of the returned screenshot image
+ @param timeout how much time to allow for the screenshot to be taken
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return Device screenshot as PNG-, HEIC- or JPG-encoded data or nil in case of failure
+ */
++ (nullable NSData *)takeInOriginalResolutionWithScreenID:(long long)screenID
+                                       compressionQuality:(CGFloat)compressionQuality
+                                                      uti:(UTType *)uti
+                                                  timeout:(NSTimeInterval)timeout
+                                                    error:(NSError **)error;
+
+@end
+
+NS_ASSUME_NONNULL_END