عرض مصدر Cordova/android upgrade

<noinclude>{{DISPLAYTITLE:ترقية أندرويد في كوردوفا}}</noinclude>
[[تصنيف: Cordova]]
يوضح هذا الدليل كيفية تعديل مشروعات كوردوفا للترقية انطلاقًا من الإصدارات القديمة من كوردوفا. تُطبَّق معظم هذه الإرشادات على المشاريع التي تم إنشاؤها باستخدام أدوات سطر الأوامر القديمة التي كانت قبل [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code>. يمكنك الانتقال إلى توثيق [[Cordova/cli|واجهة سطر الأوامر]] للحصول على معلومات حول كيفية تحديث إصدار واجهة سطر الأوامر.

== الترقية إلى الإصدار  ‎7.X.X ==
أفضل طريقة للترقية إلى الإصدار ‎7.X.X هي إزالة منصة أندرويد من مشروعك، ثم إعادة إضافتها بالإصدار الجديد. مثلًا: 
<syntaxhighlight lang="shell">cordova platform remove android
cordova platform add android@7.X.X‎</syntaxhighlight> 

إن كنت تستخدم الطريقة المذكورة أعلاه، تذكر أنّ كل التغييرات التي قمت بها على مجلد منصة أندرويد ستضيع (لا يُنصح بتعديل محتويات هذا المجلد على أيِّ حال). 

لسوء الحظ، نظرًا للتحديثات التي أُجريت على بنية الملفات، يجب تحديث المشاريع التي لم تُنشأ بواسطة [[Cordova/cli|واجهة سطر الأوامر]] يدويًا، أو سيتعيّن إنشاء مشروع كوردوفا جديد، ونقل الملفات إلى المشروع الجديد. هذا الأمر ناتجٌ عن الانتقال إلى منصة التطوير Android Studio. 
== الترقية إلى الإصدار ‎6.X.X == 

أفضل طريقة للترقية إلى الإصدار ‎6.X.X‎ هي إزالة منصة أندرويد من مشروعك، ثم إعادة إضافتها بإصدار جديدٍ. مثلا: 
<syntaxhighlight lang="shell">cordova platform remove android
cordova platform add android@6.X.X‎</syntaxhighlight> 

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

يمكنك أيضًا استخدام برنامج تحديث الشيفرة (update script) الخاص بالمنصة. بالنسبة إلى المشروعات التي لم تُنشَأ عبر [[Cordova/cli|واجهة سطر الأوامر]]، فعليك تنفيذ الأمر التالي: 
<syntaxhighlight lang="shell">bin/update path/to/project‎</syntaxhighlight> 
== الترقية إلى الإصدار ‎5.X.X == 

أفضل طريقة للترقية إلى الإصدار ‎5.X.X هي إزالة منصة أندرويد من مشروعك وإعادة إضافتها مع الإصدار الجديد. مثلًا: 
<syntaxhighlight lang="shell">cordova platform remove android
cordova platform add android@5.X.X‎</syntaxhighlight> 

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

بدلاً من ذلك، يمكنك استخدام برنامج تحديث الشيفرة البرمجية الخاص بالمنصة. بالنسبة للمشاريع التي لم تُنشأ عبر [[Cordova/cli|واجهة سطر الأوامر]]، فنفّذ الأمر التالي: <syntaxhighlight lang="shell">
bin/update path/to/project
</syntaxhighlight>بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]:
# حدِّث إصدار [[Cordova/cli|واجهة سطر الأوامر]]. 
# نفّذ الأمر <code>cordova platform update android@5.0.0</code> في مشاريعك الحالية. 
=== ترقية الإضافات في الإصدار Marshmallow من أندرويد === 

