@devicelab/maestro-runner-darwin-arm64 1.1.27 → 1.1.28

package/drivers/ios/WebDriverAgent/PrivateHeaders/XCTest/XCUIScreen.h

@@ -1,27 +1,53 @@
 //
-//     Generated by class-dump 3.5 (64 bit) (Debug version compiled Nov 29 2017 14:55:25).
+//   Generated by https://github.com/blacktop/ipsw (Version: 3.1.534, BuildCommit: b276a7d7daf462beda4afef1c43a753a47405355)
 //
-//     class-dump is Copyright (C) 1997-1998, 2000-2001, 2004-2015 by Steve Nygard.
+//    - LC_BUILD_VERSION:  Platform: iOS, MinOS: 13, SDK: 26.4, Tool: ld (1267)
+//    - LC_SOURCE_VERSION: 24904.0.0.0.0
 //
+#ifndef XCUIScreen_h
+#define XCUIScreen_h
+#import <XCTest/XCUIScreen.h>
+@import Foundation;
+@import UIKit;
 
-@interface XCUIScreen()
-{
-  _Bool _isMainScreen;
-  long long _displayID;
-}
-@property(readonly) _Bool isMainScreen; // @synthesize isMainScreen=_isMainScreen;
-@property(readonly) long long displayID; // @synthesize displayID=_displayID;
-
-- (id)_clippedScreenshotData:(id)arg1 quality:(long long)arg2 rect:(struct CGRect)arg3 scale:(double)arg4;
-- (id)_screenshotDataForQuality:(long long)arg1 rect:(struct CGRect)arg2 error:(id *)arg3;
-- (id)screenshotDataForQuality:(long long)arg1 rect:(struct CGRect)arg2 error:(id *)arg3;
-- (id)screenshotDataForQuality:(long long)arg1 rect:(struct CGRect)arg2;
-- (id)_modernScreenshotDataForQuality:(long long)arg1 rect:(struct CGRect)arg2 error:(id *)arg3;
-- (id)screenshot;
-- (id)_imageFromData:(id)arg1;
-- (double)scale;
+#include "XCUIScreenDataSource-Protocol.h"
+
+@class NSObject, NSString, NSUUID, XCUIButtonConsole, XCUIDevice, XCUIKnobControl;
+@protocol XCUIDevice;
+
+@interface XCUIScreen (FBXCTestPrivate)
 
-- (id)initWithDisplayID:(long long)arg1 isMainScreen:(_Bool)arg2 device:(id)arg3 screenDataSource:(id)arg4;
+@property (retain, nonatomic) NSUUID *currentDiagnosticScreenRecordingUUID;
+@property (readonly) _Bool isMainScreen;
+@property (readonly, weak) id <XCUIDevice> device;
+@property (readonly) id <XCUIScreenDataSource> screenDataSource;
+@property (readonly) XCUIButtonConsole *buttonConsole;
+@property (readonly) XCUIKnobControl *knobControl;
+@property (readonly) long long displayID;
+@property (readonly) double scale;
+@property (readonly) CGRect bounds;
+@property (readonly) unsigned long long traits;
+@property (readonly) unsigned long long hash;
+@property (readonly) Class superclass;
+@property (readonly, copy) NSString *description;
+@property (readonly, copy) NSString *debugDescription;
+
+/* class methods */
++ (id)mainScreen;
++ (id)screens;
+
+/* instance methods */
+- (id)initWithDisplayID:(long long)id isMainScreen:(_Bool)screen device:(id)device screenDataSource:(id)source;
+- (id)makeDiagnosticScreenshotAttachment;
+- (void)startDiagnosticScreenRecordingWithCompletion:(id /* block */)completion;
+- (void)stopDiagnosticRecordingWithCompletion:(id /* block */)completion;
+- (_Bool)isEqual:(id)equal;
+- (id)screenshot;
+- (id)screenshotWithEncoding:(id)encoding options:(unsigned long long)options;
+- (id)screenshotWithPreferredEncoding:(id)encoding rect:(CGRect)rect error:(id *)error;
+- (id)screenshotWithPreferredEncoding:(id)encoding rect:(CGRect)rect options:(unsigned long long)options error:(id *)error;
+- (id)screenshotAttachmentWithPreferredEncoding:(id)encoding rect:(CGRect)rect options:(unsigned long long)options error:(id *)error;
 
 @end
 
