ما هي قنوات المنصة (Platform Channels) في Flutter؟

Question

Accepted Answer

**قنوات المنصة (Platform Channels)** هي آلية Flutter للتواصل بين **كود Dart والكود الأصلي للمنصة** (iOS/Android) — مما يسمح لـ Flutter بالوصول إلى الميزات الأصلية أو الكود الأصلي الموجود مسبقاً والذي غير متاح من خلال حزم Dart. إنها تربط Flutter بالمنصة الأساسية.

## لماذا توجد قنوات المنصة

```text
Flutter (Dart) can't directly access every native platform feature. Platform channels
let Dart call NATIVE code (Kotlin/Java on Android, Swift/Objective-C on iOS):
  → access native APIs/SDKs not covered by existing plugins
  → use existing native libraries or platform-specific functionality
  → integrate with native code in a hybrid app
→ The bridge between Flutter and the native platform.
```

## كيف تعمل قنوات الطرق (Method Channels)

```dart
// Dart side: invoke a native method via a MethodChannel
static const platform = MethodChannel('com.example/battery');

Future<int> getBatteryLevel() async {
  final int level = await platform.invokeMethod('getBatteryLevel');  // call native
  return level;
}
```

```kotlin
// Native side (Android/Kotlin): handle the method call
MethodChannel(flutterEngine, "com.example/battery").setMethodCallHandler { call, result ->
  if (call.method == "getBatteryLevel") {
    result.success(getBatteryLevel())   // return the result to Dart
  }
}
```

**MethodChannel** يسمح لـ Dart باستدعاء الطرق الأصلية واستقبال النتائج (غير متزامن). الجانب الأصلي يتعامل مع الاستدعاء ويرجع قيمة.

## أنواع القنوات والاعتبارات

```text
MethodChannel → call native methods (request/response) — most common
EventChannel → stream of events FROM native to Dart (e.g. sensor data)
BasicMessageChannel → send messages both ways
→ Most apps use PLUGINS (which use channels internally) rather than writing channels
  directly. Write channels when no plugin exists for what you need.
→ Requires native code knowledge (Kotlin/Swift); platform-specific implementation per OS.
```

## لماذا يهمك هذا

فهم قنوات المنصة هو معرفة قيّمة على مستوى أعلى لأنها **كيف يصل Flutter إلى إمكانيات المنصة الأصلية** التي لا تتوفر من خلال Dart، وهذه قدرة مهمة للتطبيقات التي تحتاج إلى ميزات أصلية، لذلك هي مفيدة لتطوير Flutter متقدم.

الحاجة الأساسية — Flutter (Dart) لا يمكنها الوصول المباشر إلى كل ميزة منصة أصلية، لذلك **قنوات المنصة تربط Dart بالكود الأصلي** (Kotlin/Java على Android، Swift/Objective-C على iOS) — تعالج حداً حقيقياً: عندما يحتاج التطبيق إلى API أصلي أو SDK أو مكتبة أصلية موجودة مسبقاً لم تغطها الإضافات المتاحة في Flutter، قنوات المنصة هي الطريقة للوصول إليها.

فهم **كيفية عمل قنوات الطرق** (Dart استدعاء الطرق الأصلية عبر `MethodChannel` واستقبال النتائج غير المتزامنة، حيث يتعامل الجانب الأصلي مع الاستدعاء ويرجع قيمة) هو الآلية الأساسية للتواصل بين Dart والكود الأصلي.

فهم **أنواع القنوات** (MethodChannel للاستدعاءات من نوع الطلب/الرد — الأكثر شيوعاً؛ EventChannel لتدفقات الأحداث من الجانب الأصلي مثل بيانات الاستشعار؛ BasicMessageChannel للرسائل ثنائية الاتجاه) يغطي خيارات التواصل.

ومن المهم، فهم **السياق العملي** — أن معظم التطبيقات تستخدم **الإضافات (Plugins)** (التي تستخدم قنوات المنصة داخلياً) بدلاً من كتابة القنوات مباشرة، وأنك تكتب القنوات بنفسك عندما لا توجد إضافة لما تحتاجه — يعكس الاستخدام الواقعي، ومعرفة أن هذا يتطلب معرفة بالكود الأصلي (Kotlin/Swift) والتنفيذ الخاص بكل نظام تشغيل يضع التوقعات المناسبة.

قنوات المنصة تمكّن Flutter من التكامل مع الكود الأصلي والوصول إلى المنصة الكاملة، وهذا مهم للتطبيقات التي تتطلب متطلبات أصلية.

بما أن الوصول إلى إمكانيات أصلية أحياناً ضروري (عندما لا تغطيها الإضافات) وقنوات المنصة هي آلية Flutter لذلك، وبما أن فهم كيفية عملها وأنواع القنوات ومتى تكون مطلوبة هو معرفة قيّمة لتطوير Flutter متقدم، فإن فهم قنوات المنصة هو معرفة قيّمة على مستوى أعلى — الجسر الذي يمكّن Flutter من الوصول إلى ميزات المنصة الأصلية، وهو مهم للتطبيقات التي تتطلب تكاملاً أصلياً ويعكس فهماً أعمق للمنصة المتوقع لأدوار Flutter الأعلى.