يضيف الإصدار 5.0.0 دعمًا لواجهة أندرويد البرمجية ذات المستوى 23 (Marshmallow). قدّم إصدارُ Marshmallow نموذج أذوناتٍ جديدٍ، والذي قد يتطلب منك تحديث بعض الإضافات المثبّتة للتأكد من توافقها مع الهواتف الجديدة. يمكن أن تتسبب الإصدارات القديمة من الإضافات التي لا تعالج الأذونات بشكل صحيح بتعطل التطبيق بشكل غير متوقع. لاحظ أنّ هذا لا يؤثر على كل الإضافات، ولكن فقط تلك التي تحاول الوصول إلى أذونات أندرويد (انظر [http://developer.android.com/guide/topics/security/permissions.html#perm-groups جدول الأذونات الخطيرة]). 

تتأثر الإضافات الأساسية التالية بهذا التغيير، ويجب ترقيتها لاستخدامها مع الإصدار <code>5.0.0</code> من <code>cordova-android</code> فما فوقه:  
{| class="wikitable"
!الإضافة
!أدنى إصدار متوافق
|-
|[[Cordova/cordova plugin camera|الكاميرا]]
|<code>2.0.0</code>
|-
|الأسماء (مهملة)
|<code>2.0.0</code>
|-
|[[Cordova/cordova plugin file|الوصول إلى الملفات]]
|<code>4.0.0</code>
|-
|[[Cordova/cordova plugin geolocation|تحديد الموقع الجغرافي]]
|<code>2.0.0</code>
|-
|[[Cordova/cordova plugin media|تسجيل الصوت]]
|<code>2.0.0</code>
|}
بالنسبة للإضافات غير الأساسية، يمكنك التحقق مما إذا كانت الإضافة تتطلب [http://developer.android.com/guide/topics/security/permissions.html#perm-groups أذونات خطيرة] من خلال فحص الملف <code>[[Cordova/plugin ref|plugin.xml]]</code> الخاص بتلك الإضافات. إن كانت الإضافة تستخدم أذونات أندرويد، فسترى بعض المُدخلات التي تصرّح بها في الملف <code>[[Cordova/plugin ref|plugin.xm<nowiki/>l]]</code>. على سبيل المثال: <syntaxhighlight lang="xml"><uses-permission android:name="android.permission.PERMISSION_NAME" />‎</syntaxhighlight> 

حيث يُستبدل اسم إذن أندرويد بـ <code>PERMISSION_NAME</code>. يمكن العثور على الملف <code>[[Cordova/plugin ref|plugin.xml]]</code> في مجلد الإضافة في مشروع كوردوفا خاصتك (مثلًا، في الموضع <code>plugins/example-plugin/plugin.xml</code>). راجع توثيقات الإضافات التي تستخدم الأذونات الخطيرة لتحديد الخطوات التي يجب اتخاذها لضمان التوافق مع الإصدار <code>5.0.0</code> فما فوق من <code>cordova-android</code>. 
==الترقية إلى الإصدار 4.0.0== 

هناك بعض الخطوات الضرورية للترقية للاستفادة من التغييرات الهامة التي جاء بها الإصدار 4.0.0. وهي بشكل عامٍ على النحو الآتي. 

بالنسبة للمشاريع التي لم تُنشأ عبر [[Cordova/cli|واجهة سطر الأوامر]]، نفّذ الأمر التالي: 
<syntaxhighlight lang="shell">bin/update path/to/project‎</syntaxhighlight> 

بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]: 
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code> . 
* َنفِّذ الأمر <code>cordova platform update android@4.0.0</code> في مشاريعك الحالية. 
=== ترقية اللائحة البيضاء === 

تُقدَّم الآن جميع وظائف [[Cordova/whitelist|اللائحة البيضاء]] عبر الإضافات. فبدون استخدام تلك الإضافات، لن تحمي [[Cordova/whitelist|اللوائح البيضاء]] تطبيقك بعد الترقية إلى الإصدار 4.0.0.  

لدى كوردوفا إضافتان خاصتان [[Cordova/whitelist|باللوائح البيضاء]]، واللتان توفران مستويات مختلفة من الحماية. 
# الإضافة <code>[[Cordova/cordova plugin whitelist|cordova-plugin-whitelist]]</code> (موصى بها)
#* يُنصح بشدة باستخدام هذه الإضافة، لأنها أكثر  أمانًا وقابلية للتعديل من [[Cordova/whitelist|اللائحة البيضاء]] في الإصدارات السابقة.
#* راجع صفحة الإضافة [[Cordova/cordova plugin whitelist|cordova-plugin-whitelist]] للحصول على تفاصيل حول التغييرات المطلوبة في الإعدادات.
#* نفّذ الأمر: <code>cordova plugin add cordova-plugin-crosswalk-webview</code> 
# الإضافة <code>[https://github.com/apache/cordova-plugin-legacy-whitelist cordova-plugin-legacy-whitelist]</code>
#* توفر هذه الإضافة نفس سلوك [[Cordova/whitelist|اللائحة البيضاء]] في الإصدارات السابقة. راجع صفحة [https://github.com/apache/cordova-plugin-legacy-whitelist cordova-plugin-legacy-whitelist]. 
#* لا تستدعي هذه الإضافة إجراء تغييرات على الإعدادات، بيْد أنّها توفر حماية أقل من الإضافة السابقة الموصى بها. 
#* نفّذ الأمر: <code>cordova plugin add cordova-plugin-legacy-whitelist</code> 
=== استخدام العارض Crosswalk === 

بشكل افتراضي، سيستخدم تطبيقك [[Cordova/webviews|عارض]] النظام الذي يوفره الجهاز. إن كنت ترغب في استخدام [[Cordova/webviews|العارض]] Crosswalk بدلًا من منه، فما عليك سوى تثبيت الإضافة Crosswalk على النحو التالي: 
<syntaxhighlight lang="shell">cordova plugin add cordova-plugin-crosswalk-webview‎</syntaxhighlight> 

عند تثبيت هذه الإضافة، فسيُثبَّت [[Cordova/webviews|العارض]] Crosswalk في تطبيقك ويُهيَّأ بالشكل الصحيح. 
=== ترقية الإضافة [[Cordova/cordova plugin splashscreen|Splashscreen]] === 

بالنسبة للتطبيقات التي تستخدم شاشة البداية (splash screen)، فقد تم احتواء هذه الوظيفة في إضافةٍ تدعى [[Cordova/cordova plugin splashscreen|cordova-plugin-splashscreen]]. خيارات الإعدادات الخاصة بشاشات البداية لم تتغير. والخطوة الوحيدة الضرورية للترقية هي تثبيت الإضافة: 
<syntaxhighlight lang="shell">cordova plugin add cordova-plugin-splashscreen‎</syntaxhighlight> 
== الترقية إلى الإصدار 3.7.1 انطلاقًا من الإصدار 3.6.0 == 

بالنسبة للمشاريع التي لم تُنشأ عبر [[Cordova/cli|واجهة سطر الأوامر]]، نفّذ الأمر التالي: 
<syntaxhighlight lang="shell">bin/update path/to/project‎</syntaxhighlight> 

بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]: 
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]].  
* نفّذ الأمر <code>cordova platform update android</code> في مشاريعك الحالية. 
== الترقية إلى الإصدار 3.3.0 انطلاقًا من الإصدار 3.2.0 == 

