Aller au contenu

Vue d'ensemble du Linter

La vérification de code (linting) est un processus d’analyse statique du code qui permet d’identifier les bugs potentiels ainsi que les erreurs programmatiques et stylistiques.

Bloc dispose d’un linter intégré, qui peut être utilisé via votre IDE ou la CLI bloc avec la commande bloc lint.

Grâce au linter bloc, vous pouvez améliorer la qualité de votre codebase et assurer la cohérence sans avoir à écrire une seule ligne de code.

Par exemple, si vous importez accidentellement une dépendance Flutter dans votre cubit :

counter_cubit.dart
import 'package:bloc/bloc.dart';
import 'packages:flutter/material.dart';
class CounterCubit extends Cubit<int> {
CounterCubit() : super(0);
}

S’il est correctement configuré, le linter bloc pointera du doigt l’import et produira l’avertissement suivant.

Fenêtre de terminal
warning[avoid_flutter_imports]: Avoid importing Flutter within bloc instances.
--> counter_cubit.dart:2
|
| import 'package:flutter/material.dart';
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
= hint: Blocs should be decoupled from Flutter.
docs: https://bloclibrary.dev/lint-rules/avoid_flutter_imports
1 issue found
Analyzed 1 file

Dans les sections suivantes, nous verrons comment installer, configurer et personnaliser le linter bloc pour que vous puissiez profiter des avantages de l’analyse statique.

Commencez à utiliser le linter bloc en quelques étapes simples et rapides.

  1. Installez la CLI bloc

    Fenêtre de terminal
    dart pub global activate bloc_tools
  2. Installez le package bloc_lint

    Fenêtre de terminal
    dart pub add --dev bloc_lint:^0.2.0-dev
  3. Ajoutez un fichier analysis_options.yaml à la racine de votre projet avec les règles recommandées

    analysis_options.yaml
    include: package:bloc_lint/recommended.yaml
  4. Exécutez le linter

    Fenêtre de terminal
    bloc lint .

Félicitations, c’est tout ce qu’il y avait à faire 🎉

Continuez la lecture de cette documentation pour un aperçu plus approfondi de la configuration et de la personnalisation du linter bloc.