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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الخطافات في كوردوفا}}</noinclude> تصنيف: Cordova تصنيف: hooks المقدمة تمثل خُطافات...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الخطافات في كوردوفا}}</noinclude>
<noinclude>{{DISPLAYTITLE:الخطافات في كوردوفا}}</noinclude>
[[تصنيف: Cordova]]
[[تصنيف: Cordova]]
[[تصنيف: hooks]]
[[تصنيف: hooks]]
المقدمة
خُطافات كوردوفا هي نصوصٌ برمجية خاصة يمكن إضافتها من قِبل مطوري التطبيقات والإضافات، أو حتى من طرف نظام البناء (build) الخاص بك لتخصيص أوامر كوردوفا.
[[تصنيف: hooks]]
تسمح لك خطافات كوردوفا بالقيام بأنشطة خاصة ترافق أوامر كوردوفا. على سبيل المثال، قد تكون لديك أداة مخصصة للتحقق من تنسيق التعليمات البرمجية في ملف [[JavaScript|جافاسكريبت]] خاصتك. وتود تشغيل هذه الأداة قبل كل عملية بناء. في مثل هذه الحالة، يمكنك استخدام الخطاف '<code>before_build</code>' وجعل كوردوفا تشغّل هذه الأداة المخصصة وقت التشغيل، بحيث تُستدعى قبل كل عملية بناء.


تمثل خُطافات كوردوفا نصوصًا برمجية خاصة يمكن إضافتها من قِبل مطوري التطبيقات والإضافات، أو حتى من طرف نظام البناء (build) الخاص بك لتخصيص أوامر كوردوفا.  
قد ترتبط الخطافات بأنشطة التطبيق الخاصة بك، كما هو الحال في الخطافين <code>before_build</code> و <code>after_build</code> وغيرهما، أو قد ترتبط بإضافات تطبيقك. على سبيل المثال، ينطبق الخطافان <code>before_plugin_add</code> و <code>after_plugin_add</code> وغيرهما على الأنشطة المتعلقة بالإضافة. يمكن ربط هذه الخطافات بجميع الإضافات داخل التطبيق، أو يمكن أن تكون مخصوصة بإضافة واحدة فقط.  


