Riverpod — mohiyati, Flutter-da bog'liqliklarni kompilyatsiya qilish

Riverpod nima?

Riverpod — Flutter-da holatni boshqarish va bog'liqliklarni kiritish uchun kutubxona bo'lib, provider tavsiflarini xavfsiz Dart kodiga kompilyatsiya qiladi. Provider-dan farqli o'laroq, Riverpod providerlari BuildContext-ga bog'liq emas: ular global yoki ProviderScope ichida yaratiladi va istalgan joydan foydalanish mumkin. Kompilyator qurish bosqichida provider grafigining turlari, bog'liqliklari va yaxlitligini tekshiradi va ProviderNotFoundException kabi runtime xatolarini bartaraf qiladi.

Riverpod test qilish uchun override modelidan foydalanadi: har bir provider subklasslar yaratmasdan yoki interfeyslarni mock qilmasdan ProviderScope.overrideWith orqali bekor qilinishi mumkin. Bu testni izolyatsiya qiladi: har bir test to'liq boshqariladigan bog'liqlik grafigining o'z nusxasini oladi.

Flutter Community Survey 2025 ma'lumotlariga ko'ra, Riverpod mashhurlik bo'yicha Provider va BLoC-dan keyin uchinchi o'rinda. Shu bilan birga, Riverpod eng tez o'sayotgan paket: 2024-yilda +120% o'rnatish. Asosiy sabablar: kompilyatsiya xavfsizligi, ProviderNotFoundException yo'qligi, AsyncValue orqali asinxronlikning o'rnatilgan qo'llab-quvvatlanishi.

Provider turlari

Riverpod har biri muayyan stsenariy uchun 8 turdagi providerlarni taqdim etadi: Provider (doimiy/xizmat), StateProvider (sodda holat), StateNotifierProvider (StateNotifier bilan murakkab mantiq), ChangeNotifierProvider (Provider-dan migratsiya uchun), FutureProvider (asinxron ma'lumotlar, bir marta), StreamProvider (reaktiv oqim), NotifierProvider (yangi API, Flutter 3.10+) va AsyncNotifierProvider (asinxron Notifier).

final counterProvider = StateNotifierProvider<CounterNotifier, int>((ref) {
  return CounterNotifier();
});

class CounterNotifier extends StateNotifier<int> {
  CounterNotifier() : super(0);

  void increment() => state++;
  void decrement() => state--;
}

class CounterScreen extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final count = ref.watch(counterProvider);
    return Text('$count');
  }
}

ProviderRef — har bir providerga boshqa providerlarga kirish uchun uzatiladigan obyekt. ref.watch — o'zgarishlarga obuna bo'lish, ref.read — bir martalik o'qish, ref.invalidate — kesheni qayta tiklash. ProviderRef Provider-dagi BuildContext o'rnini bosadi: istalgan provider vidjet daraxtiga kirmasdan boshqa providerlarni o'qiy oladi. Bu UI qatlamidan tashqarida bog'liqlik grafigini qurish imkonini beradi.

ProviderScope — Riverpod ishlashi uchun majburiy bo'lgan ildiz vidjet. ProviderScope barcha providerlarni saqlaydi, ularning hayot aylanishini boshqaradi va qiymatlarni keshlaydi. ProviderScope bo'lmasa, dastur ProviderNotFoundException bilan ishdan chiqadi. ProviderScope ichma-ich bo'lishi mumkin — ichki scope ota-ona providerlarini bekor qiladi, bu test va funksiyalarni izolyatsiya qilish uchun ishlatiladi.

AsyncValue va asinxronlik bilan ishlash

AsyncValue — asinxron holatni ifodalash uchun Riverpod-ning sealed klassi. AsyncValue uch variantga ega: AsyncData (muvaffaqiyatli ma'lumot), AsyncError (xato), AsyncLoading (yuklanmoqda). loading/error/data o'rtasida qo'lda o'tish o'rniga, har bir FutureProvider yoki StreamProvider avtomatik ravishda AsyncValue qaytaradi va vidjet ref.watch orqali uchala holatni ham boshqaradi.

final userProvider = FutureProvider((ref) async {
  final api = ref.watch(apiProvider);
  return await api.fetchUser();
});

class UserScreen extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final userAsync = ref.watch(userProvider);
    return userAsync.when(
      data: (user) => UserWidget(user),
      error: (e, _) => ErrorWidget(e.toString()),
      loading: () => CircularProgressIndicator(),
    );
  }
}

