appium-android-driver 7.8.3 → 8.0.0

package/CHANGELOG.md

@@ -1,3 +1,28 @@
+## [8.0.0](https://github.com/appium/appium-android-driver/compare/v7.8.3...v8.0.0) (2024-01-24)
+
+
+### ⚠ BREAKING CHANGES
+
+* Removed androidHelpers export. Corresponding methods are now integrated into the driver
+* Removed webviewHelpers export. Corresponding methods are now integrated into the driver
+* Removed redundant exports related to io.appium.settings.
+* Removed deprecated APIs related to launchApp/closeApp/reset
+* Removed the unused unlocker property from the driver.
+
+The mixin typesystem has been aligned. There are no explicit mixin definitions, which basically duplicate each method signature. Instead all types are now provided next to method definitions.
+
+Improved grouping of different commands. Made it more explicit which of them are designed for export and which are just internal helpers
+
+Improved helper methods design, so they don't need to retrieve driver-specific properties (like log or adb) via command line args, but use this context and explicit binding instead.
+
+Marked legacy JWP touch-related methods as deprecated. They must be eventually replaced with proper W3C implementations.
+
+Removed unused declarations for non-implemented methods.
+
+### Code Refactoring
+
+* Isolate base Android functionality ([#901](https://github.com/appium/appium-android-driver/issues/901)) ([70e6233](https://github.com/appium/appium-android-driver/commit/70e623352f3c547535598951e294100d49e81826))
+
 ## [7.8.3](https://github.com/appium/appium-android-driver/compare/v7.8.2...v7.8.3) (2024-01-22)
 
 

package/build/lib/commands/app-management.d.ts

@@ -1,8 +1,132 @@
-export default AppManagementMixin;
-export type ADB = import('appium-adb').ADB;
 /**
- * @type {import('./mixins').AppManagementMixin & ThisType<import('../driver').AndroidDriver>}
- * @satisfies {import('@appium/types').ExternalDriver}
+ * @this {AndroidDriver}
+ * @param {string} appId
+ * @returns {Promise<boolean>}
  */
-declare const AppManagementMixin: import('./mixins').AppManagementMixin & ThisType<import('../driver').AndroidDriver>;
+export function isAppInstalled(this: import("../driver").AndroidDriver, appId: string): Promise<boolean>;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').IsAppInstalledOpts} opts
+ * @returns {Promise<boolean>}
+ */
+export function mobileIsAppInstalled(this: import("../driver").AndroidDriver, opts: import('./types').IsAppInstalledOpts): Promise<boolean>;
+/**
+ * @this {AndroidDriver}
+ * @param {string} appId
+ * @returns {Promise<import('./types').AppState>}
+ */
+export function queryAppState(this: import("../driver").AndroidDriver, appId: string): Promise<import('./types').AppState>;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').QueryAppStateOpts} opts
+ * @returns {Promise<import('./types').AppState>}
+ */
+export function mobileQueryAppState(this: import("../driver").AndroidDriver, opts: import('./types').QueryAppStateOpts): Promise<import('./types').AppState>;
+/**
+ * @this {AndroidDriver}
+ * @param {string} appId
+ * @returns {Promise<void>}
+ */
+export function activateApp(this: import("../driver").AndroidDriver, appId: string): Promise<void>;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').ActivateAppOpts} opts
+ * @returns {Promise<void>}
+ */
+export function mobileActivateApp(this: import("../driver").AndroidDriver, opts: import('./types').ActivateAppOpts): Promise<void>;
+/**
+ * @this {AndroidDriver}
+ * @param {string} appId
+ * @param {Omit<import('appium-adb').UninstallOptions, 'appId'>} opts
+ * @returns {Promise<boolean>}
+ */
+export function removeApp(this: import("../driver").AndroidDriver, appId: string, opts?: Omit<import('appium-adb').UninstallOptions, 'appId'>): Promise<boolean>;
+/**
+ * @this {import('../driver').AndroidDriver}
+ * @param {import('./types').RemoveAppOpts} opts
+ * @returns {Promise<boolean>}
+ */
+export function mobileRemoveApp(this: import("../driver").AndroidDriver, opts: import('./types').RemoveAppOpts): Promise<boolean>;
+/**
+ * @this {AndroidDriver}
+ * @param {string} appId
+ * @param {Omit<import('./types').TerminateAppOpts, 'appId'>} [options={}]
+ * @returns {Promise<boolean>}
+ */
+export function terminateApp(this: import("../driver").AndroidDriver, appId: string, options?: Omit<import("./types").TerminateAppOpts, "appId"> | undefined): Promise<boolean>;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').TerminateAppOpts} opts
+ * @returns {Promise<boolean>}
+ */
+export function mobileTerminateApp(this: import("../driver").AndroidDriver, opts: import('./types').TerminateAppOpts): Promise<boolean>;
+/**
+ * @this {AndroidDriver}
+ * @param {string} appPath
+ * @param {Omit<import('appium-adb').InstallOptions, 'appId'>} opts
+ * @returns {Promise<void>}
+ */
+export function installApp(this: import("../driver").AndroidDriver, appPath: string, opts: Omit<import('appium-adb').InstallOptions, 'appId'>): Promise<void>;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').InstallAppOpts} opts
+ * @returns {Promise<void>}
+ */
+export function mobileInstallApp(this: import("../driver").AndroidDriver, opts: import('./types').InstallAppOpts): Promise<void>;
+/**
+ * @this {AndroidDriver}
+ * @param {import('./types').ClearAppOpts} opts
+ * @returns {Promise<void>}
+ */
+export function mobileClearApp(this: import("../driver").AndroidDriver, opts: import('./types').ClearAppOpts): Promise<void>;
+/**
+ * @this {AndroidDriver}
+ * @returns {Promise<string>}
+ */
+export function getCurrentActivity(this: import("../driver").AndroidDriver): Promise<string>;
+/**
+ * @this {AndroidDriver}
+ * @returns {Promise<string>}
+ */
+export function getCurrentPackage(this: import("../driver").AndroidDriver): Promise<string>;
+/**
+ * @this {AndroidDriver}
+ * @param {number} seconds
+ * @returns {Promise<string|true>}
+ */
+export function background(this: import("../driver").AndroidDriver, seconds: number): Promise<string | true>;
+/**
+ * @this {AndroidDriver}
+ * @param {import('../driver').AndroidDriverOpts?} [opts=null]
+ * @returns {Promise<void>}
+ */
+export function resetApp(this: import("../driver").AndroidDriver, opts?: import("../driver").AndroidDriverOpts | null | undefined): Promise<void>;
+export function installApk(opts?: null): Promise<void>;
+/**
+ * @this {AndroidDriver}
+ * @param {string[]} otherApps
+ * @param {import('../driver').AndroidDriverOpts?} [opts=null]
+ * @returns {Promise<void>}
+ */
+export function installOtherApks(this: import("../driver").AndroidDriver, otherApps: string[], opts?: import("../driver").AndroidDriverOpts | null | undefined): Promise<void>;
+/**
+ * @this {AndroidDriver}
+ * @param {string[]} appPackages
+ * @param {string[]} [filterPackages=[]]
+ * @returns {Promise<void>}
+ */
+export function uninstallOtherPackages(this: import("../driver").AndroidDriver, appPackages: string[], filterPackages?: string[] | undefined): Promise<void>;
+/**
+ * @this {AndroidDriver}
+ * @param {string[]} [filterPackages=[]]
+ * @returns {Promise<string[]>}
+ */
+export function getThirdPartyPackages(this: import("../driver").AndroidDriver, filterPackages?: string[] | undefined): Promise<string[]>;
+export namespace APP_STATE {
+    let NOT_INSTALLED: 0;
+    let NOT_RUNNING: 1;
+    let RUNNING_IN_BACKGROUND: 3;
+    let RUNNING_IN_FOREGROUND: 4;
+}
+export type AndroidDriver = import('../driver').AndroidDriver;
 //# sourceMappingURL=app-management.d.ts.map

package/build/lib/commands/app-management.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-management.d.ts","sourceRoot":"","sources":["../../../lib/commands/app-management.js"],"names":[],"mappings":";kBA8Ka,OAAO,YAAY,EAAE,GAAG;AAlKrC;;;GAGG;AACH,kCAHU,OAAO,UAAU,EAAE,kBAAkB,GAAG,SAAS,OAAO,WAAW,EAAE,aAAa,CAAC,CA0J3F"}
+{"version":3,"file":"app-management.d.ts","sourceRoot":"","sources":["../../../lib/commands/app-management.js"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,+EAHW,MAAM,GACJ,QAAQ,OAAO,CAAC,CAI5B;AAED;;;;GAIG;AACH,oFAHW,OAAO,SAAS,EAAE,kBAAkB,GAClC,QAAQ,OAAO,CAAC,CAK5B;AAED;;;;GAIG;AACH,8EAHW,MAAM,GACJ,QAAQ,OAAO,SAAS,EAAE,QAAQ,CAAC,CAiB/C;AAED;;;;GAIG;AACH,mFAHW,OAAO,SAAS,EAAE,iBAAiB,GACjC,QAAQ,OAAO,SAAS,EAAE,QAAQ,CAAC,CAK/C;AAED;;;;GAIG;AACH,4EAHW,MAAM,GACJ,QAAQ,IAAI,CAAC,CAsDzB;AAED;;;;GAIG;AACH,iFAHW,OAAO,SAAS,EAAE,eAAe,GAC/B,QAAQ,IAAI,CAAC,CAKzB;AAED;;;;;GAKG;AACH,0EAJW,MAAM,SACN,KAAK,OAAO,YAAY,EAAE,gBAAgB,EAAE,OAAO,CAAC,GAClD,QAAQ,OAAO,CAAC,CAI5B;AAED;;;;GAIG;AACH,+EAHW,OAAO,SAAS,EAAE,aAAa,GAC7B,QAAQ,OAAO,CAAC,CAK5B;AAED;;;;;GAKG;AACH,6EAJW,MAAM,4EAEJ,QAAQ,OAAO,CAAC,CAgC5B;AAED;;;;GAIG;AACH,kFAHW,OAAO,SAAS,EAAE,gBAAgB,GAChC,QAAQ,OAAO,CAAC,CAK5B;AAED;;;;;GAKG;AACH,6EAJW,MAAM,QACN,KAAK,OAAO,YAAY,EAAE,cAAc,EAAE,OAAO,CAAC,GAChD,QAAQ,IAAI,CAAC,CAKzB;AAED;;;;GAIG;AACH,gFAHW,OAAO,SAAS,EAAE,cAAc,GAC9B,QAAQ,IAAI,CAAC,CAKzB;AAED;;;;GAIG;AACH,8EAHW,OAAO,SAAS,EAAE,YAAY,GAC5B,QAAQ,IAAI,CAAC,CAKzB;AAED;;;GAGG;AACH,6EAFa,QAAQ,MAAM,CAAC,CAI3B;AAED;;;GAGG;AACH,4EAFa,QAAQ,MAAM,CAAC,CAI3B;AAED;;;;GAIG;AACH,6EAHW,MAAM,GACJ,QAAQ,MAAM,GAAC,IAAI,CAAC,CAyEhC;AAED;;;;GAIG;AACH,oIAFa,QAAQ,IAAI,CAAC,CA8DzB;AAED,uDAmCC;AAED;;;;;GAKG;AACH,qFAJW,MAAM,EAAE,oEAEN,QAAQ,IAAI,CAAC,CAoBzB;AAED;;;;;GAKG;AACH,6FAJW,MAAM,EAAE,0CAEN,QAAQ,IAAI,CAAC,CAUzB;AAED;;;;GAIG;AACH,uHAFa,QAAQ,MAAM,EAAE,CAAC,CAe7B;;;;;;;4BAGY,OAAO,WAAW,EAAE,aAAa"}