Riverpod: state bất đồng bộ có thể test mà không dính widget

riverpod đáng chú ý vì nó giải quyết provider, trạng thái async, cache và override dependency. Bài này trình bày cách đặt package vào đúng boundary của một ứng dụng Flutter production thay vì chỉ copy một snippet vào màn hình.

Package này sở hữu phần nào?

• Giữ API của package ở một adapter hoặc feature boundary có tên rõ ràng.
• Đưa lifecycle, lỗi và trạng thái loading vào contract mà UI có thể kiểm thử.
• Chỉ expose capability cần thiết; đừng để toàn app phụ thuộc vào chi tiết triển khai.

Snippet bắt đầu

final usersProvider = FutureProvider<List<User>>((ref) async {
  final api = ref.watch(apiProvider);
  return api.fetchUsers();
});

class UsersView extends ConsumerWidget {
  const UsersView({super.key});
  @override
  Widget build(BuildContext context, WidgetRef ref) =>
      ref.watch(usersProvider).when(
        data: (users) => UserList(users),
        loading: () => const CircularProgressIndicator(),
        error: (error, stack) => Text('Failed: $error'),
      );
}

Checklist trước khi ship

1. Đọc README và changelog của package đúng version đang pin.
2. Viết một test cho lifecycle, lỗi và hành vi khi app về background.
3. Kiểm tra Android, iOS, web hoặc desktop đúng platform mà app hỗ trợ.
4. Ghi lại owner, upgrade cadence và kế hoạch rollback trong repo.

Pitfall hay gặp

Cây provider không thay thế boundary domain; đừng đưa API model thẳng vào UI state.

Kết luận

Thư viện OSS tốt không thay thế kiến trúc. Nó giúp một boundary khó trở nên rõ ràng, có thể quan sát và dễ thay thế hơn.