ترقية أندرويد في كوردوفا

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

الترقية إلى الإصدار ‎7.X.X

أفضل طريقة للترقية إلى الإصدار ‎7.X.X هي إزالة منصة أندرويد من مشروعك، ثم إعادة إضافتها بالإصدار الجديد. مثلًا:

cordova platform remove android
cordova platform add android@7.X.X‎

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

لسوء الحظ، نظرًا للتحديث في بنية الملفات، يجب تحديث المشاريع التي لم تُنشأ بواسطة واجهة سطر الأوامر يدويًا، أو سيتعيّن إنشاء مشروع كوردوفا جديد، ونقل الملفات إلى المشروع الجديد. هذا الأمر ناتجٌ عن الانتقال إلى منصة التطوير Android Studio.

الترقية إلى الإصدار ‎6.X.X

أفضل طريقة للترقية إلى الإصدار ‎6.X.X‎ هي إزالة منصة أندرويد من مشروعك ثم إعادة إضافتها بإصدار جديدٍ. مثلا:

cordova platform remove android
cordova platform add android@6.X.X‎

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

يمكنك أيضًا استخدام برنامج التحديث النصي (update script) الخاص بالمنصة. بالنسبة إلى المشروعات التي لم تُنشأ عبر واجهة سطر الأوامر، فعليك تنفيذ الأمر التالي:

bin/update path/to/project‎

الترقية إلى الإصدار ‎5.X.X

أفضل طريقة للترقية إلى الإصدار ‎5.X.X هي إزالة منصة أندرويد من مشروعك وإعادة إضافتها مع الإصدار الجديد. مثلًا:

cordova platform remove android
cordova platform add android@5.X.X‎

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

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

bin/update path/to/project

بالنسبة لمشاريع واجهة سطر الأوامر:

حدِّث نسخة واجهة سطر الأوامر cordova. انظر صفحة [../../cli/index.html The Command-Line Interface].
نفّذ الأمر cordova platform update android@5.0.0 في مشاريعك الحالية.

ترقية الإضافات في الإصدار Marshmallow من أندرويد

يضيف الإصدار 5.0.0 دعمًا واجهة أندرويد البرمجية ذات المستوى 23 (Marshmallow). قدم إصدار Marshmallow نموذج أذونات جديدٍ، قد يتطلب منك تحديث بعض الإضافات المثبتة للتأكد من توافقها مع الهواتف الجديدة. يمكن أن تتسبب الإصدارات القديمة من الإضافات التي لا تعالج الأذونات بشكل صحيح في تعطل التطبيق بشكل غير متوقع. لاحظ أنّ هذا لا يؤثر على كل الإضافات، ولكن فقط تلك التي تحاول الوصول إلى أذونات أندرويد هي التي تسبب المشاكل (انظر the table of dangerous permissions).

تتأثر الإضافات الأساسية التالية بهذا التغيير، ويجب ترقيتها لاستخدامها مع cordova-android 5.0.0+: الإضافة أدنى إصدار متوافق cordova-plugin-camera 2.0.0 cordova-plugin-contacts 2.0.0 cordova-plugin-file 4.0.0 cordova-plugin-geolocation 2.0.0 cordova-plugin-media 2.0.0

بالنسبة للإضافات غير الأساسية، يمكنك التحقق مما إذا كانت الإضافة تتطلب dangerous permission من خلال فحص الملف plugin.xml الخاص بتلك الإضافات. إن كانت الإضافة تستخدم أذونات أندرويد، فسترى مدخلات تصرّح بها في الملف plugin.xml. مثلا:

<uses-permission android:name="android.permission.PERMISSION_NAME" />‎

حيث تم يُستبدل PERMISSION_NAME باسم إذن أندرويد. يمكن العثور على الملف plugin.xml في مجلد الإضافة في مشروع كوردوفا خاصتك (على سبيل المثال plugins/example-plugin/plugin.xml). راجع توثيقات الإضافات التي تستخدم الأذونات الخطيرة لتحديد الخطوات التي يجب اتخاذها لضمان التوافق مع cordova-android 5.0.0+.

الترقية إلى الإصدار 4.0.0

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

بالنسبة للمشاريع التي لم تُنشأ عبر واجهة سطر الأوامر، قم بتنفيذ الأمر التالي:

bin/update path/to/project‎

بالنسبة لمشاريع واجهة سطر الأوامر:

حدّث إصدار واجهة سطر الأوامر cordova . راجع صفحة [../../cli/index.html The Command-Line Interface].
َنفِّذ الأمر cordova platform update android@4.0.0 في مشاريعك الحالية.

ترقية اللائحة البيضاء

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

