PackageObject Object

Applies to TestComplete 15.47, last modified on January 20, 2023
The information below concerns legacy mobile tests that work with mobile devices connected to the local computer. For new mobile tests, we recommend using the newer cloud-compatible approach.

Description

The PackageObject object corresponds to an Android application package. You can use this object to install and launch the default activity for a package or remove a package. For this purpose, pass it as a parameter to the InstallPackage, LaunchPackage and RemovePackage methods respectively.

The PackageObject object is returned by the GetPackageFromAPK and GetInstalledPackageByName methods and by the InstalledPackage property of the PackageManager object.

In order for TestComplete to be able to provide access to an Android device, the device should be connected to Android Debug Bridge.

Members

Example

The code below obtains the PackageObject object that corresponds to the specified package file (*.apk), installs this package on the device, launches the default activity for the package and then removes the package from the device:

JavaScript, JScript

function Test()
{
  // Obtain the PackageObject object
  var DeviceObj = Mobile.Device("VirtualBox");
  var PackManagerObj = DeviceObj.PackageManager;
  var PackObj = PackManagerObj.GetPackageFromAPK("C:\\Work\\MyPackage.apk");
  // Install the package
  PackManagerObj.InstallPackage(PackObj);
  // Launch the default activity for the package
  PackManagerObj.LaunchPackage(PackObj);
  // Remove the package
  PackManagerObj.RemovePackage(PackObj);
}

Python

def Test():
  # Obtain the PackageObject object
  DeviceObj = Mobile.Device("VirtualBox")
  PackManagerObj = DeviceObj.PackageManager
  PackObj = PackManagerObj.GetPackageFromAPK("C:\\Work\\MyPackage.apk")
  # Install the package
  PackManagerObj.InstallPackage(PackObj)
  # Launch the default activity for the package
  PackManagerObj.LaunchPackage(PackObj)
  # Remove the package
  PackManagerObj.RemovePackage(PackObj)

VBScript

Sub Test
  ' Obtain the PackageObject object
  Set DeviceObj = Mobile.Device("VirtualBox")
  Set PackManagerObj = DeviceObj.PackageManager
  Set PackObj = PackManagerObj.GetPackageFromAPK("C:\Work\MyPackage.apk")
  ' Install the package
  PackManagerObj.InstallPackage(PackObj)
  ' Launch the default activity for the package
  PackManagerObj.LaunchPackage(PackObj)
  ' Remove the package
  PackManagerObj.RemovePackage(PackObj)
End Sub

DelphiScript

function Test;
var DeviceObj, PackManagerObj, PackObj: OleVariant;
begin
  // Obtain the PackageObject object
  DeviceObj := Mobile.Device('VirtualBox');
  PackManagerObj := DeviceObj.PackageManager;
  PackObj := PackManagerObj.GetPackageFromAPK('C:\Work\MyPackage.apk');
  // Install the package
  PackManagerObj.InstallPackage(PackObj);
  // Launch the default activity for the package
  PackManagerObj.LaunchPackage(PackObj);
  // Remove the package
  PackManagerObj.RemovePackage(PackObj);
end;

C++Script, C#Script

function Test()
{
  // Obtain the PackageObject object
  var DeviceObj = Mobile["Device"]("VirtualBox");
  var PackManagerObj = DeviceObj["PackageManager"];
  var PackObj = PackManagerObj["GetPackageFromAPK"]("C:\\Work\\MyPackage.apk");
  // Install the package
  PackManagerObj["InstallPackage"](PackObj);
  // Launch the default activity for the package
  PackManagerObj["LaunchPackage"](PackObj);
  // Remove the package
  PackManagerObj["RemovePackage"](PackObj);
}

See Also

GetPackageFromAPK Method
GetInstalledPackageByName Method
InstalledPackage Property
InstallPackage Method
RemovePackage Method

Highlight search results