This quickstart guide describes how to create and run your first Flutter app on iOS or Android.
- Before you begin
- Creating your first Flutter app
- Running your Flutter app
- Viewing source code changes with ‘hot reload’
- Next steps
Before you begin
To write Flutter apps, you will need to install the Flutter SDK. You also need to set up a Linux or Mac development machine to run and test your apps on Android or iOS. See Flutter Setup for instructions on how to set up your development environment.
Creating your first Flutter app
To create a starter project, open a terminal and run the
flutter create <project name> command .
Here is an example:
$ flutter create myapp
The above command creates a Flutter project directory called
myapp that contains a simple demo
app that uses Material Design.
In the project directory, the code for your app is in
Running your Flutter app
flutter run command to run your Flutter app on a connected
device or simulator.
To run your app from the command-line:
- Open a terminal and change directories to the root of your app (the same directory that
pubspec.yamlfile for your project).
- Run the following command. Once the
fluttertool is running, if you change the app’s source code, you can hit
rto hot-reload your application (updating the source on the fly without actually restarting the entire app).
$ cd myapp $ flutter run
If more than one device is connected, use the
flutter devices command
to get their IDs, and then
flutter run -d deviceID to run your app.
- In IntelliJ, click Create New Project from the Welcome window or File > New > Project… from the main IDE window.
- Select Flutter in the menu, and click Next.
- Under Project location enter, or browse to, the directory holding your new Flutter app.
- Click Finish.
- Click the Debug icon in the toolbar, or invoke the menu item Run > Debug.
If everything works, you should see your starter app on your device or simulator.
Viewing source code changes with ‘hot reload’
Hot reload reloads your app very quickly after a change to your source code, offering a best-in-class development cycle.
To edit your code and hot reload changes:
- Run your app in debug mode.
- Make desired changes in your source code (without stopping the debugger).
- In the Debug panel at the bottom, click the Hot Reload button.
Not all source code changes can be hot reloaded. To fully restart the Dart VM of your Flutter app you can use the Full Application Restart button.
main.dart button on the left side of the Debug Toolbar will
redeploy the app to the device. For both Full Application Restart and Rerun
you will lose the state of your application.
A more detailed detailed description on how to use the IntelliJ plugin and which changes are supported by the hot-reload feature can be found on the page Developing apps in the IntelliJ IDE.
Please reach out to us at our mailing list. We’d love to hear from you!