UNPKG

appium-android-driver

Version:

Android UiAutomator and Chrome support for Appium

117 lines 7.54 kB
import type { AndroidDriver } from '../driver'; /** * Starts an Android activity. * * @deprecated Use {@link mobileStartActivity} instead. * @param appPackage The package name of the application to start. * @param appActivity The activity name to start. * @param appWaitPackage The package name to wait for. Defaults to `appPackage` if not provided. * @param appWaitActivity The activity name to wait for. Defaults to `appActivity` if not provided. * @param intentAction The intent action to use. * @param intentCategory The intent category to use. * @param intentFlags The intent flags to use. * @param optionalIntentArguments Optional intent arguments. * @param dontStopAppOnReset If `true`, does not stop the app on reset. If not provided, uses the capability value. * @returns Promise that resolves when the activity is started. */ export declare function startActivity(this: AndroidDriver, appPackage: string, appActivity: string, appWaitPackage?: string, appWaitActivity?: string, intentAction?: string, intentCategory?: string, intentFlags?: string, optionalIntentArguments?: string, dontStopAppOnReset?: boolean): Promise<void>; /** * Starts an Android activity using the activity manager. * * @param wait Set it to `true` if you want to block the method call * until the activity manager's process returns the control to the system. * `false` by default. * @param stop Set it to `true` to force stop the target * app before starting the activity. `false` by default. * @param windowingMode The windowing mode to launch the activity into. * Check https://android.googlesource.com/platform/frameworks/base/+/master/core/java/android/app/WindowConfiguration.java * for more details on possible windowing modes (constants starting with `WINDOWING_MODE_`). * @param activityType The activity type to launch the activity as. * Check https://android.googlesource.com/platform/frameworks/base/+/master/core/java/android/app/WindowConfiguration.java * for more details on possible activity types (constants starting with `ACTIVITY_TYPE_`). * @param display The display identifier to launch the activity into. * @param user The user ID for which the activity is started. * @param intent The name of the activity intent to start, for example * `com.some.package.name/.YourActivitySubClassName`. * @param action Action name. * @param pkg Package name. * @param uri Unified resource identifier. * @param mimeType Mime type. * @param identifier Optional identifier. * @param component Component name. * @param categories One or more category names. * @param extras Optional intent arguments. Must be represented as array of arrays, * where each subarray item contains two or three string items: value type, key name and the value itself. * See {@link IntentOpts} for supported value types. * @param flags Intent startup-specific flags as a hexadecimal string. * @returns Promise that resolves to the command output string. */ export declare function mobileStartActivity(this: AndroidDriver, wait?: boolean, stop?: boolean, windowingMode?: string | number, activityType?: string | number, display?: number | string, user?: string, intent?: string, action?: string, pkg?: string, uri?: string, mimeType?: string, identifier?: string, component?: string, categories?: string | string[], extras?: string[][], flags?: string): Promise<string>; /** * Sends a broadcast intent to the Android system. * * @param receiverPermission Require receiver to hold the given permission. * @param allowBackgroundActivityStarts Whether the receiver may start activities even if in the background. * @param user The user ID for which the broadcast is sent. * The `current` alias assumes the current user ID. `all` by default. * @param intent The name of the activity intent to broadcast, for example * `com.some.package.name/.YourServiceSubClassName`. * @param action Action name. * @param pkg Package name. * @param uri Unified resource identifier. * @param mimeType Mime type. * @param identifier Optional identifier. * @param component Component name. * @param categories One or more category names. * @param extras Optional intent arguments. Must be represented as array of arrays, * where each subarray item contains two or three string items: value type, key name and the value itself. * See {@link IntentOpts} for supported value types. * @param flags Intent startup-specific flags as a hexadecimal string. * @returns Promise that resolves to the command output string. */ export declare function mobileBroadcast(this: AndroidDriver, receiverPermission?: string, allowBackgroundActivityStarts?: boolean, user?: string | number, intent?: string, action?: string, pkg?: string, uri?: string, mimeType?: string, identifier?: string, component?: string, categories?: string | string[], extras?: string[][], flags?: string): Promise<string>; /** * Starts an Android service. * * @param foreground Set it to `true` if your service must be started as foreground service. * This option is ignored if the API level of the device under test is below 26 (Android 8). * @param user The user ID for which the service is started. * The `current` user id is used by default. * @param intent The name of the activity intent to start, for example * `com.some.package.name/.YourServiceSubClassName`. * @param action Action name. * @param pkg Package name. * @param uri Unified resource identifier. * @param mimeType Mime type. * @param identifier Optional identifier. * @param component Component name. * @param categories One or more category names. * @param extras Optional intent arguments. Must be represented as array of arrays, * where each subarray item contains two or three string items: value type, key name and the value itself. * See {@link IntentOpts} for supported value types. * @param flags Intent startup-specific flags as a hexadecimal string. * @returns Promise that resolves to the command output string. */ export declare function mobileStartService(this: AndroidDriver, foreground?: boolean, user?: string, intent?: string, action?: string, pkg?: string, uri?: string, mimeType?: string, identifier?: string, component?: string, categories?: string | string[], extras?: string[][], flags?: string): Promise<string>; /** * Stops an Android service. * * @param user The user ID for which the service is stopped. * @param intent The name of the activity intent to stop, for example * `com.some.package.name/.YourServiceSubClassName`. * @param action Action name. * @param pkg Package name. * @param uri Unified resource identifier. * @param mimeType Mime type. * @param identifier Optional identifier. * @param component Component name. * @param categories One or more category names. * @param extras Optional intent arguments. Must be represented as array of arrays, * where each subarray item contains two or three string items: value type, key name and the value itself. * See {@link IntentOpts} for supported value types. * @param flags Intent startup-specific flags as a hexadecimal string. * @returns Promise that resolves to the command output string. * If the service was already stopped, returns the error message. */ export declare function mobileStopService(this: AndroidDriver, user?: string, intent?: string, action?: string, pkg?: string, uri?: string, mimeType?: string, identifier?: string, component?: string, categories?: string | string[], extras?: string[][], flags?: string): Promise<string>; //# sourceMappingURL=intent.d.ts.map