 |
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 LaunchPackage method starts the default activity for the package that is specified as the method’s parameter.
Declaration
PackageManagerObj.LaunchPackage(Package)
| PackageManagerObj | An expression, variable or parameter that specifies a reference to a PackageManager object | |||
| Package | [in] | Required | The PackageObject object. |
|
| Result | Boolean | |||
Applies To
The method is applied to the following object:
Parameters
The method has the following parameter:
Package
Specifies the PackageObject object that corresponds to the package whose default activity you want to start.
Result Value
Returns True if the activity has been launched successfully, and False otherwise.
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
InstallPackage Method
IsActivePackage Method
PackageManager Object