appium-mac2-driver 1.8.8 → 1.9.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [1.9.0](https://github.com/appium/appium-mac2-driver/compare/v1.8.9...v1.9.0) (2024-01-08)
+
+
+### Features
+
+* Add doctor checks ([#266](https://github.com/appium/appium-mac2-driver/issues/266)) ([001597a](https://github.com/appium/appium-mac2-driver/commit/001597a39ad5a1b9a51d7dec5f161d0c6f8b9460))
+
+## [1.8.9](https://github.com/appium/appium-mac2-driver/compare/v1.8.8...v1.8.9) (2023-12-02)
+
+
+### Miscellaneous Chores
+
+* update publish.js.yml ([#259](https://github.com/appium/appium-mac2-driver/issues/259)) ([c9d5daa](https://github.com/appium/appium-mac2-driver/commit/c9d5daab3579c1f61e3f63dccccfd484b8989bd8))
+
 ## [1.8.8](https://github.com/appium/appium-mac2-driver/compare/v1.8.7...v1.8.8) (2023-11-08)
 
 

package/README.md

@@ -25,7 +25,13 @@ On top of standard Appium requirements Mac2 driver also expects the following pr
 - Xcode 13 or later should be installed
     - `xcode-select` should be pointing to `<full_path_to_xcode_app>/Contents/Developer` developer directory instead of `/Library/Developer/CommandLineTools` to run `xcodebuild` commands
 - Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder: `open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/` and drag & drop the `Xcode Helper` app to `Security & Privacy -> Privacy -> Accessibility` list of your `System Preferences`. This action must only be done once.
-- `testmanagerd` proccess requires UIAutomation authentication since macOS 12. `automationmodetool enable-automationmode-without-authentication` command may help to disable it. This may be particularly useful in CI environments. [Apple forum thread](https://developer.apple.com/forums/thread/693850).
+- `testmanagerd` process requires UIAutomation authentication since macOS 12. `automationmodetool enable-automationmode-without-authentication` command may help to disable it. This may be particularly useful in CI environments. [Apple forum thread](https://developer.apple.com/forums/thread/693850).
+
+### Doctor
+
+Since driver version 1.9.0 you can automate the validation for the most of the above
+requirements as well as various optional ones needed by driver extensions by running the
+`appium driver doctor mac2` server command.
 
 
 ## Capabilities

package/build/lib/doctor/optional-checks.d.ts

@@ -0,0 +1,19 @@
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+export class OptionalFfmpegCheck {
+    FFMPEG_BINARY: string;
+    FFMPEG_INSTALL_LINK: string;
+    diagnose(): Promise<import("@appium/types").DoctorCheckResult>;
+    fix(): Promise<string>;
+    hasAutofix(): boolean;
+    isOptional(): boolean;
+}
+export const optionalFfmpegCheck: OptionalFfmpegCheck;
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+export class OptionalAutomationModeCheck {
+    diagnose(): Promise<import("@appium/types").DoctorCheckResult>;
+    fix(): Promise<string>;
+    hasAutofix(): boolean;
+    isOptional(): boolean;
+}
+export const optionalAutomationModeCheck: OptionalAutomationModeCheck;
+//# sourceMappingURL=optional-checks.d.ts.map

package/build/lib/doctor/optional-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-checks.d.ts","sourceRoot":"","sources":["../../../lib/doctor/optional-checks.js"],"names":[],"mappings":"AAMA,wDAAwD;AACxD;IACE,sBAAyB;IACzB,4BAA6D;IAE7D,+DAMC;IAED,uBAKC;IAED,sBAEC;IAED,sBAEC;CACF;AACD,sDAA6D;AAG7D,wDAAwD;AACxD;IACE,+DAWC;IAED,uBAEC;IAED,sBAEC;IAED,sBAEC;CACF;AACD,sEAA6E"}

package/build/lib/doctor/optional-checks.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.optionalAutomationModeCheck = exports.OptionalAutomationModeCheck = exports.optionalFfmpegCheck = exports.OptionalFfmpegCheck = void 0;
+/* eslint-disable require-await */
+const utils_1 = require("./utils");
+const support_1 = require("appium/support");
+const teen_process_1 = require("teen_process");
+require("@colors/colors");
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+class OptionalFfmpegCheck {
+    constructor() {
+        this.FFMPEG_BINARY = 'ffmpeg';
+        this.FFMPEG_INSTALL_LINK = 'https://www.ffmpeg.org/download.html';
+    }
+    async diagnose() {
+        const ffmpegPath = await (0, utils_1.resolveExecutablePath)(this.FFMPEG_BINARY);
+        return ffmpegPath
+            ? support_1.doctor.okOptional(`${this.FFMPEG_BINARY} exists at '${ffmpegPath}'`)
+            : support_1.doctor.nokOptional(`${this.FFMPEG_BINARY} cannot be found`);
+    }
+    async fix() {
+        return (`${`${this.FFMPEG_BINARY}`.bold} is used to capture screen recordings. ` +
+            `Please read ${this.FFMPEG_INSTALL_LINK}.`);
+    }
+    hasAutofix() {
+        return false;
+    }
+    isOptional() {
+        return true;
+    }
+}
+exports.OptionalFfmpegCheck = OptionalFfmpegCheck;
+exports.optionalFfmpegCheck = new OptionalFfmpegCheck();
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+class OptionalAutomationModeCheck {
+    async diagnose() {
+        let stdout;
+        try {
+            ({ stdout } = await (0, teen_process_1.exec)('automationmodetool'));
+        }
+        catch (err) {
+            return support_1.doctor.nokOptional(`Cannot run 'automationmodetool': ${err.stderr || err.message}`);
+        }
+        if (stdout.includes('disabled')) {
+            return support_1.doctor.nokOptional(`Automation Mode is disabled`);
+        }
+        return support_1.doctor.okOptional(`Automation Mode is enabled`);
+    }
+    async fix() {
+        return `Run \`automationmodetool enable-automationmode-without-authentication\` to enable Automation Mode`;
+    }
+    hasAutofix() {
+        return false;
+    }
+    isOptional() {
+        return true;
+    }
+}
+exports.OptionalAutomationModeCheck = OptionalAutomationModeCheck;
+exports.optionalAutomationModeCheck = new OptionalAutomationModeCheck();
+//# sourceMappingURL=optional-checks.js.map

package/build/lib/doctor/optional-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-checks.js","sourceRoot":"","sources":["../../../lib/doctor/optional-checks.js"],"names":[],"mappings":";;;AAAA,kCAAkC;AAClC,mCAA8C;AAC9C,4CAAsC;AACtC,+CAAkC;AAClC,0BAAwB;AAExB,wDAAwD;AACxD,MAAa,mBAAmB;IAAhC;QACE,kBAAa,GAAG,QAAQ,CAAC;QACzB,wBAAmB,GAAG,sCAAsC,CAAC;IAwB/D,CAAC;IAtBC,KAAK,CAAC,QAAQ;QACZ,MAAM,UAAU,GAAG,MAAM,IAAA,6BAAqB,EAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEnE,OAAO,UAAU;YACf,CAAC,CAAC,gBAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,aAAa,eAAe,UAAU,GAAG,CAAC;YACtE,CAAC,CAAC,gBAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,aAAa,kBAAkB,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,CACL,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,yCAAyC;YACxE,eAAe,IAAI,CAAC,mBAAmB,GAAG,CAC3C,CAAC;IACJ,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA1BD,kDA0BC;AACY,QAAA,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAG7D,wDAAwD;AACxD,MAAa,2BAA2B;IACtC,KAAK,CAAC,QAAQ;QACZ,IAAI,MAAM,CAAC;QACX,IAAI;YACF,CAAC,EAAC,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,oBAAoB,CAAC,CAAC,CAAC;SAC/C;QAAC,OAAO,GAAG,EAAE;YACZ,OAAO,gBAAM,CAAC,WAAW,CAAC,oCAAoC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;SAC5F;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE;YAC/B,OAAO,gBAAM,CAAC,WAAW,CAAC,6BAA6B,CAAC,CAAC;SAC1D;QACD,OAAO,gBAAM,CAAC,UAAU,CAAC,4BAA4B,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,mGAAmG,CAAC;IAC7G,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAzBD,kEAyBC;AACY,QAAA,2BAA2B,GAAG,IAAI,2BAA2B,EAAE,CAAC"}

package/build/lib/doctor/required-checks.d.ts

@@ -0,0 +1,19 @@
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+export class XcodeCheck {
+    diagnose(): Promise<import("@appium/types").DoctorCheckResult>;
+    fix(): Promise<string>;
+    hasAutofix(): boolean;
+    isOptional(): boolean;
+}
+export const xcodeCheck: XcodeCheck;
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+export class XcodebuildCheck {
+    XCODE_VER_PATTERN: RegExp;
+    MIN_XCODE_VERSION: number;
+    diagnose(): Promise<import("@appium/types").DoctorCheckResult>;
+    fix(): Promise<string>;
+    hasAutofix(): boolean;
+    isOptional(): boolean;
+}
+export const xcodebuildCheck: XcodebuildCheck;
+//# sourceMappingURL=required-checks.d.ts.map

package/build/lib/doctor/required-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-checks.d.ts","sourceRoot":"","sources":["../../../lib/doctor/required-checks.js"],"names":[],"mappings":"AAOA,wDAAwD;AACxD;IACE,+DAOC;IAED,uBAEC;IAED,sBAEC;IAED,sBAEC;CACF;AACD,oCAA2C;AAG3C,wDAAwD;AACxD;IACE,0BAA0C;IAC1C,0BAAuB;IAEvB,+DAoBC;IAED,uBAEC;IAED,sBAEC;IAED,sBAEC;CACF;AACD,8CAAqD"}

package/build/lib/doctor/required-checks.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.xcodebuildCheck = exports.XcodebuildCheck = exports.xcodeCheck = exports.XcodeCheck = void 0;
+/* eslint-disable require-await */
+const support_1 = require("appium/support");
+const teen_process_1 = require("teen_process");
+const appium_xcode_1 = require("appium-xcode");
+require("@colors/colors");
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+class XcodeCheck {
+    async diagnose() {
+        try {
+            const xcodePath = await (0, appium_xcode_1.getPath)();
+            return support_1.doctor.ok(`xCode is installed at '${xcodePath}'`);
+        }
+        catch (err) {
+            return support_1.doctor.nok(err.message);
+        }
+    }
+    async fix() {
+        return `Manually install ${'Xcode'.bold} and configure the active developer directory path using the xcode-select tool`;
+    }
+    hasAutofix() {
+        return false;
+    }
+    isOptional() {
+        return false;
+    }
+}
+exports.XcodeCheck = XcodeCheck;
+exports.xcodeCheck = new XcodeCheck();
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+class XcodebuildCheck {
+    constructor() {
+        this.XCODE_VER_PATTERN = /^Xcode\s+([\d.]+)$/m;
+        this.MIN_XCODE_VERSION = 13;
+    }
+    async diagnose() {
+        let xcodeVerMatch;
+        let stdout;
+        let stderr;
+        try {
+            ({ stdout, stderr } = await (0, teen_process_1.exec)('xcodebuild', ['-version']));
+            xcodeVerMatch = this.XCODE_VER_PATTERN.exec(stdout);
+        }
+        catch (err) {
+            return support_1.doctor.nok(`Cannot run 'xcodebuild': ${err.stderr || err.message}`);
+        }
+        if (!xcodeVerMatch) {
+            return support_1.doctor.nok(`Cannot determine Xcode version. stdout: ${stdout}; stderr: ${stderr}`);
+        }
+        const xcodeMajorVer = parseInt(xcodeVerMatch[1], 10);
+        if (xcodeMajorVer < this.MIN_XCODE_VERSION) {
+            return support_1.doctor.nok(`The actual Xcode version (${xcodeVerMatch[0]}) is older than the expected ` +
+                `one (${this.MIN_XCODE_VERSION})`);
+        }
+        return support_1.doctor.ok(`xcodebuild is installed and has a matching version number ` +
+            `(${xcodeVerMatch[1]} >= ${this.MIN_XCODE_VERSION})`);
+    }
+    async fix() {
+        return `Install ${'Xcode'.bold} ${this.MIN_XCODE_VERSION}+ or upgrade the existing setup`;
+    }
+    hasAutofix() {
+        return false;
+    }
+    isOptional() {
+        return false;
+    }
+}
+exports.XcodebuildCheck = XcodebuildCheck;
+exports.xcodebuildCheck = new XcodebuildCheck();
+//# sourceMappingURL=required-checks.js.map

package/build/lib/doctor/required-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-checks.js","sourceRoot":"","sources":["../../../lib/doctor/required-checks.js"],"names":[],"mappings":";;;AAAA,kCAAkC;AAClC,4CAAsC;AACtC,+CAAkC;AAClC,+CAAuD;AACvD,0BAAwB;AAGxB,wDAAwD;AACxD,MAAa,UAAU;IACrB,KAAK,CAAC,QAAQ;QACZ,IAAI;YACF,MAAM,SAAS,GAAG,MAAM,IAAA,sBAAY,GAAE,CAAC;YACvC,OAAO,gBAAM,CAAC,EAAE,CAAC,0BAA0B,SAAS,GAAG,CAAC,CAAC;SAC1D;QAAC,OAAO,GAAG,EAAE;YACZ,OAAO,gBAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;SAChC;IACH,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,oBAAoB,OAAO,CAAC,IAAI,gFAAgF,CAAC;IAC1H,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AArBD,gCAqBC;AACY,QAAA,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;AAG3C,wDAAwD;AACxD,MAAa,eAAe;IAA5B;QACE,sBAAiB,GAAG,qBAAqB,CAAC;QAC1C,sBAAiB,GAAG,EAAE,CAAC;IAmCzB,CAAC;IAjCC,KAAK,CAAC,QAAQ;QACZ,IAAI,aAAa,CAAC;QAClB,IAAI,MAAM,CAAC;QACX,IAAI,MAAM,CAAC;QACX,IAAI;YACF,CAAC,EAAC,MAAM,EAAE,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC5D,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SACrD;QAAC,OAAO,GAAG,EAAE;YACZ,OAAO,gBAAM,CAAC,GAAG,CAAC,4BAA4B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;SAC5E;QACD,IAAI,CAAC,aAAa,EAAE;YAClB,OAAO,gBAAM,CAAC,GAAG,CAAC,2CAA2C,MAAM,aAAa,MAAM,EAAE,CAAC,CAAC;SAC3F;QACD,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,aAAa,GAAG,IAAI,CAAC,iBAAiB,EAAE;YAC1C,OAAO,gBAAM,CAAC,GAAG,CAAC,6BAA6B,aAAa,CAAC,CAAC,CAAC,+BAA+B;gBAC5F,QAAQ,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;SACtC;QACD,OAAO,gBAAM,CAAC,EAAE,CAAC,4DAA4D;YAC3E,IAAI,aAAa,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,WAAW,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,iBAAiB,iCAAiC,CAAC;IAC5F,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AArCD,0CAqCC;AACY,QAAA,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/build/lib/doctor/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Return an executable path of cmd
+ *
+ * @param {string} cmd Standard output by command
+ * @return {Promise<string?>} The full path of cmd. `null` if the cmd is not found.
+ */
+export function resolveExecutablePath(cmd: string): Promise<string | null>;
+//# sourceMappingURL=utils.d.ts.map

package/build/lib/doctor/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../lib/doctor/utils.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,2CAHW,MAAM,GACL,QAAQ,MAAM,QAAE,CAU3B"}

package/build/lib/doctor/utils.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveExecutablePath = void 0;
+const support_1 = require("appium/support");
+/**
+ * Return an executable path of cmd
+ *
+ * @param {string} cmd Standard output by command
+ * @return {Promise<string?>} The full path of cmd. `null` if the cmd is not found.
+ */
+async function resolveExecutablePath(cmd) {
+    try {
+        const executablePath = await support_1.fs.which(cmd);
+        if (executablePath && (await support_1.fs.exists(executablePath))) {
+            return executablePath;
+        }
+    }
+    catch (err) { }
+    return null;
+}
+exports.resolveExecutablePath = resolveExecutablePath;
+//# sourceMappingURL=utils.js.map

package/build/lib/doctor/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../lib/doctor/utils.js"],"names":[],"mappings":";;;AAAA,4CAAkC;AAElC;;;;;GAKG;AACI,KAAK,UAAU,qBAAqB,CAAC,GAAG;IAC7C,IAAI;QACF,MAAM,cAAc,GAAG,MAAM,YAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,cAAc,IAAI,CAAC,MAAM,YAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE;YACvD,OAAO,cAAc,CAAC;SACvB;KACF;IAAC,OAAO,GAAG,EAAE,GAAE;IAChB,OAAO,IAAI,CAAC;AACd,CAAC;AARD,sDAQC"}

package/lib/doctor/optional-checks.js

@@ -0,0 +1,65 @@
+/* eslint-disable require-await */
+import {resolveExecutablePath} from './utils';
+import {doctor} from 'appium/support';
+import {exec} from 'teen_process';
+import '@colors/colors';
+
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+export class OptionalFfmpegCheck {
+  FFMPEG_BINARY = 'ffmpeg';
+  FFMPEG_INSTALL_LINK = 'https://www.ffmpeg.org/download.html';
+
+  async diagnose() {
+    const ffmpegPath = await resolveExecutablePath(this.FFMPEG_BINARY);
+
+    return ffmpegPath
+      ? doctor.okOptional(`${this.FFMPEG_BINARY} exists at '${ffmpegPath}'`)
+      : doctor.nokOptional(`${this.FFMPEG_BINARY} cannot be found`);
+  }
+
+  async fix() {
+    return (
+      `${`${this.FFMPEG_BINARY}`.bold} is used to capture screen recordings. ` +
+      `Please read ${this.FFMPEG_INSTALL_LINK}.`
+    );
+  }
+
+  hasAutofix() {
+    return false;
+  }
+
+  isOptional() {
+    return true;
+  }
+}
+export const optionalFfmpegCheck = new OptionalFfmpegCheck();
+
+
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+export class OptionalAutomationModeCheck {
+  async diagnose() {
+    let stdout;
+    try {
+      ({stdout} = await exec('automationmodetool'));
+    } catch (err) {
+      return doctor.nokOptional(`Cannot run 'automationmodetool': ${err.stderr || err.message}`);
+    }
+    if (stdout.includes('disabled')) {
+      return doctor.nokOptional(`Automation Mode is disabled`);
+    }
+    return doctor.okOptional(`Automation Mode is enabled`);
+  }
+
+  async fix() {
+    return `Run \`automationmodetool enable-automationmode-without-authentication\` to enable Automation Mode`;
+  }
+
+  hasAutofix() {
+    return false;
+  }
+
+  isOptional() {
+    return true;
+  }
+}
+export const optionalAutomationModeCheck = new OptionalAutomationModeCheck();

package/lib/doctor/required-checks.js

@@ -0,0 +1,73 @@
+/* eslint-disable require-await */
+import {doctor} from 'appium/support';
+import {exec} from 'teen_process';
+import { getPath as getXcodePath } from 'appium-xcode';
+import '@colors/colors';
+
+
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+export class XcodeCheck {
+  async diagnose() {
+    try {
+      const xcodePath = await getXcodePath();
+      return doctor.ok(`xCode is installed at '${xcodePath}'`);
+    } catch (err) {
+      return doctor.nok(err.message);
+    }
+  }
+
+  async fix() {
+    return `Manually install ${'Xcode'.bold} and configure the active developer directory path using the xcode-select tool`;
+  }
+
+  hasAutofix() {
+    return false;
+  }
+
+  isOptional() {
+    return false;
+  }
+}
+export const xcodeCheck = new XcodeCheck();
+
+
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+export class XcodebuildCheck {
+  XCODE_VER_PATTERN = /^Xcode\s+([\d.]+)$/m;
+  MIN_XCODE_VERSION = 13;
+
+  async diagnose() {
+    let xcodeVerMatch;
+    let stdout;
+    let stderr;
+    try {
+      ({stdout, stderr} = await exec('xcodebuild', ['-version']));
+      xcodeVerMatch = this.XCODE_VER_PATTERN.exec(stdout);
+    } catch (err) {
+      return doctor.nok(`Cannot run 'xcodebuild': ${err.stderr || err.message}`);
+    }
+    if (!xcodeVerMatch) {
+      return doctor.nok(`Cannot determine Xcode version. stdout: ${stdout}; stderr: ${stderr}`);
+    }
+    const xcodeMajorVer = parseInt(xcodeVerMatch[1], 10);
+    if (xcodeMajorVer < this.MIN_XCODE_VERSION) {
+      return doctor.nok(`The actual Xcode version (${xcodeVerMatch[0]}) is older than the expected ` +
+        `one (${this.MIN_XCODE_VERSION})`);
+    }
+    return doctor.ok(`xcodebuild is installed and has a matching version number ` +
+      `(${xcodeVerMatch[1]} >= ${this.MIN_XCODE_VERSION})`);
+  }
+
+  async fix() {
+    return `Install ${'Xcode'.bold} ${this.MIN_XCODE_VERSION}+ or upgrade the existing setup`;
+  }
+
+  hasAutofix() {
+    return false;
+  }
+
+  isOptional() {
+    return false;
+  }
+}
+export const xcodebuildCheck = new XcodebuildCheck();

package/lib/doctor/utils.js

@@ -0,0 +1,17 @@
+import {fs} from 'appium/support';
+
+/**
+ * Return an executable path of cmd
+ *
+ * @param {string} cmd Standard output by command
+ * @return {Promise<string?>} The full path of cmd. `null` if the cmd is not found.
+ */
+export async function resolveExecutablePath(cmd) {
+  try {
+    const executablePath = await fs.which(cmd);
+    if (executablePath && (await fs.exists(executablePath))) {
+      return executablePath;
+    }
+  } catch (err) {}
+  return null;
+}