Первое приложение 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Параметр указывает устройство для запуска:

устройстваКоманда
Эмулятор Androidflutter run -d android
Симулятор iOSflutter run -d iphone
Браузер Chromeflutter run -d chrome
Рабочий стол Windowsflutter 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. Пока приложение запущено:

  1. Измените код и сохраните
  2. В терминале нажмитеrКлавиша
  3. Приложение перезагрузится, и вы увидите последние изменения

Горячая перезагрузка очень быстрая, обычно занимает всего одну или две секунды. Это значительно повышает эффективность разработки, позволяя просматривать интерфейс в реальном времени.

Горячая перезагрузка не теряет состояние приложения, а значит, вы можете быстро перебирать варианты дизайна UI без перезапуска приложения.


Анализ файла main.dart.

В каждом проекте Flutter есть входной файлlib/main.dartДавайте посмотрим на содержимое, сгенерированное по умолчанию:

Пример: код main.dart

// lib/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
Другие расширения