الفرق بين المراجعتين ل"Cordova/android upgrade"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
سطر 2: سطر 2:
 
[[تصنيف: Cordova]]
 
[[تصنيف: Cordova]]
 
[[تصنيف: Android]]
 
[[تصنيف: Android]]
−
يوضح هذا الدليل كيفية تعديل مشروعات كوردوفا للترقية من الإصدارات القديمة من كوردوفا. تنطبق معظم هذه الإرشادات على المشاريع التي تم إنشاؤها باستخدام أدوات سطر الأوامر القديمة التي كانت قبل [[Cordova/cli|واجهة سطر الأوامر]]. يمكنك الدخول إلى صفحة الرابط للحصول على معلومات حول كيفية تحديث إصدار [[Cordova/cli|واجهة سطر الأوامر]] (CLI).
+
يوضح هذا الدليل كيفية تعديل مشروعات كوردوفا للترقية انطلاقا من الإصدارات القديمة من كوردوفا. تنطبق معظم هذه الإرشادات على المشاريع التي تم إنشاؤها باستخدام أدوات سطر الأوامر القديمة التي كانت قبل [[Cordova/cli|واجهة سطر الأوامر]]. يمكنك الدخول إلى صفحة الرابط للحصول على معلومات حول كيفية تحديث إصدار [[Cordova/cli|واجهة سطر الأوامر]] (CLI).
  
 
الترقية إلى الإصدار  ‎7.X.X
 
الترقية إلى الإصدار  ‎7.X.X
سطر 36: سطر 36:
  
 
بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]:  
 
بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]:  
−
* حدِّث نسخة [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code>. انظر صفحة [../../cli/index.html The Command-Line Interface].  
+
* حدِّث إصدار [[Cordova/cli|واجهة سطر الأوامر]].  
 
* نفّذ الأمر <code>cordova platform update android@5.0.0</code> في مشاريعك الحالية.  
 
* نفّذ الأمر <code>cordova platform update android@5.0.0</code> في مشاريعك الحالية.  
 
=== ترقية الإضافات في الإصدار Marshmallow من أندرويد ===  
 
=== ترقية الإضافات في الإصدار Marshmallow من أندرويد ===  
  
−
يضيف الإصدار 5.0.0 دعمًا واجهة أندرويد البرمجية ذات المستوى 23 (Marshmallow). قدم إصدار Marshmallow نموذج أذونات جديدٍ، قد يتطلب منك تحديث بعض الإضافات المثبتة للتأكد من توافقها مع الهواتف الجديدة. يمكن أن تتسبب الإصدارات القديمة من الإضافات التي لا تعالج الأذونات بشكل صحيح في تعطل التطبيق بشكل غير متوقع. لاحظ أنّ هذا لا يؤثر على كل الإضافات، ولكن فقط تلك التي تحاول الوصول إلى أذونات أندرويد هي التي تسبب المشاكل (انظر [http://developer.android.com/guide/topics/security/permissions.html#perm-groups the table of dangerous permissions]).  
+
يضيف الإصدار 5.0.0 دعمًا لواجهة أندرويد البرمجية ذات المستوى 23 (Marshmallow). قدّم إصدارُ Marshmallow نموذج أذوناتٍ جديدٍ، والذي قد يتطلب منك تحديث بعض الإضافات المثبّتة للتأكد من توافقها مع الهواتف الجديدة. يمكن أن تتسبب الإصدارات القديمة من الإضافات التي لا تعالج الأذونات بشكل صحيح في تعطل التطبيق بشكل غير متوقع. لاحظ أنّ هذا لا يؤثر على كل الإضافات، ولكن فقط تلك التي تحاول الوصول إلى أذونات أندرويد (انظر [http://developer.android.com/guide/topics/security/permissions.html#perm-groups جدول الأذونات الخطيرة]).  
  
−
تتأثر الإضافات الأساسية التالية بهذا التغيير، ويجب ترقيتها لاستخدامها مع <code>cordova-android 5.0.0+</code>:  
+
تتأثر الإضافات الأساسية التالية بهذا التغيير، ويجب ترقيتها لاستخدامها مع الإصدار <code>5.0.0</code> من <code>cordova-android</code> فما فوقه:
−
الإضافة  
+
{| class="wikitable"
−
أدنى إصدار متوافق
+
!الإضافة
−
cordova-plugin-camera  
+
!أدنى إصدار متوافق
−
2.0.0  
+
|-
−
cordova-plugin-contacts  
+
|<code>cordova-plugin-camera</code>
−
2.0.0  
+
|<code>2.0.0</code>
−
cordova-plugin-file  
+
|-
−
4.0.0  
+
|<code>cordova-plugin-contacts</code>
−
cordova-plugin-geolocation  
+
|<code>2.0.0</code>
−
2.0.0  
+
|-
−
cordova-plugin-media  
+
|<code>cordova-plugin-file</code>
−
2.0.0  
+
|<code>4.0.0</code>
 +
|-
 +
|<code>cordova-plugin-geolocation</code>
 +
|<code>2.0.0</code>
 +
|-
 +
|<code>cordova-plugin-media</code>
 +
|<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>
  
−
بالنسبة للإضافات غير الأساسية، يمكنك التحقق مما إذا كانت الإضافة تتطلب [http://developer.android.com/guide/topics/security/permissions.html#perm-groups dangerous permission] من خلال فحص الملف <code>plugin.xml</code> الخاص بتلك الإضافات. إن كانت الإضافة تستخدم أذونات أندرويد، فسترى مدخلات تصرّح بها في الملف <code>plugin.xml</code>. مثلا:
+
حيث يُستبدل اسم إذن أندرويد بـ<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> فما فوق.  
−
<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>.  
 
 
==الترقية إلى الإصدار 4.0.0==  
 
==الترقية إلى الإصدار 4.0.0==  
  
−
هناك بعض الخطوات الضرورية للترقية للاستفادة من التغييرات الهامة التي جاء بها الإصدار 4.0.0. أولاً، الخطوات الضرورية للترقية هي بشكل عام على النحو التالي.  
+
هناك بعض الخطوات الضرورية للترقية للاستفادة من التغييرات الهامة التي جاء بها الإصدار 4.0.0. وهي بشكل عام على النحو التالي.  
  
−
بالنسبة للمشاريع التي لم تُنشأ عبر [[Cordova/cli|واجهة سطر الأوامر]]، قم بتنفيذ الأمر التالي:  
+
بالنسبة للمشاريع التي لم تُنشأ عبر [[Cordova/cli|واجهة سطر الأوامر]]، نفّذ الأمر التالي:  
 
<syntaxhighlight lang="shell">bin/update path/to/project‎</syntaxhighlight>  
 
<syntaxhighlight lang="shell">bin/update path/to/project‎</syntaxhighlight>  
  
 
بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]:  
 
بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]:  
−
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code> . راجع صفحة [../../cli/index.html The Command-Line Interface].  
+
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code> .  
 
* َنفِّذ الأمر <code>cordova platform update android@4.0.0</code> في مشاريعك الحالية.  
 
* َنفِّذ الأمر <code>cordova platform update android@4.0.0</code> في مشاريعك الحالية.  
 
=== ترقية اللائحة البيضاء ===  
 
=== ترقية اللائحة البيضاء ===  
  
−
تُقدّم الآن جميع وظائف اللائحة البيضاء عبر الإضافة. بدون إضافة، لن تحمي اللوائح البيضاء تطبيقك بعد الترقية إلى الإصدار 4.0.0. لدى كوردوفا إضافتان خاصتان باللوائح البيضاء، واللتان توفران مستويات مختلفة من الحماية.
+
تُقدّم الآن جميع وظائف [[Cordova/whitelist|اللائحة البيضاء]] عبر الإضافات. فبدون إضافةٍ، لن تحمي [[Cordova/whitelist|اللوائح البيضاء]] تطبيقك بعد الترقية إلى الإصدار 4.0.0.
−
* الإضافة <code>cordova-plugin-whitelist</code> (موصى به)
 
−
* يُنصح بشدة باستخدام هذه الإضافة، لأنها أكثر أمنا وقابلية للتعديل من اللائحة البيضاء في الإصدارات السابقة
 
  
−
* راجع صفحة [https://github.com/apache/cordova-plugin-whitelist cordova-plugin-whitelist] للحصول على تفاصيل حول التغييرات المطلوبة في الإعدادات  
+
لدى كوردوفا إضافتان خاصتان [[Cordova/whitelist|باللوائح البيضاء]]، واللتان توفران مستويات مختلفة من الحماية.
−
* نفّذ الأمر: <code>cordova plugin add cordova-plugin-crosswalk-webview</code>  
+
# الإضافة <code>cordova-plugin-whitelist</code> (موصى بها)
−
* الإضافة <code>cordova-plugin-legacy-whitelist</code>  
+
#* يُنصح بشدة باستخدام هذه الإضافة، لأنها أكثر  أمانًا وقابلية للتعديل من [[Cordova/whitelist|اللائحة البيضاء]] في الإصدارات السابقة
−
* توفر هذه الإضافة نفس سلوك اللائحة البيضاء في الإصدارات السابقة. راجع صفحة [https://github.com/apache/cordova-plugin-legacy-whitelist cordova-plugin-legacy-whitelist].  
+
#* راجع صفحة الإضافة [[Cordova/cordova plugin whitelist|cordova-plugin-whitelist]] للحصول على تفاصيل حول التغييرات المطلوبة في الإعدادات
−
* لا يلزم إجراء تغييرات على الإعدادات، ولكنها توفر حماية أقل من الإضافة الموصى بها  
+
#* نفّذ الأمر: <code>cordova plugin add cordova-plugin-crosswalk-webview</code>  
−
* نفّذ الأمر: <code>cordova plugin add cordova-plugin-legacy-whitelist</code>  
+
# الإضافة <code>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 ===  
 
=== استخدام العارض Crosswalk ===  
  
−
بشكل افتراضي، سيستمر تطبيقك في استخدام [[Cordova/webviews|عارض]] النظام الذي يوفره الجهاز. إن كنت ترغب في استخدام [[Cordova/webviews|العارض]] Crosswalk بدلاً من ذلك، فما عليك سوى تثبيت الإضافة Crosswalk:  
+
بشكل افتراضي، سيستمر تطبيقك في استخدام [[Cordova/webviews|عارض]] النظام الذي يوفره الجهاز. إن كنت ترغب في استخدام [[Cordova/webviews|العارض]] Crosswalk بدلاً من ذلك، فما عليك سوى تثبيت الإضافة Crosswalk على النحو التالي:  
 
<syntaxhighlight lang="shell">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 في تطبيقك ويُهيؤُ بالشكل الصحيح.  
 
=== ترقية الإضافة Splashscreen ===  
 
=== ترقية الإضافة Splashscreen ===  
  
−
إن كان تطبيقك يستخدم شاشة البداية (splash screen)، فقد تم نقل هذه الوظيفة إلى إضافةٍ. خيارات الإعدادات الخاصة بشاشات البداية لم تتغير. الخطوة الوحيدة الضرورية للترقية هي تثبيت الإضافة:  
+
بالنسبة للتطبيقات التي تستخدم شاشة البداية (splash screen)، فقد تم احتواء هذه الوظيفة في إضافةٍ. خيارات الإعدادات الخاصة بشاشات البداية لم تتغير. والخطوة الوحيدة الضرورية للترقية هي تثبيت الإضافة:  
 
<syntaxhighlight lang="shell">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="shell">bin/update path/to/project‎</syntaxhighlight>  
 
<syntaxhighlight lang="shell">bin/update path/to/project‎</syntaxhighlight>  
  
 
بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]:  
 
بالنسبة لمشاريع [[Cordova/cli|واجهة سطر الأوامر]]:  
−
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code>. راجع صفحة [../../cli/index.html The Command-Line Interface].  
+
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]].
 
* نفّذ الأمر <code>cordova platform update android</code> في مشاريعك الحالية.  
 
* نفّذ الأمر <code>cordova platform update android</code> في مشاريعك الحالية.  
−
== الترقية إلى الإصدار 3.3.0 من الإصدار 3.2.0 ==  
+
== الترقية إلى الإصدار 3.3.0 انطلاقا من الإصدار 3.2.0 ==  
  
 
اتبع نفس التعليمات كما في حالة الإصدار <code>3.2.0</code>.  
 
اتبع نفس التعليمات كما في حالة الإصدار <code>3.2.0</code>.  
  
−
بدءًا من الإصدار 3.3.0، يتم الآن تصريف (compiling) وقت تشغيل كوردوفا (Cordova runtime) كمكتبة أندرويد بدلاً من ملف Jar. المفروض ألا يكون لهذا تأثيرٌ على استخدام [[Cordova/cli|واجهة سطر الأوامر]]، ولكن سيحتاج مستخدمو بيئة التطوير المتكاملة (IDE) إلى استيراد مشروع <code>MyProject-CordovaLib</code> المُضاف حديثًا إلى مساحة العمل خاصتهم.  
+
بدءًا من الإصدار 3.3.0، يتم الآن تصريف (compiling) وقت تشغيل كوردوفا (Cordova runtime) كمكتبةِ أندرويد بدلاً من ملف <code>Jar</code>. المفروض ألا يكون لهذا تأثيرٌ على استخدام [[Cordova/cli|واجهة سطر الأوامر]]، ولكن سيحتاج مستخدمو بيئات التطوير المتكاملة (IDE) إلى استيراد مشروع <code>MyProject-CordovaLib</code> المُضاف حديثًا إلى مساحة العمل خاصتهم.  
−
== الترقية إلى الإصدار 3.2.0 من الإصدار 3.1.0 ==  
+
== الترقية إلى الإصدار 3.2.0 انطلاقا من الإصدار 3.1.0 ==  
  
 
بالنسبة للمشاريع التي أُنشئت باستخدام [[Cordova/cli|واجهة سطر الأوامر]] كوردوفا:  
 
بالنسبة للمشاريع التي أُنشئت باستخدام [[Cordova/cli|واجهة سطر الأوامر]] كوردوفا:  
−
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code> . راجع صفحة [../../cli/index.html The Command-Line Interface].
+
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code> .
 
* نفّذ الأمرَ <code>cordova platform update android</code>  
 
* نفّذ الأمرَ <code>cordova platform update android</code>  
  
سطر 114: سطر 120:
 
<syntaxhighlight lang="shell">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|جافااسكريبت]] لربط قيم النموذج مع طلبية POST متعددة الأجزاء التي تصنعها الإضافة FileTransfer.  
+
'''تنبيه''': من الإصدار 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 متعددة الأجزاء التي تُنشئها الإضافة <code>FileTransfer</code>.  
−
== الترقية إلى الإصدار 3.1.0 من 3.0.0 ==  
+
== الترقية إلى الإصدار 3.1.0 انطلاقا من الإصدار 3.0.0 ==  
  
−
بالنسبة للمشاريع التي أُنشئت باستخدام [[Cordova/cli|واجهة سطر الأوامر]] كوردوفا:  
+
بالنسبة للمشاريع التي أُنشئت باستخدام [[Cordova/cli|واجهة سطر أوامر]] كوردوفا، قم بما يلي:  
−
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]] <code>cordova</code> . راجع صفحة [../../cli/index.html The Command-Line Interface].  
+
* حدّث إصدار [[Cordova/cli|واجهة سطر الأوامر]].
 