تسمح لك خطافات كوردوفا بالقيام بأنشطة خاصة حول أوامر كوردوفا. على سبيل المثال، قد تكون لديك أداة مخصصة للتحقق من تنسيق التعليمات البرمجية في ملف [[JavaScript|[[Java|جافا]]اسكريبت]] الخاص بك. وتود تشغيل هذه الأداة قبل كل عملية بناء. في مثل هذه الحالة، يمكنك استخدام الخطاف 'before_build' وجعل كوردوفا تشغّل هذه الأداة المخصصة وقت التشغيل ليتم استدعاؤها قبل كل عملية بناء.  
تدعم كوردوفا أنواع الخطافات التالية: 
{| class="wikitable"
!نوع الخطاف
!أوامر كوردوفا المقابلة
!الشرح
|-
|<code>before_platform_add</code>
| rowspan="2" |<code>cordova platform add</code>
| rowspan="2" |يُنفّذ هذا الخُطّاف قبل وبعد إضافة المنصة.
|-
|<code>before_platform_add</code>
|-
|<code>before_platform_rm</code>
| rowspan="2" |<code>cordova platform rm</code>
| rowspan="2" |يُنفّذ قبل وبعد إزالة المنصة.
|-
|<code>after_platform_rm</code>
|-
|<code>before_platform_ls</code>
| rowspan="2" |<code>cordova platform ls</code>
| rowspan="2" |يُنفّذ قبل وبعد إدراج المنصات المثبتة والمتاحة.
|-
|<code>after_platform_ls</code>
|-
|<code>before_prepare</code>
| rowspan="2" |<code>cordova prepare</code><code>cordova platform add</code><code>cordova build</code><code>cordova run</code>
| rowspan="2" |ينفّذ قبل وبعد تحضير (preparing) تطبيقك.
|-
|<code>after_prepare</code>
|-
|<code>before_compile</code>
| rowspan="2" |<code>cordova compile</code><code>cordova build</code>
| rowspan="2" |يُنفّذ قبل وبعد تصريف (compiling) نطبيقك.
|-
|<code>after_prepare</code>
|-
|<code>before_deploy</code>
|<code>cordova emulate</code><code>cordova run</code>
|يُنفّذ قبل نشر التطبيق.  
|-
|<code>before_build</code>
| rowspan="2" |<code>cordova build</code>
| rowspan="2" |يُنفّذ قبل وبعد بناء التطبيق.
|-
|<code>after_build</code>
|-
|<code>before_emulate</code>
| rowspan="2" |<code>cordova emulate</code>
| rowspan="2" |يُنفّذ قبل وبعد محاكاة التطبيق.  
|-
|<code>after_emulate</code>
|-
|<code>before_run</code>
| rowspan="2" |<code>cordova run</code>
| rowspan="2" |يُنفّذ قبل وبعد تشغيل التطبيق.
|-
|<code>after_run</code>
|-
|<code>before_serve</code>
| rowspan="2" |<code>cordova serve</code>
| rowspan="2" |يُنفّذ قبل وبعد خدمة (serving) التطبيق.
|-
|<code>after_serve</code>
|-
|<code>before_clean</code>
| rowspan="2" |<code>cordova clean</code>
| rowspan="2" |يُنفّذ قبل وبعد تنظيف (cleaning) التطبيق.  
|-
|<code>after_clean</code>
|-
|<code>pre_package</code>
|<code>N/A</code>
|قابل للتطبيق في Windows 8 و Windows Phone فقط. هذا الخطاف موقوفٌ الآن.
|-
|<code>before_plugin_add</code>
| rowspan="2" |<code>cordova plugin add</code>
| rowspan="2" |يُنفّذ قبل وبعد إضافة الإضافة.
|-
|<code>after_plugin_add</code>
|-
|<code>before_plugin_rm</code>
| rowspan="2" |<code>cordova plugin rm</code>
| rowspan="2" |يُنفّذ قبل وبعد إزالة الإضافة.
|-
|<code>after_plugin_rm</code>
|-
|<code>before_plugin_ls</code>
| rowspan="2" |<code>cordova plugin ls</code>
| rowspan="2" |يُنفّذ قبل وبعد عرض قائمة تضم الإضافات الموجودة في تطبيقك.
|-
|<code>after_plugin_ls</code>
|-
|<code>before_plugin_search</code>
| rowspan="2" |<code>cordova plugin search</code>
| rowspan="2" |يُنفّذ قبل وبعد البحث عن الإضافة.
|-
|<code>after_plugin_search</code>
|-
|<code>before_plugin_install</code>
| rowspan="2" |<code>cordova plugin add</code>
| rowspan="2" |يُنفّذ قبل وبعد تثبيت الإضافة (على المنصات). يتم تنفيذ خطافات الإضافات في <code>plugin.xml</code> عند إضافة الإضافات فقط.
|-
|<code>after_plugin_install</code>
|-
|<code>before_plugin_uninstall</code>
|<code>cordova plugin rm</code>
|يُنفّذ قبل إلغاء تثبيت الإضافة (من المنصات). يتم تنفيذ خطافات الإضافات في <code>plugin.xml</code> عند تثبيت إضافة فقط.
|}


قد ترتبط الخطافات بأنشطة التطبيق الخاصة بك مثل <code>before_build</code> و <code>after_build</code> وغيرها، أو قد ترتبط بإضافات تطبيقك. على سبيل المثال، تنطبق الخطافات مثل <code>before_plugin_add</code> و <code>after_plugin_add</code> وغيرها على الأنشطة المتعلقة بالإضافة. يمكن ربط هذه الخطافات بجميع الإضافات داخل التطبيق، أو يمكن أن تكون مخصوصة بإضافة واحدة فقط.
== طرق لتعريف الخطافات ==


