appium-android-driver 7.8.2 → 8.0.0

package/build/lib/commands/app-management.js

@@ -1,152 +1,457 @@
 "use strict";
-// @ts-check
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getThirdPartyPackages = exports.uninstallOtherPackages = exports.installOtherApks = exports.installApk = exports.resetApp = exports.background = exports.getCurrentPackage = exports.getCurrentActivity = exports.mobileClearApp = exports.mobileInstallApp = exports.installApp = exports.mobileTerminateApp = exports.terminateApp = exports.mobileRemoveApp = exports.removeApp = exports.mobileActivateApp = exports.activateApp = exports.mobileQueryAppState = exports.queryAppState = exports.mobileIsAppInstalled = exports.isAppInstalled = exports.APP_STATE = void 0;
 const support_1 = require("@appium/support");
 const asyncbox_1 = require("asyncbox");
 const lodash_1 = __importDefault(require("lodash"));
-const helpers_1 = require("../helpers");
 const utils_1 = require("../utils");
-const mixins_1 = require("./mixins");
+const node_os_1 = require("node:os");
+const bluebird_1 = __importDefault(require("bluebird"));
 const APP_EXTENSIONS = ['.apk', '.apks'];
 const RESOLVER_ACTIVITY_NAME = 'android/com.android.internal.app.ResolverActivity';
