Consulta rápida da API para o dia a dia.
Esta página resume as classes e os métodos mais usados de miniriverpod_core.dart e miniriverpod_flutter.dart.
Tipos centrais
Primitivas centrais de estado e provider.
AsyncValue<T>
AsyncLoading / AsyncData / AsyncError
Provider<T>
Provider síncrono com autoDispose opcional
AsyncProvider<T>
Provider assíncrono com seletor .future
Dica de leitura
AsyncValue não inclui um método when; use correspondência de padrões com switch ou verificações is.
Métodos de Ref e ProviderContainer
Métodos operacionais comuns para atualizar, invalidar, lidar com o ciclo de vida e executar mutações.
Sequência comum
Mapa de métodos
read / watch / listen : leia e assine providers.
invalidate / refresh / refreshValue : recalcule o estado.
onDispose / keepAlive / emit : ciclo de vida e conexão com streams.
mutation / mutate / invoke : operações de escrita rastreadas.
scope / overrideWithValue : overrides de DI e testes.
Resumo da API Flutter
Os pontos de entrada ProviderScope e WidgetRef são usados no código da aplicação.
// Escopo
ProviderScope(
child: const App(),
);
// ConsumerWidget
class Header extends ConsumerWidget {
const Header({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
final user = ref.watch(currentUser);
return Text('$user');
}
}
// Execução da mutação
await ref.invoke(userProvider.rename('Alice'));
ProviderScope(container: external) exige chamar manualmente container.dispose().
UncontrolledProviderScope nunca faz dispose do container injetado.
Consumer, ConsumerWidget e ConsumerStatefulWidget são todos suportados.
Próximos passos
Widgets Consumer
Implemente fluxos de escrita explícitos com controle de concorrência.
Abrir mutações