Структура проекта 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/ # 路由配置
Другие расширенияХорошая структура проекта может улучшить поддерживаемость кода. Рекомендуется выбирать подходящую структуру в зависимости от масштаба приложения.