دليل التطوير على منصة OS X في كوردوفا

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

يوضح هذا الدليل كيفية إعداد بيئة تطوير SDK لنشر تطبيقات كوردوفا على أجهزة OS X الحاسوبية. راجع ما يلي للحصول على معلومات أكثر تفصيلًا متعلقة بالمنصة:

تشير أدوات سطر الأوامر أعلاه إلى الإصدارات السابقة لإصدار كوردوفا 3.0. اطلع على صفحة واجهة سطر الأوامر للحصول على معلومات حول الواجهة الحالية.

المتطلبات والدعم

تعمل أدوات Apple®‎ اللازمة لتشغيل تطبيقات OS X فقط على نظام التشغيل OS X على أجهزة Mac المستندة إلى Intel-based Xcode® 6.0 (الحد الأدنى للإصدار المطلوب) تحتوي فقط على إصدار OS Xversion 10.9 (هو Mavericks) أو الأحدث، ويتضمن OS X SDK (مجموعة أدوانت تطوير البرامج). يتطلب إرسال التطبيقات إلى المتجر Apple App Store℠‎ أحدث إصدار من أدوات Apple.

يمكنك اختبار جميع ميزات كوردوفا باستخدام XCode أو أي IDE آخر مثل AppCode في JetBrain، ولكنك تحتاج إلى استخدام XCode للتوقيع قبل الإرسال إلى المتجر App Store. لتوقيع التطبيقات، يجب أن تكون أيضًا عضوًا في مجتمع مطوري برامج OS X.

تثبيت SDK

هناك طريقتان لتنزيل Xcode:

  • من متجر التطبيقات؛ هذا متاح من خلال البحث عن "Xcode" في المتجر App Store.
  • من صفحة التنزيلات (Downloads) لمطوري تطبيقات Apple؛ وهذا يتطلب التسجيل كمطور تطبيقات Apple.

بمجرد تثبيت Xcode، يجب تمكين العديد من أدوات سطر الأوامر لتشغيل كوردوفا. من قائمة Xcode، حدد Preferences (التفضيلات)، ثم اللسان Downloads (التنزيلات). من لوحة Components  (المكونات)، اضغط على زر Install الموجود بجوار قائمة Command Line Tools.

إنشاء مشروع جديد

استخدم الأداة cordova لإعداد مشروع جديد وكما هو موضح في سطر أوامر كوردوفا. فعلى سبيل المثال، في مجلد الشيفرة المصدرية (source-code directory):
$ cordova create hello com.example.hello "HelloWorld"
$ cd hello
$ cordova platform add osx
$ cordova prepare              # or "cordova build"

تشغيل التطبيق

لتشغيل التطبيق على سطح المكتب لديك، نفذ الأمر التالي:
$ cordova run
ويجب أن تشاهد نافذة تظهر لك مع مثال للتطبيق كما في الشكل التالي:
تشغيل تطبيق كوردوفا المبني على منصة OS X على الحاسوب.
تشغيل تطبيق كوردوفا المبني على منصة OS X على الحاسوب.

يمكنك أيضًا استخدام الأمر cordova run --help لمشاهدة خيارات إضافية للتشغيل والبناء.

فتح المشروع في SDK

بمجرد إضافة منصة osx إلى مشروعك، يمكنك فتحه من داخل Xcode. انقر نقرًا مزدوجًا لفتح الملف hello/platforms/osx/HelloWorld.xcodeproj. يجب أن تبدو الشاشة كما يلي:

فتح مشروع كوردوفا بعد إضافة منصة OS X إليه من داخل Xcode.
فتح مشروع كوردوفا بعد إضافة منصة OS X إليه من داخل Xcode.
تلميح: يمكنك أيضًا استخدام الأمر open لفتح مشروع XCode مباشرة من سطر الأوامر:
$ open platforms/osx/HelloWorld.xcodeproj

المشاكل الشائعة

تحذيرات الإهمال: عند تغيير واجهة برمجة التطبيقات (API) أو استبدالها بواجهة برمجة تطبيقات أخرى، يتم وضع علامة عليها كمهمل (deprecated). في حين لا تزال واجهة برمجة التطبيقات تعمل على المدى القريب إلا أنه ستُزال في النهاية. تنعكس بعض هذه الواجهات التي تم إهمالها في كوردوفا وتصدر Xcode تحذيرات عنها عند إنشاء تطبيق ونشره.

العناوين الرأسية المفقودة: تنتج أخطاء التصريف (compilation errors) المتعلقة بالعناوين الرأسية المفقودة (missing headers) عن مشاكل في موقع البناء، ويمكن إصلاحها عبر تفضيلات Xcode:

  1. اختر Xcode ← التفضيلات (Preferences) ← المواقع (Locations).
  2. في القسم Derived Data، اضغط على الزر Advanced وحدد Unique كموقع البناء (Build Location) كما هو موضح بالصورة التالية:
إصلاح مشاكل موقع البناء في Xcode التي تؤدي إلى عناوين مفقودة. 
إصلاح مشاكل موقع البناء في Xcode التي تؤدي إلى عناوين مفقودة. 

هذا هو الإعداد الافتراضي لتثبيت Xcode جديد، ولكن قد يتم تعيينه بشكل مختلف بعد الترقية من إصدار قديم من Xcode.

لمزيد من المعلومات، راجع التوثيقات التالية من Apple:

(Mac®‎ و OS X®‎ و Apple®‎ و Xcode®‎ و App Store℠‎ و iPad®‎ و iPhone®‎ و iPod®‎ و Finder®‎ هي علامات تجارية لشركة Apple Inc.)

مصادر