You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/appium-install-uninstall-hook.md
+14-25Lines changed: 14 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -47,15 +47,15 @@ import TabItem from '@theme/TabItem';
47
47
48
48
## Introduction
49
49
50
-
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.
50
+
LambdaTest now allows you to install and uninstall apps in the middle of your automated tests. This means you don’t need to restart the session every time you want to switch apps, upgrade them, or clean up the device.
51
51
52
52
## Installing and Uninstalling Apps
53
53
54
-
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.
54
+
LambdaTest enables you to install and uninstall applications during automation test execution by using commands that can be run through WebDriver's script execution functionality.
55
55
56
56
### Install App
57
57
58
-
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.
58
+
You can install apps uploaded to the LambdaTest platform directly within your automation scripts using the `lambda-install-app`command followed by the app’s ID. This ID can be either the LambdaTest-generated ID or a custom ID assigned during upload.
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 :
77
+
Testing app upgrades is important because users often update to the latest version instead of reinstalling the app. To ensure existing user data is preserved and the app continues to function properly after an upgrade, you can use the following hooks:
78
78
79
79
**Python example:**
80
80
@@ -137,37 +137,26 @@ data = {
137
137
</Tabs>
138
138
139
139
140
-
141
-
142
140
## Validation Errors
143
141
144
142
You might encounter some errors while using these features. The following are some common validation errors and their meaning:
145
143
146
-
-**App URL is empty while using the install app command:**
147
-
148
-
`No app_url has been provided for lambda-install-app. Please check and try again.`
149
-
150
-
-**App URL does not belong to the user while using the install app command:**
151
-
152
-
`The app provided for lambda-install-app is not accessible. Please check and try again.`
153
-
154
-
-**App details are not found while using the install app command:**
|`No app_url has been provided for lambda-install-app. Please check and try again.`| The install command is missing the app URL or ID. |
147
+
|`The app provided for lambda-install-app is not accessible. Please check and try again.`| The app ID does not belong to your account or is inaccessible. |
148
+
|`Failed to fetch app details.`| The app ID is invalid or app is not found. |
149
+
|`Failed to install the app using lambda-install-app.`| Installation failed due to compatibility or other issues. |
150
+
|`No app package or app bundle id has been provided for lambda-uninstall-app. Please check and try again.`| The uninstall command is missing the app package or bundle ID. |
151
+
|`Failed to uninstall the app using lambda-uninstall-app.`| Uninstallation failed; app may not be installed or wrong ID.|
159
152
160
-
`Failed to install the app using lambda-install-app.`
161
153
162
-
-**App package is empty while using the uninstall app command:**
163
154
164
-
`No app package or app bundle id has been provided for lambda-uninstall-app. Please check and try again.`
155
+
Multiple errors may occur based on the scenario. Understanding these errors will help you identify and resolve issues more efficiently, ensuring smooth test execution. Once the code snippets are added, the tests can be executed and will appear on the[LambdaTest App Automation Dashboard](https://appautomation.lambdatest.com/build).
165
156
166
-
-**App package uninstallation fails:**
167
157
168
-
`Failed to uninstall the app using lambda-uninstall-app.`
158
+
> **Note:** If the user had enabled any of the following capabilities in the previously installed app, they will remain available and functional in the upgraded app as well : `EnableScreenshotUnblock`,`EnableImageInjection`,`EnableVideoInjection`,`Network`,`AppProfiling`,`EnableWebContentsDebugging`,`EnableBiometricInjection`.This ensures that key testing features continue to work seamlessly after the app is updated, without requiring additional configuration.
169
159
170
-
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](https://appautomation.lambdatest.com/build).
0 commit comments