|
| 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 | +::: |
0 commit comments