AsyncValue.when — uchala holatning naqshini moslashtirish uchun metod. Kompilyator barcha uch holatning ishlanganligini tekshiradi — agar loading yoki error unutilsa, kod kompilyatsiya qilinmaydi. AsyncValue.whenData — faqat data uchun (agar loading/error kerak bo'lmasa). AsyncValue.guard — istisnoni AsyncError-ga aylantirish uchun try-catch o'rami. keepAlive — ko'rinish doirasidan chiqishda provider keshesining yo'q qilinishini oldini oluvchi bayroq.

Code Generation va @riverpod

Kodgeneratsiya — Riverpod 2.0+ ning asosiy xususiyati. Funksiya ustidagi @riverpod annotatsiyasi avtomatik ravishda to'g'ri turga ega, refaktoring qo'llab-quvvatlashi va avtoto'ldirish bilan provider yaratadi. Kodgeneratsiya riverpod_generator va build_runner dan foydalanadi. Dasturchi sof funksiya yozadi, qolgan hamma narsa — turlar, klasslar, fabrika konstruktorlari — avtomatik generatsiya qilinadi.

@riverpod
String helloWorld(HelloWorldRef ref) {
  return 'Hello World';
}

// Yaratildi: final helloWorldProvider = Provider((ref) => 'Hello World');

@riverpod
class Counter extends _$Counter {
  int build() => 0;
  void increment() => state++;
}

Notifier — kodgeneratsiya bilan mutatsiya qilinadigan holat uchun yangi API. Notifier build() metodi va holatni o'zgartiruvchi metodlarga ega klass. StateNotifier-dan farqli o'laroq, Notifier alohida holat klassini talab qilmaydi va getter/setter orqali state ga to'g'ridan-to'g'ri kirish imkonini beradi. Riverpod @riverpod annotatsiyasiga ega har bir Notifier klassi uchun avtomatik NotifierProvider yaratadi.

build_runner: kodgeneratsiya dart run build_runner build buyrug'i bilan ishga tushiriladi. Generatsiya qilingan fayllar .g.dart suffiksiga ega va manba kodiga import qilinadi. Annotatsiyalar yoki provider turlari o'zgarganda kodgeneratsiyani qayta ishga tushirish kerak. Riverpod 2.x barcha yangi loyihalar uchun kodgeneratsiyani tavsiya qiladi — providerlarni qo'lda yaratish eskirgan.

Riverpod vs Provider

Asosiy farqlar Riverpod va Provider o'rtasida: BuildContext-dan mustaqillik, kompilyatsiya xavfsizligi, asinxronlik bilan o'rnatilgan ishlash, avtomatik keshlash va override orqali test qilish. Provider holatga kirish uchun BuildContext talab qiladi (context.watch, context.read), Riverpod WidgetRef va global e'lon qilingan providerlardan foydalanadi.

Provider-dan migratsiya: Riverpod mavjud ChangeNotifier-larni qayta yozmasdan ishlatish uchun ChangeNotifierProvider.adaptive ni qo'llab-quvvatlaydi. Bosqichma-bosqich migratsiya: avval yangi funksiyalar Riverpod-da yoziladi, keyin eski Provider-lar adapter orqali Riverpod providerlari bilan almashtiriladi. Ikkala paket bir loyihada birga mavjud bo'lishi mumkin, bu rivojlanishni to'xtatmasdan migratsiya qilish imkonini beradi.

Riverpod-ni test qilish

Riverpod-ni test qilish ProviderScope.overrideWith ga asoslangan. Har bir provider mock va DI konteynerlarisiz test ProviderScope ichida bekor qilinadi. ProviderContainer — Fluttersiz (sof Dart) testlar uchun izolyatsiya qilingan muhit bo'lib, vidjetlarni ko'rsatmasdan providerlarni test qilish imkonini beradi.

import 'package:flutter_test/flutter_test.dart';
import 'package:riverpod/riverpod.dart';

void main() {
  test('Counter increments correctly', () {
    final container = ProviderContainer();
    container.read(counterProvider.notifier).increment();
    expect(container.read(counterProvider), 1);
  });

  testWidgets('UI updates on increment', (tester) async {
    await tester.pumpWidget(
      ProviderScope(
        overrides: [counterProvider.overrideWithValue(5)],
        child: CounterScreen(),
      ),
    );
    expect(find.text('5'), findsOneWidget);
  });
}

ProviderContainer — Fluttersiz. ProviderContainer-dan vidjetlarsiz providerlarning birlik testlari uchun foydalaning. overrideWithValue — providerni aniq qiymat bilan almashtirish. overrideWith — provider fabrikasi bilan almashtirish (xizmatlarni mock qilish uchun). autodispose — testlarda providerning ko'rinish doirasidan chiqishda container.dispose() bilan yo'q qilinishini tekshiring.