Structure du projet Flutter

Comprendre la structure des répertoires d'un projet Flutter est crucial pour un développement efficace.

Cette section fournira une introduction détaillée aux différents composants d'un projet Flutter et à leurs objectifs.


Structure des répertoires du projet

Lorsque vous utilisezflutter createAprès avoir créé un nouveau projet, vous obtiendrez la structure de répertoires suivante :

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         # 项目说明文件

Description des répertoires et fichiers principaux

Répertoire lib/ - Répertoire de code principal

lib/Ce répertoire est l'endroit principal où vous écrivez du code Dart. Toute la logique de l'application doit être placée ici.

Fichier/répertoireDescription
main.dartLe fichier d'entrée de l'application, contenant la fonction main et le Widget racine.
*.dartAutres fichiers source Dart, généralement organisés par modules fonctionnels.

Répertoire android/ - Plateforme Android

Contient les fichiers de projet natifs Android, utilisés pour :

  • Configurer le nom et l’icône de l’application
  • Définition des autorisations de l’application
  • Intégrer des SDK natifs (par exemple, Google Play services)

Répertoire ios/ - Plateforme iOS

Contient les fichiers de projet natifs iOS (projet Xcode), utilisés pour :

  • Configurer le nom et l’icône de l’application
  • Définir la configuration spécifique à iOS
  • Intégrer les dépendances CocoaPods

Répertoire test/ - Code de test

Contient le code de test de l’application, incluant généralement :

  • Tests unitaires
  • Tests de widgets
  • Tests d’intégration

pubspec.yaml - Configuration du projet

pubspec.yamlLe fichier de configuration principal du projet Flutter, définissant le nom, la version, les dépendances du projet, etc.

Exemple : échantillon de pubspec.yaml

# Nom du projet
name
: my_app
# Version du projet
version
: 1.0.0+1

# Description du projet
description
: "Ma première application Flutter"

# Environnement d'exécution
environment
:
  sdk
: ^3.0.0

# Dépendances du projet
dependencies
:
  flutter
:
    sdk
: flutter

  # Ajouter des dépendances tierces
  http
: ^1.0.0
  fournisseur
: ^6.0.0

# Dépendances de développement (utilisées uniquement pendant le développement)
dev_dependencies
:
  flutter_test
:
    sdk
: flutter
  flutter_lints
: ^3.0.0

# Configuration Flutter
flutter
:
  uses-material-design
: true

  # Configurer les fichiers de ressources
  assets
:
   - images/
    - assets/data.json

Champs courants dans pubspec.yaml

FieldsDescription
nameNom du projet, doit utiliser des lettres minuscules et des traits de soulignement.
versionNuméro de version du projet, au format x.y.z.
descriptionTexte de description du projet
dependenciesPaquets de dépendances d'exécution
dev_dependenciesPaquets nécessaires au développement (par exemple, outils de test)
flutter.assetsFichiers de ressources qui doivent être empaquetés

Gestion des dépendances

Ajouter une dépendance

Utilisationflutter pub addCommande pour ajouter des dépendances :

$ flutter pub add http

Ou modifier manuellementpubspec.yamlPuis exécutez :

$ flutter pub get

Commandes de dépendances courantes

CommandeDescription
flutter pub getObtenir toutes les dépendances
flutter pub add packageAjouter une dépendance
flutter pub remove packageSupprimer les dépendances
flutter pub outdatedVérifier les dépendances obsolètes
flutter pub upgradeMettre à jour les dépendances vers les dernières versions

Structure de projet recommandée

À mesure que l'échelle de l'application augmente, il est recommandé d'adopter une structure de projet claire :

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

Une bonne structure de projet peut améliorer la maintenabilité du code. Il est recommandé de choisir une structure appropriée en fonction de l'échelle de l'application.

autres extensions