Cordova/Topics

من موسوعة حسوب
مراجعة 13:57، 24 ديسمبر 2018 بواسطة جميل-بيلوني (نقاش | مساهمات) (إضافة قسم من شرح الصفحة)

البدء باستعمال كوردوفا

نظرة عامة

يعطي هذا القسم لمحة مختصرة عن كوردوفا ويشرح المعمارية المتبعة في بناء التطبيقات باستعمال كوردوفا، وعارض الويب المستعمل، وأهمية الإضافات وكيفية توسيعها لعمل التطبيق، ومسارات التطوير المتبعة أثناء إنشاء التطبيق.

تثبيت كوردوفا وإنشاء أول تطبيق

يوضح لك هذا الدليل كيفية تثبيت كوردوفا وإنشاء تطبيق متكامل فيها اعتمادًا على HTML و JS ونشره على العديد من المنصات الأصلية للجوّال باستخدام واجهة سطر أوامر كوردوفا (CLI). للحصول على مرجع تفصيلي حول سطر أوامر كوردوفا، اطلع على صفحة واجهة سطر الأوامر.

استعمال القوالب الجاهزة

يشرح هذا القسم كيفية الاستفادة من القوالب الجاهزة عبر استخدام شيفرة برمجية موجودة مسبقًا لتبني عليها مشروعك. يتطرق أيضًا إلى كيفية إنشاء قالب ومشاركته مع الآخرين.

دعم المنصات

يوضح هذا القسم مجموعة أدوات التطوير وواجهات برمجة التطبيقات للجهاز (device APIs) المتاحة لكل منصة من منصات الجوال.

إنشاء التطبيقات

التطوير على مختلف المنصات

منصة أندرويد

يوضح هذا القسم كيفية إعداد بيئة SDK لنشر تطبيقات كوردوفا لأجهزة أندرويد، وكيفية استخدام أدوات سطر الأوامر المتمحورة حول أندرويد اختياريًا في سير عمل التطوير الخاص بك.

منصة iOS

يوضح هذا القسم كيفية إعداد بيئة تطوير SDK لنشر تطبيقات كوردوفا للأجهزة التي تعمل على أنظمة iOS مثل iPhone و iPad وكيفية استخدام أدوات سطر الأوامر المرتكزة على منصة iOS بشكل اختياري في سير عمل التطوير الخاص بك. 

منصة ويندوز

يوضح هذا القسم كيفية إعداد بيئة تطوير SDK الخاصة بك لإنشاء تطبيقات كوردوفا ونشرها على منصات Windows 8.1، و Windows Phone 8.1، و Windows 10 Universal App. يوضح أيضًا كيفية استخدام أدوات الصدفة (shell) لتوليد وبناء التطبيقات، أو واجهة سطر أوامر كوردوفا العابر للمنصات. بالإضافة إلى ذلك، يتطرق هذا القسم إلى كيفية تعديل تطبيقات كوردوفا داخل Visual Studio. 

منصة OS X

يوضح هذا القسم كيفية إعداد بيئة تطوير SDK لنشر تطبيقات كوردوفا على أجهزة OS X الحاسوبية.

إدارة إصدارات المنصات والإضافات

تخصيص الأيقونات

يوضح هذا القسم كيفية إعداد أيقونة التطبيق لمختلف المنصات.

تخزين البيانات

يشرح هذا القسم واجهات برمجة التطبيقات (APIs) المتخصصة في التخزين لأجل استخدامها مع تطبيقات كوردوفا. يلخص أيضًا مزايا ومساوئ كل واجهة من الواجهات المتوافرة لتحدِّد أنت الواجهة الأنسب لاستعمالها في تطبيقك. 

إدارة الخصوصية

يتناول هذا الدليل مجال خصوصية تطبيقات الجوّال ويعالج بعض قضاياها المهمة. كما يوضح بعض أفضل الممارسات الشائعة والمقبولة في مجتمع المطورين، ويقدم روابطًا لمراجع أكثر تفصيلاً.