* نفّذ الأمرَ <code>cordova platform update android</code>  
 
* نفّذ الأمرَ <code>cordova platform update android</code>  
  
−
بالنسة للمشاريع التي لم تُنشأ باستخدام [[Cordova/cli|واجهة سطر الأوامر]]، فنفّذ الأمر:  
+
بالنسة للمشاريع التي لم تُنشأ باستخدام [[Cordova/cli|واجهة سطر الأوامر]]، فنفّذ الأمر التالي:  
 
<syntaxhighlight lang="shell">bin/update <project_path>‎</syntaxhighlight>  
 
<syntaxhighlight lang="shell">bin/update <project_path>‎</syntaxhighlight>  
−
== ترقية [[Cordova/cli|واجهة سطر الأوامر]] إلى الإصدار 3.0.0 من 2.9.0 ==  
+
== ترقية واجهة سطر الأوامر إلى الإصدار 3.0.0 انطلاقا من الإصدار 2.9.0 ==  
−
* أنشئ مشروعًا جديدًا لكوردوفا 3.0.0 باستخدام [[Cordova/cli|واجهة سطر الأوامر]]، كما هو موضح في [../../cli/index.html The Command-Line Interface].
+
* أنشئ مشروعًا جديدًا لكوردوفا 3.0.0 باستخدام [[Cordova/cli|واجهة سطر الأوامر]]، كما هو موضح في صفحتها
−
* أضف منصاتك إلى مشروع كوردوفا، على سبيل المثال: <code>cordova
+
* أضف منصاتك إلى مشروع كوردوفا، على سبيل المثال: <code>cordova platform add android</code>
−
platform add android</code>.
+
 