تدعم كوردوفا أنواع الخطافات التالية:
نوع الخطاف
أوامر كوردوفا المقابلة
الوصف
before_platform_add
<code>cordova platform add</code>
يُنفّذ قبل وبعد إضافة المنصة.
after_platform_add
before_platform_rm
<code>cordova platform rm</code>
يُنفّذ قبل وبعد إزالة المنصة.
after_platform_rm
before_platform_ls
<code>cordova platform ls</code>
يُنفّذ قبل وبعد إدراج المنصات المثبتة والمتاحة.
after_platform_ls
before_prepare
<code>cordova prepare</code>
<code>cordova platform add</code>
<code>cordova build</code>
<code>cordova run</code>
يُنفّذ قبل وبعد تحضير (preparing) تطبيقك.
after_prepare
before_compile
<code>cordova compile</code>
<code>cordova build</code>
يُنفّذ قبل وبعد تصريف (compiling) نطبيقك.
after_compile
before_deploy
<code>cordova emulate</code>
<code>cordova run</code>
يُنفّذ قبل نشر تطبيقك.
before_build
<code>cordova build</code>
يُنفّذ قبل وبعد بناء تطبيقك.
after_build
before_emulate
<code>cordova emulate</code>
يُنفّذ قبل وبعد محاكاة تطبيقك.
after_emulate
before_run
<code>cordova run</code>
يُنفّذ قبل وبعد تشغيل تطبيقك.
after_run
before_serve
<code>cordova serve</code>
يُنفّذ قبل وبعد خدمة (serving) تطبيقك.
after_serve
before_clean
<code>cordova clean</code>
يُنفّذ قبل وبعد تنظيف (cleaningن) تطبيقك.
after_clean
pre_package
N / A
قابل للتطبيق على Windows 8 و Windows Phone فقط. هذا الخطاف موقوفٌ الآن.
before_plugin_add
<code>cordova plugin add</code>
يُنفّذ قبل وبعد إضافة الإضافة.
after_plugin_add
before_plugin_rm
<code>cordova plugin rm</code>
يُنفّذ قبل وبعد إزالة الإضافة.
after_plugin_rm
before_plugin_ls
<code>cordova plugin ls</code>
يُنفّذ قبل وبعد إدراج الإضافات الموجودة في تطبيقك في قائمة.
after_plugin_ls
before_plugin_search
<code>cordova plugin search</code>
يُنفّذ قبل وبعد البحث عن الإضافة.
after_plugin_search
before_plugin_install
<code>cordova plugin add</code>
يُنفّذ قبل وبعد تثبيت الإضافة (على المنصات). يتم تنفيذ خطافات الإضافات في plugin.xml فقط عند إضافة الإضافات
after_plugin_install
before_plugin_uninstall
<code>cordova plugin rm</code>
يُنفّذ قبل إلغاء تثبيت الإضافة (من المنصات).يتم تنفيذ خطافات الإضافات في plugin.xml فقط عند تثبيت إضافة.
طرق لتعريف الخطافات
== Config.xml ==  
== Config.xml ==  


سطر 126: سطر 155:
hooks/after_build/after_build_custom_action.js‎</syntaxhighlight>  
hooks/after_build/after_build_custom_action.js‎</syntaxhighlight>  


عند استخدام هذه الخطافات، سيتم تشغيلها دائمًا كملفات قابلة للتنفيذ (executable)، وليس كوحدات [[JavaScript|[[Java|جافا]]اسكريبت]] قابلة للتحميل.  
عند استخدام هذه الخطافات، سيتم تشغيلها دائمًا كملفات قابلة للتنفيذ (executable)، وليس كوحدات [[JavaScript|جافااسكريبت]] قابلة للتحميل.  


'''Remember''': اجعل برنامجك النصي قابلًا للتنفيذ في هذه الحالة.  
'''Remember''': اجعل برنامجك النصي قابلًا للتنفيذ في هذه الحالة.  
سطر 163: سطر 192:
== ملاحظات خاصة بمنصة ويندوز ==  
== ملاحظات خاصة بمنصة ويندوز ==  