الإضافة cordova-plugin-whitelist (موصى به)
يُنصح بشدة باستخدام هذه الإضافة، لأنها أكثر أمنا وقابلية للتعديل من اللائحة البيضاء في الإصدارات السابقة

راجع صفحة cordova-plugin-whitelist للحصول على تفاصيل حول التغييرات المطلوبة في الإعدادات
نفّذ الأمر: cordova plugin add cordova-plugin-crosswalk-webview
الإضافة cordova-plugin-legacy-whitelist
توفر هذه الإضافة نفس سلوك اللائحة البيضاء في الإصدارات السابقة. راجع صفحة cordova-plugin-legacy-whitelist.
لا يلزم إجراء تغييرات على الإعدادات، ولكنها توفر حماية أقل من الإضافة الموصى بها
نفّذ الأمر: cordova plugin add cordova-plugin-legacy-whitelist

استخدام العارض Crosswalk

بشكل افتراضي، سيستمر تطبيقك في استخدام عارض النظام الذي يوفره الجهاز. إن كنت ترغب في استخدام العارض Crosswalk بدلاً من ذلك، فما عليك سوى تثبيت الإضافة Crosswalk:

cordova plugin add cordova-plugin-crosswalk-webview‎

عند تثبيت الإضافة، فسيُثبّت عارض Crosswalk في تطبيقك ويُهيؤُ بالشكل الصحيح.

ترقية الإضافة Splashscreen

إن كان تطبيقك يستخدم شاشة البداية (splash screen)، فقد تم نقل هذه الوظيفة إلى إضافةٍ. خيارات الإعدادات الخاصة بشاشات البداية لم تتغير. الخطوة الوحيدة الضرورية للترقية هي تثبيت الإضافة:

cordova plugin add cordova-plugin-splashscreen‎

الترقية إلى الإصدار الإصدار 3.7.1 من الإصدار 3.6.0

بالنسبة للمشاريع التي لم تُنشأ عبر واجهة سطر الأوامر، قم بتنفيذ الأمر التالي:

bin/update path/to/project‎

بالنسبة لمشاريع واجهة سطر الأوامر:

حدّث إصدار واجهة سطر الأوامر cordova. راجع صفحة [../../cli/index.html The Command-Line Interface].
نفّذ الأمر cordova platform update android في مشاريعك الحالية.

الترقية إلى الإصدار 3.3.0 من الإصدار 3.2.0

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

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

الترقية إلى الإصدار 3.2.0 من الإصدار 3.1.0

بالنسبة للمشاريع التي أُنشئت باستخدام واجهة سطر الأوامر كوردوفا:

حدّث إصدار واجهة سطر الأوامر cordova . راجع صفحة [../../cli/index.html The Command-Line Interface].
نفّذ الأمرَ cordova platform update android

بالنسة للمشاريع التي لم تُنشأ باستخدام واجهة سطر الأوامر، فنفّذ الأمر:

bin/update <project_path>‎

