Bildirimsel programlama

İş mantığınızı Stateless widget'lara benzer bir biçimde yazın.
Ağ isteklerinizin gerektiğinde otomatik olarak yeniden hesaplanmasını sağlayın ve mantığınızı kolayca yeniden kullanılabilir/birleştirilebilir/bakımı kolay hale getirin.

Yaygın arayüz kalıplarını kolayca uygulayın

Riverpod ile "yenilemek için çek" / "yazdıkça ara" gibi yaygın ama karmaşık arayüz kalıpları yalnızca birkaç satır kod uzağınızda.

Araçlarla uyumlu

Riverpod, sık yapılan hataları derleme hatasına dönüştürerek derleyiciyi güçlendirir. Ayrıca özel lint kuralları ve yeniden düzenleme seçenekleri sunar. Hatta doküman üretmek için bir komut satırı aracı bile vardır.

Özellikler

✅ Declarative programming
✅ Native network requests support
✅ Automatic loading/error handling
✅ Compile safety
✅ Type-safe query parameters
✅ Test ready
✅ Work in plain Dart (servers/CLI/...)
✅ Easily combinable states
✅ Built-in support for pull-to-refresh
✅ Custom lint rules
✅ Built-in refactorings
✅ Hot-reload support
✅ Logging
✅ Websocket support
✅ Documentation generator

Durumu her yerden paylaşın

main.dart ve kullanıcı arayüzü dosyalarınız arasında geçiş yapmanıza gerek yok. Paylaşılan durum kodunuzu, ayrı bir pakette veya ihtiyaç duyulan Widget'ın hemen yanında, test yapma yeteneğini kaybetmeden yazın.

// A shared state that can be accessed by multiple widgets at the same time.
@riverpod
class Count extends _$Count {
  @override
  int build() => 0;

  void increment() => state++;
}

// Consumes the shared state and rebuild when it changes
class Title extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final count = ref.watch(countProvider);
    return Text('$count');
  }
}

Durumu ve kullanıcı arayüzünü yalnızca gerektiğinde yeniden hesaplayın

build yönteminde listeleri sıralamak ve/veya filtrelemek zorunda kalmayız veya gelişmiş bir önbellekleme mekanizmasına başvurmak zorunda kalmayız.

Provider ve "families" ile listelerinizi yalnızca gerçekten ihtiyaç duyduğunuzda sıralayabilir veya HTTP istekleri yapabilirsiniz.

@riverpod
List<Todo> filteredTodos(Ref ref) {
  // Providers can consume other providers using the "ref" object.
  // With ref.watch, providers will automatically update if the watched values changes.
  final List<Todo> todos = ref.watch(todosProvider);
  final Filter filter = ref.watch(filterProvider);

  switch (filter) {
    case Filter.all:
      return todos;
    case Filter.completed:
      return todos.where((todo) => todo.completed).toList();
    case Filter.uncompleted:
      return todos.where((todo) => !todo.completed).toList();
  }
}

Günlük işinizi yeniden düzenlemelerle kolaylaştırın

Riverpod, "Widget'ı Consumer ile sarmala" gibi çeşitli yeniden düzenleme (refactoring) seçenekleri sunar. yeniden düzenlemeler listesine göz atın.

Lint kurallarıyla kodunuzun bakımını kolay tutun

Riverpod'a özgü yeni lint kuralları geliştirildi ve sürekli yenileri ekleniyor. Bu, kodunuzun en iyi durumda kalmasını sağlar. lint kuralları listesine göz atın.

Provider'ı güvenli bir şekilde okuyun

Bir provider'ı okumak hiçbir zaman kötü bir duruma neden olmaz. Bir provider'ı okumak için gerekli kodu yazabiliyorsanız, geçerli bir değer elde edersiniz.

Bu, asenkron olarak elde edilen değerler için bile geçerlidir. Provider'ın aksine, Riverpod yükleme ve hata durumlarını temiz bir şekilde yönetmenize izin verir.

@riverpod
Future<Configuration> configurations(Ref ref) async {
  final uri = Uri.parse('configs.json');
  final rawJson = await File.fromUri(uri).readAsString();

  return Configuration.fromJson(json.decode(rawJson));
}

class Example extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final configs = ref.watch(configurationsProvider);

    // Use pattern matching to safely handle loading/error states
    return switch (configs) {
      AsyncData(:final value) => Text('data: ${value.host}'),
      AsyncError(:final error) => Text('error: $error'),
      _ => const CircularProgressIndicator(),
    };
  }
}

Durumunuzu geliştirici aracında inceleyin

Riverpod kullanarak, varsayılan olarak, durumunuz Flutter geliştirici aracında görülebilir. Dahası, kapsamlı bir durum inceleme aracı geliştirme aşamasındadır.