Native Plugins: وصل للـ Device

الهدف

بعد هالدرس تعرف كيف تثبّت وتستخدم Capacitor plugins، تقدر تاخذ صورة بالـ Camera، تحفظ ملف بالـ Filesystem، وتتحقق من حالة الشبكة.

ليش هذا الحين؟

Capacitor بدون plugins = website في native shell. الـ plugins هي اللي تخلي التطبيق يحس إنه mobile حقيقي — Camera، Filesystem، GPS، Haptics. هالدرس يعلمك النمط مرة وحدة وتكرره مع أي plugin.

الفكرة

كل Capacitor plugin يتبع نفس النمط:

npm install @capacitor/plugin-name
npx cap sync (يثبّت الكود الـ native في iOS/Android)
إضافة permissions في Info.plist (iOS) و AndroidManifest.xml (Android)
استدعاء الـ plugin من JavaScript

الـ plugins الرسمية (Official) من Ionic — مضمونة، مدعومة، تشتغل على iOS و Android:

@capacitor/camera — كاميرا وألبوم
@capacitor/filesystem — قراءة وكتابة ملفات
@capacitor/network — حالة الشبكة
@capacitor/preferences — تخزين key-value بسيط
@capacitor/push-notifications — push notifications
@capacitor/geolocation — GPS
@capacitor/haptics — اهتزاز و haptic feedback
@capacitor/status-bar — شريط الحالة
@capacitor/keyboard — لوحة المفاتيح

الـ community plugins من مطورين خارجيين — تحقق من عدد النجوم وآخر commit قبل ما تستخدمها.

Permissions: كل API حساس يحتاج إذن من المستخدم. iOS يطلب الإذن أول مرة تستخدم الـ API. Android 6+ نفس الشيء. لو الإذن انرفض، تحتاج توجّه المستخدم لـ Settings يدويا — الـ plugin ما يفتح Settings تلقائيا.