−
* انسخ محتويات مجلد المشروع الخاص بك <code>www</code> إلى المجلد <code>www</code> في جذر مشروع كوردوفا الذي أنشأته للتو.  
+
* انسخ محتويات مجلد المشروع <code>www</code> الخاص بك إلى المجلد <code>www</code> الموجود في جذر مشروع كوردوفا الذي أنشأته للتو.  
−
* انسخ كل الأصول المحلية من مشروعك القديم إلى المجلدات المناسبة داخل <code>platforms/android</code>: هذا المجلد سيحتوي مشروع Cordova-android الأصلي خاصتك.  
+
* انسخ كل الأصول المحلية (native assets) من مشروعك القديم إلى المجلدات المناسبة داخل <code>platforms/android</code>: هذا المجلد سيحتوي مشروع Cordova-android الأصلي خاصتك.  
−
* استخدم [[Cordova/cli|واجهة سطر الأوامر]] لتثبيت الإضافات التي تحتاج. لاحظ أن [[Cordova/cli|واجهة سطر الأوامر]] (CLI) تتعامل مع جميع الواجهات البرمجية الأساسية على أنّها إضافات، لذا قد تحتاج إلى إضافتها. فقط الإضافات من الإصدار 3.0.0 متوافقة مع [[Cordova/cli|واجهة سطر الأوامر]].  
+
* استخدم [[Cordova/cli|واجهة سطر الأوامر]] لتثبيت الإضافات التي تحتاج. لاحظ أنّ [[Cordova/cli|واجهة سطر الأوامر]] تتعامل مع جميع الواجهات البرمجية الأساسية على أنّها إضافات، لذا قد تحتاج إلى إضافتها. وفقط الإضافات ذات الإصدارات الأعلى من 3.0.0 متوافقة مع [[Cordova/cli|واجهة سطر الأوامر]].  
−
== الترقية إلى الإصدار 3.0.0 من الإصدار 2.9.0 ==  
+
== الترقية إلى الإصدار 3.0.0 انطلاقا من الإصدار 2.9.0 ==  
 
