Test drive
What you'll learn
#- How to create a new Flutter app from a sample template.
- How to run the new Flutter app.
- How to use "hot reload" after you make changes to the app.
These tasks depend on which integrated development environment (IDE) you use.
Option 1 explains how to code with Visual Studio Code and its Flutter extension.
Option 2 explains how to code with Android Studio or IntelliJ IDEA with its Flutter plugin.
Flutter supports IntelliJ IDEA Community, Educational, and Ultimate editions.
Option 3 explains how to code with an editor of your choice and use the terminal to compile and debug your code.
Choose your IDE
#Select your preferred IDE for Flutter apps.
Create a sample Flutter app
#To use Flutter DevTools from VS Code, install the Flutter extension. This also automatically installs the Dart extension. With these extensions, you can debug your Flutter app.
Open the Command Palette.
Go to View > Command Palette or press + Shift + P.
Type
flutter
.Select Flutter: New Project.
When prompted for Which Flutter Project, select Application.
Create or select the parent directory for the new project folder.
When prompted for a Project Name, enter
test_drive
.Press Enter.
Wait for project creation to complete.
Open the
lib
directory, then themain.dart
.To learn what each code block does, check out the comments in that Dart file.
The previous commands create a Flutter project directory called test_drive
that contains a simple demo app that uses Material Components.
Run your sample Flutter app
#Run your example application on your desktop platform, in the Chrome web browser, in an iOS simulator, or Android emulator.
Open the Command Palette.
Go to View > Command Palette or press + Shift + P.
Type
flutter
.Select Flutter: Select Device.
If no devices are running, this command prompts you to enable a device.
Select a target device from Select Device prompt.
After you select a target, start the app. Go to Run > Start Debugging or press F5.
Wait for the app to launch.
You can watch the launch progress in the Debug Console view.
After the app build completes, your device displays your app.
Try hot reload
#Flutter offers a fast development cycle with Stateful Hot Reload, the ability to reload the code of a live running app without restarting or losing app state.
You can change your app source code, run the hot reload command in VS Code, and see the change in your target device.
Open
lib/main.dart
.Change the word
pushed
toclicked
in the following string. It is on line 109 of themain.dart
file as of this writing.Original New 'You have pushed the button this many times:' ,
'You have clicked the button this many times:' ,
Save your changes: invoke Save All, or click Hot Reload .
Your app updates the string as you watch.
Create a sample Flutter app
#Launch the IDE.
To be able to create flutter projects on Android Studio, install the Flutter Plugin and for smart Dart coding assistance that includes code completion, formatting, navigation, intentions, refactorings, and more, install the Dart Plugin.
Head back to your IDE start page and Click New Flutter Project at the top of the Welcome to Android Studio dialog.
Under Generators, click Flutter.
Verify the Flutter SDK path value against the Flutter SDK location on your development machine.
Click Next.
Enter
test_drive
into the Project name field. Your project name should be written in snake case and in lowercase. This follows the Flutter best practices for naming projects.Set the directory in the Project location field to
C:\dev\test_drive
on Microsoft Windows or~/development/test_drive
on other platforms.If you didn't create that directory before, Android Studio displays a warning that the Directory Does Not Exist. Click Create.
From Project type dropdown, select Application.
Ignore the remaining form fields. You don't need to change them for this test drive. Click Create.
Wait for Android Studio to create the project.
Open the
lib
directory, then themain.dart
.To learn what each code block does, check out the comments in that Dart file.
The previous commands create a Flutter project directory called test_drive
that contains a simple demo app that uses Material Components.
Run your sample Flutter app
#Locate the main Android Studio toolbar at the top of the Android Studio edit window.
In the target selector, select an Android device for running the app. You created your Android target device in the Install section.
To run your app, make one of the following choices:
Click the run icon in the toolbar.
Go to Run > Run.
Press Ctrl + R.
After the app build completes, your device displays your app.
Try hot reload
#Flutter offers a fast development cycle with Stateful Hot Reload, the ability to reload the code of a live running app without restarting or losing app state.
You can change your app source code, run the hot reload command in Android Studio, and see the change in your target device.
Open
lib/main.dart
.Change the word
pushed
toclicked
in the following string. It is on line 109 of themain.dart
file as of this writing.Original New 'You have pushed the button this many times:' ,
'You have clicked the button this many times:' ,
Save your changes: invoke Save All, or click Hot Reload .
Your app updates the string as you watch.
Create a sample Flutter app
#To create a new Flutter app, run the following commands in your shell or Terminal.
Run the
flutter create
command.flutter create test_drive
The command creates a Flutter project directory called
test_drive
that contains a simple demo app that uses Material Components.Change to the Flutter project directory.
cd test_drive
Run your sample Flutter app
#To verify that you have a running target device, run the following command.
flutter devices
You created your target device in the Install section.
To run your app, run the following command.
flutter run
After the app build completes, your device displays your app.
Try hot reload
#Flutter offers a fast development cycle with Stateful Hot Reload, the ability to reload the code of a live running app without restarting or losing app state.
You can change your app source code, run the hot reload command in VS Code, and see the change in your target device.
Open
lib/main.dart
.Change the word
pushed
toclicked
in the following string. It is on line 109 of themain.dart
file as of this writing.Original New 'You have pushed the button this many times:' ,
'You have clicked the button this many times:' ,
Save your changes.
Type r in the terminal window.
Your app updates the string as you watch.
Unless stated otherwise, the documentation on this site reflects the latest stable version of Flutter. Page last updated on 2024-12-04. View source or report an issue.