رفتن به محتوا

مروری بر لینتر

لینتینگ فرایند تحلیل ایستأ کد برای شناسایی باگ‌ها و خطاهای منطقی و نگارشی است.

Bloc دارای یک لینتر داخلی است که می‌توان از طریق IDE یا ابزار خط فرمان bloc command-line tools با دستور bloc lint از آن استفاده کرد.

با کمک لینتر bloc می‌توانید کیفیت کد و یک‌دستی (consistency) در کدبیس خود را بدون اجرای هیچ‌کدام از خطوط کد بهبود دهید.

برای مثال، ممکن است به‌صورت سهوی یک وابستگی فلاتر را در cubit خود وارد کرده باشید:

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

در صورت پیکربندی صحیح، لینتر bloc به آن import اشاره کرده و هشدار زیر را تولید خواهد کرد:

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، ادامه مطلب را مطالعه کنید.