Первое приложение Flutter
В этом разделе мы рассмотрим, как использовать Flutter CLI для создания нового проекта Flutter, запуска приложения и понимания самой базовой структуры кода.
Используйте Flutter CLI для создания проекта.
Flutter CLI — это инструмент командной строки Flutter для создания, управления и сборки проектов Flutter.
Создание нового проекта
Выполните следующую команду в терминале, чтобы создать новый проект Flutter:
$ flutter create my_first_app
гдеmy_first_appЭто имя вашего проекта. Flutter создаст соответствующие папки и файлы на основе этого имени.
Имя проекта должно состоять из строчных букв и символов подчёркивания и не может содержать пробелы или специальные символы.
Параметры команды
flutter createКоманда поддерживает несколько параметров:
| Параметр | Описание | Пример |
|---|---|---|
| --org | Укажите идентификатор организации (в формате обратного доменного имени) | --org com.example |
| --platforms | Укажите поддерживаемые платформы | --platforms ios,android |
| --empty | Создать проект с использованием минимального шаблона | --empty |
$ flutter create hello_world
Creating project "hello_world"...
.gitignore 2026-04-01 10:30:22
.metadata 2026-04-01 10:30:22
analysis_options.yaml 2026-04-01 10:01:15
pubspec.yaml 2026-04-01 10:30:22
README.md 2026-04-01 10:30:22
lib/
main.dart 2026-04-01 10:30:22
test/
widget_test.dart 2026-04-01 10:22:34
android/
ios/
web/
...
Running "flutter pub get"... 13.2s
Running "flutter analyze"... 3.2s
Запуск приложения Flutter
Запустить сервер разработки
После создания проекта перейдите в каталог проекта и запустите приложение:
$ cd hello_world $ flutter run
Первый запуск может занять некоторое время, поскольку Flutter должен скомпилировать код Dart и запустить приложение.
Укажите устройство для запуска
Если к вашему компьютеру подключено несколько устройств (или эмуляторов), вы можете использовать-dПараметр указывает устройство для запуска:
| устройства | Команда |
|---|---|
| Эмулятор Android | flutter run -d android |
| Симулятор iOS | flutter run -d iphone |
| Браузер Chrome | flutter run -d chrome |
| Рабочий стол Windows | flutter run -d windows |
Просмотр доступных устройств
Выполните следующую команду, чтобы просмотреть все доступные запущенные устройства:
$ flutter devices
Пример вывода:
2 connected devices: Chrome (web) • chrome • web-javascript • Chrome • web Windows (windows) • windows • windows • x64 • Windows 10.0.0
Функция Hot Reload
Одна из самых мощных функций Flutter — Hot Reload. Пока приложение запущено:
- Измените код и сохраните
- В терминале нажмите
rКлавиша - Приложение перезагрузится, и вы увидите последние изменения
Горячая перезагрузка очень быстрая, обычно занимает всего одну или две секунды. Это значительно повышает эффективность разработки, позволяя просматривать интерфейс в реальном времени.
Горячая перезагрузка не теряет состояние приложения, а значит, вы можете быстро перебирать варианты дизайна UI без перезапуска приложения.
Анализ файла main.dart.
В каждом проекте Flutter есть входной файлlib/main.dartДавайте посмотрим на содержимое, сгенерированное по умолчанию:
Пример: код main.dart
// Входной файл приложения Flutter
// Импорт библиотеки компонентов Material Design
import 'package:flutter/material.dart';
// Функция точки входа приложения
void main() {
// runApp — стартовая функция Flutter
// Она принимает Widget в качестве корневого виджета
runApp(const MyApp());
}
// Корневой Widget (виджет без состояния)
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
// MaterialApp — корневой виджет в стиле Material Design
return MaterialApp(
// Установить заголовок приложения
title: 'Flutter Demo',
// Установить цвет темы
theme: ThemeData(
colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
// Использовать Material 3
useMaterial3: true,
),
// Главная страница приложения
home: const MyHomePage(title: 'Flutter Home'),
);
}
}
// Виджет с состоянием (может иметь внутреннее состояние)
class MyHomePage extends StatefulWidget {
const MyHomePage({super.key, required this.title});
// Заголовок страницы (неизменяемый)
final String title;
@override
State<MyHomePage> createState() => _MyHomePageState();
}
class _MyHomePageState extends State<MyHomePage> {
// Состояние счётчика
int _counter = 0;
// Метод для увеличения счётчика
void _incrementCounter() {
// setState уведомляет Flutter, что состояние изменилось и UI нужно перестроить
setState(() {
_counter++;
});
}
@override
Widget build(BuildContext context) {
// Scaffold — это каркас страницы Material Design
return Scaffold(
// AppBar — это верхняя панель приложения
appBar: AppBar(
backgroundColor: Theme.of(context).colorScheme.inversePrimary,
// Отобразить заголовок страницы
title: Text(widget.title),
),
// Содержимое тела страницы
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
const Text('Сколько раз вы нажали кнопку:'),
// Отобразить значение счётчика
Текст(
'$_counter',
style: Theme.of(context).textTheme.headlineMedium,
),
],
),
),
// Плавающая кнопка действия
floatingActionButton: FloatingActionButton(
onPressed: _incrementCounter,
tooltip: 'Увеличить',
child: const Icon(Icons.add),
),
);
}
}
Объяснение структуры кода
| Часть | Описание |
|---|---|
| инструкция import | Импортируйте необходимые пакеты; здесь импортируется библиотека компонентов Material Design. |
| функция main | Точка входа программы на Dart, которая вызывает runApp для запуска приложения |
| функция runApp | Функция запуска Flutter, которая принимает корневой Widget в качестве параметра |
| StatelessWidget | Виджет без состояния, чей UI не изменяется со временем |
| StatefulWidget | Виджет с состоянием, чей UI может реагировать на изменения данных |
| метод build | Метод, который должен реализовать каждый Widget, используется для построения UI |