Skip to content

2.7 Android Mobile assistant function (trial)

In order to facilitate Android users to perform some ADB-related operations, we have added an Android phone assistant function.After connected to the phone , click the tool icon in the upper right corner of the device window, in the expand drop-down menu, select Show assistant dialog to open the Android phone assistant.



In the Android Phone Assistant, we offer the following features:

  • Mobile app install/uninstall/view list
  • Common shortcuts: open URL, input text, switch input method, volume adjustment, etc.
  • Shell Debug Window on the phone


At present, the Android mobile assistant function is still in the testing stage. If there is a BUG, please feedback the operation steps, mobile phone model, Android version number and error log to Github.

1. App management function

Install Apk from your computer to your phone

At present, you can directly click the install button on the Android Assistant and select the apk file on the PC to open the installation window.Clicking on the Install button will start trying to install apk on your phone. Please note that the phone is clicked to agree to the installation.


In addition, directly drag the apk file to the screen of the current mobile phone, after releasing the mouse button, you can also open the installation window to install.

view Mobile app list

The list of apps installed on the current phone is displayed in the list on the left side of the Android assistant. You can enter keywords in the search box to filter the list.Checking Only show third party applications will only show third-party apps on your phone, making the list more streamlined.


Quick operation of mobile apps

In the lower right corner of the Android assistant is a series of shortcut buttons for mobile applications, which can be used to start, close, uninstall, clean and backup the selected applications in the left list.


Before clicking the operation such as stop start clear, make sure that the package name displayed in the current Package column is the corresponding package name you want to operate.Click the refresh button to refresh and display the package information in the phone's current startup.

2. Common shortcuts for mobile phones

Open URL and quick input

Enter the URL in the input box in the top right corner and click open to open the URL using your current default browser.Enter the text content and click input to enter it on your phone.

Fast switching input method

In the IME Manager drop-down menu, you can quickly switch the current input method of the phone. The default input method used in airtest is the yosemite input method, which is not convenient when switching back to manual use. Now you can directly check the switch input method in this drop-down menu.


Common shortcuts

Quick Button provides operations such as unlock, power, and a snapshot to immediately capture a picture of the current phone screen and select the path to save to the computer.

Volumn Setting provides shortcuts for mute , volumn_down , and volumn_up .

3. Shell Debug Window on the phone

Occasionally we need to do some ADB operations on the Android phone, or connect to the ADB shell to view some mobile phone related information. Currently, you can switch to the Remote Debug page in the Android phone assistant, and you can directly input the adb shell command.


As shown in the figure, you don't need to enter adb shell.You only need to input subsequent instructions and you can see the corresponding return result.So there is no need to use the command line to connect to ADB SHELL.

The Clear log button clears the log in the current window. Export log to a file can export the information in the current log window to a text file.

Please note that this function is still in the trial phase, some shell commands please Do not enter , such as top, this will appear repeatedly brushing the command.

4. TV App Shortcut Buttons

Some TV version apps, and some special device applications, may need to use the up, down, left and right direction keys + confirmation key to operate. To meet such needs, we have added a small function of the TV version button:


After successfully connecting to the device, click the shortcut menu button in the upper right corner and select Show TV Buttons in the pop-up window to open the TV button:


Use it to quickly click the up, down, left, right, and + confirm buttons. The corresponding ADB instructions are:

adb shell input keyevent KEYCODE_DPAD_UP
adb shell input keyevent KEYCODE_DPAD_DOWN
adb shell input keyevent KEYCODE_DPAD_LEFT
adb shell input keyevent KEYCODE_DPAD_RIGHT
adb shell input keyevent ENTER