إدارة الأمن

يتضمن هذا القسم بعض شرحًا لأفضل الممارسات الأمنية التي يجب مراعاتها عند تطوير تطبيقات كوردوفا. يرجى الانتباه إلى أن الأمن موضوع معقد للغاية، وأنّ هذا القسم ليس شاملًا.

اللوائح البيضاء

لوائح النطاقات البيضاء (Domain whitelisting) هي نموذج أمني يضبط إمكانية الوصول إلى النطاقات الخارجية التي لا يتحكم فيها تطبيقك. توفر كوردوفا سياسة أمنية قابلة للتعديل لتحديد المواقع الخارجية التي يمكن الوصول إليها.

استعمال الإضافات

الإضافة هي حزمة من الأكواد البرمجية التي تسمح لعارض كوردوفا (Cordova webview)، الذي يُعرض التطبيق من خلاله، التواصل مع المنصة الأصلية (native platform) التي يعمل عليها. توفر الإضافات إمكانية الوصول إلى وظائف الجهاز والمنصة غير المتوفرة عادةً للتطبيقات الشبكية (web-based apps). كل ميزات واجهة كوردوفا البرمجية (Cordova API) الرئيسية تنفَّذ على أنَّها إضافات، فضلًا عن العديد من الإضافات الأخرى التي تتيح ميزات أخرى، مثل ماسحات الرموز الشريطية (bar code scanners) والتحكم باتصالات NFC، وتصميم واجهات التقويم الزمني ...إلخ.

إنشاء إضافة

يوضح هذا القسم خطوات إنشاء إضافة بسيطة تعمل على تمرير سلسلة نصية من JavaScript إلى المنصة الأصلية، والعكس بالعكس. يمكنك استخدامها كنموذج لبناء ميزات أكثر تعقيدًا. يناقش هذا القسم البنية الأساسية للإضافات وواجهة JavaScript المقدمة.

استعمال الأداة Plugman لإدارة الإضافات

منذ الإصدار 3.0 وما بعده، أصبحت كوردوفا تنفِّذ كل الواجهات البرمجية الخاصة بالجهاز (device APIs) على شكل إضافات، لكن لا تفعِّلها افتراضيًا. بناءً على ذلك، أصبحت هنالك حاجة لتوفير أداة تنفذ ذلك وتدير الإضافات - مثل التثبيت والإزالة ...إلخ. - في منصة كوردوفا. هذا الأمر يعتمد على سير العمل المتبع في إنشاء تطبيقك (اطلع على قسم "مسارات التطوير" في الصفحة "نظرة عامة").

سير العمل المرتكز على منصة واحدة يستخدم الأداة Plugman منخفضة المستوى في واجهة سطر الأوامر لكل منصة مستهدفة على حِدة. يقدم هذا القسم تفاصيلًا مفصلة عن كيفية استخدام الأداة Plugman.

استعمال الإضافات وتطويرها على مختلف المنصات

لتعلم كيفية استعمال الإضافات وتطويرها على جميع المنصات، سيتم تطوير مثالالإضافة echo الوارد في دليل تطوير الإضافات، والذي يربط الاتصال بين المعرض webview الخاص بكوردوفا وبين المنصة الأصلية في منصة في كل منصة على حدة. قبل الانتقال إلى الأقسام التالية، راجع صفحة دليل تطوير الإضافات لتكوين نظرة عامة على بنية الإضافات وواجهات JavaScript الخاصة بها.

منصة أندرويد

يشرح هذا القسم كيفية تنفيذ شيفرات الإضافات الأصلية (native plugin code) على منصة أندرويد.

منصة iOS

يقدم هذا القسم تفاصيل عن كيفية تنفيذ شيفرات الإضافات الأصلية (native plugin code) على منصة iOS.

منصة ويندوز

