Skip to content

Commit 85c32b0

Browse files
sakshamarora-archIshavyas9
authored andcommitted
Updated documentation
1 parent f5b8211 commit 85c32b0

File tree

3 files changed

+132
-0
lines changed

3 files changed

+132
-0
lines changed
Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
---
2+
id: group-folder-redirect-on-real-device
3+
title: Group Folder Redirect for iOS Apps in App Live
4+
sidebar_label: Group Folder Redirect
5+
description: Enable Group Folder Redirect support for iOS apps on LambdaTest Real Devices.
6+
keywords:
7+
- lambdatest real devices
8+
- ios app live
9+
- group folder redirect
10+
- ios file system testing
11+
- private app container testing
12+
url: https://www.lambdatest.com/support/docs/group-folder-redirect-on-real-device/
13+
site_name: LambdaTest
14+
slug: group-folder-redirect-on-real-device/
15+
---
16+
17+
# Group Folder Redirect On Real Devices
18+
19+
LambdaTest supports **Group Folder Redirect** for iOS apps on Real Devices.
20+
This feature ensures your app uses its **private container directory** instead of the **shared app group container**, which becomes inaccessible after **app resigning** on Real Devices.
21+
22+
---
23+
24+
## Use Cases
25+
26+
- Ensure your app maintains **file system access** after being re-signed on Real Devices.
27+
- Prevent issues when your app relies on the **shared App Group container**, which becomes inaccessible after resigning.
28+
- Guarantee consistent **storage and retrieval of files** by using the app’s private container.
29+
30+
---
31+
32+
## Using Group Folder Redirect in Manual Testing
33+
34+
35+
**Step 1**: Click on the Real Devices > App Testing
36+
37+
38+
**Step 2**: Upload your application. Open the **App Settings** to enable the **Group Folder Redirect** toggle.
39+
40+
![Group-Folder-Redirect](../assets/images/real-device-app-testing/Group-folder-redirect/Group-Folder-redirects.png)
41+
42+
43+
**Step 4**: Select your device and start your Real Device testing session.
44+
45+
---
46+
:::info
47+
- An **instrumented version** of your app with Group Folder Redirect support will launch.
48+
- The app will store and retrieve files from its **private container directory** instead of the shared App Group container.
49+
- File system features will function consistently even after app resigning.
50+
:::
51+
52+
53+

docs/group-folder-redirect.md

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
---
2+
id: group-folder-redirects
3+
title: Group Folder Redirect for iOS Apps in Appium Tests
4+
sidebar_label: Group Folder Redirect
5+
description: Learn how to enable Group Folder Redirect for iOS apps during Appium testing on LambdaTest Real Device Cloud.
6+
keywords:
7+
- lambdatest automation
8+
- ios app automation
9+
- group folder redirect
10+
- appium ios file system testing
11+
- private app container automation
12+
url: https://www.lambdatest.com/support/docs/group-folder-redirects/
13+
site_name: LambdaTest
14+
slug: group-folder-redirects/
15+
---
16+
17+
import CodeBlock from '@theme/CodeBlock';
18+
import Tabs from '@theme/Tabs';
19+
import TabItem from '@theme/TabItem';
20+
21+
# Group Folder Redirect for iOS Apps
22+
23+
LambdaTest now supports **Group Folder Redirect** for iOS apps during automation testing with Appium.
24+
This feature ensures your app uses its **private container directory** instead of the **shared app group container**, which becomes inaccessible after **app resigning** on Real Devices.
25+
26+
---
27+
28+
## Use Cases
29+
30+
- Ensure your app maintains **file system access** after being re-signed on Real Devices.
31+
- Prevent issues when your app relies on the **shared App Group container**, which becomes inaccessible after resigning.
32+
- Guarantee consistent **storage and retrieval of files** by using the app’s private container.
33+
34+
---
35+
36+
## Steps to Enable Group Folder Redirect
37+
38+
### 1. Upload Your Application
39+
- Upload your iOS app to LambdaTest following standard procedures.
40+
- Refer to the [**Upload your Application**](https://www.lambdatest.com/support/docs/application-setup-via-api/#upload-your-application) documentation for detailed instructions.
41+
- Note the **App ID** returned after uploading — you will use this in your automation scripts.
42+
43+
---
44+
45+
### 2. Configure Desired Capabilities
46+
Include the `groupFolderRedirectEnabled` capability in your Appium desired capabilities and set it to `True`.
47+
48+
<Tabs>
49+
<TabItem value="ios" label="iOS">
50+
<CodeBlock className="language-java">
51+
{`desired_caps = {
52+
"deviceName":"iPhone 16",
53+
"platformName":"iOS",
54+
"platformVersion":"18",
55+
"isRealMobile": True,
56+
"app":"YOUR_APP_URL",
57+
"build":"Sample Build",
58+
"name":"Sample Test",
59+
#highlight-next-line
60+
"groupFolderRedirectEnabled": True
61+
}`}
62+
</CodeBlock>
63+
</TabItem>
64+
</Tabs>
65+
66+
---
67+
68+
### 3. Run Your Automation Test
69+
Launch your Appium test, the app will automatically use its private container for all file operations without any code changes.
70+
71+
---
72+
73+
:::info
74+
- LambdaTest launches an **instrumented version** of your app with **Group Folder Redirect** support.
75+
- All file system operations that previously relied on the App Group container now use the **private container**.
76+
- Your tests remain compatible and functional, even after app resigning.
77+
:::

sidebars.js

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2098,6 +2098,7 @@ module.exports = {
20982098
"set-date-time-hour-format-real-devices",
20992099
"assistive-touch-on-real-ios-devices",
21002100
"dark-mode-on-real-devices",
2101+
"group-folder-redirect-on-real-device"
21012102
],
21022103
},
21032104
],
@@ -2818,6 +2819,7 @@ module.exports = {
28182819
"appium-app-performance",
28192820
"appium-ios-app-settings",
28202821
"ios-keychain-cleanup",
2822+
"group-folder-redirects",
28212823
"adb-commands-support",
28222824
"login-google-android",
28232825
"disable-screenshot-block",

0 commit comments

Comments
 (0)