الفرق بين المراجعتين لصفحة: «Cordova/android upgrade»

من موسوعة حسوب
التعديل اللاحق ←
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:ترقية أندرويد في كوردوفا}}</noinclude> تصنيف: Cordova تصنيف: Android يوضح هذا الدليل ك...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:ترقية أندرويد في كوردوفا}}</noinclude>
<noinclude>{{DISPLAYTITLE:ترقية أندرويد في كوردوفا}}</noinclude>
[[تصنيف: Cordova]]
[[تصنيف: Cordova]]
[[تصنيف: Android]]
[[تصنيف: Android]]
يوضح هذا الدليل كيفية تعديل مشروعات كوردوفا للترقية من الإصدارات القديمة من كوردوفا. تنطبق معظم هذه الإرشادات على المشاريع التي تم إنشاؤها باستخدام أدوات سطر الأوامر القديمة التي تسبق [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code> . راجع [../../cli/index.html The Command-Line Interface] للحصول على معلومات حول كيفية تحديث إصدار [[Cordova/cli|واجهة سطر الأوامر]] CLI.  
يوضح هذا الدليل كيفية تعديل مشروعات كوردوفا للترقية من الإصدارات القديمة من كوردوفا. تنطبق معظم هذه الإرشادات على المشاريع التي تم إنشاؤها باستخدام أدوات سطر الأوامر القديمة التي تسبق [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code> . راجع [../../cli/index.html The Command-Line Interface] للحصول على معلومات حول كيفية تحديث إصدار [[Cordova/cli|واجهة سطر الأوامر]] CLI.  
== الترقية إلى 7.XX ==  
== الترقية إلى 7.XX ==  


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


سطر 15: سطر 15:


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


سطر 21: سطر 21:


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


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


سطر 57: سطر 57:


بالنسبة للإضافات غير الأساسية، يمكنك التحقق مما إذا كانت الإضافة تتطلب [http://developer.android.com/guide/topics/security/permissions.html#perm-groups dangerous permission] من خلال فحص الملف <code>plugin.xml</code> الخاص بتلك الإضافات. إن كانت الإضافة تستخدم أذونات أندرويد، فسترى مدخلات تصرّح بها في الملف <code>plugin.xml</code>. مثلا:  
بالنسبة للإضافات غير الأساسية، يمكنك التحقق مما إذا كانت الإضافة تتطلب [http://developer.android.com/guide/topics/security/permissions.html#perm-groups dangerous permission] من خلال فحص الملف <code>plugin.xml</code> الخاص بتلك الإضافات. إن كانت الإضافة تستخدم أذونات أندرويد، فسترى مدخلات تصرّح بها في الملف <code>plugin.xml</code>. مثلا:  
<syntaxhighlight lang="javascript"><uses-permission android:name="android.permission.PERMISSION_NAME" />‎</syntaxhighlight>  
<syntaxhighlight lang="shell"><uses-permission android:name="android.permission.PERMISSION_NAME" />‎</syntaxhighlight>  


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


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


بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]:  
بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]:  
سطر 85: سطر 85:


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


عند تثبيت الإضافة، فسيُثبّت [[Cordova/webviews|عارض]] Crosswalk في تطبيقك ويُهيؤُ بالشكل الصحيح.  
عند تثبيت الإضافة، فسيُثبّت [[Cordova/webviews|عارض]] Crosswalk في تطبيقك ويُهيؤُ بالشكل الصحيح.  
سطر 91: سطر 91:


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


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


بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]:  
بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]:  
سطر 112: سطر 112:


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


<code>WARNING:</code> على أندرويد 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"، ثم عرض واجهة منتقي الملفات. لربط بيانات النموذج مع التحميل، يمكنك استخدام [[JavaScript|[[Java|جافا]]اسكريبت]] لربط قيم النموذج مع طلبية POST متعددة الأجزاء التي تصنعها الإضافة FileTransfer.  
<code>WARNING:</code> على أندرويد 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"، ثم عرض واجهة منتقي الملفات. لربط بيانات النموذج مع التحميل، يمكنك استخدام [[JavaScript|[[Java|جافا]]اسكريبت]] لربط قيم النموذج مع طلبية POST متعددة الأجزاء التي تصنعها الإضافة FileTransfer.  
سطر 122: سطر 122:


بالنسة للمشاريع التي لم تُنشأ باستخدام [[Cordova/cli|واجهة سطر الأوامر]]، فنفّذ الأمر:  
بالنسة للمشاريع التي لم تُنشأ باستخدام [[Cordova/cli|واجهة سطر الأوامر]]، فنفّذ الأمر:  
<syntaxhighlight lang="javascript">bin/update <project_path>‎</syntaxhighlight>  
<syntaxhighlight lang="shell">bin/update <project_path>‎</syntaxhighlight>  
== ترقية [[Cordova/cli|واجهة سطر الأوامر]] إلى الإصدار 3.0.0 من 2.9.0 ==  
== ترقية [[Cordova/cli|واجهة سطر الأوامر]] إلى الإصدار 3.0.0 من 2.9.0 ==  
* أنشئ مشروعًا جديدًا لكوردوفا 3.0.0 باستخدام [[Cordova/cli|واجهة سطر الأوامر]]، كما هو موضح في [../../cli/index.html The Command-Line Interface].  
* أنشئ مشروعًا جديدًا لكوردوفا 3.0.0 باستخدام [[Cordova/cli|واجهة سطر الأوامر]]، كما هو موضح في [../../cli/index.html The Command-Line Interface].  

مراجعة 17:25، 27 ديسمبر 2018

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

الترقية إلى 7.XX

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

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

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

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

الترقية إلى 6.XX

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

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

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

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

bin/update path/to/project‎

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

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

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

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

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

bin/update path/to/project


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

  • حدِّث نسخة واجهة سطر الأوامر 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"، ثم عرض واجهة منتقي الملفات. لربط بيانات النموذج مع التحميل، يمكنك استخدام [[JavaScript|جافااسكريبت]] لربط قيم النموذج مع طلبية 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.

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Cordova/android_upgrade&oldid=26883»