إن كنت تعمل على ويندوز، وفي حالة لم يكن ملف برنامجك النصي ([[JavaScript|[[Java|جافا]]اسكريبت]] أو لا) من النوع bat (وهو أمر موصى به، إن كنت تريد أن يعمل برنامجك النصي في أنظمة تشغيل أخرى غير ويندوز)، فإن [[Cordova/cli|واجهة سطر الأوامر]] ستتوقع وجود السطر shebang (سطر يبدأ بالسلسلة النصية "‎#!‎") كسطر أول لتعلم المترجم (interpreter) المُستخدم لتشغيل البرنامج النصي. يجب أن يطابق سطر shebang المثال التالي:  
إن كنت تعمل على ويندوز، وفي حالة لم يكن ملف برنامجك النصي ([[JavaScript|جافااسكريبت]] أو لا) من النوع bat (وهو أمر موصى به، إن كنت تريد أن يعمل برنامجك النصي في أنظمة تشغيل أخرى غير ويندوز)، فإن [[Cordova/cli|واجهة سطر الأوامر]] ستتوقع وجود السطر shebang (سطر يبدأ بالسلسلة النصية "‎#!‎") كسطر أول لتعلم المترجم (interpreter) المُستخدم لتشغيل البرنامج النصي. يجب أن يطابق سطر shebang المثال التالي:  
<syntaxhighlight lang="javascript">#!/usr/bin/env [name_of_interpreter_executable]‎</syntaxhighlight>  
<syntaxhighlight lang="javascript">#!/usr/bin/env [name_of_interpreter_executable]‎</syntaxhighlight>  
== [[Java|جافا]]اسكريبت ==  
== [[Java|جافا]]اسكريبت ==  
سطر 211: سطر 240:
     return deferral.promise;
     return deferral.promise;
}‎</syntaxhighlight>  
}‎</syntaxhighlight>  
'''Note''': لا تُمستخدم واجهة البرنامج النصي لمٌحمِّل الوحدة (module loader) الجديدة لملفات <code>.js</code> المعرّفة إلا عبر <code>config.xml</code> أو <code>plugin.xml</code> فقط. لأغراض التوافق، يتم تشغيل ملفات الخطاف المحددة عبر المجلد <code>/hooks</code> عبر الأمر Node child_process spawn، راجع قسم "غير [[JavaScript|[[Java|جافا]]اسكريبت]]" أدناه.  
'''Note''': لا تُمستخدم واجهة البرنامج النصي لمٌحمِّل الوحدة (module loader) الجديدة لملفات <code>.js</code> المعرّفة إلا عبر <code>config.xml</code> أو <code>plugin.xml</code> فقط. لأغراض التوافق، يتم تشغيل ملفات الخطاف المحددة عبر المجلد <code>/hooks</code> عبر الأمر Node child_process spawn، راجع قسم "غير [[JavaScript|جافااسكريبت]]" أدناه.  
== غير [[Java|جافا]]ا سكريبت ==  
== غير [[Java|جافا]]ا سكريبت ==  


يتم تشغيل البرامج النصية التي لا تستخدم [[JavaScript|[[Java|جافا]]اسكريبت]] (Non-javascript scripts) عبر الأمر Node child_process spawn من المجلد الجذري للمشروع، مع تمرير المجلد الجذري كوسيط أول. تُمرر جميع الخيارات الأخرى إلى البرنامج النصي باستخدام متغيرات البيئة:  
يتم تشغيل البرامج النصية التي لا تستخدم [[JavaScript|جافااسكريبت]] (Non-javascript scripts) عبر الأمر Node child_process spawn من المجلد الجذري للمشروع، مع تمرير المجلد الجذري كوسيط أول. تُمرر جميع الخيارات الأخرى إلى البرنامج النصي باستخدام متغيرات البيئة:  
اسم متغير البيئة  
اسم متغير البيئة  
الوصف
الوصف

مراجعة 10:58، 8 ديسمبر 2018

خُطافات كوردوفا هي نصوصٌ برمجية خاصة يمكن إضافتها من قِبل مطوري التطبيقات والإضافات، أو حتى من طرف نظام البناء (build) الخاص بك لتخصيص أوامر كوردوفا. تسمح لك خطافات كوردوفا بالقيام بأنشطة خاصة ترافق أوامر كوردوفا. على سبيل المثال، قد تكون لديك أداة مخصصة للتحقق من تنسيق التعليمات البرمجية في ملف جافاسكريبت خاصتك. وتود تشغيل هذه الأداة قبل كل عملية بناء. في مثل هذه الحالة، يمكنك استخدام الخطاف 'before_build' وجعل كوردوفا تشغّل هذه الأداة المخصصة وقت التشغيل، بحيث تُستدعى قبل كل عملية بناء.

قد ترتبط الخطافات بأنشطة التطبيق الخاصة بك، كما هو الحال في الخطافين before_build و after_build وغيرهما، أو قد ترتبط بإضافات تطبيقك. على سبيل المثال، ينطبق الخطافان before_plugin_add و after_plugin_add وغيرهما على الأنشطة المتعلقة بالإضافة. يمكن ربط هذه الخطافات بجميع الإضافات داخل التطبيق، أو يمكن أن تكون مخصوصة بإضافة واحدة فقط.

تدعم كوردوفا أنواع الخطافات التالية:

