Riverpod — Flutter-এর জন্য কম্পাইলড ডিপেনডেন্সি ম্যানেজমেন্ট

Riverpod কী?

Riverpod Flutter-এর জন্য একটি স্টেট ম্যানেজমেন্ট এবং ডিপেনডেন্সি ইনজেকশন লাইব্রেরি যা প্রোভাইডার বর্ণনাকে নিরাপদ Dart কোডে কম্পাইল করে। Provider-এর বিপরীতে, Riverpod প্রোভাইডারগুলো BuildContext-এর সাথে আবদ্ধ নয়: এগুলি গ্লোবালি বা ProviderScope-এ তৈরি করা হয় এবং যেকোনো জায়গা থেকে অ্যাক্সেসযোগ্য। কম্পাইলার বিল্ড টাইমে টাইপ, ডিপেনডেন্সি এবং প্রোভাইডার গ্রাফের অখণ্ডতা পরীক্ষা করে, যার ফলে ProviderNotFoundException-এর মতো রানটাইম ত্রুটি দূর হয়।

Riverpod টেস্টিংয়ের জন্য override মডেল ব্যবহার করে: প্রতিটি প্রোভাইডারকে ProviderScope.overrideWith-এর মাধ্যমে সাবক্লাস তৈরি বা ইন্টারফেস মক না করেই ওভাররাইড করা যায়। এটি টেস্টিংকে বিচ্ছিন্ন করে: প্রতিটি টেস্ট ডিপেনডেন্সি গ্রাফের নিজস্ব কপি পায় যা সম্পূর্ণ নিয়ন্ত্রিত।

Flutter Community Survey 2025-এর তথ্য অনুসারে, Riverpod Provider এবং BLoC-এর পরে জনপ্রিয়তায় তৃতীয় স্থানে রয়েছে। তবে Riverpod হল সবচেয়ে দ্রুত বর্ধনশীল প্যাকেজ: 2024-এ +120% ইনস্টল। প্রধান কারণ: কম্পাইল-টাইম নিরাপত্তা, কোন ProviderNotFoundException নেই, AsyncValue-এর মাধ্যমে বিল্ট-ইন অ্যাসিঙ্ক সমর্থন।

প্রোভাইডারের প্রকারভেদ

