عرض مصدر Cordova/platforms ios

<noinclude>{{DISPLAYTITLE:دليل التطوير على منصة iOS في كوردوفا}}</noinclude>
[[تصنيف: Cordova]]
[[تصنيف: Cordova Platform]]
يوضح هذا الدليل كيفية إعداد بيئة تطوير SDK لنشر تطبيقات كوردوفا للأجهزة التي تعمل على أنظمة iOS مثل iPhone و iPad وكيفية استخدام أدوات سطر الأوامر المرتكزة على منصة iOS بشكل اختياري في سير عمل التطوير الخاص بك. تحتاج إلى تثبيت أدوات SDK بغض النظر عما إذا كنت ترغب في استخدام أدوات الصدفة (shell) هذه المرتكزة على منصة ios فقط أو استخدام سطر أوامر كوردوفا العابر للمنصات في عملية التطوير. وللمقارنة بين مساري التطوير، راجع صفحة [[Cordova/overview|نظرة عامة]]. للحصول على تفاصيل حول سطر أوامر كوردوفا، اطلع على صفحة [[Cordova/cli|واجهة سطر الأوامر]] في كوردوفا.

== المتطلبات والدعم ==
تعمل أدوات Apple®‎ اللازمة لإنشاء تطبيقات iOS فقط على نظام التشغيل OS X على أجهزة Mac المستندة إلى Intel. Xcode® 8.0 (الإصدار الأدنى المطلوب) والذي يعمل فقط على الإصدار OS X 10.11.5 (الذي يدعى El Capitan) أو ما بعده، ويتضمن iOS 10 SDK (مجموعة تطوير البرامج). ولإرسال التطبيقات إلى متجر Apple App Store℠‎، يجب أن تستعمل أحدث إصدار من أدوات Apple.

يمكنك اختبار العديد من ميزات كوردوفا باستخدام محاكي iOS المثبت مع iOS SDK و Xcode، ولكنك تحتاج إلى جهاز حقيقي لاختبار التطبيق مع كامل ميزات الجهاز قبل رفعه على متجر التطبيقات. يجب أن يكون مثبتا على الجهاز الإصدار iOS 9 على الأقل، وهو الإصدار الأدنى لنظام iOS المدعوم من كوردوفا 4.4.0. 

== تثبيت المتطلبات ==

