Перейти до вмісту

Огляд лінтера

Лінтинг — це процес статичного аналізу коду для виявлення потенційних помилок, а також програмних і стилістичних проблем.

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 вкаже на імпорт і видасть наступне попередження:

Terminal window
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

    Terminal window
    dart pub global activate bloc_tools
  2. Встановіть пакет bloc_lint

    Terminal window
    dart pub add --dev bloc_lint
  3. Додайте файл analysis_options.yaml у корінь вашого проєкту з рекомендованими правилами

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

    Terminal window
    bloc lint .

Ось і все 🎉

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