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

TypeRèglesExemple
Nom de classeUpperCamelCaseMyHomePage
Fonctions/VariableslowerCamelCaseuserName, getData
ConstantesUpper Camel Case + préfixe kkMaxCount
FichierMinuscules + trait de soulignementmy_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

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'),
  ],
)

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),
    );
  },
)

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')),
)

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

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);
  });
}

Suivre les meilleures pratiques peut rendre le code plus maintenable, améliorer les performances et réduire les bugs en production.

autres extensions