* أنشئ مشروعًا جديدًا.  
 
* أنشئ مشروعًا جديدًا.  
 
* انسخ محتويات المجلد <code>www</code> إلى المشروع الجديد.  
 
* انسخ محتويات المجلد <code>www</code> إلى المشروع الجديد.  
سطر 140: سطر 146:
 
<code>NOTE</code>: أزيلت جميع الواجهات البرمجية الأساسية، ويجب تثبيتها كإضافات. يرجى الاطلاع على دليل [../../../plugin_ref/plugman.html Using Plugman to Manage Plugins] لمزيد من التفاصيل.
 
<code>NOTE</code>: أزيلت جميع الواجهات البرمجية الأساسية، ويجب تثبيتها كإضافات. يرجى الاطلاع على دليل [../../../plugin_ref/plugman.html Using Plugman to Manage Plugins] لمزيد من التفاصيل.
  
−
== الترقية إلى الإصدار2.9.0 من الإصدار 2.8.0 ==  
+
== الترقية إلى الإصدار2.9.0 انطلاقا من الإصدار 2.8.0 ==  
 
* نفّذ الأمرَ <code>bin/update <project_path></code>  
 
* نفّذ الأمرَ <code>bin/update <project_path></code>  
−
== الترقية إلى الإصدار 2.8.0 من الإصدار 2.7.0 ==  
+
== الترقية إلى الإصدار 2.8.0 انطلاقا من الإصدار 2.7.0 ==  
 
* إزِل الملف <code>cordova-2.7.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* إزِل الملف <code>cordova-2.7.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أضف الملف <code>cordova-2.8.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* أضف الملف <code>cordova-2.8.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 151: سطر 157:
 
* حدِّث الملف <code>framework/res/xml/config.xml</code> حتى تحصل على إعدادات مماثلة كما فعلت سابقا.  
 
* حدِّث الملف <code>framework/res/xml/config.xml</code> حتى تحصل على إعدادات مماثلة كما فعلت سابقا.  
 
* انسخ الملفات من المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
 
* انسخ الملفات من المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
−
== الترقية إلى الإصدار 2.7.0 من الإصدار 2.6.0 ==  
+
== الترقية إلى الإصدار 2.7.0 انطلاقا من الإصدار 2.6.0 ==  
 
* أزِل <code>cordova-2.6.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل <code>cordova-2.6.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أضف الملف <code>cordova-2.7.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* أضف الملف <code>cordova-2.7.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 160: سطر 166:
 
* حدّث الملف <code>framework/res/xml/config.xml</code> لتحصل على إعدادات مماثلة كما فعلت سابقا.  
 
* حدّث الملف <code>framework/res/xml/config.xml</code> لتحصل على إعدادات مماثلة كما فعلت سابقا.  
 
* انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
 
* انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
−
== الترقية إلى الإصدار 2.6.0 من الإصدار 2.5.0 ==  
+
== الترقية إلى الإصدار 2.6.0 انطلاقا من الإصدار 2.5.0 ==  
 
* إزِل الملف <code>cordova-2.5.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* إزِل الملف <code>cordova-2.5.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.6.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.6.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 171: سطر 177:
  
 
نفّذ الأمر <code>bin/update <project></code> في مسار المشروع المذكور في المجلد المصدري لكوردوفا.  
 
نفّذ الأمر <code>bin/update <project></code> في مسار المشروع المذكور في المجلد المصدري لكوردوفا.  
−
== الترقية إلى الإصدار 2.5.0 من الإصدار 2.4.0 ==  
+
== الترقية إلى الإصدار 2.5.0 انطلاقا من الإصدار 2.4.0 ==  
 
* أزِل الملف <code>cordova-2.4.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-2.4.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.5.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.5.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 180: سطر 186:
 
* حدّث الملف <code>framework/res/xml/config.xml</code> لتحصل على إعدادات مماثلة كما فعلت سابقا.  
 
* حدّث الملف <code>framework/res/xml/config.xml</code> لتحصل على إعدادات مماثلة كما فعلت سابقا.  
 
* انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
 
* انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
−
== الترقية إلى الإصدار 2.4.0 من الإصدار 2.3.0 ==  
+
== الترقية إلى الإصدار 2.4.0 انطلاقا من الإصدار 2.3.0 ==  
 
* أزِل الملف <code>cordova-2.3.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-2.3.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.4.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.4.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 188: سطر 194:
 
* انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>.  
 
* انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>.  
 
* انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
 
* انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
−
== الترقية إلى الإصدار 2.3.0 من الإصدار 2.2.0 ==  
+
== الترقية إلى الإصدار 2.3.0 انطلاقا من الإصدار 2.2.0 ==  
 
* أزِل الملف <code>cordova-2.2.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-2.2.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.3.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.3.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 196: سطر 202:
 
* انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>.  
 
* انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>.  
 
* انسخ الملفات من المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
 
* انسخ الملفات من المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
−
== الترقية إلى الإصدار 2.2.0 من الإصدار 2.1.0 ==  
+
== الترقية إلى الإصدار 2.2.0 انطلاقا من الإصدار 2.1.0 ==  
 
* أزِل الملف <code>cordova-2.1.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-2.1.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.2.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.2.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 204: سطر 210:
 
* انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>.  
 
* انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>.  
 
* انسخ الملفات من المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
 
* انسخ الملفات من المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
−
== الترقية إلى الإصدار 2.1.0 من الإصدار 2.0.0 ==  
+
== الترقية إلى الإصدار 2.1.0 انطلاقا من الإصدار 2.0.0 ==  
 
* أزِل الملف <code>cordova-2.0.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-2.0.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.1.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.1.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 212: سطر 218:
 
* انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>.  
 
* انسخ الملف <code>res/xml/config.xml</code> ليُطابق المسار <code>framework/res/xml/config.xml</code>.  
 
* انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
 
* انسخ الملفات الموجودة في المجلد <code>bin/templates/cordova</code> إلى مجلد المشروع <code>cordova</code>.  
−
== الترقية إلى الإصدار 2.0.0 من الإصدار 1.9.0 ==  
+
== الترقية إلى الإصدار 2.0.0 انطلاقا من الإصدار 1.9.0 ==  
 
* أزِل الملف <code>cordova-1.9.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-1.9.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.0.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-2.0.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 221: سطر 227:
  
 
في الإصدار 2.0.0، يجمع الملف <code>config.xml</code> ويستبدل الملفين <code>cordova.xml</code> و <code>plugins.xml</code>. الملفات القديمة صارت مُهملةً الآن، وبينما لا تزال تعمل في الإصدار 2.0.0، فستوقف في إصدار مستقبلي.  
 
في الإصدار 2.0.0، يجمع الملف <code>config.xml</code> ويستبدل الملفين <code>cordova.xml</code> و <code>plugins.xml</code>. الملفات القديمة صارت مُهملةً الآن، وبينما لا تزال تعمل في الإصدار 2.0.0، فستوقف في إصدار مستقبلي.  
−
== الترقية إلى الإصدار 1.9.0 من الإصدار 1.8.1 ==  
+
== الترقية إلى الإصدار 1.9.0 انطلاقا من الإصدار 1.8.1 ==  
 
* أزِل الملف <code>cordova-1.8.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-1.8.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.9.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.9.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 230: سطر 236:
  
 
نظرًا لإدخال <code>CordovaWebView</code> في الإصدار 1.9.0، فقد لا تعمل إضافات الطرف الثالث. تحتاج تلك الإضافات إلى الحصول على سياق من <code>CordovaInterface</code> باستخدام التابعَين <code>getContext()</code> أو <code>getActivity()</code>. إذا لم تكن لديك خبرة في التطوير على منصة أندرويد، فيرجى الاتصال بمشرف الإضافة وإضافة هذه المهمة إلى أداة تعقب الأخطاء خاصتهم.  
 
نظرًا لإدخال <code>CordovaWebView</code> في الإصدار 1.9.0، فقد لا تعمل إضافات الطرف الثالث. تحتاج تلك الإضافات إلى الحصول على سياق من <code>CordovaInterface</code> باستخدام التابعَين <code>getContext()</code> أو <code>getActivity()</code>. إذا لم تكن لديك خبرة في التطوير على منصة أندرويد، فيرجى الاتصال بمشرف الإضافة وإضافة هذه المهمة إلى أداة تعقب الأخطاء خاصتهم.  
−
== الترقية إلى الإصدار 1.8.0 من الإصدار 1.8.0 ==  
+
== الترقية إلى الإصدار 1.8.0 انطلاقا من الإصدار 1.8.0 ==  
 
* أزِل الملف <code>cordova-1.8.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-1.8.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.8.1.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.8.1.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 237: سطر 243:
 