اتبع نفس التعليمات كما في حالة الإصدار <code>3.2.0</code>. 

بدءًا من الإصدار 3.3.0، يتم الآن تصريف (compiling) وقت تشغيل كوردوفا (Cordova runtime) كمكتبةِ أندرويد بدلًا من ملف <code>Jar</code>. المفروض ألا يكون لهذا تأثيرٌ على استخدام [[Cordova/cli|واجهة سطر الأوامر]]، ولكن سيحتاج مستخدمو بيئات التطوير المتكاملة (IDE) إلى استيراد مشروع <code>MyProject-CordovaLib</code> المُضاف حديثًا إلى مساحة العمل خاصتهم. 
== الترقية إلى الإصدار 3.2.0 انطلاقًا من الإصدار 3.1.0 == 

بالنسبة للمشاريع التي أُنشئت باستخدام [[Cordova/cli|واجهة سطر الأوامر]] كوردوفا: 
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code> .  
* نفّذ الأمرَ <code>cordova platform update android</code> 

بالنسة للمشاريع التي لم تُنشأ باستخدام [[Cordova/cli|واجهة سطر الأوامر]]، نفّذ الأمر: 
<syntaxhighlight lang="shell">bin/update <project_path>‎</syntaxhighlight> 

'''تنبيه''': من الإصدار 4.4 إلى الإصدار 4.4.3 من أندرويد، لن يؤدي إنشاء عنصر إدخال ملفات (file input element) من النوع <code>type = "file"</code>‎ إلى فتح منتقي الملفات (file picker). مصدر هذه المشكلة هو المتصفح Chromium على منصة أندرويد، ويمكن إعادة إنتاج المشكلة في متصفح Chrome المنفصل عنه على نفس المنصة (راجع [http://code.google.com/p/android/issues/detail?id=62220 هذه الصفحة] لمزيدٍ من التفاصيل)؛ الحل المقترح هو استخدام الإضافتين <code>FileTransfer</code> و <code>[[Cordova/cordova plugin file|File]]</code> على منصة أندرويد 4.4. يمكنك الإنصات إلى الحدث <code>onClick</code> من المُدخلة <code>type="file"‎</code>، ثم عرض واجهة منتقي الملفات. لربط بيانات النموذج مع التحميل، يمكنك استخدام [[JavaScript|جافاسكريبت]] لربط قيم النموذج مع طلبية POST متعددة الأجزاء (multi-part POST) التي تُنشئها الإضافة <code>FileTransfer</code>. 
== الترقية إلى الإصدار 3.1.0 انطلاقًا من الإصدار 3.0.0 == 

بالنسبة للمشاريع التي أُنشئت باستخدام [[Cordova/cli|واجهة سطر أوامر]] كوردوفا، قم بما يلي: 
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]].  
* نفّذ الأمرَ <code>cordova platform update android</code> 

