miniriverpod په څو دقیقو کې نصب کړئ.

SDK constraints وټاکئ، package اضافه کړئ، او ډاډ ترلاسه کړئ چې ProviderScope + WidgetRef.watch سم نښلول شوي دي.

اړتیاوې

د package په څېر هماغه constraints وکاروئ څو analyzer او runtime mismatch رامنځته نه شي.

Dart SDK

>=3.10.0 <4.0.0

Flutter

لارښوونه

که ستاسو app له Dart 3.10 ښکته pin شوې وي، لومړی SDK constraints لوړ کړئ، بیا flutter pub get وچلوئ.

نصب

د CLI نصب ته لومړیتوب ورکړئ، بیا نسخه د package changelog سره برابره وساتئ.

CLI

pubspec.yaml

# انحصارونو ته اضافه کړئ
dependencies:
  miniriverpod: ^0.0.2

لومړني ګامونه

خپله app په ProviderScope کې راونغاړئ، یو Provider تعریف کړئ، او له ConsumerWidget څخه state وښایاست.

import 'package:flutter/widgets.dart';
import 'package:miniriverpod/miniriverpod.dart';

final counterProvider = Provider<int>((ref) => 0);

void main() {
  runApp(const ProviderScope(child: CounterApp()));
}

class CounterApp extends ConsumerWidget {
  const CounterApp({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final count = ref.watch(counterProvider);
    return Directionality(
      textDirection: TextDirection.ltr,
      child: Center(child: Text('$count')),
    );
  }
}
د سنکرون ارزښتونو لپاره Provider((ref) => ...) وکاروئ.
د Future لپاره AsyncProvider<T>((ref) async => ...) او د Stream لپاره ref.emit(stream) وکاروئ.
کله چې mutations پلي کوئ، ref.invoke(provider.method()) ته واوړئ.

راتلونکې ګامونه

اصلي مفاهیم

د args-بنسټ provider identity، Scope injection، او codegen-نه لرونکي design choices درک کړئ.

Core Concepts پرانیزئ

Providers او Reads

د watch/read/listen چلند او AsyncProvider refresh patterns زده کړئ.

Providers پرانیزئ

API حواله

په چټکۍ سره invalidate, refreshValue, keepAlive, او invoke ومومئ.

API Reference پرانیزئ