+#endif /* XCUIScreen_h */

package/drivers/ios/WebDriverAgent/PrivateHeaders/XCTest/XCUIScreenDataSource-Protocol.h

@@ -1,19 +1,35 @@
 //
-//     Generated by class-dump 3.5 (64 bit).
+//   Generated by https://github.com/blacktop/ipsw (Version: 3.1.534, BuildCommit: b276a7d7daf462beda4afef1c43a753a47405355)
 //
-//     class-dump is Copyright (C) 1997-1998, 2000-2001, 2004-2013 by Steve Nygard.
+//    - LC_BUILD_VERSION:  Platform: iOS, MinOS: 13, SDK: 26.4, Tool: ld (1267)
+//    - LC_SOURCE_VERSION: 24904.0.0.0.0
 //
-
-@class NSString;
+#ifndef XCUIScreenDataSource_Protocol_h
+#define XCUIScreenDataSource_Protocol_h
+@import Foundation;
+@import UIKit;
 
 @protocol XCUIScreenDataSource <NSObject>
-- (void)requestScreenshotOfScreenWithID:(long long)arg1
-                               withRect:(struct CGRect)arg2
-                                  scale:(double)arg3
-                              formatUTI:(NSString *)arg4
-                     compressionQuality:(double)arg5
-                              withReply:(void (^)(NSData *, NSError *))arg6;
-- (void)requestScaleForScreenWithIdentifier:(long long)arg1 completion:(void (^)(double, NSError *))arg2;
-- (void)requestScreenIdentifiersWithCompletion:(void (^)(NSArray *, NSError *))arg1;
+
+@required
+
+@property (readonly, nonatomic) _Bool supportsHEICImageEncoding;
+@property (readonly, nonatomic) _Bool preferScreenshotsOverScreenRecordings;
+@property (readonly, nonatomic) _Bool supportsScreenRecording;
+@property (readonly, nonatomic) _Bool supportsMultiDeviceScreenRecording;
+
+/* required instance methods */
+- (void)requestScreenIdentifiersWithCompletion:(id /* block */)completion;
+- (void)requestTraitsForScreenWithIdentifier:(long long)identifier completion:(id /* block */)completion;
+- (void)requestScaleForScreenWithIdentifier:(long long)identifier completion:(id /* block */)completion;
+- (void)requestBoundsForScreenWithIdentifier:(long long)identifier completion:(id /* block */)completion;
+- (void)requestScreenshotWithRequest:(id)request withReply:(id /* block */)reply;
+- (void)requestScreenshotAttachmentWithRequest:(id)request withReply:(id /* block */)reply;
+- (void)startScreenRecordingWithRequest:(id)request withReply:(id /* block */)reply;
+- (void)stopScreenRecordingWithUUID:(id)uuid withReply:(id /* block */)reply;
+
+@optional
+
 @end
 
+#endif /* XCUIScreenDataSource_Protocol_h */

package/drivers/ios/WebDriverAgent/PrivateHeaders/XCTest/XCUISiriService.h

