عرض مصدر Cordova/overview

<noinclude>{{DISPLAYTITLE:دليل تطوير الإضافات في كوردوفا}}</noinclude>
أباتشي كوردوفا (Apache Cordova، وسنطلق عليه اختصارًا "كوردوفا" فقط) هو إطار تطوير جوال (هاتف محمول) مفتوح المصدر. يسمح لك كوردوفا باستخدام تقنيات الويب القياسية مثل [[HTML|HTML5]] تمام و [[CSS|CSS3]] و [[JavaScript]] لتطوير الأنظمة الأساسية. يتم تنفيذ التطبيقات ضمن مغلفات (wrappers) يتم توجيهها إلى كل منصة وتعتمد على روابط واجهة برمجة التطبيقات المتوافقة مع المعايير للوصول إلى إمكانات كل جهاز مثل المستشعرات والبيانات وحالة الشبكة وما إلى ذلك.

استخدم كوردوفا إذا كنت:
* مطوّر برامج جوّال وتريد توسيع تطبيق عبر أكثر من نظام أساسي واحد، دون الحاجة إلى إعادة بنائه باستعمال لغة وأداة كل منصة.
* مطور ويب وترغب في نشر تطبيق ويب يتم تعبئته للتوزيع في بوابات متجر التطبيقات المختلفة.
* مطوّر برامج جوال مهتم بمزج مكونات التطبيقات الأصلية باستخدام العارض [[Cordova/webviews|WebView]] (نافذة متصفح خاصة) التي يمكنها الوصول إلى واجهات برمجة التطبيقات على مستوى الجهاز، أو إذا كنت ترغب في تطوير واجهة مكون إضافي بين المكونات الأصلية ومكونات [[Cordova/webviews|WebView]].

== المعمارية المتبعة في بناء التطبيق ==
هناك العديد من المكونات لتطبيق كوردوفا. يوضح المخطط التالي عرضًا عالي المستوى للبناء الهيكلي للتطبيق Cordova.

[[ملف:cordova-app.png]]

== عارض الويب ==
إن تطبيق كوردوفا يمكن العارض [[Cordova/webviews|WebView]] من تزويد واجهة المستخدم الخاصة به بالكامل. وفي بعض المنصات الأخرى، يمكن أن يكون أيضًا مكونًا داخل تطبيق أكبر حجمًا أي يمكن دمج العارض [[Cordova/webviews|WebView]] مع مكونات تطبيق أصيل. (راجع صفحة [[Cordova/webviews|تضمين كوردوفا في تطبيق أصيل]] للاطلاع على تفاصيل أكثر).

== تطبيق الويب ==
إن هذا الجزء هو الذي تتواجد فيه شيفرة التطبيق الخاص بك. يتم تنفيذ التطبيق نفسه كصفحة ويب - الذي هو ملف محلي يسمى index.html افتراضيًّا -  تشير إلى ملفات [[CSS]]، أو [[JavaScript]]، أو الصور، أو ملفات الوسائط أو الموارد الأخرى اللازمة لتشغيله. ينفذ التطبيق في العارض [[Cordova/webviews|WebView]] داخل مغلف تطبيق أصيل الذي يوزعه لاحقًا على متاجر التطبيقات.

تحتوي هذه الحاوية على ملف بالغ الأهمية يسمى [[Cordova/config ref|config.xml]] الذي يوفر معلومات حول التطبيق ويحدد المعاملات التي تؤثر على كيفية عمله، مثل ما إذا كان يستجيب لارتفاعات الاتجاه أم لا.  

== الإضافات ==
تعتبر [[Cordova/plugins|الإضافات]] جزءًا لا يتجزأ من بيئة كوردوفا، اذ توفر واجهة لكوردوفا فيها المكونات الأصلية للتواصل مع بعضها البعض والارتباطات إلى واجهات برمجة التطبيقات القياسية للجهاز. تمكّنك هذه الميزة من استدعاء الشيفرة الأصلية من [[JavaScript]].