بالنسبة للمشاريع التي لم تُنشأ باستخدام [[Cordova/cli|واجهة سطر الأوامر]]، فنفّذ الأمر التالي: 
<syntaxhighlight lang="shell">bin/update <project_path>‎</syntaxhighlight> 
== ترقية واجهة سطر الأوامر إلى الإصدار 3.0.0 انطلاقًا من الإصدار 2.9.0 == 
# أنشئ مشروعًا جديدًا لكوردوفا 3.0.0 باستخدام [[Cordova/cli|واجهة سطر الأوامر]]، كما هو موضح في صفحتها 
# أضف منصاتك إلى مشروع كوردوفا، مثل استعمال الأمر: <code>cordova platform add android</code>

# انسخ محتويات مجلد المشروع <code>www</code> الخاص بك إلى المجلد <code>www</code> الموجود في جذر مشروع كوردوفا الذي أنشأته للتو. 
# انسخ كل الأصول المحلية (native assets) من مشروعك القديم إلى المجلدات المناسبة داخل <code>platforms/android</code>: هذا المجلد سيحتوي مشروع Cordova-android الأصلي. 
# استخدم [[Cordova/cli|واجهة سطر الأوامر]] لتثبيت الإضافات التي تحتاج إليها. لاحظ أنّ [[Cordova/cli|واجهة سطر الأوامر]] تتعامل مع جميع الواجهات البرمجية الأساسية على أنّها إضافات، لذا قد تحتاج إلى إضافتها. تذكر أنّ الإضافات ذات الإصدارات الأعلى من 3.0.0 هي الوحيدة المتوافقة مع [[Cordova/cli|واجهة سطر الأوامر]]. 
== الترقية إلى الإصدار 3.0.0 انطلاقًا من الإصدار 2.9.0 ==
# أنشئ مشروعًا جديدًا.
# انسخ محتويات المجلد <code>www</code> إلى المشروع الجديد.
# انسخ كل أصول أندرويد الأصلية من المجلد <code>res</code> إلى المشروع الجديد.
# انسخ كل الإضافات التي ثبتّها من المجلدات الفرعية <code>src</code> إلى المشروع الجديد.
# تأكد من ترقية أي مراجع مُهملة <code><plugin></code> في الملف <code>[[Cordova/config ref|config.xml]]</code> القديم إلى مواصفات <code><feature></code> الجديدة.
# قم بتحديث أي مراجع تُشير إلى الحزمة <code>org.apache.cordova.api</code> واجعلها تشير إلى <code>org.apache.cordova</code>.
'''ملاحظة''': أزيلت جميع الواجهات البرمجية الأساسية، ويجب تثبيتها كإضافات. يرجى الاطلاع على [[Cordova/plugman|دليل استخدام Plugman لإدارة الإضافات]] لمزيد من التفاصيل.

== الترقية إلى الإصدار 2.9.0 انطلاقا من الإصدار 2.8.0 ==
# نفّذ الأمرَ <code>bin/update <project_path>‎</code>

== الترقية إلى الإصدار 2.8.0 انطلاقا من الإصدار 2.7.0 == 
# أزِل الملف <code>cordova-2.7.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-2.8.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean)‏. 
# انسخ الملف <code>cordova.js</code> الجديد إلى مشروعك. 
# قم بتحديث ملف HTML خاصتك لاستخدام ملف <code>cordova.js</code> الجديد. 
# انسخ الملف <code>res/xml/config.xml</code> في المسار <code>framework/res/xml/config.xml</code>. 
# حدِّث الملف <code>framework/res/xml/config.xml</code> حتى يحتوي على إعدادات مماثلةٍ للسابق. 
# انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>. 
== الترقية إلى الإصدار 2.7.0 انطلاقًا من الإصدار 2.6.0 == 
# أزِل الملف <code>cordova-2.6.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-2.7.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ ملف <code>cordova-2.7.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام ملف <code>cordova-2.7.0.js</code> الجديد. 
# انقل الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>. 
# حدّث الملف <code>framework/res/xml/config.xml</code> حتى يحتوي على إعدادات مماثلةٍ للسابق. 
# انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>. 
== الترقية إلى الإصدار 2.6.0 انطلاقا من الإصدار 2.5.0 == 
# أزِل الملف <code>cordova-2.5.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-2.6.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ ملف <code>cordova-2.6.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-2.6.0.js</code> الجديد. 
# انقل الملف <code>res/xml/config.xml</code> ليُطابِق المسار <code>framework/res/xml/config.xml</code>. 
# حدّث الملف <code>framework/res/xml/config.xml</code> حتى يحتوي على إعدادات مماثلةٍ للسابق. 
# انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.