نوع الخطاف أوامر كوردوفا المقابلة الشرح
before_platform_add cordova platform add يُنفّذ هذا الخُطّاف قبل وبعد إضافة المنصة.
before_platform_add
before_platform_rm cordova platform rm يُنفّذ قبل وبعد إزالة المنصة.
after_platform_rm
before_platform_ls cordova platform ls يُنفّذ قبل وبعد إدراج المنصات المثبتة والمتاحة.
after_platform_ls
before_prepare cordova preparecordova platform addcordova buildcordova run ينفّذ قبل وبعد تحضير (preparing) تطبيقك.
after_prepare
before_compile cordova compilecordova build يُنفّذ قبل وبعد تصريف (compiling) نطبيقك.
after_prepare
before_deploy cordova emulatecordova run يُنفّذ قبل نشر التطبيق.
before_build cordova build يُنفّذ قبل وبعد بناء التطبيق.
after_build
before_emulate cordova emulate يُنفّذ قبل وبعد محاكاة التطبيق.
after_emulate
before_run cordova run يُنفّذ قبل وبعد تشغيل التطبيق.
after_run
before_serve cordova serve يُنفّذ قبل وبعد خدمة (serving) التطبيق.
after_serve
before_clean cordova clean يُنفّذ قبل وبعد تنظيف (cleaning) التطبيق.
after_clean
pre_package N/A قابل للتطبيق في Windows 8 و Windows Phone فقط. هذا الخطاف موقوفٌ الآن.
before_plugin_add cordova plugin add يُنفّذ قبل وبعد إضافة الإضافة.
after_plugin_add
before_plugin_rm cordova plugin rm يُنفّذ قبل وبعد إزالة الإضافة.
after_plugin_rm
before_plugin_ls cordova plugin ls يُنفّذ قبل وبعد عرض قائمة تضم الإضافات الموجودة في تطبيقك.
after_plugin_ls
before_plugin_search cordova plugin search يُنفّذ قبل وبعد البحث عن الإضافة.
after_plugin_search
before_plugin_install cordova plugin add يُنفّذ قبل وبعد تثبيت الإضافة (على المنصات). يتم تنفيذ خطافات الإضافات في plugin.xml عند إضافة الإضافات فقط.
after_plugin_install
before_plugin_uninstall cordova plugin rm يُنفّذ قبل إلغاء تثبيت الإضافة (من المنصات). يتم تنفيذ خطافات الإضافات في plugin.xml عند تثبيت إضافة فقط.

طرق لتعريف الخطافات

Config.xml

يمكن تعريف الخطافات في الملف config.xml الخاص بالمشروع باستخدام وُسوم <hook>، على سبيل المثال:

<hook type="before_build" src="scripts/appBeforeBuild.bat" />
<hook type="before_build" src="scripts/appBeforeBuild.js" />
<hook type="before_plugin_install" src="scripts/appBeforePluginInstall.js" />
<platform name="android">
    <hook type="before_build" src="scripts/wp8/appAndroidBeforeBuild.bat" />
    <hook type="before_build" src="scripts/wp8/appAndroidBeforeBuild.js" />
    <hook type="before_plugin_install" src="scripts/wp8/appWP8BeforePluginInstall.js" />
    ...
</platform>
<platform name="windows">
    <hook type="before_build" src="scripts/windows/appWinBeforeBuild.bat" />
    <hook type="before_build" src="scripts/windows/appWinBeforeBuild.js" />
    <hook type="before_plugin_install" src="scripts/windows/appWinBeforePluginInstall.js" />
    ...
</platform>‎

خطافات الإضافات (plugin.xml)

كمطور للإضافات، يمكنك تعريف برامج الخطافات النصية باستخدام عناصر <hook> في الملف plugin.xml على النحو التالي:

<hook type="before_plugin_install" src="scripts/beforeInstall.js" />
<hook type="after_build" src="scripts/afterBuild.js" />
<platform name="android">
    <hook type="before_plugin_install" src="scripts/androidBeforeInstall.js" />
    <hook type="before_build" src="scripts/androidBeforeBuild.js" />
    ...
</platform>‎

سيتم تفعيل خطافات الإضافات before_plugin_installX و after_plugin_install و before_plugin_uninstall حصريًا عند تثبيت أو إلغاء تثبيت الإضافات.

عبر المجلد ‎/hooks (مُتجاوز)

لتنفيذ إجراء مخصص عند إطلاق نوع الخطاف المطابق، استخدم نوع الخطاف كاسم لمجلد فرعي داخل المجلد 'hooks' وضع ملف البرنامج النصي هناك، على سبيل المثال:

