FlutterFlow Docs
Troubleshooting GuidesDocs Feedback
Ask or search…
⌃K
Links
Comment on page

Testing On Mobile Device

This page guides you on testing your app on a mobile device.

Prerequisites

Before you start testing on a mobile device, make sure to set up your machine.

How to test on a mobile device

Testing your app on a mobile device consists of the following steps:

1. Download code

We allow you to download the entire codebase and run it on your preferred IDE.
  • This feature is only included in our Standard and Pro plans.
  • Make sure to address any project issues before downloading the code.
To download your app code:
  1. 1.
    Move to the toolbar and click on the Developer Menu (
    ) > Download Code (
    ). This will download the .zip file. Extract the .zip file to view the contents of the project.
  2. 2.
    Alternatively, you can also download and extract the code using FlutterFlow CLI.
    1. 1.
      To do so, open the terminal and hit the dart pub global activate flutterflow_cli.
    2. 2.
      Once installed, enter this command: flutterflow export-code --project <project id> --dest <output folder> --[no-]include-assets --token <token> Note that you must replace the <project id>, <output folder>, and <token> with your own.
You can find the project id in the app URL and the API token on your account page.
Download from builder
Download via CLI
Download from builder
Download via CLI
Project id

2. Running app on device

You can choose to run your app on a real device or an emulator.
To run your app on a device:
  1. 1.
    First open the downloaded project in your preferred IDE.
  2. 2.
    For VS Code:
    1. 1.
      Go to the "View" menu -> select "Terminal" from the dropdown.
    2. 2.
      Run the command flutter pub get.
    3. 3.
      Now, enter the command flutter run. VS Code will build and run your app. You'll see the output in the terminal, and the app should launch in the selected emulator or physical device.
  3. 3.
    For Android Studio:
    1. 1.
      Open the terminal within Android Studio by clicking "View" -> "Tool Windows" -> "Terminal."
    2. 2.
      Run the command flutter pub get.
    3. 3.
      Click the green "Run" button (a right-facing triangle) located in the top toolbar. Choose the target device (emulator or physical device) where you want to run the app. Android Studio will build and run your app. You'll see the output in the "Run" panel at the bottom, and the app should launch in the selected emulator or device.
If your device is not listed in the Flutter Device Selection dropdown, make sure you have properly completed the Android and iOS setup. You can find the instructions for setting up an Android device here and here and for iOS check this and this.
Last Updated Date: October 4, 2023
Previous
Set Up
Next
Testing On Desktop
Last modified 2mo ago