@@ -0,0 +1,39 @@
+//
+//   Generated by https://github.com/blacktop/ipsw (Version: 3.1.534, BuildCommit: b276a7d7daf462beda4afef1c43a753a47405355)
+//
+//    - LC_BUILD_VERSION:  Platform: iOS, MinOS: 13, SDK: 26.4, Tool: ld (1267)
+//    - LC_SOURCE_VERSION: 24904.0.0.0.0
+//
+#ifndef XCUISiriService_h
+#define XCUISiriService_h
+#import <XCTest/XCUISiriService.h>
+@import Foundation;
+@import UIKit;
+
+#include "XCUIRemoteSiriInterface-Protocol.h"
+
+@class NSObject, NSString, XCUIApplication, XCUIDevice;
+@protocol XCUIDevice;
+
+@interface XCUISiriService (FBXCTestPrivate)
+
+@property (readonly) XCUIApplication *siriApplication;
+@property (readonly) _Bool supportsAccessibility;
+@property (readonly) id <XCUIDevice> device;
+@property (readonly) id <XCUIRemoteSiriInterface> remoteSiriInterface;
+@property (readonly, getter=isEnabled) _Bool enabled;
+
+/* instance methods */
+- (id)initWithDevice:(id)device remoteSiriInterface:(id)interface supportsAccessibility:(_Bool)accessibility;
+- (void)injectAssistantRecognitionStrings:(id)strings;
+- (void)injectVoiceRecognitionAudioInputPaths:(id)paths;
+- (_Bool)_usesLegacySiriViewService;
+- (id)_siriBundleIdentifier;
+- (unsigned long long)_expectedStateForActivate;
+- (void)_assertSiriEnabled;
+- (void)_waitForActivation;
+- (id)forwardingTargetForSelector:(SEL)selector;
+
+@end
+
+#endif /* XCUISiriService_h */

package/drivers/ios/WebDriverAgent/PrivateHeaders/XCTest/XCUISystem.h

@@ -0,0 +1,26 @@
+//
+//   Generated by https://github.com/blacktop/ipsw (Version: 3.1.534, BuildCommit: b276a7d7daf462beda4afef1c43a753a47405355)
+//
+//    - LC_BUILD_VERSION:  Platform: iOS, MinOS: 13, SDK: 26.4, Tool: ld (1267)
+//    - LC_SOURCE_VERSION: 24904.0.0.0.0
+//
+#ifndef XCUISystem_h
+#define XCUISystem_h
+#import <XCTest/XCUISystem.h>
+@import Foundation;
+@import UIKit;
+
+@class NSArray, NSObject, XCUIDevice;
+@protocol XCUIDevice;
+
+@interface XCUISystem (FBXCTestPrivate)
+
+@property (readonly, weak) id <XCUIDevice> device;
+@property (readonly) NSArray *activeForegroundApplications;
+
+/* instance methods */
+- (id)initWithDevice:(id)device;
+
+@end
+
+#endif /* XCUISystem_h */

package/drivers/ios/WebDriverAgent/PrivateHeaders/XCTest/XCUIXcodeApplicationManaging-Protocol.h

@@ -0,0 +1,27 @@
+//
+//   Generated by https://github.com/blacktop/ipsw (Version: 3.1.534, BuildCommit: b276a7d7daf462beda4afef1c43a753a47405355)
+//
+//    - LC_BUILD_VERSION:  Platform: iOS, MinOS: 13, SDK: 26.4, Tool: ld (1267)
+//    - LC_SOURCE_VERSION: 24904.0.0.0.0
+//
+#ifndef XCUIXcodeApplicationManaging_Protocol_h
+#define XCUIXcodeApplicationManaging_Protocol_h
+@import Foundation;
+@import UIKit;
+
+#include "XCUIApplicationManaging-Protocol.h"
+
+@protocol XCUIXcodeApplicationManaging <XCUIApplicationManaging>
+
+@required
+
+/* required instance methods */
+- (void)openURL:(id)url processPath:(id)path bundleID:(id)id arguments:(id)arguments environmentVariables:(id)variables completion:(id /* block */)completion;
+- (void)requestLaunchProgressForProcessWithToken:(id)token completion:(id /* block */)completion;
+- (void)terminateProcessWithToken:(id)token completion:(id /* block */)completion;
+
+@optional
+
+@end
+
+#endif /* XCUIXcodeApplicationManaging_Protocol_h */

package/drivers/ios/WebDriverAgent/PrivateHeaders/XCTest/_TtC10XCTestCore19XCTReportingContext.h