نفّذ الأمر <code>bin/update <project>‎</code> في مسار المشروع المذكور في المجلد المصدري لكوردوفا. 
== الترقية إلى الإصدار 2.5.0 انطلاقا من الإصدار 2.4.0 == 
# أزِل الملف <code>cordova-2.4.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-2.5.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ ملف <code>cordova-2.5.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-2.5.0.js</code> الجديد. 
# انقل الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>. 
# حدّث الملف <code>framework/res/xml/config.xml</code> حتى يحتوي على إعدادات مماثلةٍ للسابق. 
# انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>. 
== الترقية إلى الإصدار 2.4.0 انطلاقًا من الإصدار 2.3.0 ==
# أزِل الملف <code>cordova-2.3.0.jar</code> من مجلد المشروع <code>libs</code>.
# أضف الملف <code>cordova-2.4.0.jar</code> إلى مجلد المشروع <code>libs</code>.
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
# انسخ الملف <code>cordova-2.4.0.js</code> الجديد إلى مشروعك.
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-2.4.0.js</code> الجديد.
# انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>.
# انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.

== الترقية إلى الإصدار 2.3.0 انطلاقًا من الإصدار 2.2.0 == 
# أزِل الملف <code>cordova-2.2.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-2.3.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>cordova-2.3.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-2.3.0.js</code> الجديد. 
# انقل الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>. 
# انسخ الملفات من المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>. 
== الترقية إلى الإصدار 2.2.0 انطلاقًا من الإصدار 2.1.0 == 
# أزِل الملف <code>cordova-2.1.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-2.2.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>cordova-2.2.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-2.2.0.js</code> الجديد. 
# انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>. 
# انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>. 
== الترقية إلى الإصدار 2.1.0 انطلاقًا من الإصدار 2.0.0 == 
# أزِل الملف <code>cordova-2.0.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-2.1.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>cordova-2.1.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-2.1.0.js</code> الجديد. 
# انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>. 
# انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>. 
== الترقية إلى الإصدار 2.0.0 انطلاقا من الإصدار 1.9.0 == 
# أزِل الملف <code>cordova-1.9.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-2.0.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>cordova-2.0.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-2.0.0.js</code> الجديد. 
# انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>. 

في الإصدار 2.0.0، يجمع الملف <code>[[Cordova/config ref|config.xml]]</code> الملفين <code>cordova.xml</code> و <code>[[Cordova/plugin ref|plugins.xml]]</code> ويستبدلهما. الملفات القديمة أصبحت مُهملةً الآن، وعلى الرغم من أنها لا تزال مدعومةً في الإصدار 2.0.0، إلا أنها ستوقف في إصدار مستقبلي. 
== الترقية إلى الإصدار 1.9.0 انطلاقا من الإصدار 1.8.1 == 
# أزِل الملف <code>cordova-1.8.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-1.9.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>cordova-1.9.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-1.9.0.js</code> الجديد. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>.

