Skip to main content
Generate simulator builds for your Flutter app.

​
Build Guidance

To use the Dev Loop, a build is required on every code change. Dart compiles into the native binary — see Dev Loop: Hot reload and rebuild configuration for the full breakdown.

​
Build via the Revyl CLI

​
Prerequisites

  • Flutter SDK installed (flutter doctor passes)
  • Xcode (for iOS) or Android SDK (for Android)
  • Revyl CLI installed and authenticated (revyl auth login)

​
Setup

Initialize the project using the Revyl CLI:
This detects Flutter and writes named profiles with the applicable iOS and/or Android recipes. Review or fill in the app IDs, commands, and output paths before the first build.

​
Run Build

Run one profile/platform recipe locally:
Add --remote to execute the same recipe on a Revyl cloud runner. Profiles live under build.profiles, may contain ios and/or android, and are never stored as active/default. See Configuration. This command automatically builds and uploads the app to Revyl, where you can use it to start sessions.

​
Advanced Configuration

When you run revyl init, Revyl makes a best-effort guess at your configuration. This section covers configuration in more detail. If the build does not complete successfully modify the build commands manually in the config.yaml file. Note: For flutter apps, use debug builds for better test reliability. Debug builds provide an accurate view hierarchy extraction, better element identification, and faster execution. Here are example commands of how to build your flutter app as a debug configuration:

​
Troubleshooting

Check Xcode configuration:
Clean and rebuild:
Check build output directory:

​
Resources