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/DirectorioDescripción
main.dartArchivo de entrada de la aplicación, contiene la función main y el Widget raíz
*.dartOtros 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

# Nombre del proyecto
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

CampoDescripción
nameNombre del proyecto, debe usar letras minúsculas y guiones bajos
versionNúmero de versión del proyecto, formato x.y.z
descriptionTexto de descripción del proyecto
dependenciesPaquetes de los que depende en tiempo de ejecución
dev_dependenciesPaquetes de los que depende en desarrollo (como herramientas de prueba)
flutter.assetsArchivos 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

ComandoDescripción
flutter pub getObtener todas las dependencias
flutter pub add packageAñadir dependencias
flutter pub remove packageEliminar dependencias
flutter pub outdatedVerificar dependencias desactualizadas
flutter pub upgradeActualizar 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/                # 路由配置

Una 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.

Otras extensiones