Riverpod ৮ ধরনের প্রোভাইডার প্রদান করে, প্রতিটি নির্দিষ্ট পরিস্থিতির জন্য: Provider (ধ্রুবক/সেবা), StateProvider (আদিম অবস্থা), StateNotifierProvider (StateNotifier-সহ জটিল লজিক), ChangeNotifierProvider (Provider থেকে মাইগ্রেশনের জন্য), FutureProvider (অ্যাসিঙ্ক ডেটা, একবার), StreamProvider (রিঅ্যাকটিভ স্ট্রিম), NotifierProvider (নতুন API, Flutter 3.10+) এবং AsyncNotifierProvider (অ্যাসিঙ্ক 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 — অন্যান্য প্রোভাইডার অ্যাক্সেস করার জন্য প্রতিটি প্রোভাইডারে পাস করা অবজেক্ট। ref.watch — পরিবর্তনের সাবস্ক্রিপশন, ref.read — একবার পড়া, ref.invalidate — ক্যাশ রিসেট। ProviderRef Provider-এর BuildContext প্রতিস্থাপন করে: যেকোনো প্রোভাইডার উইজেট ট্রিতে অ্যাক্সেস ছাড়াই অন্য প্রোভাইডার পড়তে পারে। এটি UI লেয়ারের বাইরে ডিপেনডেন্সি গ্রাফ তৈরি করতে দেয়।

ProviderScope — মূল উইজেট, Riverpod কাজ করার জন্য বাধ্যতামূলক। ProviderScope সব প্রোভাইডার সংরক্ষণ করে, তাদের লাইফসাইকেল পরিচালনা করে এবং মান ক্যাশ করে। ProviderScope ছাড়া অ্যাপ ProviderNotFoundException-সহ ক্র্যাশ করবে। ProviderScope নেস্টেড হতে পারে — নেস্টেড স্কোপ প্যারেন্ট প্রোভাইডার ওভাররাইড করে, যা টেস্টিং এবং ফিচার আইসোলেশনের জন্য ব্যবহৃত হয়।

AsyncValue এবং অ্যাসিঙ্ক্রোনাসিটি নিয়ে কাজ

AsyncValue — অ্যাসিঙ্ক্রোনাস অবস্থা উপস্থাপনের জন্য Riverpod-এর সিলড ক্লাস। AsyncValue-এর তিনটি রূপ আছে: AsyncData (সফল ডেটা), AsyncError (ত্রুটি), AsyncLoading (লোড হচ্ছে)। loading/error/data-এর মধ্যে ম্যানুয়ালি স্যুইচ করার পরিবর্তে, প্রতিটি FutureProvider বা StreamProvider স্বয়ংক্রিয়ভাবে AsyncValue রিটার্ন করে, এবং উইজেট ref.watch-এর মাধ্যমে তিনটি অবস্থাই হ্যান্ডল করে।

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 — তিনটি অবস্থার প্যাটার্ন-ম্যাচিংয়ের জন্য মেথড। কম্পাইলার পরীক্ষা করে যে তিনটি ক্ষেত্রেই হ্যান্ডল করা হয়েছে — যদি আপনি loading বা error ভুলে যান, কোড কম্পাইল হবে না। AsyncValue.whenData — শুধুমাত্র ডেটার জন্য (যদি loading/error প্রয়োজন না হয়)। AsyncValue.guard — ব্যতিক্রমকে AsyncError-এ রূপান্তরের জন্য try-catch-এর উপর র্যাপার। keepAlive — একটি ফ্ল্যাগ যা প্রোভাইডার ক্যাশকে স্কোপের বাইরে যাওয়ার সময় ধ্বংস হতে বাধা দেয়।

কোড জেনারেশন এবং @riverpod

কোড জেনারেশন — Riverpod 2.0+-এর একটি মূল বৈশিষ্ট্য। ফাংশনে @riverpod অ্যানোটেশন স্বয়ংক্রিয়ভাবে সঠিক টাইপ, রিফ্যাক্টরিং সাপোর্ট এবং অটোকমপ্লিট-সহ একটি প্রোভাইডার জেনারেট করে। কোড জেনারেশন riverpod_generator এবং build_runner ব্যবহার করে। ডেভেলপার একটি পিওর ফাংশন লেখে, এবং বাকি সবকিছু — টাইপ, ক্লাস, ফ্যাক্টরি কনস্ট্রাক্টর — স্বয়ংক্রিয়ভাবে জেনারেট হয়।

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

// জেনারেটেড: final helloWorldProvider = Provider((ref) => 'Hello World');

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

Notifier — কোড জেনারেশন-সহ মিউটেবল স্টেটের জন্য নতুন API। Notifier একটি build() মেথড এবং স্টেট মিউটেশন মেথডসহ ক্লাস। StateNotifier-এর বিপরীতে, Notifier-এর আলাদা স্টেট ক্লাসের প্রয়োজন হয় না এবং getter/setter-এর মাধ্যমে state-তে সরাসরি অ্যাক্সেস দেয়। Riverpod @riverpod দিয়ে অ্যানোটেটেড প্রতিটি Notifier ক্লাসের জন্য স্বয়ংক্রিয়ভাবে NotifierProvider জেনারেট করে।

build_runner: কোড জেনারেশন dart run build_runner build কমান্ড দিয়ে চালানো হয়। জেনারেটেড ফাইলগুলোর .g.dart সাফিক্স থাকে এবং সোর্স কোডে ইমPORT করা হয়। যখন অ্যানোটেশন বা প্রোভাইডার টাইপ পরিবর্তন হয়, তখন কোড জেনারেশন পুনরায় চালানোর প্রয়োজন হয়। Riverpod 2.x সব নতুন প্রজেক্টের জন্য কোড জেনারেশন সুপারিশ করে — ম্যানুয়াল প্রোভাইডার তৈরি অপ্রচলিত হচ্ছে।

Riverpod বনাম Provider

মূল পার্থক্য Riverpod এবং Provider-এর মধ্যে: BuildContext থেকে স্বাধীনতা, কম্পাইল-টাইম নিরাপত্তা, বিল্ট-ইন অ্যাসিঙ্ক সাপোর্ট, অটো-ক্যাশিং এবং override-এর মাধ্যমে টেস্টিং। Provider-এর স্টেট অ্যাক্সেস করতে BuildContext প্রয়োজন (context.watch, context.read), Riverpod WidgetRef এবং গ্লোবালি ডিক্লেয়ারড প্রোভাইডার ব্যবহার করে।

Provider থেকে মাইগ্রেশন: Riverpod পুনর্লিখন ছাড়াই বিদ্যমান ChangeNotifier ব্যবহারের জন্য ChangeNotifierProvider.adaptive সমর্থন করে। ধাপে ধাপে মাইগ্রেশন: প্রথমে নতুন ফিচার Riverpod-এ লেখা হয়, তারপর পুরনো Provider ইন্সট্যান্স অ্যাডাপ্টারের মাধ্যমে Riverpod প্রোভাইডার দিয়ে প্রতিস্থাপন করা হয়। উভয় প্যাকেজ একটি প্রজেক্টে সহাবস্থান করতে পারে, যা ডেভেলপমেন্ট স্থগিত না করেই মাইগ্রেট করতে দেয়।

Riverpod টেস্টিং

Riverpod টেস্টিং ProviderScope.overrideWith-এর উপর ভিত্তি করে তৈরি। প্রতিটি প্রোভাইডার মক বা DI কন্টেইনার ছাড়াই একটি টেস্ট ProviderScope-এর ভিতরে ওভাররাইড করা হয়। ProviderContainer — Flutter ছাড়া টেস্টের জন্য বিচ্ছিন্ন পরিবেশ (বিশুদ্ধ Dart), যা উইজেট রেন্ডারিং ছাড়াই প্রোভাইডার টেস্ট করতে দেয়।

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 — Flutter ছাড়া। উইজেট ছাড়া প্রোভাইডারের ইউনিট টেস্টের জন্য ProviderContainer ব্যবহার করুন। overrideWithValue — একটি নির্দিষ্ট মান দিয়ে প্রোভাইডার প্রতিস্থাপন করা। overrideWith — প্রোভাইডার ফ্যাক্টরি দিয়ে প্রতিস্থাপন করা (সেবা মক করার জন্য)। autodispose — টেস্টে পরীক্ষা করুন যে প্রোভাইডার container.dispose() ব্যবহার করে স্কোপের বাইরে গেলে ধ্বংস হয়।