appium-android-driver
Version:
Android UiAutomator and Chrome support for Appium
117 lines • 7.54 kB
TypeScript
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