البدء مع فلاتر من الصفر: التثبيت، أول تطبيق وبنية المشروع
دليل خطوة بخطوة من تثبيت Flutter SDK حتى تشغيل أول تطبيق وفهم بنية المشروع، مع نصائح توفّر عليك الوقت في البداية.
اختيار طريقة إدارة الحالة من أول الأسئلة التي يواجهها كل مطوّر فلاتر. يشرح هذا المقال setState وProvider وRiverpod وBloc مع الشيفرة، ويخبرك أيها تختار لأي مشروع.

«الحالة» (State) هي البيانات التي تُبنى منها واجهتك وتتغير مع الوقت: عدّاد سلة المشتريات، والمستخدم المسجّل دخوله، ونتيجة البحث. والسؤال الأساسي: أين تعيش هذه البيانات، وكيف تتحدّث الواجهة عندما تتغير؟
يكفي للحالة المحلية لعنصر واحد (مثل هل اللوحة مفتوحة أم لا):
class CounterPage extends StatefulWidget {
const CounterPage({super.key});
@override
State<CounterPage> createState() => _CounterPageState();
}
class _CounterPageState extends State<CounterPage> {
int count = 0;
@override
Widget build(BuildContext context) {
return ElevatedButton(
onPressed: () => setState(() => count++),
child: Text('$count'),
);
}
}تبدأ المشكلة عندما تحتاج عدة شاشات إلى البيانات نفسها. ارفع الحالة إلى الأعلى قدر الإمكان، لكنها بعد حدّ معيّن تصبح معقّدة دون أداة مناسبة.
طبقة رقيقة فوق InheritedWidget. تنشئ ChangeNotifier وتضعه فوق عناصرك في الشجرة:
class CartModel extends ChangeNotifier {
final List<String> items = [];
void add(String item) {
items.add(item);
notifyListeners();
}
}
// near the root
ChangeNotifierProvider(create: (_) => CartModel(), child: const MyApp());
// in any widget below
final cart = context.watch<CartModel>();سهل التعلّم ويعمل بشكل ممتاز للمشاريع الصغيرة والمتوسطة.
تطوّر لـ Provider: مستقل عن BuildContext، وأسهل في الاختبار، وأكثر أمانًا وقت الترجمة:
final counterProvider = NotifierProvider<Counter, int>(Counter.new);
class Counter extends Notifier<int> {
@override
int build() => 0;
void increment() => state++;
}
// in a ConsumerWidget
final count = ref.watch(counterProvider);
ref.read(counterProvider.notifier).increment();كما يوفّر أدوات للبيانات غير المتزامنة مثل طلبات الشبكة.
نمط «حدث ← حالة». كل إجراء حدث، والمخرج حالة جديدة. يحتاج إلى شيفرة أكثر، لكن بنيته وقابليته للتنبؤ تؤتي ثمارها للفرق الكبيرة والتطبيقات المعقّدة.
setState وValueNotifier.أفضل أداة لإدارة الحالة هي التي يعرفها فريقك جيدًا.
يبني فريق فست فلاتر تطبيقات أندرويد وiOS والويب وسطح المكتب والمواقع بفلاتر: تقدير فوري بالدولار، ودفع على مراحل، والشيفرة المصدرية كاملة.