@@ -0,0 +1,26 @@
+//
+//   Generated by https://github.com/blacktop/ipsw (Version: 3.1.534, BuildCommit: b276a7d7daf462beda4afef1c43a753a47405355)
+//
+//    - LC_BUILD_VERSION:  Platform: iOS, MinOS: 13, SDK: 26.4, Tool: ld (1267)
+//    - LC_SOURCE_VERSION: 24904.0.0.0.0
+//
+#ifndef _TtC10XCTestCore19XCTReportingContext_h
+#define _TtC10XCTestCore19XCTReportingContext_h
+@import Foundation;
+@import UIKit;
+
+@class NSObject;
+
+@interface XCTReportingContext : NSObject { // (Swift)
+    /* instance variables */
+     id ideProxy;
+     id configuration;
+     id publisher;
+}
+
+/* instance methods */
+- (id)init;
+
+@end
+
+#endif /* _TtC10XCTestCore19XCTReportingContext_h */

package/drivers/ios/WebDriverAgent/PrivateHeaders/XCTest/_XCTMessaging_VoidProtocol-Protocol.h

@@ -0,0 +1,20 @@
+//
+//   Generated by https://github.com/blacktop/ipsw (Version: 3.1.534, BuildCommit: b276a7d7daf462beda4afef1c43a753a47405355)
+//
+//    - LC_BUILD_VERSION:  Platform: iOS, MinOS: 13, SDK: 26.4, Tool: ld (1267)
+//    - LC_SOURCE_VERSION: 24904.0.0.0.0
+//
+#ifndef _XCTMessaging_VoidProtocol_Protocol_h
+#define _XCTMessaging_VoidProtocol_Protocol_h
+@import Foundation;
+@import UIKit;
+
+@protocol _XCTMessaging_VoidProtocol
+
+@required
+
+@optional
+
+@end
+
+#endif /* _XCTMessaging_VoidProtocol_Protocol_h */

package/drivers/ios/WebDriverAgent/PrivateHeaders/XCTest/_XCTestObservationInternal-Protocol.h

@@ -0,0 +1,26 @@
+//
+//   Generated by https://github.com/blacktop/ipsw (Version: 3.1.534, BuildCommit: b276a7d7daf462beda4afef1c43a753a47405355)
+//
+//    - LC_BUILD_VERSION:  Platform: iOS, MinOS: 13, SDK: 26.4, Tool: ld (1267)
+//    - LC_SOURCE_VERSION: 24904.0.0.0.0
+//
+#ifndef _XCTestObservationInternal_Protocol_h
+#define _XCTestObservationInternal_Protocol_h
+@import Foundation;
+@import UIKit;
+
+#include "_XCTestObservationPrivate-Protocol.h"
+
+@protocol _XCTestObservationInternal <_XCTestObservationPrivate>
+
+@required
+
+@optional
+
+/* optional instance methods */
+- (void)testSuite:(id)suite didRecordSkipWithDescription:(id)description sourceCodeContext:(id)context;
+- (void)testCasePlaceholder:(id)placeholder isUnavailableWithReason:(id)reason;
+
+@end
+
+#endif /* _XCTestObservationInternal_Protocol_h */

package/drivers/ios/WebDriverAgent/PrivateHeaders/XCTest/_XCTestObservationPrivate-Protocol.h

@@ -0,0 +1,27 @@
+//
+//   Generated by https://github.com/blacktop/ipsw (Version: 3.1.534, BuildCommit: b276a7d7daf462beda4afef1c43a753a47405355)
+//
+//    - LC_BUILD_VERSION:  Platform: iOS, MinOS: 13, SDK: 26.4, Tool: ld (1267)
+//    - LC_SOURCE_VERSION: 24904.0.0.0.0
+//
+#ifndef _XCTestObservationPrivate_Protocol_h
+#define _XCTestObservationPrivate_Protocol_h
+#import <XCTest/XCTestObservation.h>
+@import Foundation;
+@import UIKit;
+
+
+@protocol _XCTestObservationPrivate <XCTestObservation>
+
+@required
+
+@optional
+
+/* optional instance methods */
+- (void)_context:(id)_context willStartActivity:(id)activity;
+- (void)_context:(id)_context didFinishActivity:(id)activity;
+- (void)testCase:(id)_case didRecordSkipWithDescription:(id)description sourceCodeContext:(id)context;
+
+@end
+
+#endif /* _XCTestObservationPrivate_Protocol_h */

