Riverpod — esensi, kompilasi dependensi di Flutter

Apa itu Riverpod?

Riverpod — sebuah pustaka untuk manajemen state dan injeksi dependensi di Flutter yang mengkompilasi deskripsi provider menjadi kode Dart yang aman. Tidak seperti Provider, provider Riverpod tidak terikat pada BuildContext: mereka dibuat secara global atau di ProviderScope dan dapat diakses dari mana saja. Kompilator memeriksa tipe, dependensi, dan integritas graf provider pada tahap build, menghilangkan kesalahan runtime seperti ProviderNotFoundException.

Riverpod menggunakan model override untuk pengujian: setiap provider dapat ditimpa melalui ProviderScope.overrideWith tanpa perlu membuat subkelas atau mem-mock antarmuka. Ini membuat pengujian menjadi terisolasi: setiap pengujian mendapatkan salinan graf dependensinya sendiri yang sepenuhnya terkontrol.

Menurut Flutter Community Survey 2025, Riverpod menempati posisi ketiga dalam popularitas setelah Provider dan BLoC. Pada saat yang sama, Riverpod adalah paket dengan pertumbuhan tercepat: +120% instalasi pada tahun 2024. Alasan utama: keamanan kompilasi, tidak adanya ProviderNotFoundException, dukungan asinkronisitas bawaan melalui AsyncValue.

Tipe-tipe Provider

Riverpod menyediakan 8 tipe provider, masing-masing untuk skenario tertentu: Provider (konstanta/layanan), StateProvider (state primitif), StateNotifierProvider (logika kompleks dengan StateNotifier), ChangeNotifierProvider (untuk migrasi dari Provider), FutureProvider (data asinkron, sekali), StreamProvider (aliran reaktif), NotifierProvider (API baru, Flutter 3.10+) dan AsyncNotifierProvider (Notifier asinkron).

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 — objek yang diteruskan ke setiap provider untuk mengakses provider lain. ref.watch — berlangganan perubahan, ref.read — pembacaan sekali, ref.invalidate — mereset cache. ProviderRef menggantikan BuildContext dari Provider: provider mana pun dapat membaca provider lain tanpa akses ke pohon widget. Ini memungkinkan pembangunan graf dependensi di luar lapisan UI.

ProviderScope — widget root wajib untuk menjalankan Riverpod. ProviderScope menyimpan semua provider, mengelola siklus hidupnya, dan menyimpan cache nilai. Tanpa ProviderScope, aplikasi akan crash dengan ProviderNotFoundException. ProviderScope dapat bersarang — scope bersarang menimpa provider induk, yang digunakan untuk pengujian dan isolasi fitur.

AsyncValue dan bekerja dengan asinkronisitas

AsyncValue — kelas sealed Riverpod untuk merepresentasikan state asinkron. AsyncValue memiliki tiga varian: AsyncData (data berhasil), AsyncError (kesalahan), AsyncLoading (memuat). Alih-alih beralih secara manual antara loading/error/data, setiap FutureProvider atau StreamProvider secara otomatis mengembalikan AsyncValue, dan widget menangani ketiga status melalui 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 — metode untuk pencocokan pola ketiga status. Kompilator memeriksa bahwa ketiga kasus telah ditangani — jika loading atau error dilupakan, kode tidak akan dikompilasi. AsyncValue.whenData — hanya untuk data (jika loading/error tidak diperlukan). AsyncValue.guard — pembungkus try-catch untuk mengonversi pengecualian menjadi AsyncError. keepAlive — bendera yang mencegah penghancuran cache provider saat keluar dari cakupan visibilitas.

Code Generation dan @riverpod

Pembuatan kode — fitur utama Riverpod 2.0+. Anotasi @riverpod di atas fungsi secara otomatis menghasilkan provider dengan tipe yang benar, dukungan refactoring, dan penyelesaian otomatis. Pembuatan kode menggunakan riverpod_generator dan build_runner. Pengembang menulis fungsi murni, dan sisanya — tipe, kelas, konstruktor factory — dihasilkan secara otomatis.

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

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

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

Notifier — API baru untuk state yang dapat diubah dengan pembuatan kode. Notifier adalah kelas dengan metode build() dan metode untuk mengubah state. Tidak seperti StateNotifier, Notifier tidak memerlukan kelas state terpisah dan memberikan akses langsung ke state melalui getter/setter. Riverpod secara otomatis menghasilkan NotifierProvider untuk setiap kelas Notifier dengan anotasi @riverpod.

build_runner: pembuatan kode dijalankan dengan perintah dart run build_runner build. File yang dihasilkan memiliki akhiran .g.dart dan diimpor ke kode sumber. Saat mengubah anotasi atau tipe provider, pembuatan kode harus dijalankan ulang. Riverpod 2.x merekomendasikan pembuatan kode untuk semua proyek baru — pembuatan provider secara manual mulai usang.

Riverpod vs Provider

Perbedaan utama Riverpod dari Provider: independensi dari BuildContext, keamanan kompilasi, kerja bawaan dengan asinkronisitas, caching otomatis dan pengujian melalui override. Provider memerlukan BuildContext untuk mengakses state (context.watch, context.read), Riverpod menggunakan WidgetRef dan provider yang dideklarasikan secara global.

Migrasi dari Provider: Riverpod mendukung ChangeNotifierProvider.adaptive untuk menggunakan ChangeNotifier yang ada tanpa menulis ulang. Migrasi bertahap: pertama fitur baru ditulis dengan Riverpod, kemudian Provider lama diganti dengan provider Riverpod melalui adaptor. Kedua paket dapat hidup berdampingan dalam satu proyek, memungkinkan migrasi tanpa menghentikan pengembangan.

Menguji Riverpod

Menguji Riverpod didasarkan pada ProviderScope.overrideWith. Setiap provider ditimpa di dalam ProviderScope pengujian tanpa mock dan container DI. ProviderContainer — lingkungan terisolasi untuk pengujian tanpa Flutter (Dart murni), memungkinkan pengujian provider tanpa merender widget.

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 — tanpa Flutter. Gunakan ProviderContainer untuk pengujian unit provider tanpa widget. overrideWithValue — mengganti provider dengan nilai tertentu. overrideWith — mengganti dengan pabrik provider (untuk mem-mock layanan). autodispose — dalam pengujian, periksa apakah provider dihancurkan saat keluar dari cakupan visibilitas, dengan container.dispose().