Структура проекта Flutter

Понимание структуры каталогов проекта Flutter крайне важно для эффективной разработки.

В этом разделе будет представлено подробное введение в различные компоненты проекта Flutter и их назначение.


Структура каталогов проекта

Когда вы используетеflutter createПосле создания нового проекта вы получите следующую структуру каталогов:

my_app/
├── android/          # Android 平台相关代码
├── ios/              # iOS 平台相关代码
├── lib/              # Dart 代码目录(主要开发目录)
│   └── main.dart     # 应用入口文件
├── web/              # Web 平台相关代码
├── windows/          # Windows 桌面相关代码
├── macos/            # macOS 桌面相关代码
├── linux/            # Linux 桌面相关代码
├── test/             # 测试代码目录
├── pubspec.yaml      # 项目配置文件
├── pubspec.lock      # 依赖锁定文件(自动生成)
├── analysis_options.yaml  # Dart 分析器配置
└── README.md         # 项目说明文件

Описание основных каталогов и файлов

Каталог lib/ — Каталог основного кода

lib/Этот каталог — основное место, где вы пишете код на Dart. Вся логика приложения должна размещаться здесь.

Файл/каталогОписание
main.dartВходной файл приложения, содержащий функцию main и корневой Widget.
*.dartДругие исходные файлы Dart, обычно организованные по функциональным модулям.

Каталог android/ — платформа Android

Содержит файлы нативного Android-проекта, используется для:

  • Настройка имени и значка приложения
  • Настройка разрешений приложения
  • Интеграция нативных SDK (например, Google Play services)

Каталог ios/ — платформа iOS

Содержит файлы нативного iOS-проекта (проект Xcode), используется для:

  • Настройка имени и значка приложения
  • Настройка конфигурации, специфичной для iOS
  • Интеграция зависимостей CocoaPods

Каталог test/ — тестовый код

Содержит тестовый код приложения, обычно включающий:

  • Модульное тестирование
  • Тестирование виджетов
  • Интеграционное тестирование

pubspec.yaml - Конфигурация проекта

pubspec.yamlОсновной файл конфигурации проекта Flutter, определяющий название проекта, версию, зависимости и т. д.

Пример: образец pubspec.yaml

# Название проекта
name
: my_app
# Версия проекта
version
: 1.0.0+1

# Описание проекта
description
: "Моё первое приложение Flutter"

# Среда выполнения
environment
:
  sdk
: ^3.0.0

# Зависимости проекта
dependencies
:
  flutter
:
    sdk
: flutter

  # Добавить сторонние зависимости
  http
: ^1.0.0
  провайдер
: ^6.0.0

# Зависимости для разработки (используются только во время разработки)
dev_dependencies
:
  flutter_test
:
    sdk
: flutter
  flutter_lints
: ^3.0.0

# Конфигурация Flutter
flutter
:
  uses-material-design
: true

  # Настройка файлов ресурсов
  assets
:
   - images/
    - assets/data.json

Общие поля в pubspec.yaml

FieldsОписание
nameИмя проекта, должно использовать строчные буквы и подчеркивания.
versionНомер версии проекта, в формате x.y.z.
descriptionТекст описания проекта
dependenciesПакеты зависимостей времени выполнения
dev_dependenciesПакеты, необходимые для разработки (например, инструменты тестирования)
flutter.assetsФайлы ресурсов, которые необходимо упаковать

Управление зависимостями

Добавить зависимость

Использованиеflutter pub addКоманда для добавления зависимостей:

$ flutter pub add http

Или отредактируйте вручнуюpubspec.yamlЗатем выполните:

$ flutter pub get

Распространённые команды управления зависимостями

КомандаОписание
flutter pub getПолучить все зависимости
flutter pub add packageДобавить зависимость
flutter pub remove packageУдалить зависимости
flutter pub outdatedПроверить устаревшие зависимости
flutter pub upgradeОбновить зависимости до последних версий

Рекомендуемая структура проекта

По мере роста масштаба приложения рекомендуется придерживаться четкой структуры проекта:

lib/
├── main.dart              # 入口文件
├── app.dart               # 应用配置
├── core/                  # 核心功能
│   ├── constants/         # 常量定义
│   ├── theme/             # 主题配置
│   └── utils/             # 工具类
├── data/                  # 数据层
│   ├── models/            # 数据模型
│   ├── repositories/     # 仓库(数据接口)
│   └── services/          # 网络服务
├── domain/                # 领域层
│   └── entities/          # 实体类
├── presentation/          # 展示层
│   ├── pages/             # 页面
│   ├── widgets/           # 组件
│   └── providers/         # 状态管理
└── routes/                # 路由配置

Хорошая структура проекта может улучшить поддерживаемость кода. Рекомендуется выбирать подходящую структуру в зависимости от масштаба приложения.

Другие расширения