About TestComplete Android Agent Keyboard

TestComplete Android Agent includes the TestComplete Android Agent keyboard. If this keyboard is active, a tested Android device does not show its onscreen keyboard when text boxes get focus. Instead, it uses the invisible onscreen Agent keyboard for the text input.

Installing the Agent Keyboard

When to Use the Agent Keyboard

Setting the Agent Keyboard as the Default Keyboard

Activating and Deactivating the Agent Keyboard From Tests

The TestComplete Android Agent keyboard is installed when TestComplete installs the Android Agent on your device. See About TestComplete Android Agent.

We recommend that you use the Agent keyboard:

• To record and simulate user input in your tested applications. See Simulating Local Symbol Input.

• To simulate user input in controls located on a WebView control. Otherwise, TestComplete may fail to correctly determine the coordinates of subsequent user actions. To learn more, see the Keyboard Input Issues section in the Possible Issues With Android Applications topic.

• To record user input in Xamarin.Forms applications running on Android devices. Otherwise, TestComplete may fail to record the user input for some text edit controls. See the Known Issues section in the About Xamarin.Forms Application Testing topic.

To make the TestComplete Android Agent keyboard the default keyboard on your test device:

1. Install the TestComplete Android Agent application on the device, if it is not installed yet.

2. Open the Agent.

3. Select Enable the Android Agent Keyboard.

   Note:

   Android 5.1.1 (and later) asks for your confirmation to use the new keyboard (the input method). Select OK to confirm.

4. Select TestComplete Android Agent in the Keyboard & Input Methods section. Select OK in the subsequent window and press Back.

5. Select Make the Agent Keyboard Default.

6. Select the multilingual keyboard emulator. The dialog will close automatically.

7. Exit the Agent application by pressing Back or Home.

To enable the Agent keyboard from your test:

To disable the Agent keyboard, use this code: