Skip to content

Commit 9131561

Browse files
authored
Merge pull request #2063 from Ishavyas9/main
device-passcode-appautomation doc updated
2 parents a62e09a + 6e59df6 commit 9131561

File tree

3 files changed

+72
-42
lines changed

3 files changed

+72
-42
lines changed
98.2 KB
Loading

docs/device-passcode-appautomation.md

Lines changed: 45 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
id: device-passcode-appautomation
3-
title: Device Passcode in App Automation on Real iOS Devices
3+
title: Device Passcode in App Automation on Real Devices
44
sidebar_label: Device Passcode
55
description: Run automated tests on iOS apps that require a device passcode during execution on real devices.
66
keywords:
@@ -52,7 +52,7 @@ import TabItem from '@theme/TabItem';
5252
5353
For certain use cases, you may need to perform tests on devices that are **passcode-protected**. Apps handling sensitive data (for example, **banking apps**, **enterprise apps**, or apps distributed through **MDM**) often enforce device passcodes for enhanced security.
5454

55-
LambdaTest’s **Device Passcode in Automation** enables you to run such automated tests seamlessly on real iOS devices.
55+
LambdaTest’s **Device Passcode in Automation** enables you to run such automated tests seamlessly on real devices.
5656

5757
---
5858

@@ -66,28 +66,39 @@ LambdaTest’s **Device Passcode in Automation** enables you to run such automat
6666

6767
## Supported Devices
6868

69-
Currently, the Device Passcode feature in **App Automation** is enabled on the following iOS real devices:
69+
### iOS Devices
7070

7171
| Device Model | iOS Version |
7272
|-----------------------|-------------|
73-
| iPhone 16 | 18 |
74-
| iPhone 16 Pro | 18 |
75-
| iPad Air 11 (2024) | 18 |
76-
| iPhone 15 | 17 |
77-
| iPhone 14 | 16 |
78-
| iPhone 13 | 15 |
79-
80-
> We are actively working on expanding coverage to **all supported iOS devices** on LambdaTest Real Device Cloud.
73+
| iPhone 16 | 18 |
74+
| iPhone 16 Pro | 18 |
75+
| iPhone 15 | 17 |
76+
| iPhone 14 | 16 |
77+
| iPhone 13 | 15 |
78+
| iPad Air 11 (2024) | 18 |
79+
80+
> We are actively working on expanding coverage to all supported iOS devices on LambdaTest Real Device Cloud.
81+
8182
---
8283

84+
### Android Devices
85+
Available on **all real devices** running on **version 11 and above**.
86+
87+
## Default Passcode
88+
- **iOS:** `123456`
89+
- **Android:** `1234`
90+
91+
8392
## Capability to Enable Passcode
8493

85-
Use the `enablePasscode` capability to enable passcode-protected devices for automation testing.
94+
Use the `enablePasscode` capability to configure passcode-protected devices during automation testing.
8695

87-
| Capability | Type | Default | Description |
88-
|-----------------|---------|---------|-------------|
89-
| **enablePasscode** | Boolean | `false` | Enable passcode devices for running tests. Use `true` to start the session with a system passcode configured (default passcode: `123456`). |
96+
| Capability | Type | Default | Description |
97+
|-------------------|---------|---------|-------------|
98+
| **enablePasscode** | Boolean | `false` | Enable passcode devices for running tests. Use `true` to start the session with a system passcode configured. |
9099

100+
<Tabs>
101+
<TabItem value="ios" label="iOS">
91102

92103

93104
```python
@@ -100,15 +111,28 @@ Use the `enablePasscode` capability to enable passcode-protected devices for aut
100111
"enablePasscode": True
101112
}
102113
```
103-
## Unlock Device with Default Passcode
104114

105-
For iOS devices, the default passcode is **123456**.
106-
In your test script, write automation code that taps and sets the passcode accordingly.
115+
</TabItem>
116+
<TabItem value="android" label="Android">
117+
118+
119+
120+
```python
121+
{
122+
"platformName": "android",
123+
"deviceName": "Samsung Galaxy S25",
124+
"platformVersion": "15",
125+
"isRealMobile": True,
126+
#highlight-next-line
127+
"enablePasscode": True
128+
}
129+
```
130+
131+
</TabItem>
132+
</Tabs>
107133