* حدّث ملف HTML الخاص بك لاستخدام الملف <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>.  
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>.  
−
== الترقية إلى الإصدار 1.8.0 من الإصدار 1.7.0 ==  
+
== الترقية إلى الإصدار 1.8.0 انطلاقا من الإصدار 1.7.0 ==  
 
* أزِل الملف <code>cordova-1.7.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-1.7.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.8.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.8.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 244: سطر 250:
 
* حدّث ملف HTML الخاص بك لاستخدام الملف <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>.  
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>.  
−
== الترقية إلى الإصدار 1.8.0 من الإصدار 1.7.1 ==  
+
== الترقية إلى الإصدار 1.8.0 انطلاقا من الإصدار 1.7.1 ==  
 
* أزِل الملف <code>cordova-1.7.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-1.7.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.8.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.8.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 251: سطر 257:
 
* حدّث ملف HTML الخاص بك لاستخدام الملف <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>.  
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>.  
−
== الترقية إلى الإصدار 1.7.0 من الإصدار 1.6.1 ==  
+
== الترقية إلى الإصدار 1.7.0 انطلاقا من الإصدار 1.6.1 ==  
 
* أزِل الملف <code>cordova-1.6.1.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-1.6.1.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.7.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.7.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 257: سطر 263:
 
* انسخ ملف <code>cordova-1.7.0.js</code> الجديد إلى مشروعك.  
 
* انسخ ملف <code>cordova-1.7.0.js</code> الجديد إلى مشروعك.  
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>.  
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>.  
−
== الترقية إلى الإصدار 1.6.1 من الإصدار 1.6.0 ==  
+
== الترقية إلى الإصدار 1.6.1 انطلاقا من الإصدار 1.6.0 ==  
 
* أزِل الملف <code>cordova-1.6.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-1.6.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.6.1.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.6.1.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 263: سطر 269:
 
* انسخ ملف <code>cordova-1.6.1.js</code> الجديد إلى مشروعك.  
 
* انسخ ملف <code>cordova-1.6.1.js</code> الجديد إلى مشروعك.  
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>.  
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>.  
−
== الترقية إلى الإصدار 1.6.0 من الإصدار 1.5.0 ==  
+
== الترقية إلى الإصدار 1.6.0 انطلاقا من الإصدار 1.5.0 ==  
 
* أزِل الملف <code>cordova-1.5.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>cordova-1.5.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.6.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.6.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 271: سطر 277:
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</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>.  
 
* استبدل <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 ==  
+
== الترقية إلى الإصدار 1.5.0 انطلاقا من الإصدار 1.4.0 ==  
 
* أزِل الملف <code>phonegap-1.4.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>phonegap-1.4.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.5.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>cordova-1.5.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 279: سطر 285:
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</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>.  
 
*استبدل <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 ==  
+
== الترقية إلى الإصدار 1.4.0 انطلاقا من الإصدار 1.3.0 ==  
 
* أزِل الملف <code>phonegap-1.3.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>phonegap-1.3.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>phonegap-1.4.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>phonegap-1.4.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 287: سطر 293:
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</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>.  
 
* حدَّث الملف <code>res/xml/phonegap.xml</code> ليُطابق المسار <code>framework/res/xml/phonegap.xml</code>.  
−
== الترقية إلى الإصدار 1.3.0 من الإصدار 1.2.0 ==  
+
== الترقية إلى الإصدار 1.3.0 انطلاقا من الإصدار 1.2.0 ==  
 
* أزِل الملف <code>phonegap-1.2.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>phonegap-1.2.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>phonegap-1.3.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>phonegap-1.3.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 295: سطر 301:
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</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>.  
 
* حدَّث الملف <code>res/xml/phonegap.xml</code> ليُطابق المسار <code>framework/res/xml/phonegap.xml</code>.  
−
== الترقية إلى الإصدار 1.2.0 من الإصدار 1.1.0 ==  
+
== الترقية إلى الإصدار 1.2.0 انطلاقا من الإصدار 1.1.0 ==  
 
* أزِل الملف <code>phonegap-1.1.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>phonegap-1.1.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>phonegap-1.2.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>phonegap-1.2.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 303: سطر 309:
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</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>.  
 
* حدَّث الملف <code>res/xml/phonegap.xml</code> ليُطابق المسار <code>framework/res/xml/phonegap.xml</code>.  
−
== الترقية إلى الإصدار 1.1.0 من الإصدار 1.0.0 ==  
+
== الترقية إلى الإصدار 1.1.0 انطلاقا من الإصدار 1.0.0 ==  
 
* أزِل الملف <code>phonegap-1.0.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>phonegap-1.0.0.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>phonegap-1.1.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>phonegap-1.1.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
سطر 310: سطر 316:
 
