Skip to content
123 changes: 8 additions & 115 deletions docs/app-automation-on-emulators-simulators.md

Large diffs are not rendered by default.

83 changes: 6 additions & 77 deletions docs/build-ios-app-for-simulator-testing.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
id: build-ios-app-for-simulator-testing
title: Building Your iOS App for Simulator Testing
title: How to Build iOS Apps for Simulators on TestMu AI
sidebar_label: Build iOS App for Simulators
description: Learn how to build your iOS app correctly for testing on iOS Simulators on TestMu AI Cloud. Covers Xcode UI, command line builds, and build verification.
keywords:
Expand All @@ -20,7 +20,6 @@ canonical: https://www.testmuai.com/support/docs/build-ios-app-for-simulator-tes

import CodeBlock from '@theme/CodeBlock';
import BrandName, { BRAND_URL } from '@site/src/component/BrandName';
import VerifiedTag from '@site/src/component/verifiedTag';

<script type="application/ld+json"
dangerouslySetInnerHTML={{ __html: JSON.stringify({
Expand All @@ -39,7 +38,7 @@ import VerifiedTag from '@site/src/component/verifiedTag';
},{
"@type": "ListItem",
"position": 3,
"name": "Building Your iOS App for Simulator Testing",
"name": "How to Build iOS Apps for Simulators on TestMu AI",
"item": `${BRAND_URL}/support/docs/build-ios-app-for-simulator-testing/`
}]
})
Expand All @@ -57,7 +56,7 @@ import VerifiedTag from '@site/src/component/verifiedTag';
"@type": "WebPage",
"@id": "https://www.testmuai.com/support/docs/build-ios-app-for-simulator-testing/"
},
"headline": "Building Your iOS App for Simulator Testing",
"headline": "How to Build iOS Apps for Simulators on TestMu AI",
"description": "Learn how to build your iOS app correctly for testing on iOS Simulators on TestMu AI Cloud. Covers Xcode UI, command line builds, and build verification.",
"url": "https://www.testmuai.com/support/docs/build-ios-app-for-simulator-testing/",
"image": {
Expand All @@ -74,7 +73,6 @@ import VerifiedTag from '@site/src/component/verifiedTag';
"iphonesimulator sdk"
],
"proficiencyLevel": "Beginner",
"dependencies": "Xcode installed on a Mac (macOS 13 or later recommended); Your iOS project source code; A TestMu AI account with access to iOS Simulator testing.",
"author": {
"@type": "Organization",
"@id": "https://www.testmuai.com/#organization",
Expand All @@ -100,63 +98,11 @@ import VerifiedTag from '@site/src/component/verifiedTag';
"https://x.com/testmuai",
"https://www.youtube.com/@TestMuAI"
]
},
"hasPart": [
{
"@type": "SoftwareSourceCode",
"name": "Step 2: Run the following build command",
"codeSampleType": "code snippet",
"programmingLanguage": "Shell",
"text": "xcodebuild -project YourProject.xcodeproj \\\n -scheme YourScheme \\\n -configuration Debug \\\n -sdk iphonesimulator \\\n -arch arm64 \\\n build"
},
{
"@type": "SoftwareSourceCode",
"name": "You can find the path in the build output, or use",
"codeSampleType": "code snippet",
"programmingLanguage": "Shell",
"text": "xcodebuild -project YourProject.xcodeproj \\\n -scheme YourScheme \\\n -configuration Debug \\\n -sdk iphonesimulator \\\n -arch arm64 \\\n -showBuildSettings | grep \"BUILT_PRODUCTS_DIR\""
},
{
"@type": "SoftwareSourceCode",
"name": "Step 4: Compress the .app into a .zip file",
"codeSampleType": "code snippet",
"programmingLanguage": "Shell",
"text": "cd /path/to/build/output/\nzip -r YourApp.zip YourApp.app"
},
{
"@type": "SoftwareSourceCode",
"name": "Step 1: Run the following command",
"codeSampleType": "code snippet",
"programmingLanguage": "Shell",
"text": "vtool -show-build YourApp.app/YourApp"
},
{
"@type": "SoftwareSourceCode",
"name": "Step 2: Check the output",
"codeSampleType": "code snippet",
"programmingLanguage": "text",
"text": " platform: IOSSIMULATOR"
},
{
"@type": "SoftwareSourceCode",
"name": "Verifying Your Build",
"codeSampleType": "code snippet",
"programmingLanguage": "text",
"text": " platform: IOS"
},
{
"@type": "SoftwareSourceCode",
"name": "You can also use otool to check the architecture",
"codeSampleType": "code snippet",
"programmingLanguage": "Shell",
"text": "lipo -info YourApp.app/YourApp"
}
],
"dateModified": "2026-09-09T19:10:37+05:30"
}
}) }}
/>

To test your iOS application on <BrandName /> iOS Simulators, your app must be built specifically for the **iOS Simulator** platform. A build intended for a physical iPhone will not work on the Simulator, even if the CPU architecture matches. This guide walks you through creating a Simulator-compatible build and verifying it before uploading.
Building an iOS app for Simulator testing on TestMu AI requires compiling against the iphonesimulator SDK, not a physical-device build. This produces a .app targeting Mach-O platform 7, which the Simulator accepts, so your uploads run without any immediate crash.

## Why Simulator Builds Are Different

