get app performance information

Description

Return the current performance information of an application running on the test device.

Arguments

• package name

  APK name of the application of interest.

• cpu usage

  Variable to hold returned current CPU usage of the application process.

• memory

  Variable to hold returned current memory usage of the application process.

Valid contexts

This action may be used within the following project items: test modules and user-defined actions.

Applicable Systems/Platforms

Use of this action is supported on the following systems/platforms: Android.

Notes

• If the variables in argumentscpu usage and memoryhave not been declared, the action creates them as globals.
• On an Android device, to retrieve the package name for an application, do the following:

  1. Open the Android Instrumentation Tool dialog box.

  2. In the Application Under Test panel, right-click the appropriate application, and then select Copy package name.
     
     

  3. In the test editor, paste the copied value into the package name argument of the built-in action.

• This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Applicable Built-In Settings

The following settings are applicable to this action: remove double quotes from cells, standard ASCII only.

Example

Let’s say you wish to obtain the current performance information of two applications running on the test device:

Action Lines

Result