يحافظ مشروع كوردوفا على مجموعة من الإضافات تسمى [[Cordova#.D8.A5.D8.B6.D8.A7.D9.81.D8.A7.D8.AA .D8.AC.D8.A7.D9.87.D8.B2.D8.A9|الإضافات الأساسية]] (Core Plugins). توفر هذه الإضافات الأساسية للتطبيق الخاص بك الوصول إلى مكونات الجهاز وما يحتويه مثل [[Cordova/cordova plugin battery status|البطارية]] و<nowiki/>[[Cordova/cordova plugin camera|الكاميرا]] وجهات الاتصال.... إلخ.

بالإضافة إلى الإضافات الأساسية، هناك العديد من الإضافات الإضافية من طرف ثالث والتي توفر روابط إضافية لميزات لا تتوفر بالضرورة على جميع الأنظمة الأساسية. يمكنك البحث عن إضافات كوردوفا باستخدام ميزة [https://cordova.apache.org/plugins/ البحث عن الإضافات] أو عبر البحث في [https://www.npmjs.com/search?q=ecosystem%3Acordova npm]. يمكنك أيضًا تطوير الإضافات الخاصة بك، كما هو موضح في دليل [[Cordova/plugins|إنشاء الإضافات]]. قد تكون الإضافات ضرورية، على سبيل المثال، للتواصل بين كوردوفا والمكونات الأصلية المخصصة.

'''ملاحظة''': عندما تنشئ مشروع كوردوفا جديد، فإنه لا يحتوي على أية إضافة. هذا هو السلوك الافتراضي الجديد. فيجب عليك إضافة أية إضافات ترغب فيها، حتى الإضافات الأساسية يجب أن تضيفها بشكل صريح.

'''ملاحظة''': لا توفر كوردوفا أية أدوات واجهة مستخدم (UI widgets) أو إطارات *MV. توفر كوردوفا ذلك فقط في وقت التشغيل الذي يمكن حينذاك تنفيذها. فإذا كنت ترغب في استخدام أدوات واجهة المستخدم و/أو إطار *MV، فستحتاج إلى تحديدها وإدراجها في التطبيق الخاص بك.

== مسارات التطوير ==
توفر لك كوردوفا اثنين من مهام العمل الأساسية لإنشاء تطبيق جوال. بينما يمكنك في كثير من الأحيان استخدام احدى مسارات سير العمل لإنجاز نفس المهمة، فإن كل منها يوفر مزايا. فمثلًا:
* '''سير العمل العابر للمنصات (واجهة سطر الأوامر CLI)''': استخدم سير العمل هذا إذا كنت ترغب في تشغيل التطبيق على العديد من منصات تشغيل الهواتف المحمولة المختلفة، دون الحاجة إلى تطوير تطبيق محدد بمنصة واحدة فقط. يتمركز سير العمل هذا حول واجهة سطر الأوامر (CLI) الخاصة بكوردوفا التي تُعَد أداةً عالية المستوى تسمح لك بإنشاء مشاريع للعديد من المنصات في وقت واحد مما يزيل الكثير من وظائف النصوص ذات المستوى الأدنى. تنسخ CLI مجموعة مشتركة من أصول الويب إلى مجلدات فرعية لكل منصة، وتجري أية تغييرات ضرورية لكل منصة من تلك المنصات وتعمل على تشغيل الشيفرات لإنشاء التطبيقات التنفيذية (application binaries). يوفر سطر الأوامر CLI أيضًا واجهة شائعة لتطبيق الإضافات على تطبيقك. فبامكانك البدء باتباع الخطوات الواردة في دليل إنشاء أول تطبيق لك لبدء استعمال سير العمل هذا إلا إذا كان هناك حاجة لاستعمال سير العمل الذي يركز على منصة واحدة، فمن المستحسن استخدام سير العمل عبر النظام الأساسي.
* '''سير العمل المرتكز على منصة واحدة''': استخدم سير العمل هذا إذا كنت تريد التركيز على إنشاء تطبيق لمنصة واحدة وتحتاج إلى تعديله على مستوى أدنى. متى تحتاج إلى استخدام هذا الأسلوب؟ إذا كنت ، على سبيل المثال، تريد أن يمزج تطبيقك المكونات الأصلية المخصصة مع مكونات كوردوفا المستندة إلى الويب، كما هو موضح في صفحة [[Cordova/webviews|تضمين كوردوفا في تطبيق أصيل]]. كقاعدة عامة، استخدم سير العمل هذا إذا كنت بحاجة إلى تعديل المشروع داخل SDK لأنَّ سير العمل هذا يعتمد على مجموعة من البرامج النصية التي يتم تصميمها خصيصًا لكل مستوى من المنصة المدعومة، بالإضافة إلى الأداة [[Cordova/plugman|Plugman]] المساعدة المنفصلة تسمح لك بتطبيق الإضافات. على الرغم من أنه يمكنك استخدام سير العمل هذا لإنشاء تطبيقات مشتركة عابرة للمنصات، إلا أنه عادةً ما يكون أكثر صعوبة بسبب عدم وجود أداة ذات مستوى أعلى وهذا يعني دورات بناء منفصلة وتعديلات للإضافات لكل نظام أساسي.
عند بدء التشغيل لأول مرة، قد يكون من الأسهل استخدام سير العمل العابر للمنصات لإنشاء تطبيق، كما هو موضح في [[Cordova/first app|دليل إنشاء أول تطبيق لك]] عبر كوردوفا. يمكنك عندئذٍ التبديل إلى سير العمل المرتكز على منصة واحدة إذا كنت تحتاج إلى تحكم أكبر يوفره SDK.

'''ملاحظة''': بمجرد التبديل من سير العمل العابر للمنصات إلى سير العمل المرتكز على أدوات SDK وأدوات الصدفة (shell) الخاصة بمنصة واحدة، فإنه لا يمكنك الرجوع عن هذه الخطوة لأن سير العمل العابر للمنصات يحافظ على مجموعة شائعة من الشيفرات المصدرية العابرة للمنصات والتي تستخدمها عند كل عملية إنشاء للكتابة فوق شيفرة المصدر الخاصة بمنصة محدَّدة. وكذلك للحفاظ على أي تعديلات تجريها على الأصول الخاصة بمنصة محدَّدة، فإنك بحاجة إلى التبديل إلى أدوات الصدفة المرتكزة على منصة محدَّدة، والتي تتجاهل شيفرة المصدر العابرة للمنصات وعليك عندئذ أن تعتمد بدلًا من ذلك على شيفرة المصدر الخاصة بمنصة محدَّدة فقط.

== تثبيت كوردوفا ==
سيختلف تثبيت كوردوفا حسب سير العمل أعلاه الذي تختاره:
* سير العمل العابر للمنصات؛ راجع صفحة [[Cordova/first app|تثبيت كوردوفا وإنشاء أول تطبيق]].
* سير العمل المرتكز على منصة واحدة.
بعد تثبيت كوردوفا، يوصى بمراجعة الصفحات الخاصة بكل منصة من [[Cordova#.D8.A7.D9.84.D8.AA.D8.B7.D9.88.D9.8A.D8.B1 .D8.B9.D9.84.D9.89 .D9.85.D8.AE.D8.AA.D9.84.D9.81 .D8.A7.D9.84.D9.85.D9.86.D8.B5.D8.A7.D8.AA|المنصات التي توفر أنظمة للجوال]] التي تنوي أن تطور عليها تطبيقك. يستحسن أيضًا أن تطلع على دليل [[Cordova/privacy|الخصوصية]] ودليل [[Cordova/security|الأمان]].

== مصادر ==
* [https://cordova.apache.org/docs/en/latest/guide/overview/index.html صفحة Overview في توثيق كوردوفا الرسمي.]
[[تصنيف: Cordova]]