About TestComplete Android Agent

General Information

Installing Android Agent

Android Agent GUI

Uninstalling Android Agent

TestComplete Android Agent is part of the TestComplete software package that is installed on Android devices.

When the Agent is installed on a device, it runs as a service and provides helper functionality for the following tasks:

• Exchanging data with Android Open applications. See Instrumenting Android Applications - Overview.

• Simulating input of local (national) symbols. See Simulating Local Symbol Input.

• Retrieving data from the built-in sensors of the device. See Getting Data From Mobile Device Sensors.

• Retrieving and emulating data obtained from the GPS receiver of the device. See Geolocation Testing.

Important Notes:

• In order for the Android Agent to be able to work on the device, emulator or virtual machine, it must have 512 MB of RAM or more.

• To test Android Open Applications, you must have TestComplete Android Agent installed on your device. Otherwise, TestComplete will not be able to recognize the controls of your Open Application correctly.

To install the Agent:

• Connect to the tested Android device.

• Open the Mobile Screen window.

  If the Agent is not installed on the connected device, TestComplete displays a notification at the top of the Mobile Screen window suggesting to install the Agent.

• Click the Enable link in the notification.

  -- or --

  Press the Install Android Agent button on the toolbar.

Alternatively, you can deploy the Android Agent to the device manually. The Agent’s .apk file resides in the TestComplete installation folder. The full path is <TestComplete 14>\Bin\Extensions\Android\AndroidAgent.apk, where <TestComplete 14> is the TestComplete installation folder.

To deploy a package from tests, you can use the Install Package operation or the following script:

def InstallAgent():
  AgentApkPath = "<TestComplete 11>\\Bin\\Extensions\\Android\\AndroidAgent.apk";
  Agent = Mobile.Device().PackageManager.GetPackageFromAPK(AgentApkPath);
  Mobile.Device().PackageManager.InstallPackage(Agent);

For more information about installation packages on the device, see Installing Packages on Devices.

When the Agent is installed and is running, it displays its icon in the notification area of the main Android screen.

To open the Android Agent GUI:

• Expand the notification drawer of the main Android screen.

• Touch the Android Agent notification.

-- or --

• Touch Android Agent in the Apps list of the Android launcher.

From the Android Agent user interface, you can quickly access the Android device's settings that are important for application testing with TestComplete.

When the testing is over, remember to restore the default values of these settings.

If you no longer need the Android Agent, you can uninstall it as any other Android application:

• Go to Settings | Apps screen on the mobile device.

• Touch the Android Agent application in the list.

• Press the Uninstall button in the ensuing App Info screen.