# script file will be automatically executed after each build
hooks/after_build/after_build_custom_action.js

عند استخدام هذه الخطافات، سيتم تشغيلها دائمًا كملفات قابلة للتنفيذ (executable)، وليس كوحدات جافااسكريبت قابلة للتحميل.

Remember: اجعل برنامجك النصي قابلًا للتنفيذ في هذه الحالة.

Note: تعتبر هذه الطريقة مُتجاوزة، استخدم بدلًا منها الوسم hook في الملفين config.xml و plugin.xml.

ترتيب تنفيذ الخطافات

بناء على تعريف الخطاف

يمكن تعريف النصوص البرمجية للخطافات عن طريق إضافتها إلى المجلد المحدد مسبقًا (/hooks)، أو عبر ملفات الإعداد (config.xml و plugin.xml) وتشغيلها بالترتيب التالي:

  • خطافات التطبيق من /hooks ؛
  • خطافات التطبيق من الملف config.xml ؛
  • خطافات الإضافات من الملف plugins/.../plugin.xml.

بناءً على الترتيب الداخلي للتنفيذ

الترتيب الداخلي لتنفيذ الخطافات ثابت. مثال 1 (إcordova platform add)

إن كانت هناك خطافات مرتبطة بـ before_platform_add و after_platform_add و before_prepare و after_prepare و before_plugin_install و after_plugin_install (وعلى افتراض أن لديك إضافةً واحدة مثبتة في مشروعك)، فإن إضافة منصة جديدة سيقوم بتنفيذ الخطافات بالترتيب التالي:

before_platform_add
    before_prepare
    after_prepare
    before_plugin_install
    after_plugin_install
after_platform_add

المثال 2 (cordova build)

إن كان هناك خطافات مرتبطة بـ before_prepare و after_prepare و before_compile و after_compile و before_build و after_build - فسيؤدي تشغيل الأمر build إلى تنفيذ الخطافات وفق الترتيب التالي:

before_build
    before_prepare
    after_prepare
    before_compile
    after_compile
after_build

واجهة البرنامج النصي (Script Interface)

ملاحظات خاصة بمنصة ويندوز

إن كنت تعمل على ويندوز، وفي حالة لم يكن ملف برنامجك النصي (جافااسكريبت أو لا) من النوع bat (وهو أمر موصى به، إن كنت تريد أن يعمل برنامجك النصي في أنظمة تشغيل أخرى غير ويندوز)، فإن واجهة سطر الأوامر ستتوقع وجود السطر shebang (سطر يبدأ بالسلسلة النصية "‎#!‎") كسطر أول لتعلم المترجم (interpreter) المُستخدم لتشغيل البرنامج النصي. يجب أن يطابق سطر shebang المثال التالي:

#!/usr/bin/env [name_of_interpreter_executable]‎

جافااسكريبت

إن كنت تكتب الخطافات باستخدام Node.js، فيجب عليك استخدام تعريف الوحدة التالي:

module.exports = function(context) {
    ...
}

يحتوي الكائن context على نوع الخطاف، والمسار الكامل للنص البرمجي المُنفذ، وخيارات الخطاف، ووسائط واجهة سطر الأوامر المُمررة إلى كوردوفا، وكائن كوردوفا من مستوى الأعلى (top-level) وفق التنسيق التالي:

{
  "hook": "before_plugin_install",
  "scriptLocation": "c:\\script\\full\\path\\appBeforePluginInstall.js",
  "cmdLine": "The\\exact\\command\\cordova\\run\\with arguments",
  "opts": {
    "projectRoot":"C:\\path\\to\\the\\project",
    "cordova": {
      "platforms": ["android"],
      "plugins": ["plugin-withhooks"],
      "version": "0.21.7-dev"
    },
    "plugin": {
      "id": "plugin-withhooks",
      "pluginInfo": {
        ...
      },
      "platform": "android",
      "dir": "C:\\path\\to\\the\\project\\plugins\\plugin-withhooks"
    }
  },
  "cordova": {...}
}

لن يُمّير الكائن context.opts.plugin إلا إلى البرامج النصية لخطافات الإضافات.

يمكنك أيضًا استيردا وحدات كوردوفا إضافية في برنامجك النصي باستخدام context.requireCordovaModule بالطريقة التالية:

var Q = context.requireCordovaModule('q');

يمكنك جعل برامجك النصية متزامنة باستخدام Q:

