appium-adb 14.3.4 → 14.4.0

package/build/lib/helpers.js

@@ -1,283 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getJavaForOs = exports.getJavaHome = exports.getResourcePath = exports.DEFAULT_ADB_EXEC_TIMEOUT = exports.APK_INSTALL_TIMEOUT = exports.APK_EXTENSION = exports.APKS_EXTENSION = void 0;
-exports.getSdkRootFromEnv = getSdkRootFromEnv;
-exports.requireSdkRoot = requireSdkRoot;
-exports.unzipFile = unzipFile;
-exports.buildInstallArgs = buildInstallArgs;
-exports.readPackageManifest = readPackageManifest;
-const node_path_1 = __importDefault(require("node:path"));
-const support_1 = require("@appium/support");
-const logger_1 = require("./logger");
-const lodash_1 = __importDefault(require("lodash"));
-const teen_process_1 = require("teen_process");
-// Constants
-exports.APKS_EXTENSION = '.apks';
-exports.APK_EXTENSION = '.apk';
-exports.APK_INSTALL_TIMEOUT = 60000;
-exports.DEFAULT_ADB_EXEC_TIMEOUT = 20000; // in milliseconds
-const MODULE_NAME = 'appium-adb';
-// Public methods
-/**
- * Calculates the absolute path to the given resource
- */
-exports.getResourcePath = lodash_1.default.memoize(async function getResourcePath(relPath) {
-    const moduleRoot = await getModuleRoot();
-    const resultPath = node_path_1.default.resolve(moduleRoot, relPath);
-    if (!(await support_1.fs.exists(resultPath))) {
-        throw new Error(`Cannot find the resource '${relPath}' under the '${moduleRoot}' ` +
-            `folder of ${MODULE_NAME} Node.js module`);
-    }
-    return resultPath;
-});
-/**
- * Retrieves the actual path to SDK root folder from the system environment
- */
-function getSdkRootFromEnv() {
-    return process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
-}
-/**
- * Retrieves the actual path to SDK root folder
- */
-async function requireSdkRoot(customRoot = null) {
-    const sdkRoot = customRoot || getSdkRootFromEnv();
-    const docMsg = 'Read https://developer.android.com/studio/command-line/variables for more details';
-    if (!sdkRoot || lodash_1.default.isEmpty(sdkRoot)) {
-        throw new Error(`Neither ANDROID_HOME nor ANDROID_SDK_ROOT environment variable was exported. ${docMsg}`);
-    }
-    if (!(await support_1.fs.exists(sdkRoot))) {
-        throw new Error(`The Android SDK root folder '${sdkRoot}' does not exist on the local file system. ${docMsg}`);
-    }
-    const stats = await support_1.fs.stat(sdkRoot);
-    if (!stats.isDirectory()) {
-        throw new Error(`The Android SDK root '${sdkRoot}' must be a folder. ${docMsg}`);
-    }
-    return sdkRoot;
-}
-/**
- * @param zipPath
- * @param dstRoot
- */
-async function unzipFile(zipPath, dstRoot = node_path_1.default.dirname(zipPath)) {
-    logger_1.log.debug(`Unzipping '${zipPath}' to '${dstRoot}'`);
-    await support_1.zip.assertValidZip(zipPath);
-    await support_1.zip.extractAllTo(zipPath, dstRoot);
-    logger_1.log.debug('Unzip successful');
-}
-exports.getJavaHome = lodash_1.default.memoize(async function getJavaHome() {
-    const result = process.env.JAVA_HOME;
-    if (!result) {
-        throw new Error('The JAVA_HOME environment variable is not set for the current process');
-    }
-    if (!(await support_1.fs.exists(result))) {
-        throw new Error(`The JAVA_HOME location '${result}' must exist`);
-    }
-    const stats = await support_1.fs.stat(result);
-    if (!stats.isDirectory()) {
-        throw new Error(`The JAVA_HOME location '${result}' must be a valid folder`);
-    }
-    return result;
-});
-exports.getJavaForOs = lodash_1.default.memoize(async function getJavaForOs() {
-    let javaHome;
-    let errMsg;
-    try {
-        javaHome = await (0, exports.getJavaHome)();
-    }
-    catch (err) {
-        const error = err;
-        errMsg = error.message;
-    }
-    const executableName = `java${support_1.system.isWindows() ? '.exe' : ''}`;
-    if (javaHome) {
-        const resultPath = node_path_1.default.resolve(javaHome, 'bin', executableName);
-        if (await support_1.fs.exists(resultPath)) {
-            return resultPath;
-        }
-    }
-    try {
-        return await support_1.fs.which(executableName);
-    }
-    catch {
-        // Ignore and throw custom error below
-    }
-    throw new Error(`The '${executableName}' binary could not be found ` +
-        `neither in PATH nor under JAVA_HOME (${javaHome ? node_path_1.default.resolve(javaHome, 'bin') : errMsg})`);
-});
-/**
- * Transforms given options into the list of `adb install.install-multiple` command arguments
- */
-function buildInstallArgs(apiLevel, options = {}) {
-    const result = [];
-    if (!support_1.util.hasValue(options.replace) || options.replace) {
-        result.push('-r');
-    }
-    if (options.allowTestPackages) {
-        result.push('-t');
-    }
-    if (options.useSdcard) {
-        result.push('-s');
-    }
-    if (options.grantPermissions) {
-        if (apiLevel < 23) {
-            logger_1.log.debug(`Skipping permissions grant option, since ` +
-                `the current API level ${apiLevel} does not support applications ` +
-                `permissions customization`);
-        }
-        else {
-            result.push('-g');
-        }
-    }
-    // For multiple-install
-    if (options.partialInstall) {
-        result.push('-p');
-    }
-    return result;
-}
-/**
- * Extracts various package manifest details
- * from the given application file.
- */
-async function readPackageManifest(apkPath) {
-    await this.initAapt2();
-    const aapt2Binary = this.binaries?.aapt2;
-    if (!aapt2Binary) {
-        throw new Error('aapt2 binary is not available');
-    }
-    const args = ['dump', 'badging', apkPath];
-    logger_1.log.debug(`Reading package manifest: '${support_1.util.quote([aapt2Binary, ...args])}'`);
-    let stdout;
-    try {
-        ({ stdout } = await (0, teen_process_1.exec)(aapt2Binary, args));
-    }
-    catch (e) {
-        const error = e;
-        const prefix = `Cannot read the manifest from '${apkPath}'`;
-        const suffix = `Original error: ${error.stderr || error.message}`;
-        if (error.stderr && lodash_1.default.includes(error.stderr, `Unable to open 'badging'`)) {
-            throw new Error(`${prefix}. Update build tools to use a newer aapt2 version. ${suffix}`);
-        }
-        throw new Error(`${prefix}. ${suffix}`);
-    }
-    const extractValue = (line, propPattern, valueTransformer) => {
-        const match = propPattern.exec(line);
-        if (match) {
-            return valueTransformer ? valueTransformer(match[1]) : match[1];
-        }
-        return undefined;
-    };
-    const extractArray = (line, propPattern, valueTransformer) => {
-        let match;
-        const resultArray = [];
-        while ((match = propPattern.exec(line))) {
-            resultArray.push(valueTransformer ? valueTransformer(match[1]) : match[1]);
-        }
-        return resultArray;
-    };
-    const toInt = (x) => parseInt(x, 10);
-    const result = {
-        name: '',
-        versionCode: 0,
-        minSdkVersion: 0,
-        compileSdkVersion: 0,
-        usesPermissions: [],
-        launchableActivity: {
-            name: '',
-        },
-        architectures: [],
-        locales: [],
-        densities: [],
-    };
-    for (const line of stdout.split('\n')) {
-        if (line.startsWith('package:')) {
-            for (const [name, pattern, transformer] of [
-                ['name', /name='([^']+)'/, null],
-                ['versionCode', /versionCode='([^']+)'/, toInt],
-                ['versionName', /versionName='([^']+)'/, null],
-                ['platformBuildVersionName', /platformBuildVersionName='([^']+)'/, null],
-                ['platformBuildVersionCode', /platformBuildVersionCode='([^']+)'/, toInt],
-                ['compileSdkVersion', /compileSdkVersion='([^']+)'/, toInt],
-                ['compileSdkVersionCodename', /compileSdkVersionCodename='([^']+)'/, null],
-            ]) {
-                const value = extractValue(line, pattern, transformer);
-                if (!lodash_1.default.isUndefined(value)) {
-                    result[name] = value;
-                }
-            }
-        }
-        else if (line.startsWith('sdkVersion:') || line.startsWith('minSdkVersion:')) {
-            const value = extractValue(line, /[sS]dkVersion:'([^']+)'/, toInt);
-            if (value) {
-                result.minSdkVersion = value;
-            }
-        }
-        else if (line.startsWith('targetSdkVersion:')) {
-            const value = extractValue(line, /targetSdkVersion:'([^']+)'/, toInt);
-            if (value) {
-                result.targetSdkVersion = value;
-            }
-        }
-        else if (line.startsWith('uses-permission:')) {
-            const value = extractValue(line, /name='([^']+)'/, null);
-            if (value) {
-                result.usesPermissions.push(value);
-            }
-        }
-        else if (line.startsWith('launchable-activity:')) {
-            for (const [name, pattern] of [
-                ['name', /name='([^']+)'/],
-                ['label', /label='([^']+)'/],
-                ['icon', /icon='([^']+)'/],
-            ]) {
-                const value = extractValue(line, pattern, null);
-                if (value) {
-                    result.launchableActivity[name] = value;
-                }
-            }
-        }
-        else if (line.startsWith('locales:')) {
-            result.locales = extractArray(line, /'([^']+)'/g, null);
-        }
-        else if (line.startsWith('native-code:')) {
-            result.architectures = extractArray(line, /'([^']+)'/g, null);
-        }
-        else if (line.startsWith('densities:')) {
-            result.densities = extractArray(line, /'([^']+)'/g, toInt);
-        }
-    }
-    return result;
-}
-// Private methods
-/**
- * Calculates the absolute path to the current module's root folder
- */
-const getModuleRoot = lodash_1.default.memoize(async function getModuleRoot() {
-    let moduleRoot = node_path_1.default.dirname(node_path_1.default.resolve(__filename));
-    let isAtFsRoot = false;
-    while (!isAtFsRoot) {
-        const manifestPath = node_path_1.default.join(moduleRoot, 'package.json');
-        try {
-            if (await support_1.fs.exists(manifestPath)) {
-                const manifestContent = await support_1.fs.readFile(manifestPath, 'utf8');
-                const manifest = JSON.parse(manifestContent);
-                if (manifest.name === MODULE_NAME) {
-                    return moduleRoot;
-                }
-            }
-        }
-        catch {
-            // Ignore errors and continue searching
-        }
-        const parentDir = node_path_1.default.dirname(moduleRoot);
-        isAtFsRoot = moduleRoot.length <= parentDir.length;
-        moduleRoot = parentDir;
-    }
-    if (isAtFsRoot) {
-        throw new Error(`Cannot find the root folder of the ${MODULE_NAME} Node.js module`);
-    }
-    return moduleRoot;
-});
-//# sourceMappingURL=helpers.js.map

