appium-android-driver 14.0.2 → 14.0.3

package/lib/commands/context/exports.ts

@@ -1,7 +1,13 @@
 import {util} from '@appium/support';
+import type {StringRecord} from '@appium/types';
 import {Chromedriver} from 'appium-chromedriver';
 import {errors, PROTOCOLS} from 'appium/driver.js';
-import type {StringRecord} from '@appium/types';
+
+import type {AndroidDriver} from '../../driver.js';
+import {APP_STATE} from '../app-management.js';
+import {BIDI_EVENT_NAME} from '../bidi/constants.js';
+import {makeContextUpdatedEvent, makeObsoleteContextUpdatedEvent} from '../bidi/models.js';
+import type {WebviewsMapping} from '../types.js';
 import {
   CHROMIUM_WIN,
   KNOWN_CHROME_PACKAGE_NAMES,
@@ -15,11 +21,6 @@ import {
   setupNewChromedriver,
   shouldDismissChromeWelcome,
 } from './helpers.js';
-import {APP_STATE} from '../app-management.js';
-import {BIDI_EVENT_NAME} from '../bidi/constants.js';
-import {makeContextUpdatedEvent, makeObsoleteContextUpdatedEvent} from '../bidi/models.js';
-import type {AndroidDriver} from '../../driver.js';
-import type {WebviewsMapping} from '../types.js';
 
 // https://github.com/appium/appium/issues/20710
 const DEFAULT_NATIVE_WINDOW_HANDLE = '1';
@@ -83,10 +84,7 @@ export async function setContext(this: AndroidDriver, name?: string | null): Pro
  * @param waitForWebviewMs - Optional timeout in milliseconds to wait for webviews to appear
  * @returns An array of webview mapping objects containing detailed information about each webview
  */
-export async function mobileGetContexts(
-  this: AndroidDriver,
-  waitForWebviewMs?: number,
-): Promise<WebviewsMapping[]> {
+export async function mobileGetContexts(this: AndroidDriver, waitForWebviewMs?: number): Promise<WebviewsMapping[]> {
   const _opts = {
     androidDeviceSocket: this.opts.androidDeviceSocket,
     ensureWebviewsHavePages: true,
@@ -256,10 +254,7 @@ export async function startChromedriverProxy(
         opts.chromeAndroidPackage = androidPackage[1];
       }
       if (!opts.extractChromeAndroidPackageFromContextName) {
-        if (
-          this.opts.enableWebviewDetailsCollection !== undefined &&
-          !this.opts.enableWebviewDetailsCollection
-        ) {
+        if (this.opts.enableWebviewDetailsCollection !== undefined && !this.opts.enableWebviewDetailsCollection) {
           // When enableWebviewDetailsCollection capability is explicitly disabled, try to identify
           // chromeAndroidPackage based on contexts, known chrome variant packages and queryAppState result
           // since webviewsMapping does not have info object
@@ -269,11 +264,7 @@ export async function startChromedriverProxy(
               continue;
             }
             const appState = await this.queryAppState(knownPackage);
-            if (
-              [APP_STATE.RUNNING_IN_BACKGROUND, APP_STATE.RUNNING_IN_FOREGROUND].includes(
-                appState as any,
-              )
-            ) {
+            if ([APP_STATE.RUNNING_IN_BACKGROUND, APP_STATE.RUNNING_IN_FOREGROUND].includes(appState as any)) {
               opts.chromeAndroidPackage = knownPackage;
               this.log.debug(
                 `Identified chromeAndroidPackage as '${opts.chromeAndroidPackage}' ` +
@@ -286,9 +277,7 @@ export async function startChromedriverProxy(
           for (const wm of webviewsMapping) {
             if (wm.webviewName === context && wm?.info?.['Android-Package'] !== undefined) {
               // XXX: should be a type guard here
-              opts.chromeAndroidPackage = (wm.info as NonNullable<WebviewsMapping['info']>)[
-                'Android-Package'
-              ];
+              opts.chromeAndroidPackage = (wm.info as NonNullable<WebviewsMapping['info']>)['Android-Package'];
               this.log.debug(
                 `Identified chromeAndroidPackage as '${opts.chromeAndroidPackage}' ` +
                   `for context '${context}' by CDP`,
@@ -308,9 +297,7 @@ export async function startChromedriverProxy(
         try {
           await this.onChromedriverStop(context);
         } catch (err) {
-          this.log.warn(
-            `Error handling chromedriver stop event for context ${context}: ${(err as Error).message}`,
-          );
+          this.log.warn(`Error handling chromedriver stop event for context ${context}: ${(err as Error).message}`);
         }
       }
     });
@@ -320,9 +307,7 @@ export async function startChromedriverProxy(
   // hook up the local variables so we can proxy this biz
   this.chromedriver = cd;
   this.proxyReqRes = this.chromedriver.proxyReq.bind(this.chromedriver);
-  this.proxyCommand = this.chromedriver.jwproxy.command.bind(
-    this.chromedriver.jwproxy,
-  ) as typeof this.proxyCommand;
+  this.proxyCommand = this.chromedriver.jwproxy.command.bind(this.chromedriver.jwproxy) as typeof this.proxyCommand;
   this.jwpProxyActive = true;
 }
 
@@ -353,9 +338,7 @@ export async function onChromedriverStop(this: AndroidDriver, context: string):
   } else {
     // if a Chromedriver in the non-active context barfs, we don't really
     // care, we'll just make a new one next time we need the context.
-    this.log.warn(
-      "Chromedriver quit unexpectedly, but it wasn't the active " + 'context, ignoring',
-    );
+    this.log.warn("Chromedriver quit unexpectedly, but it wasn't the active context, ignoring");
     delete this.sessionChromedrivers[context];
   }
 }
@@ -411,9 +394,7 @@ export async function notifyBiDiContextChange(this: AndroidDriver): Promise<void
  */
 export async function mobileGetChromeCapabilities(this: AndroidDriver): Promise<StringRecord> {
   if (!this.isWebContext()) {
-    throw new errors.InvalidContextError(
-      'mobile: getChromeCapabilities can only be called in a webview context',
-    );
+    throw new errors.InvalidContextError('mobile: getChromeCapabilities can only be called in a webview context');
   }
 
   const currentContext = await this.getCurrentContext();
@@ -455,9 +436,7 @@ export async function startChromeSession(this: AndroidDriver): Promise<void> {
       try {
         await this.onChromedriverStop(CHROMIUM_WIN);
       } catch (err) {
-        this.log.warn(
-          `Error handling chromedriver stop event for context ${CHROMIUM_WIN}: ${(err as Error).message}`,
-        );
+        this.log.warn(`Error handling chromedriver stop event for context ${CHROMIUM_WIN}: ${(err as Error).message}`);
       }
     }
   });
@@ -468,9 +447,7 @@ export async function startChromeSession(this: AndroidDriver): Promise<void> {
   this.curContext = CHROMIUM_WIN;
   this.sessionChromedrivers[CHROMIUM_WIN] = chromedriver;
   this.proxyReqRes = chromedriver.proxyReq.bind(chromedriver);
-  this.proxyCommand = chromedriver.jwproxy.command.bind(
-    chromedriver.jwproxy,
-  ) as typeof this.proxyCommand;
+  this.proxyCommand = chromedriver.jwproxy.command.bind(chromedriver.jwproxy) as typeof this.proxyCommand;
   this.jwpProxyActive = true;
 
   if (shouldDismissChromeWelcome.bind(this)()) {

package/lib/commands/context/helpers.ts

@@ -1,15 +1,17 @@
-import {util, timing} from '@appium/support';
-import axios from 'axios';
+import dns from 'node:dns/promises';
+import http from 'node:http';
 import net from 'node:net';
-import {findAPortNotInUse} from 'portscanner';
-import {sleep} from 'asyncbox';
 import os from 'node:os';
 import path from 'node:path';
-import http from 'node:http';
+
+import {util, timing} from '@appium/support';
+import type {StringRecord} from '@appium/types';
 import {Chromedriver} from 'appium-chromedriver';
 import type {ChromedriverOpts} from 'appium-chromedriver';
-import {toDetailsCacheKey, getWebviewDetails, WEBVIEWS_DETAILS_CACHE} from './cache.js';
-import dns from 'node:dns/promises';
+import {sleep} from 'asyncbox';
+import axios from 'axios';
+import {findAPortNotInUse} from 'portscanner';
+
 import type {AndroidDriver, AndroidDriverOpts} from '../../driver.js';
 import type {
   GetWebviewsOpts,
@@ -20,7 +22,7 @@ import type {
   WebviewProc,
   DetailCollectionOptions,
 } from '../types.js';
-import type {StringRecord} from '@appium/types';
+import {toDetailsCacheKey, getWebviewDetails, WEBVIEWS_DETAILS_CACHE} from './cache.js';
 
 // https://cs.chromium.org/chromium/src/chrome/browser/devtools/device/android_device_info_query.cc
 export const CHROME_BROWSER_PACKAGE_ACTIVITY = {
@@ -74,10 +76,10 @@ const WEBVIEW_PKG_PATTERN = new RegExp(`^${WEBVIEW_BASE}([^\\d\\s][\\w.]*)`);
 const WEBVIEW_WAIT_INTERVAL_MS = 200;
 const CDP_REQ_TIMEOUT = 2000; // ms
 const DEVTOOLS_PORTS_RANGE = [10900, 11000] as const;
-const DEVTOOLS_PORT_ALLOCATION_GUARD = util.getLockFileGuard(
-  path.resolve(os.tmpdir(), 'android_devtools_port_guard'),
-  {timeout: 7, tryRecovery: true},
-);
+const DEVTOOLS_PORT_ALLOCATION_GUARD = util.getLockFileGuard(path.resolve(os.tmpdir(), 'android_devtools_port_guard'), {
+  timeout: 7,
+  tryRecovery: true,
+});
 
 // #region Exported Functions
 
@@ -91,9 +93,8 @@ export function getChromePkg(
   browser: string,
 ): (typeof CHROME_BROWSER_PACKAGE_ACTIVITY)[keyof typeof CHROME_BROWSER_PACKAGE_ACTIVITY] {
   return (
-    CHROME_BROWSER_PACKAGE_ACTIVITY[
-      browser.toLowerCase() as keyof typeof CHROME_BROWSER_PACKAGE_ACTIVITY
-    ] || CHROME_BROWSER_PACKAGE_ACTIVITY.default
+    CHROME_BROWSER_PACKAGE_ACTIVITY[browser.toLowerCase() as keyof typeof CHROME_BROWSER_PACKAGE_ACTIVITY] ||
+    CHROME_BROWSER_PACKAGE_ACTIVITY.default
   );
 }
 
@@ -118,19 +119,14 @@ export function parseWebviewNames(
   const result: string[] = [];
   for (const {webview, pages, proc, webviewName} of webviewsMapping) {
     if (ensureWebviewsHavePages && !pages?.length) {
-      this.log.info(
-        `Skipping the webview '${webview}' at '${proc}' ` +
-          `since it has reported having zero pages`,
-      );
+      this.log.info(`Skipping the webview '${webview}' at '${proc}' since it has reported having zero pages`);
       continue;
     }
     if (webviewName) {
       result.push(webviewName);
     }
   }
-  this.log.debug(
-    `Found ${util.pluralize('webview', result.length, true)}: ${JSON.stringify(result)}`,
-  );
+  this.log.debug(`Found ${util.pluralize('webview', result.length, true)}: ${JSON.stringify(result)}`);
   return result;
 }
 
@@ -150,10 +146,7 @@ export function parseWebviewNames(
  * @param opts - Options for webview discovery including device socket, port, and collection settings
  * @returns An array of webview mapping objects
  */
-export async function getWebViewsMapping(
-  this: AndroidDriver,
-  opts: GetWebviewsOpts = {},
-): Promise<WebviewsMapping[]> {
+export async function getWebViewsMapping(this: AndroidDriver, opts: GetWebviewsOpts = {}): Promise<WebviewsMapping[]> {
   const {
     androidDeviceSocket = null,
     ensureWebviewsHavePages = true,
@@ -241,9 +234,7 @@ export async function setupNewChromedriver(
 ): Promise<Chromedriver> {
   // TODO: Remove the legacy
   if ((opts as any).chromeDriverPort) {
-    this.log.warn(
-      `The 'chromeDriverPort' capability is deprecated. Please use 'chromedriverPort' instead`,
-    );
+    this.log.warn(`The 'chromeDriverPort' capability is deprecated. Please use 'chromedriverPort' instead`);
     opts.chromedriverPort = (opts as any).chromeDriverPort;
   }
 
@@ -256,10 +247,7 @@ export async function setupNewChromedriver(
 
   const details = context ? getWebviewDetails(this.adb, context) : undefined;
   if (!util.isEmpty(details)) {
-    this.log.debug(
-      'Passing web view details to the Chromedriver constructor: ' +
-        JSON.stringify(details, null, 2),
-    );
+    this.log.debug('Passing web view details to the Chromedriver constructor: ' + JSON.stringify(details, null, 2));
   }
 
   const chromedriverOpts: ChromedriverOpts & {details?: WebViewDetails} = {
@@ -297,17 +285,13 @@ export async function setupNewChromedriver(
   // Strip the prefix and store it
   for (const opt of Object.keys(opts)) {
     if (opt.endsWith(':loggingPrefs')) {
-      this.log.warn(
-        `Merging '${opt}' into 'chromeLoggingPrefs'. This may cause unexpected behavior`,
-      );
+      this.log.warn(`Merging '${opt}' into 'chromeLoggingPrefs'. This may cause unexpected behavior`);
       merge(opts.chromeLoggingPrefs, (opts as Record<string, any>)[opt]);
     }
   }
 
   const caps = createChromedriverCaps.bind(this)(opts, curDeviceId, details) as any;
-  this.log.debug(
-    `Before starting chromedriver, androidPackage is '${caps.chromeOptions.androidPackage}'`,
-  );
+  this.log.debug(`Before starting chromedriver, androidPackage is '${caps.chromeOptions.androidPackage}'`);
   // Optionally pre-grant all runtime permissions to the resolved Chrome package before Chrome
   // is launched, so the session is not interrupted by a native permission dialog (geolocation,
   // camera, file access, ...). Because the grant is requested explicitly, failures propagate.
@@ -453,9 +437,7 @@ function createChromedriverCaps(
   const caps: any = {chromeOptions: {}};
 
   const androidPackage =
-    opts.chromeOptions?.androidPackage ||
-    opts.appPackage ||
-    webViewDetails?.info?.['Android-Package'];
+    opts.chromeOptions?.androidPackage || opts.appPackage || webViewDetails?.info?.['Android-Package'];
   if (androidPackage) {
     // chromedriver raises an invalid argument error when androidPackage is 'null'
 
@@ -497,9 +479,7 @@ function createChromedriverCaps(
 
   if (util.isPlainObject(opts.loggingPrefs) || util.isPlainObject(opts.chromeLoggingPrefs)) {
     if (opts.loggingPrefs) {
-      this.log.warn(
-        `The 'loggingPrefs' cap is deprecated; use the 'chromeLoggingPrefs' cap instead`,
-      );
+      this.log.warn(`The 'loggingPrefs' cap is deprecated; use the 'chromeLoggingPrefs' cap instead`);
     }
     caps.loggingPrefs = opts.chromeLoggingPrefs || opts.loggingPrefs;
   }
@@ -523,9 +503,7 @@ function createChromedriverCaps(
     caps.webSocketUrl = opts.webSocketUrl;
   }
 
-  this.log.debug(
-    'Precalculated Chromedriver capabilities: ' + JSON.stringify(caps.chromeOptions, null, 2),
-  );
+  this.log.debug('Precalculated Chromedriver capabilities: ' + JSON.stringify(caps.chromeOptions, null, 2));
 
   const protectedCapNames: string[] = [];
   for (const [opt, val] of Object.entries(opts.chromeOptions)) {
@@ -536,10 +514,7 @@ function createChromedriverCaps(
     }
   }
   if (!util.isEmpty(protectedCapNames)) {
-    this.log.info(
-      'The following Chromedriver capabilities cannot be overridden ' +
-        'by the provided chromeOptions:',
-    );
+    this.log.info('The following Chromedriver capabilities cannot be overridden by the provided chromeOptions:');
     for (const optName of protectedCapNames) {
       this.log.info(`  ${optName} (${JSON.stringify(opts.chromeOptions[optName])})`);
     }
@@ -570,14 +545,9 @@ async function allocateDevtoolsChannel(
     endPort = webviewDevtoolsPort + (endPort - startPort);
     startPort = webviewDevtoolsPort;
   }
-  this.log.debug(
-    `Forwarding remote port ${remotePort} to a local ` + `port in range ${startPort}..${endPort}`,
-  );
+  this.log.debug(`Forwarding remote port ${remotePort} to a local port in range ${startPort}..${endPort}`);
   if (!webviewDevtoolsPort) {
-    this.log.debug(
-      `You could use the 'webviewDevtoolsPort' capability to customize ` +
-        `the starting port number`,
-    );
+    this.log.debug(`You could use the 'webviewDevtoolsPort' capability to customize the starting port number`);
   }
   const port = await DEVTOOLS_PORT_ALLOCATION_GUARD(async () => {
     let localPort: number;
@@ -616,11 +586,7 @@ async function collectWebviewsDetails(
     return;
   }
 
-  const {
-    webviewDevtoolsPort = null,
-    ensureWebviewsHavePages = null,
-    enableWebviewDetailsCollection = null,
-  } = opts;
+  const {webviewDevtoolsPort = null, ensureWebviewsHavePages = null, enableWebviewDetailsCollection = null} = opts;
 
   if (!ensureWebviewsHavePages) {
     this.log.info(
@@ -642,9 +608,7 @@ async function collectWebviewsDetails(
   }
 
   // Connect to each devtools socket and retrieve web view details
-  this.log.debug(
-    `Collecting CDP data of ${util.pluralize('webview', webviewsMapping.length, true)}`,
-  );
+  this.log.debug(`Collecting CDP data of ${util.pluralize('webview', webviewsMapping.length, true)}`);
   const detailCollectors: Promise<void>[] = [];
   for (const item of webviewsMapping) {
     detailCollectors.push(
@@ -652,10 +616,7 @@ async function collectWebviewsDetails(
         let port: number | undefined;
         let host: string | undefined;
         try {
-          [host, port] = (await allocateDevtoolsChannel.bind(this)(
-            item.proc,
-            webviewDevtoolsPort,
-          )) as [string, number];
+          [host, port] = (await allocateDevtoolsChannel.bind(this)(item.proc, webviewDevtoolsPort)) as [string, number];
           if (enableWebviewDetailsCollection) {
             item.info = await cdpInfo(host, port);
           }
@@ -664,9 +625,7 @@ async function collectWebviewsDetails(
           }
         } catch (e) {
           const err = e as Error;
-          this.log.info(
-            `CDP data for '${item.webview}' cannot be collected. Original error: ${err.message}`,
-          );
+          this.log.info(`CDP data for '${item.webview}' cannot be collected. Original error: ${err.message}`);
         } finally {
           if (port) {
             try {
@@ -753,10 +712,7 @@ async function getPotentialWebviewProcs(this: AndroidDriver): Promise<string[]>
  * @param deviceSocket - The explicitly-named device socket to use, or null to find all webviews
  * @returns An array of webview process objects with proc and webview properties
  */
-async function webviewsFromProcs(
-  this: AndroidDriver,
-  deviceSocket: string | null = null,
-): Promise<WebviewProc[]> {
+async function webviewsFromProcs(this: AndroidDriver, deviceSocket: string | null = null): Promise<WebviewProc[]> {
   const socketNames = await getPotentialWebviewProcs.bind(this)();
   const webviews: WebviewProc[] = [];
   for (const socketName of socketNames) {
@@ -826,8 +782,7 @@ async function getChromedriverPort(this: AndroidDriver, portSpec?: PortSpec): Pr
 
   if (foundPort === null) {
     throw new Error(
-      `Could not find a free port for chromedriver using ` +
-        `chromedriverPorts spec ${JSON.stringify(portSpec)}`,
+      `Could not find a free port for chromedriver using chromedriverPorts spec ${JSON.stringify(portSpec)}`,
     );
   }
 
@@ -846,11 +801,7 @@ function isChromedriverAutodownloadEnabled(this: AndroidDriver): boolean {
   return false;
 }
 
-function cacheChromedriverCaps(
-  this: AndroidDriver,
-  sessionCaps: Record<string, any>,
-  context?: string,
-): void {
+function cacheChromedriverCaps(this: AndroidDriver, sessionCaps: Record<string, any>, context?: string): void {
   if (!context) {
     return;
   }
@@ -872,9 +823,7 @@ function cacheChromedriverCaps(
  */
 function isCompatibleCdpHost(host: string): boolean {
   return (
-    ['localhost', 'localhost.localdomain'].includes(host) ||
-    host.endsWith('.localhost') ||
-    Boolean(net.isIP(host))
+    ['localhost', 'localhost.localdomain'].includes(host) || host.endsWith('.localhost') || Boolean(net.isIP(host))
   );
 }
 

package/lib/commands/device/common.ts

@@ -1,15 +1,17 @@
-import * as semver from 'semver';
 import path from 'node:path';
-import {setMockLocationApp} from '../geolocation.js';
+
+import type {ADB} from 'appium-adb';
+import {retryInterval} from 'asyncbox';
 import {SETTINGS_HELPER_ID} from 'io.appium.settings';
+import * as semver from 'semver';
+
+import type {AndroidDriver} from '../../driver.js';
+import {GET_SERVER_LOGS_FEATURE, nativeLogEntryToSeleniumEntry} from '../../utils.js';
+import {setMockLocationApp} from '../geolocation.js';
 import {hideKeyboardCompletely, initUnicodeKeyboard} from '../keyboard.js';
-import {createBaseADB, prepareEmulator, pushSettingsApp} from './utils.js';
 import {adjustTimeZone} from '../time.js';
-import {retryInterval} from 'asyncbox';
-import {GET_SERVER_LOGS_FEATURE, nativeLogEntryToSeleniumEntry} from '../../utils.js';
-import type {AndroidDriver} from '../../driver.js';
 import type {ADBDeviceInfo, ADBLaunchInfo} from '../types.js';
-import type {ADB} from 'appium-adb';
+import {createBaseADB, prepareEmulator, pushSettingsApp} from './utils.js';
 
 /**
  * Gets device information from capabilities, including UDID and emulator port.
@@ -38,9 +40,7 @@ export async function getDeviceInfoFromCaps(this: AndroidDriver): Promise<ADBDev
     // udid was given, lets try to init with that device
     if (udid) {
       if (!devices?.some((device) => device.udid === udid)) {
-        throw this.log.errorWithException(
-          `Device ${udid} was not in the list of connected devices`,
-        );
+        throw this.log.errorWithException(`Device ${udid} was not in the list of connected devices`);
       }
       emPort = adb.getPortFromEmulatorString(udid);
     } else if (this.opts.platformVersion) {
@@ -71,11 +71,9 @@ export async function getDeviceInfoFromCaps(this: AndroidDriver): Promise<ADBDev
         const semverDO = deviceOS;
 
         const bothVersionsCanBeCoerced = semver.valid(deviceOS) && semver.valid(platformVersion);
-        const bothVersionsAreStrings =
-          typeof deviceOS === 'string' && typeof platformVersion === 'string';
+        const bothVersionsAreStrings = typeof deviceOS === 'string' && typeof platformVersion === 'string';
         if (
-          (bothVersionsCanBeCoerced &&
-            (semverDO as semver.SemVer).version === (semverPV as semver.SemVer).version) ||
+          (bothVersionsCanBeCoerced && (semverDO as semver.SemVer).version === (semverPV as semver.SemVer).version) ||
           (bothVersionsAreStrings && deviceOS.toLowerCase() === platformVersion.toLowerCase())
         ) {
           // Got an exact match - proceed immediately
@@ -95,8 +93,7 @@ export async function getDeviceInfoFromCaps(this: AndroidDriver): Promise<ADBDev
             (pvMajor === dvMajor && pvMinor === dvMinor)) &&
           // Got a partial match - make sure we consider the most recent
           // device version available on the host system
-          ((partialMatchCandidate &&
-            semver.gt(deviceOS, Object.values(partialMatchCandidate)[0])) ||
+          ((partialMatchCandidate && semver.gt(deviceOS, Object.values(partialMatchCandidate)[0])) ||
             !partialMatchCandidate)
         ) {
           partialMatchCandidate = {[device.udid]: deviceOS};
@@ -168,9 +165,7 @@ export async function getLaunchInfo(this: AndroidDriver): Promise<ADBLaunchInfo
   let apkPackage: string | undefined;
   let apkActivity: string | undefined;
   if (appOpt) {
-    this.log.debug(
-      `Parsing package and activity from the '${path.basename(appOpt)}' file manifest`,
-    );
+    this.log.debug(`Parsing package and activity from the '${path.basename(appOpt)}' file manifest`);
     ({apkPackage, apkActivity} = await this.adb.packageAndLaunchActivityFromManifest(appOpt));
   } else if (appPackage) {
     this.log.debug(`Parsing activity from the installed '${appPackage}' package manifest`);
@@ -238,18 +233,10 @@ export async function initDevice(this: AndroidDriver): Promise<void> {
             `device provisioning, or unset the capability to let the driver install it.`,
         );
       }
-      this.log.info(
-        `'skipSettingsAppReinstall' is set; using the already-installed Appium Settings helper app as-is.`,
-      );
+      this.log.info(`'skipSettingsAppReinstall' is set; using the already-installed Appium Settings helper app as-is.`);
     } else {
       const shouldThrowError = Boolean(
-        language ||
-        locale ||
-        localeScript ||
-        unicodeKeyboard ||
-        hideKeyboard ||
-        disableWindowAnimation ||
-        !skipUnlock,
+        language || locale || localeScript || unicodeKeyboard || hideKeyboard || disableWindowAnimation || !skipUnlock,
       );
       await pushSettingsApp.bind(this)(shouldThrowError);
     }

package/lib/commands/device/emulator-actions.ts

@@ -1,22 +1,14 @@
 import {util} from '@appium/support';
-import {requireEmulator} from './utils.js';
 import {errors} from 'appium/driver.js';
+
 import type {AndroidDriver} from '../../driver.js';
-import type {
-  GsmAction,
-  GsmSignalStrength,
-  GsmVoiceState,
-  PowerACState,
-  NetworkSpeed,
-} from '../types.js';
+import type {GsmAction, GsmSignalStrength, GsmVoiceState, PowerACState, NetworkSpeed} from '../types.js';
+import {requireEmulator} from './utils.js';
 
 /**
  * @deprecated Use mobile: extension
  */
-export async function fingerprint(
-  this: AndroidDriver,
-  fingerprintId: string | number,
-): Promise<void> {
+export async function fingerprint(this: AndroidDriver, fingerprintId: string | number): Promise<void> {
   requireEmulator.bind(this)('fingerprint is only available for emulators');
   await this.adb.fingerprint(String(fingerprintId));
 }
@@ -30,21 +22,14 @@ export async function fingerprint(
  * for a fingerprint, you can run the adb command and pass it the `finger_id`
  * to simulate the fingerprint scan.
  */
-export async function mobileFingerprint(
-  this: AndroidDriver,
-  fingerprintId: string | number,
-): Promise<void> {
+export async function mobileFingerprint(this: AndroidDriver, fingerprintId: string | number): Promise<void> {
   await this.fingerprint(fingerprintId);
 }
 
 /**
  * @deprecated Use mobile: extension
  */
-export async function sendSMS(
-  this: AndroidDriver,
-  phoneNumber: string,
-  message: string,
-): Promise<void> {
+export async function sendSMS(this: AndroidDriver, phoneNumber: string, message: string): Promise<void> {
   requireEmulator.bind(this)('sendSMS is only available for emulators');
   await this.adb.sendSMS(phoneNumber, message);
 }
@@ -55,22 +40,14 @@ export async function sendSMS(
  * @param phoneNumber - The phone number to send SMS to
  * @param message - The message payload
  */
-export async function mobileSendSms(
-  this: AndroidDriver,
-  phoneNumber: string,
-  message: string,
-): Promise<void> {
+export async function mobileSendSms(this: AndroidDriver, phoneNumber: string, message: string): Promise<void> {
   await this.sendSMS(phoneNumber, message);
 }
 
 /**
  * @deprecated Use mobile: extension
  */
-export async function gsmCall(
-  this: AndroidDriver,
-  phoneNumber: string,
-  action: GsmAction,
-): Promise<void> {
+export async function gsmCall(this: AndroidDriver, phoneNumber: string, action: GsmAction): Promise<void> {
   requireEmulator.bind(this)('gsmCall is only available for emulators');
   await this.adb.gsmCall(phoneNumber, action);
 }
@@ -81,21 +58,14 @@ export async function gsmCall(
  * @param phoneNumber - The phone number to call to
  * @param action - Action to take
  */
-export async function mobileGsmCall(
-  this: AndroidDriver,
-  phoneNumber: string,
-  action: GsmAction,
-): Promise<void> {
+export async function mobileGsmCall(this: AndroidDriver, phoneNumber: string, action: GsmAction): Promise<void> {
   await this.gsmCall(phoneNumber, action);
 }
 
 /**
  * @deprecated Use mobile: extension
  */
-export async function gsmSignal(
-  this: AndroidDriver,
-  signalStrength: GsmSignalStrength,
-): Promise<void> {
+export async function gsmSignal(this: AndroidDriver, signalStrength: GsmSignalStrength): Promise<void> {
   requireEmulator.bind(this)('gsmSignal is only available for emulators');
   await this.adb.gsmSignal(signalStrength);
 }
@@ -105,10 +75,7 @@ export async function gsmSignal(
  *
  * @param strength - The signal strength value
  */
-export async function mobileGsmSignal(
-  this: AndroidDriver,
-  strength: GsmSignalStrength,
-): Promise<void> {
+export async function mobileGsmSignal(this: AndroidDriver, strength: GsmSignalStrength): Promise<void> {
   await this.gsmSignal(strength);
 }
 
@@ -187,11 +154,7 @@ export async function mobileNetworkSpeed(this: AndroidDriver, speed: NetworkSpee
  * @param value - Value to set to the sensor
  * @throws {errors.InvalidArgumentError} If sensorType or value is not provided
  */
-export async function sensorSet(
-  this: AndroidDriver,
-  sensorType: string,
-  value: string | number,
-): Promise<void> {
+export async function sensorSet(this: AndroidDriver, sensorType: string, value: string | number): Promise<void> {
   requireEmulator.bind(this)('sensorSet is only available for emulators');
   if (!util.hasValue(sensorType)) {
     throw new errors.InvalidArgumentError(`'sensorType' argument is required`);

package/lib/commands/device/emulator-console.ts

@@ -1,4 +1,5 @@
 import {errors} from 'appium/driver.js';
+
 import type {AndroidDriver} from '../../driver.js';
 
 const EMU_CONSOLE_FEATURE = 'emulator_console';