Bonnes pratiques Flutter
Cette section présentera les bonnes pratiques et les normes de codage dans le développement Flutter.
Normes de code
Conventions de nommage
| Type | Règles | Exemple |
|---|---|---|
| Nom de classe | UpperCamelCase | MyHomePage |
| Fonctions/Variables | lowerCamelCase | userName, getData |
| Constantes | Upper Camel Case + préfixe k | kMaxCount |
| Fichier | Minuscules + trait de soulignement | my_home_page.dart |
Exemple : nommage correct
// Nom de classe - UpperCamelCase
class UserProfilePage extends StatelessWidget {}
// Fonction - lowerCamelCase
void fetchUserData() {}
// Variable - lowerCamelCase
String userName = 'Zhang San';
// Constantes - préfixe k
const int kMaxRetryCount = 3;
const String kAppName = 'My App';
// Énumération - UpperCamelCase
enum AppState { loading, success, error }
// Nom du fichier - snake_case
// user_profile_page.dart
class UserProfilePage extends StatelessWidget {}
// Fonction - lowerCamelCase
void fetchUserData() {}
// Variable - lowerCamelCase
String userName = 'Zhang San';
// Constantes - préfixe k
const int kMaxRetryCount = 3;
const String kAppName = 'My App';
// Énumération - UpperCamelCase
enum AppState { loading, success, error }
// Nom du fichier - snake_case
// user_profile_page.dart
Optimisation des performances
1. Éviter les reconstructions inutiles
Exemple : Utilisation du constructeur const
// Recommandé : utiliser const pour réduire les reconstructions
const Text('Hello') // Ne sera pas reconstruit
const SizedBox(width: 10)
// À éviter : chaque construction crée un nouvel objet
Text('Hello') // Sera reconstruit
// Utiliser const dans les listes
ListView(
children: const [
Texte('A'),
Texte('B'),
Texte('C'),
],
)
const Text('Hello') // Ne sera pas reconstruit
const SizedBox(width: 10)
// À éviter : chaque construction crée un nouvel objet
Text('Hello') // Sera reconstruit
// Utiliser const dans les listes
ListView(
children: const [
Texte('A'),
Texte('B'),
Texte('C'),
],
)
2. Utilisez des clés pour optimiser les performances des listes
Exemple : Utilisation correcte des clés
// Ajouter des clés uniques aux éléments de la liste
ListView.builder(
itemCount: items.length,
itemBuilder: (context, index) {
return ListTile(
key: ValueKey(items[index].id), // Utiliser des identifiants uniques comme clés
title: Text(items[index].name),
);
},
)
ListView.builder(
itemCount: items.length,
itemBuilder: (context, index) {
return ListTile(
key: ValueKey(items[index].id), // Utiliser des identifiants uniques comme clés
title: Text(items[index].name),
);
},
)
3. Chargement paresseux des éléments de liste
Exemple : Utilisation de ListView.builder
// Recommandé : utiliser builder pour le chargement paresseux
ListView.builder(
itemCount: 1000, // À utiliser pour les grandes listes
itemBuilder: (context, index) {
return ListTile(title: Text('Item $index'));
},
)
// À éviter : utiliser children pour construire de grandes listes
ListView(
children: List.generate(1000, (i) => Text('Item $i')),
)
ListView.builder(
itemCount: 1000, // À utiliser pour les grandes listes
itemBuilder: (context, index) {
return ListTile(title: Text('Item $index'));
},
)
// À éviter : utiliser children pour construire de grandes listes
ListView(
children: List.generate(1000, (i) => Text('Item $i')),
)
Structure du projet
Exemple : Structure de projet recommandée
// lib/
// ├── main.dart # fichier d'entrée
// ├── app.dart # configuration de l'application
// ├── core/ # fonctionnalités de base
// │ ├── constants/ # constantes
// │ ├── theme/ # thème
// │ ├── utils/ # classes utilitaires
// │ └── extensions/ # extensions
// ├── data/ # couche de données
// │ ├── models/ # modèles de données
// │ ├── repositories/ # Référentiels
// │ └── services/ # Services réseau
// ├── domain/ # Couche domaine
// │ └── entities/ # Entités
// ├── presentation/ # Couche présentation
// │ ├── pages/ # Pages
// │ ├── widgets/ # Widgets
// │ └── providers/ # Gestion d'état
// └── routes/ # Routes
// ├── main.dart # fichier d'entrée
// ├── app.dart # configuration de l'application
// ├── core/ # fonctionnalités de base
// │ ├── constants/ # constantes
// │ ├── theme/ # thème
// │ ├── utils/ # classes utilitaires
// │ └── extensions/ # extensions
// ├── data/ # couche de données
// │ ├── models/ # modèles de données
// │ ├── repositories/ # Référentiels
// │ └── services/ # Services réseau
// ├── domain/ # Couche domaine
// │ └── entities/ # Entités
// ├── presentation/ # Couche présentation
// │ ├── pages/ # Pages
// │ ├── widgets/ # Widgets
// │ └── providers/ # Gestion d'état
// └── routes/ # Routes
Gestion des erreurs
Exemple : Gestion globale des erreurs
void main() {
// Capture globale des exceptions
FlutterError.onError = (details) {
// Journaliser l'erreur
print('Flutter Error: ${details.exception}');
// Signaler l'erreur au serveur
reportError(details.exception);
};
// Capture des exceptions de zone
runZonedGuarded(() {
runApp(const MyApp());
}, (error, stackTrace) {
print('Zone Error: $error');
reportError(error);
});
}
// Capture globale des exceptions
FlutterError.onError = (details) {
// Journaliser l'erreur
print('Flutter Error: ${details.exception}');
// Signaler l'erreur au serveur
reportError(details.exception);
};
// Capture des exceptions de zone
runZonedGuarded(() {
runApp(const MyApp());
}, (error, stackTrace) {
print('Zone Error: $error');
reportError(error);
});
}
autres extensionsSuivre les meilleures pratiques peut rendre le code plus maintenable, améliorer les performances et réduire les bugs en production.