Expand Down Expand Up @@ -211,8 +157,6 @@ If you use a CI/CD pipeline or prefer the terminal, use `xcodebuild` with the `-

**Step 2:** Run the following build command:

<VerifiedTag value="Verified" />

```bash
xcodebuild -project YourProject.xcodeproj \
-scheme YourScheme \
Expand All @@ -236,8 +180,6 @@ If your project uses a **workspace** (e.g., with CocoaPods), replace `-project Y

**Step 3:** Locate the `.app` output from the **Derived Data** directory. You can find the path in the build output, or use:

<VerifiedTag value="Verified" />

```bash
xcodebuild -project YourProject.xcodeproj \
-scheme YourScheme \
Expand All @@ -249,8 +191,6 @@ xcodebuild -project YourProject.xcodeproj \

**Step 4:** Compress the `.app` into a `.zip` file:

<VerifiedTag value="Verified" />

```bash
cd /path/to/build/output/
zip -r YourApp.zip YourApp.app
Expand All @@ -264,8 +204,6 @@ Before uploading, verify that your `.app` is targeting the correct platform usin

**Step 1:** Run the following command:

<VerifiedTag value="Verified" />

```bash
vtool -show-build YourApp.app/YourApp
```
Expand All @@ -275,18 +213,12 @@ Replace the second `YourApp` with the actual binary name inside the `.app` bundl
**Step 2:** Check the output:

- **Correct (Simulator build):**

<VerifiedTag value="Verified" />

```
platform: IOSSIMULATOR
```
or `platform 7`

- **Incorrect (Device build):**

<VerifiedTag value="Verified" />

```
platform: IOS
```
Expand All @@ -296,9 +228,6 @@ If the platform shows `IOS` or `platform 2`, the build is for physical devices a

:::tip Alternative Verification
You can also use `otool` to check the architecture:

<VerifiedTag value="Verified" />

```bash
lipo -info YourApp.app/YourApp
```
Expand Down Expand Up @@ -355,7 +284,7 @@ That's all! In case you have any questions or need any additional information, y
</li>
<li className="breadcrumbs__item breadcrumbs__item--active">
<span className="breadcrumbs__link">
Build iOS App for Simulator Testing
How to Build iOS Apps for Simulators on TestMu AI
</span>
</li>
</ul>
Expand Down
13 changes: 6 additions & 7 deletions docs/virtual-device-flutter-apps.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
id: virtual-device-flutter-apps
title: How to test flutter apps using Appium framework on Virtual Devices
title: How to Test Flutter Apps on Virtual Devices on TestMu AI
hide_title: false
sidebar_label: Flutter Apps
sidebar_label: "Test Flutter Apps"
description: Learn how to test flutter apps for Appium testing across 50,000+ real Android and iOS devices for virtual devices
keywords:
- how to test flutter apps
Expand All @@ -14,6 +14,7 @@ url: https://www.testmuai.com/support/docs/virtual-device-flutter-apps/
site_name: TestMu AI
slug: virtual-device-flutter-apps/
canonical: https://www.testmuai.com/support/docs/virtual-device-flutter-apps/
toc_max_heading_level: 2
---
import BrandName, { BRAND_URL } from '@site/src/component/BrandName';
import VerifiedTag from '@site/src/component/verifiedTag';
Expand All @@ -36,7 +37,7 @@ import VerifiedTag from '@site/src/component/verifiedTag';
},{
"@type": "ListItem",
"position": 3,
"name": "Virtual Devices Flutter Apps With Appium",
"name": "How to Test Flutter Apps on Virtual Devices on TestMu AI",
"item": `${BRAND_URL}/support/docs/virtual-device-flutter-apps/`
}]
})
Expand All @@ -54,7 +55,7 @@ import VerifiedTag from '@site/src/component/verifiedTag';
"@type": "WebPage",
"@id": "https://www.testmuai.com/support/docs/virtual-device-flutter-apps/"
},
"headline": "How to test flutter apps using Appium framework on Virtual Devices",
"headline": "How to Test Flutter Apps on Virtual Devices on TestMu AI",
"description": "Learn how to test flutter apps for Appium testing across 50,000+ real Android and iOS devices for virtual devices",
"url": "https://www.testmuai.com/support/docs/virtual-device-flutter-apps/",
"image": {
Expand Down Expand Up @@ -131,9 +132,7 @@ import VerifiedTag from '@site/src/component/verifiedTag';
"dateModified": "2026-09-09T19:10:37+05:30"
}) }}
/>
Google's Flutter is an open-source tool for developing native mobile apps. It enables developers to create cross-platform apps for both Android and iOS using a single codebase and programming language.

You can now run End-to-End (E2E) testing for Flutter apps on the <BrandName /> Appium testing platform across 50,000+ real Android and iOS devices. <BrandName /> supports Appium's Flutter driver that lets you test Flutter apps using the Appium framework. To test Flutter apps, you will need to upload apps on <BrandName /> cloud servers and then run your automated tests.
Testing Flutter apps on TestMu AI runs Appium's Flutter driver across 50,000+ real Android and iOS devices, letting you run End-to-End (E2E) testing of cross-platform apps from a single codebase. Compile your app in debug or profile mode, upload it, and execute automated tests.

## Prerequisites

Expand Down
14 changes: 11 additions & 3 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -3057,9 +3057,17 @@ module.exports = {
},
},
[
"app-automation-app-sim",
"build-ios-app-for-simulator-testing",
"virtual-device-flutter-apps",
{
type: "category",
collapsed: false,
label: "Getting Started",
className: "menu-bold",
items: [
"app-automation-app-sim",
"build-ios-app-for-simulator-testing",
"virtual-device-flutter-apps",
],
},
],
],

Expand Down
Loading
Loading