+const PACKAGE_INSTALL_TIMEOUT_MS = 90000;
+// These constants are in sync with
+// https://developer.apple.com/documentation/xctest/xcuiapplicationstate/xcuiapplicationstaterunningbackground?language=objc
+exports.APP_STATE = ({
+    NOT_INSTALLED: 0,
+    NOT_RUNNING: 1,
+    RUNNING_IN_BACKGROUND: 3,
+    RUNNING_IN_FOREGROUND: 4,
+});
 /**
- * @type {import('./mixins').AppManagementMixin & ThisType<import('../driver').AndroidDriver>}
- * @satisfies {import('@appium/types').ExternalDriver}
- */
-const AppManagementMixin = {
-    async isAppInstalled(appId) {
-        return await this.adb.isAppInstalled(appId);
-    },
-    async mobileIsAppInstalled(opts) {
-        const { appId } = (0, utils_1.requireArgs)('appId', opts);
-        return await this.isAppInstalled(appId);
-    },
-    async queryAppState(appId) {
-        this.log.info(`Querying the state of '${appId}'`);
-        if (!(await this.adb.isAppInstalled(appId))) {
-            return helpers_1.APP_STATE.NOT_INSTALLED;
-        }
-        if (!(await this.adb.processExists(appId))) {
-            return helpers_1.APP_STATE.NOT_RUNNING;
-        }
-        const appIdRe = new RegExp(`\\b${lodash_1.default.escapeRegExp(appId)}/`);
-        for (const line of (await this.adb.dumpWindows()).split('\n')) {
-            if (appIdRe.test(line) && ['mCurrentFocus', 'mFocusedApp'].some((x) => line.includes(x))) {
-                return helpers_1.APP_STATE.RUNNING_IN_FOREGROUND;
-            }
-        }
-        return helpers_1.APP_STATE.RUNNING_IN_BACKGROUND;
-    },
-    async mobileQueryAppState(opts) {
-        const { appId } = (0, utils_1.requireArgs)('appId', opts);
-        return await this.queryAppState(appId);
-    },
-    async activateApp(appId) {
-        this.log.debug(`Activating '${appId}'`);
-        const apiLevel = await this.adb.getApiLevel();
-        // Fallback to Monkey in older APIs
-        if (apiLevel < 24) {
-            // The monkey command could raise an issue as https://stackoverflow.com/questions/44860475/how-to-use-the-monkey-command-with-an-android-system-that-doesnt-have-physical
-            // but '--pct-syskeys 0' could cause another background process issue. https://github.com/appium/appium/issues/16941#issuecomment-1129837285
-            const cmd = ['monkey', '-p', appId, '-c', 'android.intent.category.LAUNCHER', '1'];
-            let output = '';
-            try {
-                output = await this.adb.shell(cmd);
-                this.log.debug(`Command stdout: ${output}`);
-            }
-            catch (e) {
-                this.log.errorAndThrow(`Cannot activate '${appId}'. Original error: ${ /** @type {Error} */(e).message}`);
-            }
-            if (output.includes('monkey aborted')) {
-                this.log.errorAndThrow(`Cannot activate '${appId}'. Are you sure it is installed?`);
-            }
-            return;
+ * @this {AndroidDriver}
+ * @param {string} appId
+ * @returns {Promise<boolean>}
+ */
+async function isAppInstalled(appId) {
+    return await this.adb.isAppInstalled(appId);
+}
+exports.isAppInstalled = isAppInstalled;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').IsAppInstalledOpts} opts
+ * @returns {Promise<boolean>}
+ */
+async function mobileIsAppInstalled(opts) {
+    const { appId } = (0, utils_1.requireArgs)('appId', opts);
+    return await this.isAppInstalled(appId);
+}
+exports.mobileIsAppInstalled = mobileIsAppInstalled;
+/**
+ * @this {AndroidDriver}
+ * @param {string} appId
+ * @returns {Promise<import('./types').AppState>}
+ */
+async function queryAppState(appId) {
+    this.log.info(`Querying the state of '${appId}'`);
+    if (!(await this.adb.isAppInstalled(appId))) {
+        return exports.APP_STATE.NOT_INSTALLED;
+    }
+    if (!(await this.adb.processExists(appId))) {
+        return exports.APP_STATE.NOT_RUNNING;
+    }
+    const appIdRe = new RegExp(`\\b${lodash_1.default.escapeRegExp(appId)}/`);
+    for (const line of (await this.adb.dumpWindows()).split('\n')) {
+        if (appIdRe.test(line) && ['mCurrentFocus', 'mFocusedApp'].some((x) => line.includes(x))) {
+            return exports.APP_STATE.RUNNING_IN_FOREGROUND;
         }
-        let activityName = await this.adb.resolveLaunchableActivity(appId);
-        if (activityName === RESOLVER_ACTIVITY_NAME) {
-            // https://github.com/appium/appium/issues/17128
-            this.log.debug(`The launchable activity name of '${appId}' was resolved to '${activityName}'. ` +
-                `Switching the resolver to not use cmd`);
-            activityName = await this.adb.resolveLaunchableActivity(appId, { preferCmd: false });
+    }
+    return exports.APP_STATE.RUNNING_IN_BACKGROUND;
+}
+exports.queryAppState = queryAppState;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').QueryAppStateOpts} opts
+ * @returns {Promise<import('./types').AppState>}
+ */
+async function mobileQueryAppState(opts) {
+    const { appId } = (0, utils_1.requireArgs)('appId', opts);
+    return await this.queryAppState(appId);
+}
+exports.mobileQueryAppState = mobileQueryAppState;
+/**
+ * @this {AndroidDriver}
+ * @param {string} appId
+ * @returns {Promise<void>}
+ */
+async function activateApp(appId) {
+    this.log.debug(`Activating '${appId}'`);
+    const apiLevel = await this.adb.getApiLevel();
+    // Fallback to Monkey in older APIs
+    if (apiLevel < 24) {
+        // The monkey command could raise an issue as https://stackoverflow.com/questions/44860475/how-to-use-the-monkey-command-with-an-android-system-that-doesnt-have-physical
+        // but '--pct-syskeys 0' could cause another background process issue. https://github.com/appium/appium/issues/16941#issuecomment-1129837285
+        const cmd = ['monkey', '-p', appId, '-c', 'android.intent.category.LAUNCHER', '1'];
+        let output = '';
+        try {
+            output = await this.adb.shell(cmd);
+            this.log.debug(`Command stdout: ${output}`);
         }
-        const stdout = await this.adb.shell([
-            'am',
-            apiLevel < 26 ? 'start' : 'start-activity',
-            '-a',
-            'android.intent.action.MAIN',
-            '-c',
-            'android.intent.category.LAUNCHER',
-            // FLAG_ACTIVITY_NEW_TASK | FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
-            // https://developer.android.com/reference/android/content/Intent#FLAG_ACTIVITY_NEW_TASK
-            // https://developer.android.com/reference/android/content/Intent#FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
-            '-f',
-            '0x10200000',
-            '-n',
-            activityName,
-        ]);
-        this.log.debug(stdout);
-        if (/^error:/im.test(stdout)) {
-            throw new Error(`Cannot activate '${appId}'. Original error: ${stdout}`);
+        catch (e) {
+            this.log.errorAndThrow(`Cannot activate '${appId}'. Original error: ${ /** @type {Error} */(e).message}`);
         }
-    },
-    async mobileActivateApp(opts) {
-        const { appId } = (0, utils_1.requireArgs)('appId', opts);
-        return await this.activateApp(appId);
-    },
-    async removeApp(appId, opts = {}) {
-        return await this.adb.uninstallApk(appId, opts);
-    },
-    async mobileRemoveApp(opts) {
-        const { appId } = (0, utils_1.requireArgs)('appId', opts);
-        return await this.removeApp(appId, opts);
-    },
-    async terminateApp(appId, options = {}) {
-        this.log.info(`Terminating '${appId}'`);
-        if (!(await this.adb.processExists(appId))) {
-            this.log.info(`The app '${appId}' is not running`);
-            return false;
+        if (output.includes('monkey aborted')) {
+            this.log.errorAndThrow(`Cannot activate '${appId}'. Are you sure it is installed?`);
         }
-        await this.adb.forceStop(appId);
-        const timeout = support_1.util.hasValue(options.timeout) && !Number.isNaN(options.timeout)
-            ? parseInt(String(options.timeout), 10)
-            : 500;
-        if (timeout <= 0) {
-            this.log.info(`'${appId}' has been terminated. Skip checking the application process state ` +
-                `since the timeout was set as ${timeout}ms`);
+        return;
+    }
+    let activityName = await this.adb.resolveLaunchableActivity(appId);
+    if (activityName === RESOLVER_ACTIVITY_NAME) {
+        // https://github.com/appium/appium/issues/17128
+        this.log.debug(`The launchable activity name of '${appId}' was resolved to '${activityName}'. ` +
+            `Switching the resolver to not use cmd`);
+        activityName = await this.adb.resolveLaunchableActivity(appId, { preferCmd: false });
+    }
+    const stdout = await this.adb.shell([
+        'am',
+        apiLevel < 26 ? 'start' : 'start-activity',
+        '-a',
+        'android.intent.action.MAIN',
+        '-c',
+        'android.intent.category.LAUNCHER',
+        // FLAG_ACTIVITY_NEW_TASK | FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
+        // https://developer.android.com/reference/android/content/Intent#FLAG_ACTIVITY_NEW_TASK
+        // https://developer.android.com/reference/android/content/Intent#FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
+        '-f',
+        '0x10200000',
+        '-n',
+        activityName,
+    ]);
+    this.log.debug(stdout);
+    if (/^error:/im.test(stdout)) {
+        throw new Error(`Cannot activate '${appId}'. Original error: ${stdout}`);
+    }
+}
+exports.activateApp = activateApp;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').ActivateAppOpts} opts
+ * @returns {Promise<void>}
+ */
+async function mobileActivateApp(opts) {
+    const { appId } = (0, utils_1.requireArgs)('appId', opts);
+    return await this.activateApp(appId);
+}
+exports.mobileActivateApp = mobileActivateApp;
+/**
+ * @this {AndroidDriver}
+ * @param {string} appId
+ * @param {Omit<import('appium-adb').UninstallOptions, 'appId'>} opts
+ * @returns {Promise<boolean>}
+ */
+async function removeApp(appId, opts = {}) {
+    return await this.adb.uninstallApk(appId, opts);
+}
+exports.removeApp = removeApp;
+/**
+ * @this {import('../driver').AndroidDriver}
+ * @param {import('./types').RemoveAppOpts} opts
+ * @returns {Promise<boolean>}
+ */
+async function mobileRemoveApp(opts) {
+    const { appId } = (0, utils_1.requireArgs)('appId', opts);
+    return await this.removeApp(appId, opts);
+}
+exports.mobileRemoveApp = mobileRemoveApp;
+/**
+ * @this {AndroidDriver}
+ * @param {string} appId
+ * @param {Omit<import('./types').TerminateAppOpts, 'appId'>} [options={}]
+ * @returns {Promise<boolean>}
+ */
+async function terminateApp(appId, options = {}) {
+    this.log.info(`Terminating '${appId}'`);
+    if (!(await this.adb.processExists(appId))) {
+        this.log.info(`The app '${appId}' is not running`);
+        return false;
+    }
+    await this.adb.forceStop(appId);
+    const timeout = support_1.util.hasValue(options.timeout) && !Number.isNaN(options.timeout)
+        ? parseInt(String(options.timeout), 10)
+        : 500;
+    if (timeout <= 0) {
+        this.log.info(`'${appId}' has been terminated. Skip checking the application process state ` +
+            `since the timeout was set as ${timeout}ms`);
+        return true;
+    }
+    try {
+        await (0, asyncbox_1.waitForCondition)(async () => (await this.queryAppState(appId)) <= exports.APP_STATE.NOT_RUNNING, {
+            waitMs: timeout,
+            intervalMs: 100,
+        });
+    }
+    catch (e) {
+        this.log.errorAndThrow(`'${appId}' is still running after ${timeout}ms timeout`);
+    }
+    this.log.info(`'${appId}' has been successfully terminated`);
+    return true;
+}
+exports.terminateApp = terminateApp;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').TerminateAppOpts} opts
+ * @returns {Promise<boolean>}
+ */
+async function mobileTerminateApp(opts) {
+    const { appId } = (0, utils_1.requireArgs)('appId', opts);
+    return await this.terminateApp(appId, opts);
+}
+exports.mobileTerminateApp = mobileTerminateApp;
+/**
+ * @this {AndroidDriver}
+ * @param {string} appPath
+ * @param {Omit<import('appium-adb').InstallOptions, 'appId'>} opts
+ * @returns {Promise<void>}
+ */
+async function installApp(appPath, opts) {
+    const localPath = await this.helpers.configureApp(appPath, APP_EXTENSIONS);
+    await this.adb.install(localPath, opts);
+}
+exports.installApp = installApp;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').InstallAppOpts} opts
+ * @returns {Promise<void>}
+ */
+async function mobileInstallApp(opts) {
+    const { appPath } = (0, utils_1.requireArgs)('appPath', opts);
+    return await this.installApp(appPath, opts);
+}
+exports.mobileInstallApp = mobileInstallApp;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').ClearAppOpts} opts
+ * @returns {Promise<void>}
+ */
+async function mobileClearApp(opts) {
+    const { appId } = (0, utils_1.requireArgs)('appId', opts);
+    await this.adb.clear(appId);
+}
+exports.mobileClearApp = mobileClearApp;
+/**
+ * @this {AndroidDriver}
+ * @returns {Promise<string>}
+ */
+async function getCurrentActivity() {
+    return /** @type {string} */ ((await this.adb.getFocusedPackageAndActivity()).appActivity);
+}
+exports.getCurrentActivity = getCurrentActivity;
+/**
+ * @this {AndroidDriver}
+ * @returns {Promise<string>}
+ */
+async function getCurrentPackage() {
+    return /** @type {string} */ ((await this.adb.getFocusedPackageAndActivity()).appPackage);
+}
+exports.getCurrentPackage = getCurrentPackage;
+/**
+ * @this {AndroidDriver}
+ * @param {number} seconds
+ * @returns {Promise<string|true>}
+ */
+async function background(seconds) {
+    if (seconds < 0) {
+        // if user passes in a negative seconds value, interpret that as the instruction
+        // to not bring the app back at all
+        await this.adb.goToHome();
+        return true;
+    }
+    let { appPackage, appActivity } = await this.adb.getFocusedPackageAndActivity();
+    await this.adb.goToHome();
+    // people can wait for a long time, so to be safe let's use the longSleep function and log
+    // progress periodically.
+    const sleepMs = seconds * 1000;
+    const thresholdMs = 30 * 1000; // use the spin-wait for anything over this threshold
+    // for our spin interval, use 1% of the total wait time, but nothing bigger than 30s
+    const intervalMs = lodash_1.default.min([30 * 1000, parseInt(String(sleepMs / 100), 10)]);
+    /**
+     *
+     * @param {{elapsedMs: number, progress: number}} param0
+     */
+    const progressCb = ({ elapsedMs, progress }) => {
+        const waitSecs = (elapsedMs / 1000).toFixed(0);
+        const progressPct = (progress * 100).toFixed(2);
+        this.log.debug(`Waited ${waitSecs}s so far (${progressPct}%)`);
+    };
+    await (0, asyncbox_1.longSleep)(sleepMs, { thresholdMs, intervalMs, progressCb });
+    /** @type {import('appium-adb').StartAppOptions} */
+    let args;
+    if (this._cachedActivityArgs && this._cachedActivityArgs[`${appPackage}/${appActivity}`]) {
+        // the activity was started with `startActivity`, so use those args to restart
+        args = this._cachedActivityArgs[`${appPackage}/${appActivity}`];
+    }
+    else {
+        try {
+            this.log.debug(`Activating app '${appPackage}' in order to restore it`);
+            await this.activateApp(/** @type {string} */ (appPackage));
             return true;
         }
+        catch (ign) { }
+        args =
+            (appPackage === this.opts.appPackage && appActivity === this.opts.appActivity) ||
+                (appPackage === this.opts.appWaitPackage &&
+                    (this.opts.appWaitActivity || '').split(',').includes(String(appActivity)))
+                ? {
+                    // the activity is the original session activity, so use the original args
+                    pkg: /** @type {string} */ (this.opts.appPackage),
+                    activity: this.opts.appActivity ?? undefined,
+                    action: this.opts.intentAction,
+                    category: this.opts.intentCategory,
+                    flags: this.opts.intentFlags,
+                    waitPkg: this.opts.appWaitPackage ?? undefined,
+                    waitActivity: this.opts.appWaitActivity ?? undefined,
+                    waitForLaunch: this.opts.appWaitForLaunch,
+                    waitDuration: this.opts.appWaitDuration,
+                    optionalIntentArguments: this.opts.optionalIntentArguments,
+                    stopApp: false,
+                    user: this.opts.userProfile,
+                }
+                : {
+                    // the activity was started some other way, so use defaults
+                    pkg: /** @type {string} */ (appPackage),
+                    activity: appActivity ?? undefined,
+                    waitPkg: appPackage ?? undefined,
+                    waitActivity: appActivity ?? undefined,
+                    stopApp: false,
+                };
+    }
+    args = /** @type {import('appium-adb').StartAppOptions} */ (lodash_1.default.pickBy(args, (value) => !lodash_1.default.isUndefined(value)));
+    this.log.debug(`Bringing application back to foreground with arguments: ${JSON.stringify(args)}`);
+    return await this.adb.startApp(args);
+}
+exports.background = background;
+/**
+ * @this {AndroidDriver}
+ * @param {import('../driver').AndroidDriverOpts?} [opts=null]
+ * @returns {Promise<void>}
+ */
+async function resetApp(opts = null) {
+    const { app, appPackage, fastReset, fullReset, androidInstallTimeout = PACKAGE_INSTALL_TIMEOUT_MS, autoGrantPermissions, allowTestPackages, } = opts ?? this.opts;
+    if (!appPackage) {
+        throw new Error("'appPackage' option is required");
+    }
+    const isInstalled = await this.adb.isAppInstalled(appPackage);
+    if (isInstalled) {
         try {
-            await (0, asyncbox_1.waitForCondition)(async () => (await this.queryAppState(appId)) <= helpers_1.APP_STATE.NOT_RUNNING, { waitMs: timeout, intervalMs: 100 });
+            await this.adb.forceStop(appPackage);
         }
-        catch (e) {
-            this.log.errorAndThrow(`'${appId}' is still running after ${timeout}ms timeout`);
+        catch (ign) { }
+        // fullReset has priority over fastReset
+        if (!fullReset && fastReset) {
+            const output = await this.adb.clear(appPackage);
+            if (lodash_1.default.isString(output) && output.toLowerCase().includes('failed')) {
+                throw new Error(`Cannot clear the application data of '${appPackage}'. Original error: ${output}`);
+            }
+            // executing `shell pm clear` resets previously assigned application permissions as well
+            if (autoGrantPermissions) {
+                try {
+                    await this.adb.grantAllPermissions(appPackage);
+                }
+                catch (error) {
+                    this.log.error(`Unable to grant permissions requested. Original error: ${error.message}`);
+                }
+            }
+            this.log.debug(`Performed fast reset on the installed '${appPackage}' application (stop and clear)`);
+            return;
         }
-        this.log.info(`'${appId}' has been successfully terminated`);
-        return true;
-    },
-    async mobileTerminateApp(opts) {
-        const { appId } = (0, utils_1.requireArgs)('appId', opts);
-        return await this.terminateApp(appId, opts);
-    },
-    async installApp(appPath, opts) {
-        const localPath = await this.helpers.configureApp(appPath, APP_EXTENSIONS);
-        await this.adb.install(localPath, opts);
-    },
-    async mobileInstallApp(opts) {
-        const { appPath } = (0, utils_1.requireArgs)('appPath', opts);
-        return await this.installApp(appPath, opts);
-    },
-    async mobileClearApp(opts) {
-        const { appId } = (0, utils_1.requireArgs)('appId', opts);
-        await this.adb.clear(appId);
-    },
-};
-(0, mixins_1.mixin)(AppManagementMixin);
-exports.default = AppManagementMixin;
+    }
+    if (!app) {
+        throw new Error(`Either provide 'app' option to install '${appPackage}' or ` +
+            `consider setting 'noReset' to 'true' if '${appPackage}' is supposed to be preinstalled.`);
+    }
+    this.log.debug(`Running full reset on '${appPackage}' (reinstall)`);
+    if (isInstalled) {
+        await this.adb.uninstallApk(appPackage);
+    }
+    await this.adb.install(app, {
+        grantPermissions: autoGrantPermissions,
+        timeout: androidInstallTimeout,
+        allowTestPackages,
+    });
+}
+exports.resetApp = resetApp;
+async function installApk(opts = null) {
+    const { app, appPackage, fastReset, fullReset, androidInstallTimeout = PACKAGE_INSTALL_TIMEOUT_MS, autoGrantPermissions, allowTestPackages, enforceAppInstall, } = opts ?? this.opts;
+    if (!app || !appPackage) {
+        throw new Error("'app' and 'appPackage' options are required");
+    }
+    if (fullReset) {
+        await this.resetApp(opts);
+        return;
+    }
+    const { appState, wasUninstalled } = await this.adb.installOrUpgrade(app, appPackage, {
+        grantPermissions: autoGrantPermissions,
+        timeout: androidInstallTimeout,
+        allowTestPackages,
+        enforceCurrentBuild: enforceAppInstall,
+    });
+    // There is no need to reset the newly installed app
+    const isInstalledOverExistingApp = !wasUninstalled && appState !== this.adb.APP_INSTALL_STATE.NOT_INSTALLED;
+    if (fastReset && isInstalledOverExistingApp) {
+        this.log.info(`Performing fast reset on '${appPackage}'`);
+        await this.resetApp(opts);
+    }
+}
+exports.installApk = installApk;
+/**
+ * @this {AndroidDriver}
+ * @param {string[]} otherApps
+ * @param {import('../driver').AndroidDriverOpts?} [opts=null]
+ * @returns {Promise<void>}
+ */
+async function installOtherApks(otherApps, opts = null) {
+    const { androidInstallTimeout = PACKAGE_INSTALL_TIMEOUT_MS, autoGrantPermissions, allowTestPackages, } = opts ?? this.opts;
+    // Install all of the APK's asynchronously
+    await bluebird_1.default.all(otherApps.map((otherApp) => {
+        this.log.debug(`Installing app: ${otherApp}`);
+        return this.adb.installOrUpgrade(otherApp, undefined, {
+            grantPermissions: autoGrantPermissions,
+            timeout: androidInstallTimeout,
+            allowTestPackages,
+        });
+    }));
+}
+exports.installOtherApks = installOtherApks;
+/**
+ * @this {AndroidDriver}
+ * @param {string[]} appPackages
+ * @param {string[]} [filterPackages=[]]
+ * @returns {Promise<void>}
+ */
+async function uninstallOtherPackages(appPackages, filterPackages = []) {
+    if (appPackages.includes('*')) {
+        this.log.debug('Uninstall third party packages');
+        appPackages = await getThirdPartyPackages.bind(this)(filterPackages);
+    }
+    this.log.debug(`Uninstalling packages: ${appPackages}`);
+    await bluebird_1.default.all(appPackages.map((appPackage) => this.adb.uninstallApk(appPackage)));
+}
+exports.uninstallOtherPackages = uninstallOtherPackages;
+/**
+ * @this {AndroidDriver}
+ * @param {string[]} [filterPackages=[]]
+ * @returns {Promise<string[]>}
+ */
+async function getThirdPartyPackages(filterPackages = []) {
+    try {
+        const packagesString = await this.adb.shell(['pm', 'list', 'packages', '-3']);
+        const appPackagesArray = packagesString
+            .trim()
+            .replace(/package:/g, '')
+            .split(node_os_1.EOL);
+        this.log.debug(`'${appPackagesArray}' filtered with '${filterPackages}'`);
+        return lodash_1.default.difference(appPackagesArray, filterPackages);
+    }
+    catch (err) {
+        this.log.warn(`Unable to get packages with 'adb shell pm list packages -3': ${err.message}`);
+        return [];
+    }
+}
+exports.getThirdPartyPackages = getThirdPartyPackages;
 /**
- * @typedef {import('appium-adb').ADB} ADB
+ * @typedef {import('../driver').AndroidDriver} AndroidDriver
  */
 //# sourceMappingURL=app-management.js.map

package/build/lib/commands/app-management.js.map

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

package/build/lib/commands/appearance.d.ts

@@ -1,7 +1,20 @@
-export default AppearanceMixin;
 /**
- * @type {import('./mixins').AppearanceMixin & ThisType<import('../driver').AndroidDriver>}
- * @satisfies {import('@appium/types').ExternalDriver}
+ * Set the Ui appearance.
+ *
+ * @since Android 10
+ * @this {import('../driver').AndroidDriver}
+ * @property {import('./types').SetUiModeOpts}
+ * @returns {Promise<void>}
  */
-declare const AppearanceMixin: import('./mixins').AppearanceMixin & ThisType<import('../driver').AndroidDriver>;
+export function mobileSetUiMode(this: import("../driver").AndroidDriver, opts: any): Promise<void>;
+/**
+ * Get the Ui appearance.
+ *
+ * @since Android 10
+ * @this {import('../driver').AndroidDriver}
+ * @property {import('./types').GetUiModeOpts}
+ * @returns {Promise<string>} The actual state for the queried UI mode,
+ * for example 'yes' or 'no'
+ */
+export function mobileGetUiMode(this: import("../driver").AndroidDriver, opts: any): Promise<string>;
 //# sourceMappingURL=appearance.d.ts.map

package/build/lib/commands/appearance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../../../lib/commands/appearance.js"],"names":[],"mappings":";AAKA;;;GAGG;AACH,+BAHU,OAAO,UAAU,EAAE,eAAe,GAAG,SAAS,OAAO,WAAW,EAAE,aAAa,CAAC,CAgCxF"}
+{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../../../lib/commands/appearance.js"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,qFAFa,QAAQ,IAAI,CAAC,CAKzB;AAED;;;;;;;;GAQG;AACH,qFAHa,QAAQ,MAAM,CAAC,CAY3B"}