package/build/lib/helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../lib/helpers.ts"],"names":[],"mappings":"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"}

package/lib/helpers.ts

@@ -1,323 +0,0 @@
-import path from 'node:path';
-import {system, fs, zip, util} from '@appium/support';
-import {log} from './logger';
-import _ from 'lodash';
-import {exec, type ExecError} from 'teen_process';
-import type {ADB} from './adb';
-import type {ApkManifest} from './tools/types';
-
-// Declare __filename for CommonJS compatibility
-declare const __filename: string;
-
-// Constants
-export const APKS_EXTENSION = '.apks';
-export const APK_EXTENSION = '.apk';
-export const APK_INSTALL_TIMEOUT = 60000;
-export const DEFAULT_ADB_EXEC_TIMEOUT = 20000; // in milliseconds
-const MODULE_NAME = 'appium-adb';
-
-// Public methods
-
-/**
- * Calculates the absolute path to the given resource
- */
-export const getResourcePath = _.memoize(async function getResourcePath(
-  relPath: string,
-): Promise<string> {
-  const moduleRoot = await getModuleRoot();
-  const resultPath = path.resolve(moduleRoot, relPath);
-  if (!(await fs.exists(resultPath))) {
-    throw new Error(
-      `Cannot find the resource '${relPath}' under the '${moduleRoot}' ` +
-        `folder of ${MODULE_NAME} Node.js module`,
-    );
-  }
-  return resultPath;
-});
-
-/**
- * Retrieves the actual path to SDK root folder from the system environment
- */
-export function getSdkRootFromEnv(): string | undefined {
-  return process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
-}
-
-/**
- * Retrieves the actual path to SDK root folder
- */
-export async function requireSdkRoot(customRoot: string | null = null): Promise<string> {
-  const sdkRoot = customRoot || getSdkRootFromEnv();
-  const docMsg =
-    'Read https://developer.android.com/studio/command-line/variables for more details';
-  if (!sdkRoot || _.isEmpty(sdkRoot)) {
-    throw new Error(
-      `Neither ANDROID_HOME nor ANDROID_SDK_ROOT environment variable was exported. ${docMsg}`,
-    );
-  }
-  if (!(await fs.exists(sdkRoot))) {
-    throw new Error(
-      `The Android SDK root folder '${sdkRoot}' does not exist on the local file system. ${docMsg}`,
-    );
-  }
-
-  const stats = await fs.stat(sdkRoot);
-  if (!stats.isDirectory()) {
-    throw new Error(`The Android SDK root '${sdkRoot}' must be a folder. ${docMsg}`);
-  }
-  return sdkRoot;
-}
-
-/**
- * @param zipPath
- * @param dstRoot
- */
-export async function unzipFile(
-  zipPath: string,
-  dstRoot: string = path.dirname(zipPath),
-): Promise<void> {
-  log.debug(`Unzipping '${zipPath}' to '${dstRoot}'`);
-  await zip.assertValidZip(zipPath);
-  await zip.extractAllTo(zipPath, dstRoot);
-  log.debug('Unzip successful');
-}
-
-export const getJavaHome = _.memoize(async function getJavaHome(): Promise<string> {
-  const result = process.env.JAVA_HOME;
-  if (!result) {
-    throw new Error('The JAVA_HOME environment variable is not set for the current process');
-  }
-  if (!(await fs.exists(result))) {
-    throw new Error(`The JAVA_HOME location '${result}' must exist`);
-  }
-  const stats = await fs.stat(result);
-  if (!stats.isDirectory()) {
-    throw new Error(`The JAVA_HOME location '${result}' must be a valid folder`);
-  }
-  return result;
-});
-
-export const getJavaForOs = _.memoize(async function getJavaForOs(): Promise<string> {
-  let javaHome: string | undefined;
-  let errMsg: string | undefined;
-  try {
-    javaHome = await getJavaHome();
-  } catch (err: unknown) {
-    const error = err as Error;
-    errMsg = error.message;
-  }
-  const executableName = `java${system.isWindows() ? '.exe' : ''}`;
-  if (javaHome) {
-    const resultPath = path.resolve(javaHome, 'bin', executableName);
-    if (await fs.exists(resultPath)) {
-      return resultPath;
-    }
-  }
-  try {
-    return await fs.which(executableName);
-  } catch {
-    // Ignore and throw custom error below
-  }
-  throw new Error(
-    `The '${executableName}' binary could not be found ` +
-      `neither in PATH nor under JAVA_HOME (${javaHome ? path.resolve(javaHome, 'bin') : errMsg})`,
-  );
-});
-
-/**
- * Transforms given options into the list of `adb install.install-multiple` command arguments
- */
-export function buildInstallArgs(
-  apiLevel: number,
-  options: BuildInstallArgsOptions = {},
-): string[] {
-  const result: string[] = [];
-
-  if (!util.hasValue(options.replace) || options.replace) {
-    result.push('-r');
-  }
-  if (options.allowTestPackages) {
-    result.push('-t');
-  }
-  if (options.useSdcard) {
-    result.push('-s');
-  }
-  if (options.grantPermissions) {
-    if (apiLevel < 23) {
-      log.debug(
-        `Skipping permissions grant option, since ` +
-          `the current API level ${apiLevel} does not support applications ` +
-          `permissions customization`,
-      );
-    } else {
-      result.push('-g');
-    }
-  }
-  // For multiple-install
-  if (options.partialInstall) {
-    result.push('-p');
-  }
-
-  return result;
-}
-
-/**
- * Extracts various package manifest details
- * from the given application file.
- */
-export async function readPackageManifest(this: ADB, apkPath: string): Promise<ApkManifest> {
-  await this.initAapt2();
-  const aapt2Binary = this.binaries?.aapt2;
-  if (!aapt2Binary) {
-    throw new Error('aapt2 binary is not available');
-  }
-
-  const args = ['dump', 'badging', apkPath];
-  log.debug(`Reading package manifest: '${util.quote([aapt2Binary, ...args])}'`);
-  let stdout: string;
-  try {
-    ({stdout} = await exec(aapt2Binary, args));
-  } catch (e: unknown) {
-    const error = e as ExecError;
-    const prefix = `Cannot read the manifest from '${apkPath}'`;
-    const suffix = `Original error: ${error.stderr || error.message}`;
-    if (error.stderr && _.includes(error.stderr, `Unable to open 'badging'`)) {
-      throw new Error(`${prefix}. Update build tools to use a newer aapt2 version. ${suffix}`);
-    }
-    throw new Error(`${prefix}. ${suffix}`);
-  }
-
-  const extractValue = (
-    line: string,
-    propPattern: RegExp,
-    valueTransformer: ((x: string) => any) | null,
-  ): any => {
-    const match = propPattern.exec(line);
-    if (match) {
-      return valueTransformer ? valueTransformer(match[1]) : match[1];
-    }
-    return undefined;
-  };
-  const extractArray = (
-    line: string,
-    propPattern: RegExp,
-    valueTransformer: ((x: string) => any) | null,
-  ): any[] => {
-    let match: RegExpExecArray | null;
-    const resultArray: any[] = [];
-    while ((match = propPattern.exec(line))) {
-      resultArray.push(valueTransformer ? valueTransformer(match[1]) : match[1]);
-    }
-    return resultArray;
-  };
-
-  const toInt = (x: string): number => parseInt(x, 10);
-
-  const result: ApkManifest = {
-    name: '',
-    versionCode: 0,
-    minSdkVersion: 0,
-    compileSdkVersion: 0,
-    usesPermissions: [],
-    launchableActivity: {
-      name: '',
-    },
-    architectures: [],
-    locales: [],
-    densities: [],
-  };
-  for (const line of stdout.split('\n')) {
-    if (line.startsWith('package:')) {
-      for (const [name, pattern, transformer] of [
-        ['name', /name='([^']+)'/, null],
-        ['versionCode', /versionCode='([^']+)'/, toInt],
-        ['versionName', /versionName='([^']+)'/, null],
-        ['platformBuildVersionName', /platformBuildVersionName='([^']+)'/, null],
-        ['platformBuildVersionCode', /platformBuildVersionCode='([^']+)'/, toInt],
-        ['compileSdkVersion', /compileSdkVersion='([^']+)'/, toInt],
-        ['compileSdkVersionCodename', /compileSdkVersionCodename='([^']+)'/, null],
-      ] as const) {
-        const value = extractValue(line, pattern, transformer);
-        if (!_.isUndefined(value)) {
-          (result as Record<string, any>)[name] = value;
-        }
-      }
-    } else if (line.startsWith('sdkVersion:') || line.startsWith('minSdkVersion:')) {
-      const value = extractValue(line, /[sS]dkVersion:'([^']+)'/, toInt);
-      if (value) {
-        result.minSdkVersion = value;
-      }
-    } else if (line.startsWith('targetSdkVersion:')) {
-      const value = extractValue(line, /targetSdkVersion:'([^']+)'/, toInt);
-      if (value) {
-        result.targetSdkVersion = value;
-      }
-    } else if (line.startsWith('uses-permission:')) {
-      const value = extractValue(line, /name='([^']+)'/, null);
-      if (value) {
-        result.usesPermissions.push(value);
-      }
-    } else if (line.startsWith('launchable-activity:')) {
-      for (const [name, pattern] of [
-        ['name', /name='([^']+)'/],
-        ['label', /label='([^']+)'/],
-        ['icon', /icon='([^']+)'/],
-      ] as const) {
-        const value = extractValue(line, pattern, null);
-        if (value) {
-          (result.launchableActivity as Record<string, any>)[name] = value;
-        }
-      }
-    } else if (line.startsWith('locales:')) {
-      result.locales = extractArray(line, /'([^']+)'/g, null) as string[];
-    } else if (line.startsWith('native-code:')) {
-      result.architectures = extractArray(line, /'([^']+)'/g, null) as string[];
-    } else if (line.startsWith('densities:')) {
-      result.densities = extractArray(line, /'([^']+)'/g, toInt) as number[];
-    }
-  }
-  return result;
-}
-
-// Private methods
-
-/**
- * Calculates the absolute path to the current module's root folder
- */
-const getModuleRoot = _.memoize(async function getModuleRoot(): Promise<string> {
-  let moduleRoot = path.dirname(path.resolve(__filename));
-  let isAtFsRoot = false;
-  while (!isAtFsRoot) {
-    const manifestPath = path.join(moduleRoot, 'package.json');
-    try {
-      if (await fs.exists(manifestPath)) {
-        const manifestContent = await fs.readFile(manifestPath, 'utf8');
-        const manifest = JSON.parse(manifestContent) as {name?: string};
-        if (manifest.name === MODULE_NAME) {
-          return moduleRoot;
-        }
-      }
-    } catch {
-      // Ignore errors and continue searching
-    }
-    const parentDir = path.dirname(moduleRoot);
-    isAtFsRoot = moduleRoot.length <= parentDir.length;
-    moduleRoot = parentDir;
-  }
-  if (isAtFsRoot) {
-    throw new Error(`Cannot find the root folder of the ${MODULE_NAME} Node.js module`);
-  }
-  return moduleRoot;
-});
-
-// Type definitions
-
-/**
- * Options for building install arguments
- */
-interface BuildInstallArgsOptions {
-  replace?: boolean;
-  allowTestPackages?: boolean;
-  useSdcard?: boolean;
-  grantPermissions?: boolean;
-  partialInstall?: boolean;
-}