Перейти к содержимому

Обзор линтера

Линтинг — это процесс статического анализа кода для выявления потенциальных ошибок, а также программных и стилистических проблем.

Bloc имеет встроенный линтер, который можно использовать через вашу IDE или инструменты командной строки bloc с помощью команды bloc lint.

С помощью линтера bloc вы можете повысить качество вашей кодовой базы и обеспечить единообразие без выполнения ни одной строки кода.

Например, возможно, вы случайно импортировали зависимость Flutter в ваш cubit:

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

При правильной настройке линтер bloc укажет на импорт и выдаст следующее предупреждение:

Окно терминала
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

В следующих разделах мы рассмотрим, как установить, настроить и кастомизировать линтер bloc, чтобы вы могли воспользоваться преимуществами статического анализа в вашей кодовой базе.

Начните использовать линтер bloc всего за несколько быстрых и простых шагов.

  1. Установите инструменты командной строки bloc

    Окно терминала
    dart pub global activate bloc_tools
  2. Установите пакет bloc_lint

    Окно терминала
    dart pub add --dev bloc_lint
  3. Добавьте файл analysis_options.yaml в корень вашего проекта с рекомендуемыми правилами

    analysis_options.yaml
    include: package:bloc_lint/recommended.yaml
  4. Запустите линтер

    Окно терминала
    bloc lint .

Вот и всё 🎉

Продолжайте чтение для более подробного изучения настройки и кастомизации линтера bloc.