WARNING: على أندرويد 4.4 إلى أندرويد 4.4.3، لن يؤدي إنشاء عنصر إدخال ملف (file input element) من النوع type = "file"‎ إلى فتح منتقي الملفات (file picker). مصدر هذه المشكلة آتٍ من المتصفح Chromium على منصة أندرويد، ويمكن إعادة إنتاج المشكلة في متصفح Chrome المنفصل عنه على منصةأندرويد (راجع الصفحة http://code.google.com/p/android/issues/detail؟id=62220) الحل المقترح هو استخدام الإضافتين FileTransfer و File على منصة أندرويد 4.4. يمكنك الانصات إلى الحدث onClick من المُدخلة type="file"، ثم عرض واجهة منتقي الملفات. لربط بيانات النموذج مع التحميل، يمكنك استخدام جافااسكريبت لربط قيم النموذج مع طلبية POST متعددة الأجزاء التي تصنعها الإضافة FileTransfer.

الترقية إلى الإصدار 3.1.0 من 3.0.0

بالنسبة للمشاريع التي أُنشئت باستخدام واجهة سطر الأوامر كوردوفا:

حدّث إصدار واجهة سطر الأوامر cordova . راجع صفحة [../../cli/index.html The Command-Line Interface].
نفّذ الأمرَ cordova platform update android

بالنسة للمشاريع التي لم تُنشأ باستخدام واجهة سطر الأوامر، فنفّذ الأمر:

bin/update <project_path>‎

ترقية واجهة سطر الأوامر إلى الإصدار 3.0.0 من 2.9.0

أنشئ مشروعًا جديدًا لكوردوفا 3.0.0 باستخدام واجهة سطر الأوامر، كما هو موضح في [../../cli/index.html The Command-Line Interface].
أضف منصاتك إلى مشروع كوردوفا، على سبيل المثال: cordova

platform add android.

انسخ محتويات مجلد المشروع الخاص بك www إلى المجلد www في جذر مشروع كوردوفا الذي أنشأته للتو.
انسخ كل الأصول المحلية من مشروعك القديم إلى المجلدات المناسبة داخل platforms/android: هذا المجلد سيحتوي مشروع Cordova-android الأصلي خاصتك.
استخدم واجهة سطر الأوامر لتثبيت الإضافات التي تحتاج. لاحظ أن واجهة سطر الأوامر (CLI) تتعامل مع جميع الواجهات البرمجية الأساسية على أنّها إضافات، لذا قد تحتاج إلى إضافتها. فقط الإضافات من الإصدار 3.0.0 متوافقة مع واجهة سطر الأوامر.

الترقية إلى الإصدار 3.0.0 من الإصدار 2.9.0

أنشئ مشروعًا جديدًا.
انسخ محتويات المجلد www إلى المشروع الجديد.
انسخ كل أصول أندرويد الأصلية من المجلد res إلى المشروع الجديد.
انسخ كل الإضافات التي ثبتّها من المجلدات الفرعية src إلى المشروع الجديد.
تأكد من ترقية أي مراجع مُهملة <plugin> في الملف config.xml القديم إلى مواصفات <feature> الجديدة.
قم بتحديث أي مراجع تُشير إلى الحزمة org.apache.cordova.api واجعلها تشير إلى org.apache.cordova.

NOTE: أزيلت جميع الواجهات البرمجية الأساسية، ويجب تثبيتها كإضافات. يرجى الاطلاع على دليل [../../../plugin_ref/plugman.html Using Plugman to Manage Plugins] لمزيد من التفاصيل.

الترقية إلى الإصدار2.9.0 من الإصدار 2.8.0

نفّذ الأمرَ bin/update <project_path>

الترقية إلى الإصدار 2.8.0 من الإصدار 2.7.0

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

الترقية إلى الإصدار 2.7.0 من الإصدار 2.6.0

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

الترقية إلى الإصدار 2.6.0 من الإصدار 2.5.0

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

نفّذ الأمر bin/update <project> في مسار المشروع المذكور في المجلد المصدري لكوردوفا.

الترقية إلى الإصدار 2.5.0 من الإصدار 2.4.0

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

الترقية إلى الإصدار 2.4.0 من الإصدار 2.3.0

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

الترقية إلى الإصدار 2.3.0 من الإصدار 2.2.0

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

الترقية إلى الإصدار 2.2.0 من الإصدار 2.1.0

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

الترقية إلى الإصدار 2.1.0 من الإصدار 2.0.0

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

الترقية إلى الإصدار 2.0.0 من الإصدار 1.9.0

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

في الإصدار 2.0.0، يجمع الملف config.xml ويستبدل الملفين cordova.xml و plugins.xml. الملفات القديمة صارت مُهملةً الآن، وبينما لا تزال تعمل في الإصدار 2.0.0، فستوقف في إصدار مستقبلي.

الترقية إلى الإصدار 1.9.0 من الإصدار 1.8.1

أزِل الملف cordova-1.8.0.jar من مجلد المشروع libs.
اضف الملف cordova-1.9.0.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف cordova-1.9.0.js الجديد إلى مشروعك.
حدّث ملف HTML الخاص بك لاستخدام الملف cordova-1.9.0.js الجديد.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.

نظرًا لإدخال CordovaWebView في الإصدار 1.9.0، فقد لا تعمل إضافات الطرف الثالث. تحتاج تلك الإضافات إلى الحصول على سياق من CordovaInterface باستخدام التابعَين getContext() أو getActivity(). إذا لم تكن لديك خبرة في التطوير على منصة أندرويد، فيرجى الاتصال بمشرف الإضافة وإضافة هذه المهمة إلى أداة تعقب الأخطاء خاصتهم.

الترقية إلى الإصدار 1.8.0 من الإصدار 1.8.0

أزِل الملف cordova-1.8.0.jar من مجلد المشروع libs.
اضف الملف cordova-1.8.1.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف cordova-1.8.1.js الجديد إلى مشروعك.
حدّث ملف HTML الخاص بك لاستخدام الملف cordova-1.8.1.js الجديد.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.

الترقية إلى الإصدار 1.8.0 من الإصدار 1.7.0

أزِل الملف cordova-1.7.0.jar من مجلد المشروع libs.
اضف الملف cordova-1.8.0.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف cordova-1.8.0.js الجديد إلى مشروعك.
حدّث ملف HTML الخاص بك لاستخدام الملف cordova-1.8.0.js الجديد.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.

الترقية إلى الإصدار 1.8.0 من الإصدار 1.7.1

أزِل الملف cordova-1.7.0.jar من مجلد المشروع libs.
اضف الملف cordova-1.8.0.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف cordova-1.8.0.js الجديد إلى مشروعك.
حدّث ملف HTML الخاص بك لاستخدام الملف cordova-1.8.0.js الجديد.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.

الترقية إلى الإصدار 1.7.0 من الإصدار 1.6.1

أزِل الملف cordova-1.6.1.jar من مجلد المشروع libs.
اضف الملف cordova-1.7.0.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف cordova-1.7.0.js الجديد إلى مشروعك.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.

الترقية إلى الإصدار 1.6.1 من الإصدار 1.6.0

أزِل الملف cordova-1.6.0.jar من مجلد المشروع libs.
اضف الملف cordova-1.6.1.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف cordova-1.6.1.js الجديد إلى مشروعك.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.

الترقية إلى الإصدار 1.6.0 من الإصدار 1.5.0

أزِل الملف cordova-1.5.0.jar من مجلد المشروع libs.
اضف الملف cordova-1.6.0.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف cordova-1.6.0.js الجديد إلى مشروعك.
حدّث ملف HTML الخاص بك لاستخدام الملف cordova-1.6.0.js الجديد.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.
استبدل res/xml/phonegap.xml بالمسار res/xml/cordova.xml لمطابقة المسار framework/res/xml/cordova.xml.

الترقية إلى الإصدار 1.5.0 من الإصدار 1.4.0

أزِل الملف phonegap-1.4.0.jar من مجلد المشروع libs.
اضف الملف cordova-1.5.0.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف cordova-1.5.0.js الجديد إلى مشروعك.
حدّث ملف HTML الخاص بك لاستخدام الملف cordova-1.5.0.js الجديد.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.
استبدل res/xml/phonegap.xml بالمسار res/xml/cordova.xml لمطابقة المسار framework/res/xml/cordova.xml.

الترقية إلى الإصدار 1.4.0 من الإصدار 1.3.0

أزِل الملف phonegap-1.3.0.jar من مجلد المشروع libs.
اضف الملف phonegap-1.4.0.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف phonegap-1.4.0.js الجديد إلى مشروعك.
حدّث ملف HTML الخاص بك لاستخدام الملف phonegap-1.4.0.js الجديد.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.
حدَّث الملف res/xml/phonegap.xml ليُطابق المسار framework/res/xml/phonegap.xml.

الترقية إلى الإصدار 1.3.0 من الإصدار 1.2.0

أزِل الملف phonegap-1.2.0.jar من مجلد المشروع libs.
اضف الملف phonegap-1.3.0.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف phonegap-1.3.0.js الجديد إلى مشروعك.
حدّث ملف HTML الخاص بك لاستخدام الملف phonegap-1.2.0.js الجديد.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.
حدَّث الملف res/xml/phonegap.xml ليُطابق المسار framework/res/xml/phonegap.xml.

الترقية إلى الإصدار 1.2.0 من الإصدار 1.1.0

أزِل الملف phonegap-1.1.0.jar من مجلد المشروع libs.
اضف الملف phonegap-1.2.0.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف phonegap-1.2.0.js الجديد إلى مشروعك.
حدّث ملف HTML الخاص بك لاستخدام الملف phonegap-1.2.0.js الجديد.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.
حدَّث الملف res/xml/phonegap.xml ليُطابق المسار framework/res/xml/phonegap.xml.

الترقية إلى الإصدار 1.1.0 من الإصدار 1.0.0

أزِل الملف phonegap-1.0.0.jar من مجلد المشروع libs.
اضف الملف phonegap-1.1.0.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف phonegap-1.1.0.js الجديد إلى مشروعك.
حدّث ملف HTML الخاص بك لاستخدام الملف phonegap-1.1.0.js الجديد.
حدَّث الملف res/xml/plugins.xml ليُطابق المسار framework/res/xml/plugins.xml.

الترقية إلى الإصدار 1.0.0 من الإصدار 0.9.6

أزِل الملف phonegap-0.9.6.jar من مجلد المشروع libs.
اضف الملف phonegap-1.0.0.jar إلى مجلد المشروع libs.
إن كنت تستخدم إطار العمل Eclipse، يرجى تحديث مشروع Eclipse الخاص بك والقيام بعملية التنظيف (clean).
انسخ ملف phonegap-1.0.0.js الجديد إلى مشروعك.
حدّث ملف HTML الخاص بك لاستخدام الملف phonegap-1.0.0.js الجديد.
أضف res/xml/plugins.xml لمطابقة المسار framework/res/xml/plugins.xml.

مصادر

صفحة Upgrading Android في توثيق كوردوفا الرسمي.