package/drivers/ios/WebDriverAgent/README.md

@@ -42,15 +42,5 @@ Then, you find `WebDriverAgentRunner-Runner-sim-<version>.zip`  for iOS and `Web
 
 [`WebDriverAgent` is BSD-licensed](LICENSE).
 
-## Third Party Sources
-
-WebDriverAgent depends on the following third-party frameworks:
-- [CocoaHTTPServer](https://github.com/robbiehanson/CocoaHTTPServer)
-- [RoutingHTTPServer](https://github.com/mattstevens/RoutingHTTPServer)
-
-These projects haven't been maintained in a while. That's why the source code of these
-projects has been integrated directly in the WebDriverAgent source tree.
-
-You can find the source files and their licenses in the `WebDriverAgentLib/Vendor` directory.
 
 Have fun!

package/drivers/ios/WebDriverAgent/Scripts/build-webdriveragent.mjs

@@ -1,9 +1,9 @@
 import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { asyncify } from 'asyncbox';
-import { logger, fs } from '@appium/support';
-import { exec } from 'teen_process';
+import {fileURLToPath} from 'node:url';
+
+import {logger, fs} from '@appium/support';
 import * as xcode from 'appium-xcode';
+import {exec} from 'teen_process';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -12,16 +12,22 @@ const isMainModule = process.argv[1] && path.resolve(process.argv[1]) === __file
 const LOG = new logger.getLogger('WDABuild');
 const ROOT_DIR = path.resolve(__dirname, '..');
 const DERIVED_DATA_PATH = `${ROOT_DIR}/wdaBuild`;
-const WDA_BUNDLE = 'WebDriverAgentRunner-Runner.app';
-const WDA_BUNDLE_PATH = path.join(DERIVED_DATA_PATH, 'Build', 'Products', 'Debug-iphonesimulator');
-
-const WDA_BUNDLE_TV = 'WebDriverAgentRunner_tvOS-Runner.app';
-const WDA_BUNDLE_TV_PATH = path.join(DERIVED_DATA_PATH, 'Build', 'Products', 'Debug-appletvsimulator');
 
-const TARGETS = ['runner', 'tv_runner'];
-const SDKS = ['sim', 'tv_sim'];
-
-async function buildWebDriverAgent (xcodeVersion) {
+const BUNDLE_INFO = {
+  runner: {bundle: 'WebDriverAgentRunner-Runner.app', productDir: 'Debug-iphonesimulator'},
+  tv_runner: {bundle: 'WebDriverAgentRunner_tvOS-Runner.app', productDir: 'Debug-appletvsimulator'},
+  watch_runner: {bundle: 'WebDriverAgentRunner_watchOS-Runner.app', productDir: 'Debug-watchsimulator'},
+};
+
+const TARGETS = ['runner', 'tv_runner', 'watch_runner'];
+const SDKS = ['sim', 'tv_sim', 'watch_sim'];
+
+/**
+ * Build WebDriverAgent and pack the app bundle into a zip archive.
+ *
+ * @param {string} [xcodeVersion] Xcode version to include in archive name.
+ */
+async function buildWebDriverAgent(xcodeVersion) {
   const target = process.env.TARGET;
   const sdk = process.env.SDK;
 
@@ -33,23 +39,22 @@ async function buildWebDriverAgent (xcodeVersion) {
     throw Error(`Please set SDK environment variable from the supported SDKs ${JSON.stringify(SDKS)}`);
   }
 
-
   LOG.info(`Cleaning ${DERIVED_DATA_PATH} if exists`);
   try {
     await exec('xcodebuild', ['clean', '-derivedDataPath', DERIVED_DATA_PATH, '-scheme', 'WebDriverAgentRunner'], {
-      cwd: ROOT_DIR
+      cwd: ROOT_DIR,
     });
   } catch {}
 
   // Get Xcode version
-  xcodeVersion = xcodeVersion || await xcode.getVersion();
+  xcodeVersion = xcodeVersion || (await xcode.getVersion());
   LOG.info(`Building WebDriverAgent for iOS using Xcode version '${xcodeVersion}'`);
 
   // Clean and build
   try {
     await exec('/bin/bash', ['./Scripts/build.sh'], {
       env: {TARGET: target, SDK: sdk, DERIVED_DATA_PATH},
-      cwd: ROOT_DIR
+      cwd: ROOT_DIR,
     });
   } catch (e) {
     LOG.error(`===FAILED TO BUILD FOR ${xcodeVersion}`);
@@ -57,9 +62,8 @@ async function buildWebDriverAgent (xcodeVersion) {
     throw e;
   }
 
-  const isTv = target === 'tv_runner';
-  const bundle = isTv ? WDA_BUNDLE_TV : WDA_BUNDLE;
-  const bundle_path = isTv ? WDA_BUNDLE_TV_PATH : WDA_BUNDLE_PATH;
+  const {bundle, productDir} = BUNDLE_INFO[target];
+  const bundle_path = path.join(DERIVED_DATA_PATH, 'Build', 'Products', productDir);
 
   const zipName = `WebDriverAgentRunner-Runner-${sdk}-${xcodeVersion}.zip`;
   LOG.info(`Creating ${zipName} which includes ${bundle}`);
@@ -78,8 +82,12 @@ async function buildWebDriverAgent (xcodeVersion) {
 }
 
 if (isMainModule) {
-  asyncify(buildWebDriverAgent);
+  try {
+    await buildWebDriverAgent();
+  } catch (e) {
+    LOG.error(e);
+    process.exit(1);
+  }
 }
 
 export default buildWebDriverAgent;
-

package/drivers/ios/WebDriverAgent/Scripts/build.sh

@@ -17,6 +17,8 @@ function define_xc_macros() {
     "runner" ) XC_TARGET="WebDriverAgentRunner";;
     "tv_lib" ) XC_TARGET="WebDriverAgentLib_tvOS";;
     "tv_runner" ) XC_TARGET="WebDriverAgentRunner_tvOS";;
+    "watch_lib" ) XC_TARGET="WebDriverAgentLib_watchOS";;
+    "watch_runner" ) XC_TARGET="WebDriverAgentRunner_watchOS";;
     *) echo "Unknown TARGET"; exit 1 ;;
   esac
 
@@ -24,8 +26,10 @@ function define_xc_macros() {
     "iphone" ) XC_DESTINATION="platform=iOS Simulator,name=`echo $IPHONE_MODEL | tr -d "'"`,OS=$IOS_VERSION";;
     "ipad" ) XC_DESTINATION="platform=iOS Simulator,name=`echo $IPAD_MODEL | tr -d "'"`,OS=$IOS_VERSION";;
     "tv" ) XC_DESTINATION="platform=tvOS Simulator,name=`echo $TV_MODEL | tr -d "'"`,OS=$TV_VERSION";;
+    "watch" ) XC_DESTINATION="platform=watchOS Simulator,name=`echo $WATCH_MODEL | tr -d "'"`,OS=$WATCH_VERSION";;
     "generic" ) XC_DESTINATION="generic/platform=iOS";;
     "tv_generic" ) XC_DESTINATION="generic/platform=tvOS" XC_MACROS="${XC_MACROS} ARCHS=arm64";; # tvOS only supports arm64
+    "watch_generic" ) XC_DESTINATION="generic/platform=watchOS" XC_MACROS="${XC_MACROS} ARCHS=arm64";; # watchOS only supports arm64
   esac
 
   case "$ACTION" in
@@ -43,6 +47,8 @@ function define_xc_macros() {
     "device" ) XC_SDK="iphoneos";;
     "tv_sim" ) XC_SDK="appletvsimulator";;
     "tv_device" ) XC_SDK="appletvos";;
+    "watch_sim" ) XC_SDK="watchsimulator";;
+    "watch_device" ) XC_SDK="watchos";;
     *) echo "Unknown SDK"; exit 1 ;;
   esac
 
@@ -100,8 +106,11 @@ function fastlane_test() {
     "tv" )
       FASTLANE_DEVICE="$(echo $TV_MODEL | tr -d "'") ($TV_VERSION)"
       ;;
+    "watch" )
+      FASTLANE_DEVICE="$(echo $WATCH_MODEL | tr -d "'") ($WATCH_VERSION)"
+      ;;
     * )
-      echo "Error: Unknown DEST value '${DEST:-}'. DEST must be one of: iphone, ipad, tv"
+      echo "Error: Unknown DEST value '${DEST:-}'. DEST must be one of: iphone, ipad, tv, watch"
       exit 1
       ;;
   esac
@@ -120,5 +129,9 @@ case "$ACTION" in
   "int_test_1" ) fastlane_test IntegrationTests_1 ;;
   "int_test_2" ) fastlane_test IntegrationTests_2 ;;
   "int_test_3" ) fastlane_test IntegrationTests_3 ;;
+  "tv_int_test" ) fastlane_test IntegrationTests_tvOS ;;
+  # Like the iOS/tvOS integration tests, this launches the app under test in-process via
+  # XCUIApplication rather than driving a separately running WDA server over HTTP.
+  "watch_int_test" ) fastlane_test IntegrationTests_watchOS ;;
   *) xcbuild ;;
 esac

package/drivers/ios/WebDriverAgent/Scripts/embed-runner-icon.sh

@@ -0,0 +1,118 @@
+#!/bin/bash
+# Embed the WDA app icon into the wrapping XCTRunner host app so the
+# installed WebDriverAgent shows the Appium logo on the iOS home screen
+# instead of a blank icon.
+#
+# Apple's USES_XCTRUNNER auto-generates a Runner.app around UI-testing
+# .xctest bundles but does not inherit icons from the test bundle's
+# asset catalog. actool produces AppIcon*.png + Assets.car inside
+# PlugIns/<product>.xctest/ where iOS never looks. This script lifts
+# them up to the Runner.app root and patches Info.plist accordingly.
+#
+# Limitations:
+#   - Touches XCTRunner internals; may need updates across Xcode versions.
+#   - iOS only; tvOS uses different "Brand Assets" and is not handled.
+#   - Cloud device farms that re-sign WDA must preserve these changes.
+
+set -euo pipefail
+
+RUNNER_APP="${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}-Runner.app"
+XCTEST="${RUNNER_APP}/PlugIns/${PRODUCT_NAME}.xctest"
+
+if [ ! -d "$RUNNER_APP" ]; then
+    echo "warning: ${PRODUCT_NAME}-Runner.app not found at $RUNNER_APP; skipping icon embed"
+    exit 0
+fi
+
+if [ ! -d "$XCTEST" ]; then
+    echo "warning: ${PRODUCT_NAME}.xctest not found inside Runner.app; skipping icon embed"
+    exit 0
+fi
+
+shopt -s nullglob
+ICONS=("$XCTEST"/AppIcon*.png)
+if [ ${#ICONS[@]} -eq 0 ]; then
+    echo "warning: no compiled AppIcon*.png found inside $XCTEST; skipping icon embed"
+    exit 0
+fi
+
+PLIST="$RUNNER_APP/Info.plist"
+
+# Everything below mutates a bundle Xcode already signed, so keep enough state
+# to undo it: a failed re-sign must not leave an uninstallable runner behind.
+PLIST_BACKUP=$(mktemp)
+CERT_DIR=$(mktemp -d)
+trap 'rm -rf "$PLIST_BACKUP" "$CERT_DIR"' EXIT
+cp "$PLIST" "$PLIST_BACKUP"
+ADDED_FILES=()
+
+restore_bundle() {
+    cp -f "$PLIST_BACKUP" "$PLIST"
+    if [ ${#ADDED_FILES[@]} -gt 0 ]; then
+        rm -f "${ADDED_FILES[@]}"
+    fi
+}
+
+for icon in "${ICONS[@]}"; do
+    dest="$RUNNER_APP/$(basename "$icon")"
+    [ -e "$dest" ] || ADDED_FILES+=("$dest")
+    cp -f "$icon" "$dest"
+done
+if [ -f "$XCTEST/Assets.car" ]; then
+    [ -e "$RUNNER_APP/Assets.car" ] || ADDED_FILES+=("$RUNNER_APP/Assets.car")
+    cp -f "$XCTEST/Assets.car" "$RUNNER_APP/"
+fi
+/usr/libexec/PlistBuddy -c "Delete :CFBundleIcons" "$PLIST" 2>/dev/null || true
+/usr/libexec/PlistBuddy -c "Delete :CFBundleIcons~ipad" "$PLIST" 2>/dev/null || true
+
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons dict" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons:CFBundlePrimaryIcon dict" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons:CFBundlePrimaryIcon:CFBundleIconName string AppIcon" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons:CFBundlePrimaryIcon:CFBundleIconFiles array" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons:CFBundlePrimaryIcon:CFBundleIconFiles:0 string AppIcon60x60" "$PLIST"
+
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad dict" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad:CFBundlePrimaryIcon dict" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad:CFBundlePrimaryIcon:CFBundleIconName string AppIcon" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad:CFBundlePrimaryIcon:CFBundleIconFiles array" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad:CFBundlePrimaryIcon:CFBundleIconFiles:0 string AppIcon60x60" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad:CFBundlePrimaryIcon:CFBundleIconFiles:1 string AppIcon76x76" "$PLIST"
+
+# Re-codesign since we modified the bundle after Xcode signed it. Scheme
+# post-actions never receive EXPANDED_CODE_SIGN_IDENTITY, so the signer has to
+# be recovered from the already-signed bundle.
+if [ -d "$RUNNER_APP/_CodeSignature" ]; then
+    # Capture the signature info once. Piping codesign straight into
+    # `awk ... exit` makes awk close the pipe early, killing codesign with
+    # SIGPIPE -- which `set -o pipefail` turns into a fatal error. That trips
+    # only when an Authority line exists, i.e. on every real-device build.
+    SIGN_INFO=$(codesign -dvv "$RUNNER_APP" 2>&1 || true)
+
+    if grep -q '^Signature=adhoc' <<< "$SIGN_INFO"; then
+        # Simulator builds are ad-hoc signed; re-sign them ad-hoc.
+        EXISTING_IDENT="-"
+    else
+        # Identify the signer by leaf-certificate SHA-1, never by Authority
+        # display name: duplicate identities can share a name, and codesign
+        # then rejects the name as ambiguous (Apple TN3161).
+        EXISTING_IDENT=""
+        if codesign -d --extract-certificates="$CERT_DIR/leaf" "$RUNNER_APP" 2>/dev/null \
+                && [ -f "$CERT_DIR/leaf0" ]; then
+            EXISTING_IDENT=$(shasum -a 1 "$CERT_DIR/leaf0" | awk '{print toupper($1)}')
+        fi
+        if [ -z "$EXISTING_IDENT" ]; then
+            EXISTING_IDENT=$(awk -F'=' '/^Authority/ {print $2; exit}' <<< "$SIGN_INFO")
+        fi
+    fi
+
+    if [ -z "$EXISTING_IDENT" ] || ! codesign --force --sign "$EXISTING_IDENT" \
+            --preserve-metadata=identifier,entitlements "$RUNNER_APP"; then
+        # A modified-but-stale-signed bundle fails to install, which would break
+        # the session over a cosmetic icon. Undo instead.
+        restore_bundle
+        echo "warning: could not re-sign $RUNNER_APP; skipped icon embed"
+        exit 0
+    fi
+fi
+
+echo "embedded icon into $RUNNER_APP"