# Producing an iOS Build
Moropo supports running tests on iOS using a `.app` simulator build file.
Please note: real iOS device builds with the file extension `.ipa` are currently **not supported**.
{% hint style="info" %}
**Important: ensure your zip your `.app`**
Because of the way that some operating systems handle `.app` files, it's essential that you zip your build before uploading it to Moropo.
The file you upload will look like this: **`myapp.app.zip`**\
How to zip on [MacOS](https://support.apple.com/en-gb/guide/mac-help/mchlp2528/mac#:~:text=Compress%20a%20file%20or%20folder,zip%20extension.), [Windows](https://support.microsoft.com/en-us/windows/zip-and-unzip-files-8d28fa72-f2f9-712f-67df-f80cf89fd4e5).
{% endhint %}
## Which build type should I use?
You can use any backend environment so long as your build target is `simulator`.
Many Moropo users configure different test setups for different build types. For example:
* a simulator build using your Dev Environment that runs a regression suite on each pull request for a single device
* a simulator build using your Staging Environment that runs a full test suite before each production release across a wide range of devices
## Using XCode Command Line to produce a `.app`
If you're comfortable with the terminal and have a natively-built iOS app, you can use `xcrun` to produce your build file.
For example, to build an app called "Classy Mall":
```bash
xcrun xcodebuild -scheme 'Classy Mall' \
-project 'Class Mall.xcodeproj' \
-sdk 'iphonesimulator' \
-configuration Debug \
-destination 'generic/platform=iOS Simulator' \
-derivedDataPath \
build
```
Once successful, your `.app` simulator build will be found in the `./build` folder.
## Using XCode UI to produce a `.app`
If you prefer a user interface, you can use [XCode](https://developer.apple.com/xcode/) to produce your build file:
1. Launch XCode.
2. Open your project.
3. Set your target to **simulator**.\
\
4. Click on the **Product** menu in the top bar, then select **Build**.
5. Wait for your build to complete.\
\
6. Click on the **Product** menu in the top bar, then select **Show Build Folder in Finder** to open the file system on the newly exported `.app` file.\
\
## \[React Native] Using Expo EAS to produce a `.app`
If your app is built using React Native, you can use [Expo Application Services](https://expo.dev/eas) to build your app.
Ensure your `eas.config` includes the correct setting:
```json
{
"build": {
"myProfile": {
"ios": {
"simulator": true
}
}
}
}
```
*Note: EAS allows a `.app` to be produced using various config options; read the* [*official docs*](https://docs.expo.dev/build-reference/simulators/)*.*
Run EAS via your terminal to trigger the build:
```
eas build -p ios --profile myProfile
```
## Using Flutter to produce a `.app`
If your app is built using Flutter, you can use the `flutter` command line inside your terminal.
To produce an iOS simulator build, run `flutter build ios --debug --simulator`
Your `.app` will appear in the `./build/ios/iphonesimulator/` folder.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.moropo.com/uploading-your-app/producing-an-ios-build.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.