يقدم هذا القسم تفاصيل عن كيفية تنفيذ إضافة لاستخدامها في متجر تطبيقات ويندوز للهواتف وسطح المكتب في ويندوز 8.1 للهاتف (Windows 8.1 phone)، ومنصة ويندوز الكونية (Universal Windows [ويندوز 10+]‎‎).

إضافات جاهزة

توفِّر كوردوفا العديد من الواجهات البرمجية لإضافات أساسية (Core Plugin APIs) جاهزة يمكن تثبيتها واستعمالها مباشرةً في تطبيقك. الإضافات التي سيأتي ذكرها بعد قليل هي الإضافات الأساسية ولكنها ليست كل الإضافات المتاحة في كوردوفا.  تتوافر واجهات برمجة تطبيقات إضافية عبر إضافات من طرف ثالث (third-party plugins). يمكنك في أي وقت إلقاء نظرة على الإضافات الموجودة عبر هذا الرابط.

حالة البطارية

تمنح هذه الإضافة التطبيق إمكانية معرفة حالة بطارية الجهاز.

الكاميرا

توفر هذه الإضافة واجهة برمجية لالتقاط الصور، واختيار الصور من مكتبة الصور داخل النظام.

حالة الجهاز

توفر هذه الإضافة معلومات حول عتاد وبرامج الجهاز الذي يعمل عليه التطبيق. 

مربعات الحوار

توفر هذه الإضافة إمكانية الوصول إلى بعض مربعات الحوار ومربعات التنبيه الأصلية والتحكم بها وعرضها.

الوصول إلى الملفات

توفر هذه الإضافة واجهة برمجية للوصول إلى الملفات، إذ يمكن استخدامها للقراءة من أو الكتابة على الملفات الموجودة على الجهاز.

تحديد الموقع الجغرافي

توفر هذه الإضافة معلومات حول الموقع الجغرافي للجهاز، مثل خط العرض وخط الطول.

متصفح داخلي

تساعد هذه الإضافة على عرض المقالات ومقاطع الفيديو وموارد الويب المفيدة داخل تطبيقك. كما تمُكن المستخدمين أيضًا من الاطلاع على صفحات الويب دون مغادرة التطبيق.

تسجيل الصوت

تُمكّن إضافة تسجيل الصوت من تسجيل وتشغيل الملفات الصوتية على الجهاز.

الوصول إلى الوسائط المتعددة

تمكّن إضافة الوصول إلى الوسائط المتعددة من التقاط الصور وتسجيل الصوت والفيديو على الجهاز.

حالة الشبكة

توفر هذه الإضافة معلومات حول حالة الاتصال بشبكة الاتصال الخليوية (cellular) والشبكة اللاسلكي (wifi)، وتتحقق مما إذا كان الجهاز متصلًا بالإنترنت. 

اتجاه الشاشة

تُستخدَم إضافة اتجاه الشاشة للتحكم باتجاه الشاشة (عبر ضبطها إلى اتجاه محدَّد أو منع تغيير الاتجاه) بشكل موحَّد في المنصات iOS وأندرويد و windows-uwp.

شاشة البدء

تستعمل هذه الإضافة لإنشاء شاشات البدء (splash screens)، إذ تعرض أو تخفي شاشة البدء أثناء فتح التطبيق.

شريط الحالة

توفر هذه الإضافة بعض الدوال التي يمكن استخدامها لتخصيص شريط الحالة في منصتي iOS و أندرويد.

التحكم بالاهتزاز

توفر هذه الإضافة وسيلة للتحكم في اهتزاز الجهاز.

اللائحة البيضاء

توفر هذه الإضافة اللوائح البيضاء التي تحدِّد كيفية التصفح عبر واجهات وصفحات التطبيق في كورودوفا 4.0.

مواضيع متقدمة

تضمين كوردوفا في تطبيق أصيل

الخطوات التالية

مراجع

الملف Config.xml

الملف Plugin.xml

الأحداث

واجهة سطر الأوامر

الخطافات