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épertoire | Description |
|---|---|
| main.dart | Le fichier d'entrée de l'application, contenant la fonction main et le Widget racine. |
| *.dart | Autres 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
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
| Fields | Description |
|---|---|
| name | Nom du projet, doit utiliser des lettres minuscules et des traits de soulignement. |
| version | Numéro de version du projet, au format x.y.z. |
| description | Texte de description du projet |
| dependencies | Paquets de dépendances d'exécution |
| dev_dependencies | Paquets nécessaires au développement (par exemple, outils de test) |
| flutter.assets | Fichiers 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
| Commande | Description |
|---|---|
| flutter pub get | Obtenir toutes les dépendances |
| flutter pub add package | Ajouter une dépendance |
| flutter pub remove package | Supprimer les dépendances |
| flutter pub outdated | Vérifier les dépendances obsolètes |
| flutter pub upgrade | Mettre à 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/ # 路由配置
autres extensionsUne 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.