Ability to Install and Uninstall Apps in App Automation Scripts

Introduction

LambdaTest has introduced features that allow users to install and uninstall specified applications within app automation scripts. This document outlines the usage and provides examples of these features.

Installing and Uninstalling Apps

LambdaTest supports commands that allow you to install or uninstall apps during the execution of an automation test. These commands can be executed using the script execution functionality of the WebDriver.

Install App

You can install apps that have been uploaded to the LambdaTest platform within your automation scripts. To install an app, use the command lambda-install-app followed by the app's ID. The ID can either be the LambdaTest-generated app ID or a custom ID provided while uploading the app.

Python example:

driver.execute_script("lambda-install-app=myApp")
driver.execute_script("lambda-install-app=lt://APP100000000123456789123456789")

Uninstall App

You can uninstall apps during the execution of an automation test using the command lambda-uninstall-app followed by the app's package name (for Android apps) or bundle ID (for iOS apps).

Python example:

driver.execute_script("lambda-uninstall-app=com.myApp.beta")
driver.execute_script("lambda-uninstall-app=com.apple.myApp")

Test App Upgrades with Hooks

Testing app upgrades is vital because new app versions are frequently delivered to users. Users upgrade to the latest app version rather than performing a fresh installation. During these upgrades, existing user data may need to be migrated to ensure the app functions correctly.You can use the below hooks for the same :

Python example:

Android

# Payload required to retain app data while uninstalling it
data = {
  "appPackage": "sampleapp.android.app",
  "retainData": True
}

driver.execute_script("lambda-uninstall-app", data)

# Payload required to reuse data of the old app while installing the new one
data = {
  "appUrl": "lt://APPID",
  "retainData": True
}
driver.execute_script("lambda-install-app", data)

iOS

# Send the current app in background
driver.background_app(-1)


# Payload required while installing the new upgrade 
data = {
  "appUrl": "lt://APPID",
  "retainData": True
}
driver.execute_script("lambda-install-app", data)

# Note : In case of enterprise app, user have to pass the below payload 
data = {
  "appUrl": "lt://APPID",
  "resignApp": False,
  "retainData": True
}

Validation Errors

You might encounter some errors while using these features. The following are some common validation errors and their meaning:

• App URL is empty while using the install app command:

  No app_url has been provided for lambda-install-app. Please check and try again.

• App URL does not belong to the user while using the install app command:

  The app provided for lambda-install-app is not accessible. Please check and try again.

• App details are not found while using the install app command:

  Failed to fetch app details.

• App installation fails:

  Failed to install the app using lambda-install-app.

• App package is empty while using the uninstall app command:

  No app package or app bundle id has been provided for lambda-uninstall-app. Please check and try again.

• App package uninstallation fails:

  Failed to uninstall the app using lambda-uninstall-app.

Multiple options can be selected. By understanding these errors, you can debug issues faster and ensure smooth execution of your tests. Once you have added the code snippet, the tests can be executed and will be visible on the LambdaTest App Automation Dashboard.