نظرًا لإدخال العارض <code>CordovaWebView</code> في الإصدار 1.9.0، فقد لا تعمل إضافات الطرف الثالث. فتلك الإضافات تحتاج إلى الحصول على سياق من <code>CordovaInterface</code> باستخدام التابعَين <code>getContext()‎</code> أو <code>getActivity()‎</code>. إن لم تكن لديك خبرة في التطوير على منصة أندرويد، فيرجى الاتصال بمشرف الإضافة، وإضافة هذه المهمة إلى أداة تعقب الأخطاء خاصتهم. 
== الترقية إلى الإصدار 1.8.0 انطلاقًا من الإصدار 1.8.0 == 
# أزِل الملف <code>cordova-1.8.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-1.8.1.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>cordova-1.8.1.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-1.8.1.js</code> الجديد. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>. 
== الترقية إلى الإصدار 1.8.0 انطلاقًا من الإصدار 1.7.0 == 
# أزِل الملف <code>cordova-1.7.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-1.8.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>cordova-1.8.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-1.8.0.js</code> الجديد. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>. 
== الترقية إلى الإصدار 1.8.0 انطلاقًا من الإصدار 1.7.1 == 
# أزِل الملف <code>cordova-1.7.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-1.8.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>cordova-1.8.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-1.8.0.js</code> الجديد. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>. 
== الترقية إلى الإصدار 1.7.0 انطلاقا من الإصدار 1.6.1 == 
# أزِل الملف <code>cordova-1.6.1.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-1.7.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>cordova-1.7.0.js</code> الجديد إلى مشروعك. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>. 
== الترقية إلى الإصدار 1.6.1 انطلاقا من الإصدار 1.6.0 == 
# أزِل الملف <code>cordova-1.6.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-1.6.1.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>cordova-1.6.1.js</code> الجديد إلى مشروعك. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>. 
== الترقية إلى الإصدار 1.6.0 انطلاقا من الإصدار 1.5.0 == 
# أزِل الملف <code>cordova-1.5.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-1.6.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ ملف <code>cordova-1.6.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-1.6.0.js</code> الجديد. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>. 
# استبدل الملف <code>res/xml/phonegap.xml</code> بالملف <code>res/xml/cordova.xml</code> لمطابقة المسار <code>framework/res/xml/cordova.xml</code>. 
== الترقية إلى الإصدار 1.5.0 انطلاقًا من الإصدار 1.4.0 == 
# أزِل الملف <code>phonegap-1.4.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>cordova-1.5.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>cordova-1.5.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>cordova-1.5.0.js</code> الجديد. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>. 
#استبدل الملف <code>res/xml/phonegap.xml</code> بالملف <code>res/xml/cordova.xml</code> لمطابقة المسار <code>framework/res/xml/cordova.xml</code>. 
== الترقية إلى الإصدار 1.4.0 انطلاقًا من الإصدار 1.3.0 == 
# أزِل الملف <code>phonegap-1.3.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>phonegap-1.4.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>phonegap-1.4.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>phonegap-1.4.0.js</code> الجديد. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>. 
# انقل الملف <code>res/xml/phonegap.xml</code> ليُطابق المسار <code>framework/res/xml/phonegap.xml</code>. 
== الترقية إلى الإصدار 1.3.0 انطلاقًا من الإصدار 1.2.0 == 
# أزِل الملف <code>phonegap-1.2.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>phonegap-1.3.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>phonegap-1.3.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>phonegap-1.2.0.js</code> الجديد. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>. 
# انقل الملف <code>res/xml/phonegap.xml</code> ليُطابق المسار <code>framework/res/xml/phonegap.xml</code>. 
== الترقية إلى الإصدار 1.2.0 انطلاقًا من الإصدار 1.1.0 == 
# أزِل الملف <code>phonegap-1.1.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>phonegap-1.2.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>phonegap-1.2.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>phonegap-1.2.0.js</code> الجديد. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>. 
# انقل الملف <code>res/xml/phonegap.xml</code> ليُطابق المسار <code>framework/res/xml/phonegap.xml</code>. 
== الترقية إلى الإصدار 1.1.0 انطلاقًا من الإصدار 1.0.0 == 
# أزِل الملف <code>phonegap-1.0.0.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>phonegap-1.1.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>phonegap-1.1.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>phonegap-1.1.0.js</code> الجديد. 
# انقل الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>. 
== الترقية إلى الإصدار 1.0.0 انطلاقًا من الإصدار 0.9.6== 
# أزِل الملف <code>phonegap-0.9.6.jar</code> من مجلد المشروع <code>libs</code>. 
# أضف الملف <code>phonegap-1.0.0.jar</code> إلى مجلد المشروع <code>libs</code>. 
# إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean). 
# انسخ الملف <code>phonegap-1.0.0.js</code> الجديد إلى مشروعك. 
# حدّث ملف HTML الخاص بك لاستخدام الملف <code>phonegap-1.0.0.js</code> الجديد. 
# أضف <code>res/xml/plugins.xml</code> لمطابقة المسار <code>framework/res/xml/plugins.xml</code>.

== انظر أيضًا ==
* [[Cordova/platforms android|دليل التطوير على منصة أندرويد]]
* [[Cordova/platform plugin versioning ref|دليل إدارة إصدارات المنصات والإضافات]]

==مصادر==
*[https://cordova.apache.org/docs/en/latest/guide/platforms/android/upgrade.html صفحة Upgrading Android في توثيق كوردوفا الرسمي.]