* حدّث ملف HTML الخاص بك لاستخدام الملف <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>.  
 
* حدَّث الملف <code>res/xml/plugins.xml</code> ليُطابق المسار <code>framework/res/xml/plugins.xml</code>.  
−
== الترقية إلى الإصدار 1.0.0 من الإصدار 0.9.6==  
+
== الترقية إلى الإصدار 1.0.0 انطلاقا من الإصدار 0.9.6==  
 
* أزِل الملف <code>phonegap-0.9.6.jar</code> من مجلد المشروع <code>libs</code>.  
 
* أزِل الملف <code>phonegap-0.9.6.jar</code> من مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>phonegap-1.0.0.jar</code> إلى مجلد المشروع <code>libs</code>.  
 
* اضف الملف <code>phonegap-1.0.0.jar</code> إلى مجلد المشروع <code>libs</code>.  

مراجعة 20:05، 27 ديسمبر 2018

يوضح هذا الدليل كيفية تعديل مشروعات كوردوفا للترقية انطلاقا من الإصدارات القديمة من كوردوفا. تنطبق معظم هذه الإرشادات على المشاريع التي تم إنشاؤها باستخدام أدوات سطر الأوامر القديمة التي كانت قبل واجهة سطر الأوامر. يمكنك الدخول إلى صفحة الرابط للحصول على معلومات حول كيفية تحديث إصدار واجهة سطر الأوامر (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

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

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

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

تتأثر الإضافات الأساسية التالية بهذا التغيير، ويجب ترقيتها لاستخدامها مع الإصدار 5.0.0 من cordova-android فما فوقه:

الإضافة أدنى إصدار متوافق
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

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

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

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

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

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

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

bin/update path/to/project‎

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

  • حدّث إصدار واجهة سطر الأوامر cordova .
  • َنفِّذ الأمر cordova platform update android@4.0.0 في مشاريعك الحالية.

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

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

لدى كوردوفا إضافتان خاصتان باللوائح البيضاء، واللتان توفران مستويات مختلفة من الحماية.

  1. الإضافة cordova-plugin-whitelist (موصى بها)
    • يُنصح بشدة باستخدام هذه الإضافة، لأنها أكثر أمانًا وقابلية للتعديل من اللائحة البيضاء في الإصدارات السابقة
    • راجع صفحة الإضافة cordova-plugin-whitelist للحصول على تفاصيل حول التغييرات المطلوبة في الإعدادات
    • نفّذ الأمر: cordova plugin add cordova-plugin-crosswalk-webview
  2. الإضافة 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‎

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

الترقية إلى الإصدار 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

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

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

bin/update <project_path>‎

تنبيه: من الإصدار 4.4 إلى الإصدار4.4.3 من أندرويد، لن يؤدي إنشاء عنصر إدخال ملفات (file input element) من النوع type = "file"‎ إلى فتح منتقي الملفات (file picker). مصدر هذه المشكلة هو المتصفح Chromium على منصة أندرويد، ويمكن إعادة إنتاج المشكلة في متصفح Chrome المنفصل عنه على نفس المنصة (راجع هذه الصفحة لمزيدٍ من التفاصيل)، الحل المقترح هو استخدام الإضافتين FileTransfer و File على منصة أندرويد 4.4. يمكنك الإنصات إلى الحدث onClick من المُدخلة type="file"‎، ثم عرض واجهة منتقي الملفات. لربط بيانات النموذج مع التحميل، يمكنك استخدام جافاسكريبت لربط قيم النموذج مع طلبية POST متعددة الأجزاء التي تُنشئها الإضافة FileTransfer.

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

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

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

bin/update <project_path>‎

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

  • أنشئ مشروعًا جديدًا لكوردوفا 3.0.0 باستخدام واجهة سطر الأوامر، كما هو موضح في صفحتها
  • أضف منصاتك إلى مشروع كوردوفا، على سبيل المثال: cordova platform add android
  • انسخ محتويات مجلد المشروع www الخاص بك إلى المجلد www الموجود في جذر مشروع كوردوفا الذي أنشأته للتو.
  • انسخ كل الأصول المحلية (native assets) من مشروعك القديم إلى المجلدات المناسبة داخل platforms/android: هذا المجلد سيحتوي مشروع Cordova-android الأصلي خاصتك.
  • استخدم واجهة سطر الأوامر لتثبيت الإضافات التي تحتاج. لاحظ أنّ واجهة سطر الأوامر تتعامل مع جميع الواجهات البرمجية الأساسية على أنّها إضافات، لذا قد تحتاج إلى إضافتها. وفقط الإضافات ذات الإصدارات الأعلى من 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=26896"