=== Xcode ===
هناك طريقتان لتنزيل Xcode همها:
* تنزيله من المتجر [https://itunes.apple.com/us/app/xcode/id497799835?mt=12 App Store]، إذ يمكن العثور عليه عبر البحث عنه "Xcode" في قسم التطبيقات في المتجر App Store.
* تنزيله من صفحة [https://developer.apple.com/downloads/index.action التنزيلات] لمطوري تطبيقات Apple، وهذا يتطلب التسجيل كمطور Apple.
بمجرد تثبيت Xcode، يجب تمكين العديد من أدوات سطر الأوامر لتشغيل كوردوفا. نفذ الأمر التالي من سطر الأوامر:<syntaxhighlight lang="shell">
$ xcode-select --install
</syntaxhighlight>

=== أدوات النشر ===
تتيح لك أدوات [https://www.npmjs.org/package/ios-deploy نشر التطبيق] على منصة ios تشغيل تطبيقات iOS على جهاز iOS من سطر الأوامر. لتثبيته، قم بتنفيذ الأمر التالي من سطر الأوامر:<syntaxhighlight lang="shell">
$ npm install -g ios-deploy
</syntaxhighlight>

== ضبط المشروع ==
سيعمل تثبيت Xcode على ضبط كل شيء مطلوب للبدء مع الجانب الأصلي من الأشياء. فيجب أن تكون الآن قادرًا على إنشاء مشروع كوردوفا وبنائه. ولمزيد من التفاصيل حول تثبيت CLI واستخدامه، ارجع إلى إنشاء صفحة [[Cordova/first app|إنشاء التطبيق الأول في كوردوفا]].

=== النشر إلى المحاكي ===
لمعاينة التطبيق في محاكي iOS، اتبع الخطوات التالية:
# افتح الملف workspace من <code>platforms/ios/HelloWorld.xcworkspace</code> من Xcode، أو من سطر الأوامر:<syntaxhighlight lang="shell">
$ open ./platforms/ios/HelloWorld.xcworkspace/
</syntaxhighlight>
# تأكد من تحديد المشروع <code>HelloWorld</code> في اللوحة اليمنى (الخطوة 1):  [[ملف:select_xcode_scheme.png|بديل=تحديد المشروع HelloWorld وفتحه لمعاينة التطبيق في محاكي iOS.|بدون|تحديد المشروع HelloWorld وفتحه لمعاينة التطبيق في محاكي iOS.|تصغير|600بك]]
# حدد الجهاز المقصود من القائمة Scheme في شريط الأدوات، مثل محاكي iPhone 7 Plus كما هو موضح في الخطوة (2) في الصورة السابقة.
# اضغط على الزر Run (الخطوة 3) في نفس شريط الأدوات على يسار Scheme. هذا الزر يبني وينشر ويدير التطبيق في جهاز المحاكاة. يفتح عندئذ تطبيق المحاكاة بشكل منفصل لعرض التطبيق.  [[ملف:HelloWorldStandard.png|بديل=تشغيل التطبيق HelloWorld المنشأ باستعمال كوردوفا في محاكي iOS.|بدون|تشغيل التطبيق HelloWorld المنشأ باستعمال كوردوفا في محاكي iOS.|تصغير|200بك]]
يمكن تشغيل جهاز محاكاة واحد فقط في كل مرة، لذلك إذا كنت ترغب في اختبار التطبيق في محاكي مختلف، فإنك تحتاج إلى إنهاء تطبيق جهاز المحاكاة الحالي وتشغيل محاكي آخر ضمن Xcode.

تأتي Xcode مجمعة مع أجهزة محاكاة لأحدث إصدارات iPhone و iPad. وقد تكون الإصدارات الأقدم متاحة من Xcode. يمكنك التحقق من ذلك عبر '''Xcode''' ‏← '''Preferences...‎''' ‏← '''Components'''.

=== النشر على الجهاز ===
للحصول على تفاصيل حول المتطلبات المتعددة لنشرها على الجهاز، ارجع إلى قسم "تشغيل تطبيقك على الأجهزة" في [https://developer.apple.com/library/prerelease/ios/documentation/IDEs/Conceptual/AppDistributionGuide/Introduction/Introduction.html هذه] الصفحة. باختصار، يلزمك إجراء ما يلي قبل النشر:

1- إنشاء ملف شخصي لإدارة الحسابات في [https://developer.apple.com/ios/manage/overview/index.action iOS Provisioning Portal]. يمكنك استخدام مساعد إدارة التطوير (Development Provisioning Assistant) لإنشاء وتثبيت الملف الشخصي والشهادة التي يطلبها Xcode.

2- تحقق من تعيين إعداد "هوية توقيع الشيفرة" (Code Signing Identity) داخل قسم "توقيع الشيفرة" ضمن إعدادات الإنشاء إلى اسم ملف التعريف الخاص بك المقدم (الخطوة 1).

للنشر على الجهاز، اتبع الخطوات التالية:

1- استخدم كابل USB لتوصيل حاسوبك بالجهاز Mac

2- اختر اسم المشروع من القائمة المنسدلة '''Scheme''' لنافذة Xcode

3- اختر جهازك من القائمة المنسدلة '''Device'''. وإذا تم توصيله عبر USB ولكن لا يزال غير موجود، فاضغط على الزر '''Organizer''' لحل أي أخطاء.

4- اضغط على الزر '''Run''' لإنشاء التطبيق ونشره على جهازك

== توقيع التطبيق ==
أولاً، يجب أن تقرأ من خلال صفحة [https://developer.apple.com/support/code-signing/ دعم توقيع الشيفرة] و[https://developer.apple.com/library/prerelease/ios/documentation/IDEs/Conceptual/AppDistributionGuide/Introduction/Introduction.html مسار عمل توزيع التطبيقات].

=== استخدام الرايات ===
لتسجيل تطبيق، فإنك  تحتاج إلى المعاملات التالية:
{| class="wikitable"
!المعامل
!الراية
!الوصف
|-
|معرف شيفرة الدخول
|<code>‎--codeSignIdentity</code>
|معرِّف توقيع الشفرة لاستخدامها للتوقيع. فيمكن إنشاؤها مع Xcode وإضافتها إلى سلسلة المفاتيح الخاصة بك. بدءًا من Xcode 8 يجب عليك استخدام <code>"‎--codeSignIdentity = "iPhone Developer</code> كلاهما من أجل <code>debug</code> و <code>release</code>.
|-
|فريق التطوير
|<code>‎--developmentTeam</code>
|فريق التطوير ([https://developer.apple.com/account/#/membership/ معرف الفريق]) لاستخدامه لتوقيع الشيفرة. يمكنك استخدام هذا الإعداد ومعرف توقيع شيفرة مبسط (مثل "iPhone Developer" فقط) للدخول على تطبيقاتك، ولا يلزمك تقديم ملف شخصي لإدارة الحسابات.
|-
|نوع الحزمة
|<code>‎--packageType</code>
|سيحدد هذا نوع البنية التي يتم إنشاؤها بواسطة Xcode، إذ تتمثل الخيارات الصالحة في <code>development</code> (الخيار الافتراضي) و <code>enterprise</code> و <code>ad-hoc</code> و app-<code>store</code>.
|-
|ملف التطوير
|<code>‎--provisioningProfile</code>
|(اختياري) GUID لملف التعريف الشخصي الذي سيتم استخدامه للتوقيع اليدوي حيث يتم نسخها هنا على جهاز Mac الخاص بك: ‎<code>~/Library/MobileDevice/Provisioning\Profiles/</code>‎. عبر فتحه في محرر نصي، يمكنك العثور على المعرف GUID العمومي الذي يحتاج إلى تحديد هنا إذا كنت تستخدم الدخول اليدوي.
|-
|قواعد مصدر توقيع الشيفرة
|<code>‎--codesignResourceRules</code>
|(اختياري) يستخدم للتحكم في الملفات الموجودة في الحزمة التي يجب أن تكون مختومة بواسطة توقيع الشيفرة. وللحصول على مزيد من التفاصيل، اقرأ [https://developer.apple.com/library/mac/technotes/tn2206/_index.html#//apple_ref/doc/uid/DTS40007919-CH1-TNTAG206 هذه] المقالة.
|-
|معرف التزويد التلقائي
|<code>--automaticProvisioning</code>
|(اختياري) فعله ليتمكك Xcode من إدارة ملفات تعريف التوفير (provisioning profiles) تلقائيًا. الخيارات الصالحة هي <code>false</code> (الافتراضي) و <code>true</code>.
|}

=== استخدام build.json ===
بدلاً من ذلك، يمكنك تحديدها في ملف الضبط (<code>build.json</code>) باستخدام الوسيط ‎<code>--buildConfig</code> إلى نفس الأوامر.  إليك عينة من ملف ضبط البناء:

للدخول التلقائي، حيث تتم إدارة ملفات التخصيص تلقائيًا بواسطة Xcode (موصى به):<syntaxhighlight lang="shell">
{
    "ios": {
        "debug": {
            "codeSignIdentity": "iPhone Developer",
            "developmentTeam": "FG35JLLMXX4A",
            "packageType": "development",
            "automaticProvisioning": true,
            "buildFlag": [
                "EMBEDDED_CONTENT_CONTAINS_SWIFT = YES",
                "ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES=NO",
                "LD_RUNPATH_SEARCH_PATHS = \"@executable_path/Frameworks\""
            ]
        },
        "release": {
            "codeSignIdentity": "iPhone Developer",
            "developmentTeam": "FG35JLLMXX4A",
            "packageType": "app-store",
            "automaticProvisioning": true,
            "buildFlag": [
                "EMBEDDED_CONTENT_CONTAINS_SWIFT = YES",
                "ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES=NO",
                "LD_RUNPATH_SEARCH_PATHS = \"@executable_path/Frameworks\""
            ]
        }
    }
}
</syntaxhighlight>للدخول اليدوي، حدد ملفات التوفير المتوفرة بواسطة UUID:<syntaxhighlight lang="shell">
{
    "ios": {
        "debug": {
            "codeSignIdentity": "iPhone Development",
            "provisioningProfile": "926c2bd6-8de9-4c2f-8407-1016d2d12954",
            "developmentTeam": "FG35JLLMXX4A",
            "packageType": "development"
        },
        "release": {
            "codeSignIdentity": "iPhone Distribution",
            "provisioningProfile": "70f699ad-faf1-4adE-8fea-9d84738fb306",
            "developmentTeam": "FG35JLLMXX4A",
            "packageType": "app-store"
        }
    }
}

</syntaxhighlight>

== رايات بناء Xcode ==
إذا كان لديك حالة مخصصة حيث تحتاج إلى تمرير رايات بناء إضافية إلى Xcode، فيمكنك عندئذٍ استخدام واحد أو أكثر من خيارات ‎<code>--binildFlag</code> لتمرير هذه الرايات إلى <code>xcodebuild</code>. وإذا استخدمت الراية <code>xcodebuild</code> المضمنة، فسيظهر تحذير لك.  <syntaxhighlight lang="shell">
cordova build --device --buildFlag="MYSETTING=myvalue" --buildFlag="MY_OTHER_SETTING=othervalue"
cordova run --device --buildFlag="DEVELOPMENT_TEAM=FG35JLLMXX4A" --buildFlag="-scheme TestSchemeFlag"

</syntaxhighlight>يمكنك أيضًا تحديد الخيار <code>buildFlag</code> في <code>build.json</code> أعلاه (تكون قيمة المفتاح <code>buildFlag</code> عبارة عن سلسلة نصية أو مصفوفة من السلاسل النصية).

== التنقيح ==
للحصول على تفاصيل حول أدوات تنقيح وتصحيح الأخطاء التي تأتي مع Xcode، راجع [https://developer.apple.com/support/debugging هذه] المقالة و[https://developer.apple.com/videos/play/wwdc2014-413/ هذا] الفيديو.

=== فتح مشروع ضمن Xcode ===
يمكن فتح مشروع كوردوفا لمنصة iOS في Xcode. و يمكن لذلك ان يكون مفيدًا إذا كنت ترغب في استخدام Xcode المدمج في أدوات تصحيح الأخطاء/الصياغة أو إذا كنت تقوم بتطوير الإضافات لنظام iOS. يرجى عندئذٍ ملاحظة أنه عند فتح مشروعك في Xcode، يوصى بعدم تحرير شيفرتك في IDE لأنَّ ذلك سيؤدي إلى تعديل الشيفرة في المجلد <code>platforms</code> في مشروعك (وليس في المجلد <code>www</code>)، وستكون التغييرات قابلة للكتابة والاستبدال. فبدلًا من ذلك، قم بتحرير المجلد <code>www</code> ونسخ التغييرات التي أجريتها عن طريق تنفيذ الأمر <code>[[Cordova/cli#.D8.A7.D9.84.D8.A3.D9.85.D8.B1 cordova build|cordova build]]</code>.

يجب على مطوري البرامج الإضافية الراغبين في تحرير شيفرتهم الأصلية في بيئة تطوير متكاملة (IDE) استخدام الراية ‎ <code>--link</code>عند إضافة إضافة للمشروع عن طريق <code>cordova plugin add</code>. سيؤدي هذا إلى ربط الملفات بحيث التغييرات التي تطرأ على ملفات الإضافات في المجلد platforms تنعكس في مجلد المصدري للإضافة (والعكس صحيح).

بمجرد إضافة منصة ios إلى مشروعك وبناءها باستخدام <code>[[Cordova/cli#.D8.A7.D9.84.D8.A3.D9.85.D8.B1 cordova build|cordova build]]</code>، يمكنك فتحه من داخل Xcode. انقر نقرًا مزدوجًا لفتح الملف ‎<code>${PROJECT_NAME}/platforms/ios/${PROJECT_NAME}.xcworkspace</code> أو افتح Xcode من الطرفية:<syntaxhighlight lang="shell">
$ open -a Xcode platforms/ios
</syntaxhighlight>يجب أن تكون الشاشة كالشكل التالي:

[[ملف:helloworld_project.png|بديل=فتح المشروع helloworld الذي بني في كوردوفا لمنصة iOS على Xcode. |بدون|فتح المشروع helloworld الذي بني في كوردوفا لمنصة iOS على Xcode. |تصغير|600بك]]

== سير العمل المرتكز على منصة واحدة ==
يشمل cordova-ios عددًا من النصوص البرمجية التي تسمح باستخدام المنصة دون الاعتماد كليًّا على سطر أوامر كوردوفا. وقد يوفر لك مسار التطوير هذا مجموعة أكبر من خيارات التطوير في مواقف معينة غير لا يوفرها مسار العمل العابر للمنصات باستعمال سطرالأوامر. على سبيل المثال، تحتاج إلى استخدام أدوات الصدفة (shell) عند نشر عارض [[Cordova/webviews|WebView]] مخصص إلى جانب المكونات الأصلية. وقبل استخدام مسار التطوير هذا، يجب عليك تهيئة بيئة SDK كما هو موضح في قسم المتطلبات والدعم أعلاه.

لكل من النصوص الموضحة أدناه، ارجع إلى [[Cordova/cli|واجهة سطر أوامر كوردوفا]] للحصول على مزيد من المعلومات حول الوسائط والاستخدام. يملك كل برنامج نصي اسمًا يطابق أمرًا في سطر الأوامر؛ فعلى سبيل المثال، <code>cordova-ios/bin/create</code> يكافئ <code>cordova create</code>.

للبدء، إما قم بتنزيل حزمة cordova-ios من [https://www.npmjs.com/package/cordova-ios npm] أو من [https://github.com/apache/cordova-ios Github]. لإنشاء مشروع باستخدام هذه الحزمة، قم بتشغيل البرنامج النصي <code>create</code> في المجلد <code>bin</code>:<syntaxhighlight lang="shell">
$ cordova-ios/bin/create ...
</syntaxhighlight>لتشغيل التطبيق، استخدم النص البرمجي للتشغيل <code>run</code> في المجلد <code>bin</code>:<syntaxhighlight lang="shell">
$ cordova-ios/bin/run
</syntaxhighlight>سيكون للمشروع الذي تم إنشاؤه مجلدًا باسم <code>cordova</code> بداخله يحتوي على برامج نصية لأوامر Cordova الخاصة بالمشروع (مثل <code>run</code>، و <code>build</code> ...إلخ). 

لتثبيت الإضافات في هذا المشروع، استخدم الأداة المساعدة [[Cordova/plugman|Plugman]].

== الترقية ==
اطلع على [https://cordova.apache.org/docs/en/latest/guide/platforms/ios/upgrade.html هذه] المقالة للحصول على تعليمات لترقية إصدار cordova-ios الخاص بك.

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

== مصادر ==
* [https://cordova.apache.org/docs/en/latest/guide/platforms/ios/index.html صفحة iOS Platform Guide في توثيق كوردوفا الرسمي.]