108134
:::note
109135
- Passcode entry screens are **not visible** in the stream for security reasons — you may see a blank screen briefly during automation.
110-
- The default passcode for iOS real devices is **123456**.
111-
- Enabling passcode may increase the setup time of your test by **25–30 seconds** compared to regular sessions.
112-
- Passcode support is currently available for **iOS real devices** only. Support for **Android devices** is **Coming Soon**.
136+
- Enabling passcode for iOS Devices may increase the setup time of your test by **25–30 seconds** compared to regular sessions.
113137
:::
114138

docs/device-passcode-on-realdevice.md

Lines changed: 27 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
id: device-passcode-on-realdevice
3-
title: Device Passcode on Real iOS Devices
3+
title: Device Passcode on Real Devices
44
sidebar_label: Device Passcode
55
description: Enable and test iOS app flows that require a device passcode during manual sessions on real iPhones and iPads.
66
keywords:
@@ -63,42 +63,48 @@ This is especially useful for apps in **Banking/Finance**, **Enterprise**, or th
6363

6464
## Supported Devices
6565

66-
Currently, the Device Passcode feature in **App Automation** is enabled on the following iOS real devices:
66+
### iOS Devices
6767

6868
| Device Model | iOS Version |
6969
|-----------------------|-------------|
70-
| iPhone 16 | 18 |
71-
| iPhone 16 Pro | 18 |
72-
| iPad Air 11 (2024) | 18 |
73-
| iPhone 15 | 17 |
74-
| iPhone 14 | 16 |
75-
| iPhone 13 | 15 |
70+
| iPhone 16 | 18 |
71+
| iPhone 16 Pro | 18 |
72+
| iPhone 15 | 17 |
73+
| iPhone 14 | 16 |
74+
| iPhone 13 | 15 |
75+
| iPad Air 11 (2024) | 18 |
7676

77-
> We are actively working on expanding coverage to **all supported iOS devices** on LambdaTest Real Device Cloud.
78-
> Support for Android devices with passcode testing is **Coming Soon**.
77+
> We are actively working on expanding coverage to all supported iOS devices on LambdaTest Real Device Cloud.
7978
80-
## Default Passcode
79+
---
8180

82-
- The default passcode for LambdaTest iOS real devices is **123456**.
83-
- Use your system keyboard to input this passcode when prompted during testing.
81+
### Android Devices
82+
Available on **all real devices** running on **version 11 and above**.
8483

85-
## Accessing Device Passcode in Manual Testing
8684

87-
**Step 1:** On the App Testing Dashboard, click on **Advanced Settings** and enable the **Device Passcode** filter. This will refine the device list to show only those devices where the passcode feature is available.
85+
## Default Passcode
86+
- **iOS:** `123456`
87+
- **Android:** `1234`
8888

89-
![Passcode Entry](../assets/images/real-device-app-testing/passcodetoggle.png)
89+
## Accessing Device Passcode in Manual Testing
9090

91-
**Step 2:** Start a manual testing session on a real iOS device.
91+
**Step 1:** (**iOS only**) On the App Testing Dashboard, click **Advanced Settings** and enable the **Device Passcode** filter. This will refine the iOS device list to show only those with passcode support.
9292

93-
**Step 3:** From the session toolbar, open the **iOS Settings** panel and toggle **Passcode** on. Once enabled, the device will take **20–25 seconds** to complete the passcode setup. Please wait for confirmation.
93+
![Passcode Entry](../assets/images/real-device-app-testing/passcodetoggle.png)
9494

95-
![Enable Device Passcode](../assets/images/real-device-app-testing/passcodeenabled.png)
95+
**Step 2:** Start a manual testing session on your selected device (iOS or Android).
96+
- On **iOS** → Open the **iOS Settings** panel and toggle **Passcode** on.
97+
![Enable Device Passcode](../assets/images/real-device-app-testing/passcodeenabled.png)
98+
- On **Android** → Open the **Device Controls** panel and toggle **Passcode** on.
99+
![Enable Device Passcode](../assets/images/real-device-app-testing/Android-Passcode.png)
100+
Setup may take **15–30 seconds** depending on the platform.
96101

97102
**Step 4:** Trigger the workflow inside your app that requires the device passcode.
98-
99103
- A system passcode screen will appear.
100104
- Since passcode entry is sensitive, the keypad or the screen may not be streamed and could appear as black in your session view.
101-
- Use your **system keyboard** to type the passcode (**123456**) and press **Enter**.
105+
- Use your system keyboard to enter the default passcode:
106+
- iOS: `123456`
107+
- Android: `1234`
102108

103109
**Step 5:** Continue your app testing once the **passcode** is validated.
104110

0 commit comments

Comments
 (0)