Estructura del Proyecto Flutter
Comprender la estructura de directorios de un proyecto Flutter es esencial para un desarrollo eficiente.
En esta sección se detallarán los diversos componentes de un proyecto Flutter y su función.
Estructura del directorio del proyecto
Cuando usasflutter createDespués de crear un nuevo proyecto, obtendrás la siguiente estructura de directorios:
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 # 项目说明文件
Descripción de los principales directorios y archivos
Directorio lib/ - Directorio de código principal
lib/Este directorio es el lugar principal donde escribes código Dart. Toda la lógica de la aplicación debe colocarse aquí.
| Archivo/Directorio | Descripción |
|---|---|
| main.dart | Archivo de entrada de la aplicación, contiene la función main y el Widget raíz |
| *.dart | Otros archivos fuente Dart, generalmente organizados por módulos funcionales |
Directorio android/ - Plataforma Android
Contiene los archivos del proyecto nativo de Android, para:
- Configurar el nombre e ícono de la aplicación
- Establecer los permisos de la aplicación
- Integrar SDK nativos (como Google Play Services)
Directorio ios/ - Plataforma iOS
Contiene los archivos del proyecto nativo de iOS (proyecto Xcode), para:
- Configurar el nombre e ícono de la aplicación
- Establecer configuraciones específicas de iOS
- Integrar dependencias de CocoaPods
Directorio test/ - Código de pruebas
Contiene el código de pruebas de la aplicación, que generalmente incluye:
- Pruebas unitarias
- Pruebas de Widgets
- Pruebas de integración
pubspec.yaml - Configuración del proyecto
pubspec.yamlEs el archivo de configuración central del proyecto Flutter, define el nombre del proyecto, versión, dependencias, etc.
Ejemplo: Muestra de pubspec.yaml
name: my_app
# Versión del proyecto
version: 1.0.0+1
# Descripción del proyecto
description: "Mi primera aplicación Flutter"
# Entorno de ejecución
environment:
sdk: ^3.0.0
# Dependencias del proyecto
dependencies:
flutter:
sdk: flutter
# Añadir dependencias de terceros
http: ^1.0.0
provider: ^6.0.0
# Dependencias de desarrollo (solo se usan durante el desarrollo)
dev_dependencies:
flutter_test:
sdk: flutter
flutter_lints: ^3.0.0
# Configuración de Flutter
flutter:
uses-material-design: true
# Configurar archivos de recursos
assets:
- images/
- assets/data.json
Campos comunes de pubspec.yaml
| Campo | Descripción |
|---|---|
| name | Nombre del proyecto, debe usar letras minúsculas y guiones bajos |
| version | Número de versión del proyecto, formato x.y.z |
| description | Texto de descripción del proyecto |
| dependencies | Paquetes de los que depende en tiempo de ejecución |
| dev_dependencies | Paquetes de los que depende en desarrollo (como herramientas de prueba) |
| flutter.assets | Archivos de recursos que necesitan empaquetarse |
Gestión de dependencias
Añadir dependencias
Usaflutter pub addel comando para añadir dependencias:
$ flutter pub add http
O edita manualmentepubspec.yamly luego ejecuta:
$ flutter pub get
Comandos comunes de dependencias
| Comando | Descripción |
|---|---|
| flutter pub get | Obtener todas las dependencias |
| flutter pub add package | Añadir dependencias |
| flutter pub remove package | Eliminar dependencias |
| flutter pub outdated | Verificar dependencias desactualizadas |
| flutter pub upgrade | Actualizar dependencias a la última versión |
Estructura de proyecto recomendada
A medida que la aplicación crece, se recomienda adoptar una estructura de proyecto clara:
lib/ ├── main.dart # 入口文件 ├── app.dart # 应用配置 ├── core/ # 核心功能 │ ├── constants/ # 常量定义 │ ├── theme/ # 主题配置 │ └── utils/ # 工具类 ├── data/ # 数据层 │ ├── models/ # 数据模型 │ ├── repositories/ # 仓库(数据接口) │ └── services/ # 网络服务 ├── domain/ # 领域层 │ └── entities/ # 实体类 ├── presentation/ # 展示层 │ ├── pages/ # 页面 │ ├── widgets/ # 组件 │ └── providers/ # 状态管理 └── routes/ # 路由配置
Otras extensionesUna buena estructura de proyecto mejora la mantenibilidad del código; se recomienda elegir la estructura adecuada según el tamaño de la aplicación.