module.exports = function(context) {
    var Q = context.requireCordovaModule('q');
    var deferral = new Q.defer();
    setTimeout(function(){
      console.log('hook.js>> end');
    deferral.resolve();
    }, 1000);
    return deferral.promise;
}

Note: لا تُمستخدم واجهة البرنامج النصي لمٌحمِّل الوحدة (module loader) الجديدة لملفات .js المعرّفة إلا عبر config.xml أو plugin.xml فقط. لأغراض التوافق، يتم تشغيل ملفات الخطاف المحددة عبر المجلد /hooks عبر الأمر Node child_process spawn، راجع قسم "غير جافااسكريبت" أدناه.

غير جافاا سكريبت

يتم تشغيل البرامج النصية التي لا تستخدم جافااسكريبت (Non-javascript scripts) عبر الأمر Node child_process spawn من المجلد الجذري للمشروع، مع تمرير المجلد الجذري كوسيط أول. تُمرر جميع الخيارات الأخرى إلى البرنامج النصي باستخدام متغيرات البيئة: اسم متغير البيئة الوصف CORDOVA_VERSION إصدار Cordova-CLI. CORDOVA_PLATFORMS قائمة مفصولة بفواصل تحتوي المنصات التي ينطبق عليها الأمر (على سبيل المثال: android أو ios). CORDOVA_PLUGINS قائمة مفصولة بفواصل لمُعرفات (IDs) الإضافات التي ينطبق عليها الأمر (على سبيل المثال: cordova-plugin-file-transfer و cordova-plugin-file). CORDOVA_HOOK مسار الخُطاف الذي يتم تنفيذه. CORDOVA_CMDLINE وسائط واجهة سطر الأوامر المُمررة إلى كوردوفا (على سبيل المثال: cordova run ios --emulate).

إن أعاد البرنامج النصي قيمة مخالفة للصفر، فسيتم إنهاء الأمر الأب (parent command) لكوردوفا. Note: نوصي بشدة بأن تكتب خطافاتك باستخدام Node.js، بحيث تكون عابرة للمنصات (cross-platform)، انظر القسم [#link-javascript Javascript] أعلاه.

مثال على طريقة الاستخدام

يوضح هذا المثال كيفية استخدام خطافات كوردوف لطباعة حجم الملف المُنشأ ‎.apk لمنصة أندرويد في مخرجات وحدة التحكم (console).

قم بإنشاء تطبيق كوردوفا فارغ، وأضف التعريف التالي إلى الملف config.xml لإعلام كوردوفا بتشغيل البرنامج النصي afterBuild.js بعد كل عملية بناء للمنصة.

<hook type="after_build" src="scripts/afterBuild.js" />

أنشئ الملف scripts/afterBuild.js، وأضف المحتويات التالية. سنستخدم إصدار غير متزامن للتابع fs.stat لشرح كيفية عمل وظيفة التزامن عبر الخطافات.

module.exports = function(ctx) {
    // make sure android platform is part of build
    if (ctx.opts.platforms.indexOf('android') < 0) {
        return;
    }
    var fs = ctx.requireCordovaModule('fs'),
        path = ctx.requireCordovaModule('path'),
        deferral = ctx.requireCordovaModule('q').defer();
    var platformRoot = path.join(ctx.opts.projectRoot, 'platforms/android');
    var apkFileLocation = path.join(platformRoot, 'build/outputs/apk/android-debug.apk');
    fs.stat(apkFileLocation, function(err,stats) {
        if (err) {
                deferral.reject('Operation failed');
        } else {
            console.log('Size of ' + apkFileLocation + ' is ' + stats.size +' bytes');
            deferral.resolve();
        }
    });
    return deferral.promise;
};

يُمرّر المعامل ctx في المثال أعلاه من طرف كوردوفا، حيث يمثل سياق التنفيذ، مثل المسار الكامل للبرنامج النصي، والمنصة المستهدفة، ووسائط واجهة سطر الأوامر، وما إلى ذلك، ويعرض أيضًا وظائف إضافية للمساعدة. انظر القسم Script Interface أعلاه لمزيد من التفاصيل.

يمكنك الآن إضافة نظام أندرويد وتنفيذ عملية البناء.

cordova platform add android
..
cordova build
..
Size of path\to\app\platforms\android\build\outputs\apk\android-debug.apk is 1821193 bytes

يمكن العثور على المزيد من الأمثلة المفيدة في Three Hooks Your Cordova Phone Gap Project needs

مصادر