Skip to main content
Add our MCP Server to help you build your app for our cloud.

Build Requirements

Autosana runs your mobile apps on our virtual device cloud using iOS Simulators and Android Emulators. Your builds must meet these requirements:

iOS Builds

  • Format: .app file (compressed as .zip)
  • Architecture: arm64 (for Apple Silicon simulators)
Building on an M1+ Mac will use arm64 by default. Intel Macs will produce x86_64 builds, which won’t work on our simulators.

Android Builds

  • Format: .apk file
  • Architectures: arm64-v8a and x86_64
Most build commands create universal APKs that include both architectures by default, so you typically don’t need to configure the build architecture manually.

Select your framework to see build instructions:
  • React Native
  • Flutter
  • Native iOS
  • Native Android
Important: React Native apps must be built in Release mode. Debug builds will attempt to connect to Metro bundler and fail to run on the device. Release builds bundle the JavaScript code directly into the app, making them standalone.

React Native (iOS)

  1. Build it with:
npx react-native run-ios --mode Release
  1. App file should be here:
ios/build/Build/Products/Release-iphonesimulator/[YourApp].app
In macOS, it should just be YourApp because macOS hides .app extensions
  1. Go to Finder, compress YourApp to a .zip and upload/drag it into the Autosana app upload dialog

React Native with Expo (iOS)

For Expo projects, use EAS Build to create simulator builds:
  1. Add this profile to your eas.json:
{
  "build": {
    "preview-simulator": {
      "distribution": "internal",
      "ios": {
        "simulator": true
      }
    }
  }
}
  1. Run the build command:
eas build --platform ios --profile preview-simulator
  1. Once the build completes, EAS will provide a download URL for the build
  2. Download and extract it to get the .app file
  3. Compress the .app to a .zip and upload it to Autosana

React Native (Android)

  1. Navigate to your Android directory and build the release APK:
cd android && ./gradlew assembleRelease
  1. The APK will be located at:
android/app/build/outputs/apk/release/app-release.apk
  1. Upload the .apk file to Autosana

React Native with Expo (Android)

For Expo projects, use EAS Build to create APK builds:
  1. Add this profile to your eas.json:
{
  "build": {
    "preview": {
      "distribution": "internal",
      "channel": "preview",
      "android": {
        "buildType": "apk"
      }
    }
  }
}
  1. Run the build command:
eas build --platform android --profile preview
  1. Once the build completes, EAS will provide a download URL for the .apk file
  2. Download the APK and upload it to Autosana