الفرق بين المراجعتين ل"Cordova/config ref"
سطر 598: | سطر 598: | ||
اضبط هذا الإعداد عند القيمة <code>true</code> لمنع المنصات من الإصدار iOS9 وما فوق من عرض ودجة زجاجية مُكبّرة (magnifying glass widget) عندما يضغط (longpresses) المستخدم على [[Cordova/webviews|العارض]]. اختبر تطبيقك جيدًا، لأن هذا السلوك قد يتداخل مع إمكانيات تحديد (selection) النصوص. | اضبط هذا الإعداد عند القيمة <code>true</code> لمنع المنصات من الإصدار iOS9 وما فوق من عرض ودجة زجاجية مُكبّرة (magnifying glass widget) عندما يضغط (longpresses) المستخدم على [[Cordova/webviews|العارض]]. اختبر تطبيقك جيدًا، لأن هذا السلوك قد يتداخل مع إمكانيات تحديد (selection) النصوص. | ||
|- | |- | ||
− | | | + | |<code>TopActivityIndicator</code> (سلسلة نصية) |
− | | | + | |
+ | (ios) | ||
+ | |القيمة الافتراضية: <code>gray</code> | ||
+ | |||
+ | القيم المسموح بها: <code>whiteLarge</code> و <code>white</code> و <code>gray</code>. | ||
+ | |||
+ | تتحكم هذه الخاصية في مظهر أيقونة الدوران (spinning icon) الصغيرة في شريط الحالة، والذي يشير إلى وجود نشاطٍ كبيرٍ من المعالج. | ||
+ | |- | ||
+ | |<code>uap-target-min-version</code> (سلسلة نصية) | ||
+ | |||
+ | (ويندوز) | ||
+ | |تعيّن هذه الخاصية قيمة <code>MinTargetVersion</code> على Windows UAP (منصة ويندوز العامة للتطبيقات). في حال لم تُعيّن هذه الخاصية، فستُضبط عند الإصدار المبدئي <code>10.0.10240.0</code> | ||
+ | |||
+ | '''ملاحظة:''' يتم تعيين هذا التفضيل في ملفات جافاسكريبت الخاصة بالمشروع وليس في ملف البيان (appxmanifest). لذلك لن يتمكن المستخدمون الذين لديهم أنظمة تشغيل ذات إصدارات أقل من هذه القيمة من تشغيل التطبيق. | ||
+ | |- | ||
+ | |<code>UIWebViewDecelerationSpeed</code> (سلسلة نصية) | ||
+ | |||
+ | (ios) | ||
+ | |القيمة الافتراضية: <code>normal</code> | ||
+ | |||
+ | القيم المسموح بها: <code>normal</code> و <code>fast</code> | ||
+ | |||
+ | تتحكم هذه الخاصية في سرعة تباطؤ (deceleration) حركة التمرير (scrolling). السرعة الافتراضية هي السرعة العادية (<code>normal</code>) لمعظم التطبيقات المحلية، أما في منصة Mobile Safari، فالسرعة الافتراضية هي <code>fast</code>. | ||
+ | |- | ||
+ | |<code>WindowSize</code> (سلسلة نصية) | ||
+ | |||
+ | (OS X 4.0.0+) | ||
+ | |القيمة الافتراضية: <code>auto</code> | ||
+ | |||
+ | تحدد حجم نافذة التطبيق. | ||
+ | |||
+ | تقبل الصيغة <code>WxH</code>، والتي تحدد عرضًا وارتفاعًا معينًا، أو القيم الخاصة <code>auto</code> و <code>fullscreen</code>. الخيار الأخير سيفتح نافذة بلا حدود (borderless) تمتد على كامل حيز سطح المكتب. يرجى ملاحظة أن هذا يختلف عن الوضع <code>fullscreen</code> العادي في منصات OS X، والذي لن يمتد على عدة شاشات. | ||
+ | |||
+ | '''ملاحظة''': الخيار العام <code>fullscreen</code> ليس له أي تأثير على منصات OS X. | ||
+ | |- | ||
+ | |<code>WindowsDefaultUriPrefix</code> (سلسلة نصية) | ||
+ | |||
+ | (ويندوز) | ||
+ | |القيم المسموح بها: <code>ms-appx://</code> و <code>ms-appx-web://</code> | ||
+ | |||
+ | تحدد هذه الخاصية ما إذا كنت تريد أن يستهدف تطبيقك السياق المحلي أو السياق البعيد (remote context) كعنوان URI الإطلاق (startup URI). | ||
+ | |||
+ | عند تطوير تطبيقات لمنصة ويندوز 10، فالإعداد الافتراضي سيكون هو السياق البعيد (<code>ms-appx-web://</code>). لكي يكون لديك تطبيق في وضع محلي، وغير متأثر بقيود الوضع البعيد (Remote Mode)، فيجب عليك تعيين هذا الإعداد عند القيمة <code>ms-appx://</code>، وعدم إعطاء أيٍّ من عناصر <code><access></code> عناوين URI بعيدة. الوضع المحلي هو الوضع الافتراضي لمنصة ويندوز 8.1. | ||
|- | |- | ||
− | | | + | |WindowsStoreDisplayName (سلسلة نصية) |
− | | | + | |
+ | (ويندوز) | ||
+ | |اسم للناشر لأجل لعرضه على المستخدمين. | ||
|- | |- | ||
− | | | + | |<code>WindowsStoreIdentityName</code> (سلسلة نصية) |
− | |||
− | |||
− | |||
− | |||
− | + | (ويندوز) | |
− | + | |اسم التعريف المستخدم في متجر ويندوز. تحدد هذه الخاصية معرفًا فريدًا عامًّا لحزمة معينة. يُمثّل اسم تعريف الحزمة على هيئة سلسلة من خاصيات الحزمة. انظر صفحة [https://msdn.microsoft.com/en-us/library/windows/apps/br211441.aspx صفحة الهوية في ملف بيان الحُزمة] لمزيد من التفاصيل. | |
− | + | |- | |
− | + | |القيمة الافتراضية: false | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | اسم التعريف المستخدم في متجر ويندوز. تحدد هذه الخاصية معرفًا فريدًا عامًّا لحزمة معينة. | ||
− | |||
− | |||
− | |||
− | القيمة الافتراضية: false | ||
تشير القيمة <code>true</code> إلى أنه يُسمح للتطبيق بتقديم "الإشعارات السريعة" (toast notifications). | تشير القيمة <code>true</code> إلى أنه يُسمح للتطبيق بتقديم "الإشعارات السريعة" (toast notifications). | ||
− | + | |اسم الناشر. | |
− | + | |- | |
− | + | |<code>WindowsToastCapable</code> (قيمة منطقية) | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | أمثلة: | + | (ويندوز) |
+ | |القيمة الافتراضية: <code>false</code> | ||
+ | |||
+ | تشير القيمة <code>true</code> إلى أنه يُسمح للتطبيق بتقديم "الإشعارات السريعة" (toast notifications). | ||
+ | |- | ||
+ | |<code>deployment-target</code> (سلسلة نصية) | ||
+ | |||
+ | (ios) | ||
+ | |يعيّن هذا الإعداد قيمة <code>IPHONEOSDEPLOYMENTTARGET</code> عند البناء، والذي يترجم في النهاية إلى الخاصية <code>MinimumOSVersion</code> في ملف الأرشيف ipa. لمزيد من التفاصيل، يرجى الرجوع إلى وثائق Apple حول إعدادات النشر. | ||
+ | |- | ||
+ | |<code>target-device</code> (سلسلة نصية) | ||
+ | |||
+ | (ios) | ||
+ | |لقيمة الافتراضية: <code>universal</code> | ||
+ | |||
+ | القيم المسموح بها: <code>handset</code> و <code>tablet</code> و <code>universal</code> | ||
+ | |||
+ | ترتبط هذه الخاصية مباشرة بالخاصية <code>TARGETEDDEVICEFAMYY</code> في مشروع xcode. في حال اختيار القيمة <code>Universal</code> (وهو الإعداد الافتراضي)، فستحتاج إلى توفير لقطات الشاشة لكل من iPhone و iPad أو قد يُرفض تطبيقك. | ||
+ | |- | ||
+ | |<code>windows-phone-target-version</code> (سلسلة نصية) | ||
+ | |||
+ | (ويندوز) | ||
+ | |تعيّن هذه الخاصية إصدار Windows Phone الذي ستستهدفه الحزمة (الناتجة من <code>cordova build</code>). إذا لم يتم تحديدها، فسيتم تعيينها عند نفس الإصدار مثل <code>windows-target-version</code> (إذا تم العثور عليه). | ||
+ | |- | ||
+ | |<code>windows-target-version</code> (سلسلة نصية) | ||
+ | |||
+ | (ويندوز) | ||
+ | |تعين هذه الخاصية إصدار ويندوز الذي ستستهدفه الحزمة (الناتجة من <code>cordova build</code>). إذا لم يتم تحديدها، فسيتم تعيينها عند القيمة "8.1". | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |}أمثلة: | ||
<syntaxhighlight lang="xml"><preference name="DisallowOverscroll" value="true"/> | <syntaxhighlight lang="xml"><preference name="DisallowOverscroll" value="true"/> | ||
<preference name="Fullscreen" value="true" /> | <preference name="Fullscreen" value="true" /> | ||
سطر 653: | سطر 696: | ||
<preference name="HideKeyboardFormAccessoryBar" value="true"/> | <preference name="HideKeyboardFormAccessoryBar" value="true"/> | ||
<preference name="Orientation" value="landscape" /> | <preference name="Orientation" value="landscape" /> | ||
− | <!-- iOS | + | <!-- iOS تفضيلات خاصة بمنصة --> |
<preference name="EnableViewportScale" value="true"/> | <preference name="EnableViewportScale" value="true"/> | ||
<preference name="MediaPlaybackAllowsAirPlay" value="false"/> | <preference name="MediaPlaybackAllowsAirPlay" value="false"/> | ||
سطر 675: | سطر 718: | ||
<preference name="SuppressesLongPressGesture" value="true" /> | <preference name="SuppressesLongPressGesture" value="true" /> | ||
<preference name="Suppresses3DTouchGesture" value="true" /> | <preference name="Suppresses3DTouchGesture" value="true" /> | ||
− | <!-- Android | + | <!-- Android تفضيلات خاصة بمنصة --> |
<preference name="KeepRunning" value="false"/> | <preference name="KeepRunning" value="false"/> | ||
<preference name="LoadUrlTimeoutValue" value="10000"/> | <preference name="LoadUrlTimeoutValue" value="10000"/> | ||
سطر 687: | سطر 730: | ||
<preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" /> | <preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" /> | ||
<preference name="AppendUserAgent" value="My Browser" /> | <preference name="AppendUserAgent" value="My Browser" /> | ||
− | <!-- Windows | + | <!-- Windows تفضيلات خاصة --> |
<preference name="windows-phone-target-version" value="8.1" /> | <preference name="windows-phone-target-version" value="8.1" /> | ||
<preference name="windows-target-version" value="8.1" /> | <preference name="windows-target-version" value="8.1" /> | ||
سطر 698: | سطر 741: | ||
<preference name="WindowsToastCapable" value="true" /> | <preference name="WindowsToastCapable" value="true" /> | ||
<preference name="uap-target-min-version" value="10.0.10586.0" /> | <preference name="uap-target-min-version" value="10.0.10586.0" /> | ||
− | <!-- OS X | + | <!-- OS X تفضيلات خاصة بمنصة --> |
<preference name="HideMousePointer" value="5"/> | <preference name="HideMousePointer" value="5"/> | ||
<preference name="OSXLocalStoragePath" value="~/.myapp/database"/> | <preference name="OSXLocalStoragePath" value="~/.myapp/database"/> | ||
<preference name="WindowSize" value="800x400"/> | <preference name="WindowSize" value="800x400"/> | ||
− | <preference name="EnableWebGL" value="true"/></syntaxhighlight> | + | <preference name="EnableWebGL" value="true"/></syntaxhighlight> |
− | feature | + | === <code>feature</code> === |
+ | إن كنت تستخدم [[Cordova/cli|واجهة سطر الأوامر]] لإنشاء التطبيقات، فستستخدم أمر الإضافة (plugin command) لتمكين الواجهات البرمجية (APIs) للجهاز. ولن يعدّل ذلك الملف <code>config.xml</code>، لذلك فإن هذا العنصر لن ينطبق على سير عملك. إذا كنت تعمل مباشرةً في بيئة العمل SDK وكنت تستخدم الملف <code>config.xml</code> المخصوص بالمنصة كمصدر، فاستخدم هذا الوسم لتمكين الواجهات البرمجية على مستوى الجهاز والإضافات الخارجية. حيث غالبًا ما تظهر مع قيم مخصصة في ملفات <code>config.xml</code> المخصوصة بالمنصات. راجع مرجع واجهة التطبيقات API للمزيد من التفاصيل حول كيفية تحديد كل ميزة. راجع صفحة [[Cordova/plugins|دليل تطوير الإضافات]] لمزيد من المعلومات حول إضافة الإضافات. | ||
− | + | '''ملاحظة''': في معظم الأحيان، ليس عليك تعيين هذا الإعداد مباشرة. | |
− | |||
− | |||
− | |||
− | فقط | + | {| class="wikitable" |
− | + | !الخاصيات (النوع) | |
− | name (سلسلة نصية) | + | <small>فقط لمنصات</small> |
− | مطلوب | + | !الشرح |
− | + | |- | |
− | + | |<code>name</code> (سلسلة نصية) | |
+ | |مطلوب | ||
− | + | اسم الإضافة المراد تمكينها. | |
+ | |} | ||
+ | ===<code>param</code>=== | ||
+ | |||
+ | يستخدم هذا الوسم لتحديد معاملات إضافة، مثل: ما هي الحزمة التي ستُسترد شيفة الإضافة منها، وما إذا كانت شيفرة الإضافة ستُهيؤ أثناء تهيئة [[Cordova/webviews|العارض]]. | ||
الخاصيات (النوع) | الخاصيات (النوع) | ||
− | فقط | + | {| class="wikitable" |
− | + | !الخاصيات (النوع) | |
− | name (سلسلة نصية) | + | <small>فقط لمنصات</small> |
− | مطلوب | + | !الشرح |
− | القيم المسموح بها: android- | + | |- |
− | تُستخدم "ios-package" و "osx-package" و "android-package" لتحديد اسم الحزمة (كما هو محدد بواسطة الخاصية "value") لاستخدامها في تهيئة شيفرة الإضافة، بينما تُستخدم "onload" لتحديد ما إذا كان يجب أن يتم إنشاء الإضافة المقابلة (كما هو محدد في الخاصية"value") عند تهيئة وحدة التحكم (controller). | + | |<code>name</code> (سلسلة نصية) |
− | + | (أندرويد - osx - ios) | |
− | + | |مطلوب | |
− | + | ||
+ | القيم المسموح بها: <code>android-package</code> و <code>ios-package</code> و <code>osx-package</code> و <code>onload</code>. | ||
+ | |||
+ | تُستخدم القيم "<code>ios-package</code>" و <code>"osx-package</code>" و "<code>android-package</code>" لتحديد اسم الحزمة (كما هو محدد بواسطة الخاصية "value") لاستخدامها في تهيئة شيفرة الإضافة، بينما تُستخدم "<code>onload</code>" لتحديد ما إذا كان يجب أن يتم إنشاء الإضافة المقابلة (كما هو محدد في الخاصية"value") عند تهيئة وحدة التحكم (controller). | ||
+ | |- | ||
+ | |<code>value</code> (سلسلة نصية أو قيمة منطقية) | ||
+ | |||
+ | (أندرويد - osx - ios) | ||
+ | |مطلوب | ||
− | أمثلة: | + | تحدد اسم الحزمة التي ستُستخدم لتهيئة شيفرة الإضافة (عندما تساوي الخاصية '<code>name</code>' إحدى القيم <code>android-package</code> أو <code>ios-package</code> أو <code>osx-package</code>)، تحدد اسم الإضافة التي ستُحمّل أثناء تهيئة وحدة التحكم - controller - (عند تعيين "<code>name</code>" عند القيمة "<code>onload</code>"). |
− | <syntaxhighlight lang="xml"><!-- | + | |}أمثلة: <syntaxhighlight lang="xml"><!--هكذا تحدد الواجهة البرمجية للجهاز لتطبيقات أنردويد --> |
<feature name="Device"> | <feature name="Device"> | ||
<param name="android-package" value="org.apache.cordova.device.Device" /> | <param name="android-package" value="org.apache.cordova.device.Device" /> | ||
سطر 742: | سطر 796: | ||
</feature> | </feature> | ||
<!-- Here's how the element appears for OS X projects --> | <!-- Here's how the element appears for OS X projects --> | ||
+ | <!-- osx هكذا تظهر العناصر لمشاريع --> | ||
<feature name="Device"> | <feature name="Device"> | ||
<param name="osx-package" value="CDVDevice" /> | <param name="osx-package" value="CDVDevice" /> | ||
<param name="onload" value="true" /> | <param name="onload" value="true" /> | ||
− | </feature></syntaxhighlight> | + | </feature></syntaxhighlight> |
− | platform | + | === <code>platform</code> === |
+ | عند استخدام [[Cordova/cli|واجهة سطر الأوامر]] لإنشاء التطبيقات، من الضروري في بعض الأحيان تحديد التفضيلات وغيرها من العناصر الخاصة بمنصة معينة. | ||
− | + | استخدم العنصر <code>platform</code> لتحديد الإعدادات الذي يجب أن تظهر حصرًا في الملف <code>config.xml</code> الخاص بالمنصة. | |
− | لتحديد الإعدادات الذي يجب أن تظهر | ||
− | |||
− | فقط | + | {| class="wikitable" |
− | + | !الخاصيات (النوع) | |
− | name (سلسلة نصية) | + | <small>فقط لمنصات</small> |
− | مطلوب | + | !الشرح |
− | + | |- | |
+ | |<code>name</code> (سلسلة نصية) | ||
+ | |مطلوب | ||
− | أمثلة: | + | المنصة المراد تحديد تفضيلاتها. |
− | <syntaxhighlight lang="xml"><platform name="android"> | + | |}أمثلة: <syntaxhighlight lang="xml"><platform name="android"> |
<preference name="Fullscreen" value="true" /> | <preference name="Fullscreen" value="true" /> | ||
− | </platform></syntaxhighlight> | + | </platform></syntaxhighlight> |
+ | |||
+ | === <code>hook</code> === | ||
+ | يمثل هذا العنصر برنامجك النصي (script) المخصص، والذي سيٌستدعى من قبل كوردوفا عند وقوع حدثٍ معينٍ (على سبيل المثال، بعد إضافة الإضافة أو عند استدعاء سلسلة التحضير الخاصة بالمنصة). هذا مفيد عندما تحتاج إلى توسيع كوردوفا. راجع صفحة [[Cordova/hooks|الخطافات]] لمزيد من المعلومات. | ||
− | + | {| class="wikitable" | |
+ | !الخاصيات (النوع) | ||
+ | <small>فقط لمنصات</small> | ||
+ | !الشرح | ||
+ | |- | ||
+ | |<code>type</code> (سلسلة نصية) | ||
+ | |مطلوب | ||
− | + | يحدد الإجراء الذي يتم خلاله استدعاء البرنامج النصي المخصص. | |
− | + | |- | |
+ | |<code>src</code> (سلسلة نصية) | ||
+ | |مطلوب | ||
− | + | يحدد مكان البرنامج النصي المراد استدعاؤه عند حدوث إجراء محدد. | |
− | + | |} | |
− | + | أمثلة:<syntaxhighlight lang="xml"><hook type="after_plugin_install" src="scripts/afterPluginInstall.js" /></syntaxhighlight> | |
− | |||
− | |||
− | |||
− | |||
− | يحدد مكان البرنامج النصي المراد استدعاؤه عند حدوث إجراء محدد. | ||
− | + | === <code>resource-file</code> === | |
− | < | + | يثبّت هذا الوسم الملفات المصدرية (resource files) في المنصة، وهو مماثل لوسمٍ يحمل نفس الاسم في الملف <code>plugin.xml</code>. |
− | + | هذا الوسم ليس مدعومًا حاليًا إلا في الإصدار <code>cordova-ios@4.4.0</code> ومافوق، وفي الإصدار <code>cordova-android@6.2.1</code> وما فوق. | |
− | + | {| class="wikitable" | |
− | + | !الخاصيات (النوع) | |
+ | <small>فقط لمنصات</small> | ||
+ | !الشرح | ||
+ | |- | ||
+ | |<code>src</code> (سلسلة نصية) | ||
− | + | (أندرويد - ios) | |
− | + | |مطلوب | |
− | |||
− | مطلوب | ||
− | |||
− | |||
− | |||
− | أمثلة: | + | موقع الملف بالنسبة إلى <code>config.xml</code>. |
+ | |- | ||
+ | |<code>target</code> (سلسلة نصية) | ||
+ | |المسار حيث سيُنسخ الملف داخل المجلد خاصتك. | ||
+ | |}أمثلة: | ||
لأجهزة الأندرويد: | لأجهزة الأندرويد: | ||
<syntaxhighlight lang="xml"><resource-file src="FooPluginStrings.xml" target="res/values/FooPluginStrings.xml" /></syntaxhighlight> | <syntaxhighlight lang="xml"><resource-file src="FooPluginStrings.xml" target="res/values/FooPluginStrings.xml" /></syntaxhighlight> | ||
− | == | + | == عينة من الملف config.xml == |
− | فيما يلي نموذج للملف config.xml: | + | فيما يلي نموذج للملف <code>config.xml</code>: |
<syntaxhighlight lang="xml"><?xml version='1.0' encoding='utf-8'?> | <syntaxhighlight lang="xml"><?xml version='1.0' encoding='utf-8'?> | ||
<widget id="io.cordova.hellocordova" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0"> | <widget id="io.cordova.hellocordova" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0"> | ||
سطر 828: | سطر 893: | ||
</platform> | </platform> | ||
</widget></syntaxhighlight> | </widget></syntaxhighlight> | ||
+ | |||
+ | == انظر أيضا == | ||
+ | * صفحة الملف [[Cordova/Plugin xml|Plugin.xml]]. | ||
+ | * صفحة [[Cordova/cli|واجهة سطر الأوامر]]. | ||
+ | |||
==مصادر== | ==مصادر== | ||
*[https://cordova.apache.org/docs/en/latest/config_ref/index.html صفحة Config.xml في توثيق كوردوفا الرسمي.] | *[https://cordova.apache.org/docs/en/latest/config_ref/index.html صفحة Config.xml في توثيق كوردوفا الرسمي.] |
مراجعة 21:21، 30 نوفمبر 2018
يتضمن الملف Config.xml
الإعدادات العامة التي تتحكم في العديد من سلوكيات تطبيقات كوردوفا. هذا الملف مستقل عن المنصات، وهو مصاغ وفق مواصفات W3C في تطبيقات الويب المحزومة (الودجات)، وقد تم توسيعها لتحديد ميزات الواجهة البرمجية (API) لكوردوفا، والإضافات والإعدادات الخاصة بالمنصات.
بخصوص المشاريع التي تم إنشاؤها باستخدام واجهة سطر الأوامر الخاصة بكوردوفا، فيمكن العثور على هذا الملف في المجلد الجذري (top-level directory) التالي:
app/config.xml
لاحظ أنه قبل الإصدار 3.3.1-0.2.0، كان هذا الملف موجودًا في الموضع app/www/config.xml
، وهو ما لا يزال مدعومًا لحد الآن.
عند استخدام واجهة سطر الأوامر لإنشاء مشروع، تُنسخ إصدارات هذا الملف كما هي إلى المجلدات الفرعية في platforms/
. مثل:
app/platforms/ios/AppName/config.xml
app/platforms/android/res/xml/config.xml
بالإضافة إلى خيارات الإعدادات المفصلة أدناه، يمكنك أيضًا إعداد مجموعة من الصور الخاصة بالتطبيق لكل منصة مستهدفة. راجع صفحة تخصيص الأيقونات لمزيد من المعلومات.
widget
تمثل widget
العنصر الجذري في الملف config.xml
.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
id (سلسلة نصية)
|
مطلوب
يحدد معرف النطاق العكسي (reverse-domain identifier) للتطبيق |
version (سلسلة نصية)
|
مطلوب
رقم الإصدار الكامل معبر عنه بالصيغة الإصدار_الرئيسي/الإصدار_الفرعي/الرقعة (major/minor/patch). |
android-versionCode (سلسلة نصية)
(أندرويد) |
إصدار بديلة لنظام أندرويد. يضبط قيمة إصدار شيفرة للتطبيق. راجع صفحة دليل أندرويد للحصول على معلومات حول كيفية تعديل هذه الخاصية. |
ios-CFBundleVersion (سلسلة نصية)
(ios) |
إصدار بديل لنظام iOS. لمزيد من التفاصيل، انظر iOS versioning. |
OSX-CFBundleVersion (سلسلة نصية)
(osx) |
إصدار بديل لأنظمة التشغيل OSX. لمزيد من التفاصيل، راجع صفحة OS X versioning. |
windows-packageVersion (سلسلة نصية)
(ويندوز) |
إصدار بديل لنظام التشغيل ويندوز. لمزيد من التفاصيل، انظر Windows versioning |
android-packageName (سلسلة نصية)
(أندرويد) |
اسم حزمة بديل لمنصة أندرويد، يعيد تعريف id .
|
ios-CFBundleIdentifier (سلسلة نصية)
(ios) |
مُعرّف حزمة (bundle id) بديل لنظام iOS. يتجاوز id .
|
packageName (سلسلة نصية)
(ويندوز) |
القيمة الافتراضية: Cordova.Example
اسم الحزمة لويندوز. |
defaultlocale
(ويندوز و ios) |
يحدد اللغة الافتراضية للتطبيق، على هيئة رمز اللغة IANA. |
android-activityName (سلسلة نصية)
(أندرويد) |
يعيّن اسم النشاط الخاص بتطبيقك في الملف AndroidManifest.xml . لاحظ أن هذه الخاصية تُعيّن مرة واحدة فقط بعد إضافة نظام أندرويد للمرة الأولى.
|
XMLNS (سلسلة نصية)
|
مطلوب
مجال الاسماء (Namespace) للمستند |
xmlns:cdv (سلسلة نصية)
|
مطلوب
بادئة فضاء الاسماء (Namespace ). |
أمثلة:
<!-- أندرويد-->
<widget id="io.cordova.hellocordova" version="0.0.1" android-versionCode="13" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
</widget>
<!-- iOS -->
<widget id="io.cordova.hellocordova" version="0.0.1" ios-CFBundleVersion="0.1.3" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
</widget>
<!-- ويندوز-->
<widget id="io.cordova.hellocordova" version="0.0.1" windows-packageVersion="0.1.3" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
</widget>
<!-- OS X -->
<widget id="io.cordova.hellocordova" version="0.0.1" osx-CFBundleVersion="0.1.3" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
</widget>
name
يحدد الاسم الرسمي للتطبيق، كما يظهر على الشاشة الرئيسية للجهاز وضمن واجهات متجر التطبيقات.
أمثلة:
<widget ...>
<name>HelloCordova</name>
</widget>
الاسم المختصر (short name)
تحدد هذه الخاصية اسمًا اختياريًا لعرضٍ للتطبيق. ففي بعض الأحيان، يكون اسم التطبيق المعروض على الشاشة الرئيسية للجهاز مختلفًا عنه على واجهات المعلومات وواجهات متجر التطبيقات بسبب محدودية المساحة.
أمثلة:
<widget ...>
<name short="HiCdv">HelloCordova</name>
</widget>
description
تحدد هذه الخاصية البيانات الوصفية (metadata) التي قد تظهر داخل قوائم متجر التطبيقات.
أمثلة:
<widget ...>
<description>A sample Apache Cordova application</description>
</widget>
author
تحدد معلومات الاتصال التي قد تظهر داخل قوائم متجر التطبيقات.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
email (سلسلة نصية)
|
مطلوب
البريد الإلكتروني للمؤلف. |
href (سلسلة نصية)
|
مطلوب
موقع المؤلف. |
أمثلة:
<widget ...>
<author email="dev@cordova.apache.org" href="http://cordova.io"></author>
</widget>
content
تحدد هذه الخاصية صفحة البدء الخاصة بالتطبيق في المجلد الجذري للأصول (top-level web assets directory). القيمة الافتراضية هي index.html
، والتي تظهر عادة في المجلد الجذري للمشروع www
.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
src (سلسلة نصية)
|
مطلوب
تحدد صفحة البدء الخاصة بالتطبيق في المجلد الجذري للأصول (web assets directory). القيمة الافتراضية هي |
أمثلة:
<widget ...>
<content src="startPage.html"></content>
</widget>
access
تحدد هذه الخاصية مجموعة النطاقات الخارجية التي يُسمح للتطبيق بالاتصال بها.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
origin (سلسلة نصية)
|
مطلوب
تحدد مجموعة النطاقات الخارجية التي يُسمح للتطبيق بالاتصال بها. |
تسمح القيمة الافتراضية الموضحة أعلاه بوصول التطبيق إلى أي خادم. راجع صفحة اللوائح البيضاء لمزيد من التفاصيل.
أمثلة:
<widget ...>
<access origin="*"></access>
</widget>
<widget ...>
<access origin="http://google.com"></access>
</widget>
allow-navigation
يتحكم هذا الوسم في العناوين التي يمكن للعارض أن يتصفّحها. ينطبق على المستوى الأعلى من المواقع فقط.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
href (سلسلة نصية)
|
مطلوب
يحدد مجموعة النطاقات الخارجية التي يُسمح للعارض بالانتقال إليها. |
انظر صفحة cordova-plugin-whitelist لمزيد من التفاصيل.
أمثلة:
<!-- example.com السماح بالروابط للنطاق -->
<allow-navigation href="http://example.com/*" />
<!-- Wildcards are allowed for the protocol, as a prefix to the host, or as a suffix to the path -->
<!-- علامة النجمة مسموح بها مكان البروتوكول، كبادئة للمُضيف، أو كلاحقة للمسار -->
<allow-navigation href="*://*.example.com/*" />
allow-intent
يتحكم هذا الوسم في العناوين التي يُسمح للتطبيق بمطالبة النظام بفتحها. افتراضيًا، لا يُسمح بأي عناوين خارجية.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
href (سلسلة نصية)
|
مطلوب
تحدد العناوين التي يُسمح للتطبيق بمطالبة النظام بفتحها. |
انظر صفحة cordova-plugin-whitelist لمزيد من التفاصيل.
أمثلة:
<allow-intent href="http://*/*" />
<allow-intent href="https://*/*" />
<allow-intent href="tel:*" />
<allow-intent href="sms:*" />
edit-config
راجع الصفحة plugin.xml.
config-file
راجع الصفحة plugin.xml.
engine
يحدد هذا الوسم تفاصيل حول المنصة المطلوب استرجاعها (restore) أثناء الإعداد.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
name (سلسلة نصية)
|
مطلوب
اسم المنصة المراد استرجاعها |
spec (سلسلة نصية)
|
مطلوب
تفاصيل حول المنصة المراد استعادتها. قد يكون هذا رقم إصدار وفق الصيغة |
أمثلة:
<engine name="android" spec="https://github.com/apache/cordova-android.git#5.1.1" />
<engine name="ios" spec="^4.0.0" />
plugin
يحدد هذا الوسم تفاصيل حول الإضافات المطلوب استرجاعها (restore) أثناء الإعداد. يُضاف هذا العنصر تلقائيًا إلى الملف config.xml
الخاص بالمشروع عندما تُضاف إضافة باستخدام الراية --save
. انظر صفحة واجهة سطر الأوامر لمزيد من المعلومات حول إضافة الإضافات.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
name (سلسلة نصية)
|
مطلوب
اسم الإضافة المراد استرجاعها |
spec (سلسلة نصية)
|
مطلوب
تفاصيل حول الإضافة المراد استعادتها. قد يكون هذا رقم إصدار وفق الصيغة |
أمثلة:
<plugin name="cordova-plugin-device" spec="^1.1.0" />
<plugin name="cordova-plugin-device" spec="https://github.com/apache/cordova-plugin-device.git#1.0.0" />
variable
يخزّن هذا الوسم قيمة متغيرٍ من متغيرات واجهة سطر الأوامر لكي يُستخدم عند استرجاع إضافةٍ أثناء الإعداد. هذا العنصر يُدرج إلى الملف config.xml
عندما تُضاف إحدى الإضافات التي تستخدم متغيرات واجهة سطر الأوامر باستخدام الراية --save
. راجع صفحة واجهة سطر الأوامر لمزيد من المعلومات حول إضافة الإضافات.
لاحظ أن هذه القيمة لا تُستخدم إلا عند استرجاع الإضافة إلى المشروع أثناء الإعداد، ولن يؤدي تغييرها إلى تغيير القيمة التي تستخدمها الإضافة في المشروع الحالي. لكي تسري التغييرات على هذه القيمة فعليًا، أزل الإضافة من المشروع واسترجعها عن طريق تنفيذ الأمر cordova prepare
. انظر قسم العنصر preference
للملف plugin.xml
لمزيد من التفاصيل حول متغيرات واجهة سطر الأوامر.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
name (سلسلة نصية)
|
مطلوب
اسم متغير واجهة سطر الأوامر. لا يمكن أن يحتوي إلا على الأحرف الكبيرة والأرقام والشرطات السفلية. |
value (سلسلة نصية)
|
مطلوب
قيمة متغير واجهة سطر الأوامر المراد استخدامه عند استرجاع الإضافة الأم (parent plugin) أثناء الإعداد. |
أمثلة:
<plugin name="cordova-plugin-device" spec="^1.1.0">
<variable name="MY_VARIABLE" value="my_variable_value" />
</plugin>
preference
يعيّن هذا الوسم مُختلف الخيارات على هيئة زوج من أسماء/قيم الخاصيات (name/value). الاسماء في preference
غير حساسة لحالة الأحرف. العديد من التفضيلات مخصوصة بمنصات محددة، وسيتم الإشارة إليها في موضعها.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
AllowInlineMediaPlayback (قيمة منطقية)
(ios) |
القيمة الافتراضية: false
اضبطها عند القيمة ملاحظة: قبل الإصدار iOS 10، كانت العناصر |
AndroidLaunchMode (سلسلة نصية)
(أندرويد) |
القيمة الافتراضية: singleTop
القيم المسموح بها: تعيّن قيمة الخاصية |
android-maxSdkVersion (عدد صحيح)
(أندرويد) |
القيمة الافتراضية: غير محددة
تضبط قيمة الخاصية |
android-minSdkVersion (سلسلة نصية)
(أندرويد) |
القيمة الافتراضية: يعتمد على إصدار منصة كوردوفا أندرويد
تضبط قيمة الخاصية |
android-targetSdkVersion (عدد صحيح)
(أندرويد) |
القيمة الافتراضية: تعتمد على إصدار كوردوفا-أندرويد
تضبط قيمة الخاصية |
android-minSdkVersion (سلسلة نصية)
(أندرويد) |
القيمة الافتراضية: يعتمد على إصدار منصة كوردوفا أندرويد
تضبط قيمة الخاصية |
AppendUserAgent (سلسلة نصية)
(أندرويد - ios) |
في حال تعيينها، ستُضاف قيمتها إلى نهاية وكيل المستخدم UserAgent القديم الخاص بالعارض. عند استخدامها مع OverrideUserAgent ، سيتم تجاهل هذه القيمة.
|
BackgroundColor (سلسلة نصية)
(أندرويد - ويندوز - ios) |
تعيّن هذه الخاصية لون خلفية التطبيق. تدعم القيم اللونية السداسعشرية ذات الأربع بايتات (four-byte hex)، إذ يمثل البايت الأول قناة الشفافية ألفا (alpha channel)، فيما تمثل البايتات الثلاث التالية قيم المُركّبات اللونية الثلاثة RGB في.
في منصة ويندوز، يتم تجاهل قناة ألفا. ملاحظة: ستُعيّن القيمة |
BackupWebStorage (سلسلة نصية)
(ios) |
القيمة الافتراضية: cloud
القيم المسموح بها: اضبط هذه الخاصية عند القيمة " |
CordovaWebViewEngine (سلسلة نصية)
(ios) |
القيمة الافتراضية: CDVUIWebViewEngine
تُعيّن هذه الخاصية قيمة إضافة محرك العارض (WebView engine plugin) ليتم استخدامها لعرض مضيف التطبيق. يجب أن تتوافق الإضافة مع البروتوكول عادةً ما يتم تعيين هذا التفضيل بواسطة إضافة محرك العارض المثبتة تلقائيًا. |
CordovaDefaultWebViewEngine (سلسلة نصية)
(ios) |
القيمة الافتراضية: CDVUIWebViewEngine
مثل الإعداد السابق، يجب أن تتوافق الإضافة مع البروتوكول |
DefaultVolumeStream (سلسلة نصية)
(أندرويد) |
القيمة الافتراضية: default
تمت إضافة هذا الإعداد منذ منصة كوردوفا-أندرويد 3.7.0، هذا التفضيل يحدد الصوت (volume) الذي ترتبط به أزرار مستوى الصوت في الأجهزة. بشكل افتراضي، ستكون قيمة هذه الخاصية " اضبط هذا الخيار عند القيمة " |
DisallowOverscroll (قيمة منطقية)
(أندرويد - ios) |
القيمة الافتراضية: false
اضبط هذا الإعداد عند القيمة |
EnableViewportScale (قيمة منطقية)
(ios) |
القيمة الافتراضية: false
اضبط هذا الإعداد عند القيمة |
EnableWebGL (قيمة منطقية)
(OS X 4.0.0+) |
القيمة الافتراضية: false
اضبط هذا الإعداد عند القيمة |
ErrorUrl (عنوان URL)
(أندرويد) |
القيمة الافتراضية: null
في حال تعيين هذا الإعداد، فسيتم عرض الصفحة المشار إليها عند حدوث خطأ في التطبيق بدلاً من عرضها في مربع حوار بعنوان "Application Error" |
ErrorUrl (سلسلة نصية)
(ios) |
في حال تعيين هذا الإعداد، فسيتم عرض الصفحة المحلية المشار إليها عند حدوث خطأ في التطبيق. |
ForegroundText (سلسلة نصية)
(ويندوز) |
القيمة الافتراضية: "light "
يعمل فقط على مشاريع ويندوز 8.1. القيم المسموح بها: " |
FullScreen (قيمة منطقية)
(أندرويد) |
قيمة الافتراضية: false
يسمح لك بإخفاء شريط الحالة (status bar) في الجزء العلوي من الشاشة. ملاحظة: هناك طريقة تحقق هذا المسعى على جميع المنصات، وهي استخدام إضافة شريط الحالة. |
GapBetweenPages (عدد عشري float)
(ios) |
القيمة الافتراضية: 0
حجم الفجوة بين الصفحات بالنقاط. |
HideMousePointer (عدد صحيح)
(OS X 4.0.0+) |
القيمة الافتراضية: -1
يعيّن المهلة قبل إخفاء مؤشر الفأرة. اضبط هذا الإعداد عند القيمة |
InAppBrowserStorageEnabled (قيمة منطقية)
(أندرويد) |
القيمة الافتراضية: true
يتحكم في ما إن كانت الصفحات المفتوحة ضمن |
KeepRunning (قيمة منطقية)
(أندرويد) |
القيمة الافتراضية: true
تحدد هذه الخاصية ما إن كان التطبيق سيبقى قيد التشغيل في الخلفية حتى بعد إطلاق الحدث pause. لا يؤدي تعيين هذا الإعداد عند القيمة |
KeyboardDisplayRequiresUserAction (قيمة منطقية)
(ios) |
القيمة الافتراضية: true
اضبط هذا الإعداد عند القيمة |
LoadUrlTimeoutValue (عدد الميليثواني)
(أندرويد) |
القيمة الافتراضية: 20000، أي 20 ثانية
عند تحميل صفحة، يحدد هذا الإعداد عدد الثواني التي يجب انتظارها قبل إطلاق خطأ انتهاء المهلة (timeout error). |
LoadingDialog (سلسلة نصية)
(أندرويد) |
القيمة الافتراضية: null
في حال تعيين هذا الإعداد، يعرض مربع حوار مع العنوان والرسالة المحددين، ولائحة منسدلة (spinner)، عند تحميل الصفحة الأولى من التطبيق. يفصل العنوان والرسالة بفاصلة في السلسلة النصية المعطاة، وستُزال تلك الفاصلة قبل عرض مربع الحوار. |
LogLevel (سلسلة نصية)
(أندرويد) |
القيمة الافتراضية: ERROR
القيم المسموح بها: |
MediaPlaybackAllowsAirPlay (قيمة منطقية)
(ios) |
القيمة الافتراضية: true
اضبط هذا الإعداد عند القيمة |
MediaPlaybackRequiresUserAction (قيمة منطقية)
(ios) |
القيمة الافتراضية: false
اضبط هذا الإعداد عند القيمة |
Min/Max Version (تعبير منطقي Regex)
(ويندوز) |
القيم المسموح بها: /(Microsoft.+? | Windows.+?)-(MinVersion | MaxVersionTested)/i
يحدد هذا الإعداد بيئة العمل (ecosystems) والإصدارات Min / max المتوافقة مع التطبيق. هناك ثلاثة أجزاء لكل قيمة:
إذا لم يتم تحديد أي تفضيلات لهذه الأنواع في الملف ملاحظة: يتم تعيين هذه التفضيلات فقط في ملفات ييانات التطبيق (appxmanifest) للمنصة المُستهدفة، وليس في ملفات جافاسكريبت الخاصة بالمشروع. |
Orientation (سلسلة نصية)
|
القيمة الافتراضية: default
القيم المسموح بها: يتيح لك هذا الإعداد تجميد اتجاه العرض، ومنع الواجهة من الدوران استجابة للتغيرات في الاتجاه. ملاحظة: القيمة الافتراضية |
OSXLocalStoragePath (سلسلة نصية)
(OS X 4.0.0+) |
القيمة الافتراضية: ~/Library/Application Support/{bundle.id}
تعيّن مجلد مسار التخزين المحلي. |
OverrideUserAgent (سلسلة نصية)
(أندرويد - ios) |
في حال تعيين هذا الإعداد، فستحل القيمة الجديدة محل وكيل المستخدم UserAgent القديم في العارض. من المفيد تحديد الطلبية (request) من التطبيق أو المتصفح عند طلب الصفحات البعيدة. استخدم هذا الإعداد بحذر، فقد يتسبب في مشاكل تتعلق بالتوافقية مع الخوادم. في معظم الحالات، يُفضل استخدام AppendUserAgent .
|
PageLength (عدد عشري)
|
القيمة الافتراضية: 0
يحدد حجم كل صفحة، بالنقاط، في الاتجاه الذي تسري فيه الصفحات. عندما تكون الخاصية |
PaginationBreakingMode (سلسلة نصية)
(ios) |
القيمة الافتراضية: page
القيم المسموح بها: القيم الصالحة هي |
PaginationMode (سلسلة نصية)
(ios) |
القيمة الافتراضية: unpaginated
القيم المسموح بها: تحدد هذه الخاصية ما إن كان المحتوى في العارض سيُقسّم إلى صفحات تملأ شاشة العرض في كل مرة، أو يُعرض كمعرضٍ واحد طويل وقابل للتمرير. في حال تعيين هذا الإعداد عند نموذج مقسم (paginated form)، تقوم هذه الخاصية بتبديل تخطيط صفْحِيٍّ (paginated layout) على المحتوى، مما يؤدي إلى استخدام العارض للقيم |
SetFullscreen (قيمة منطقية)
(أندرويد) |
القيمة الافتراضية: false
مشابه للمُعامل تم إيقاف هذا العنصر المخصوص بمنصة أندرويد لصالح عنصر ملء الشاشة العام (global Fullscreen element)، وسيُزال في إصدار مستقبلي. |
ShowTitle (قيمة منطقية)
(أندرويد) |
القيمة الافتراضية: false
إظهار العنوان في أعلى الشاشة. |
SplashScreenBackgroundColor
(ويندوز) |
القيمة الافتراضية: #464646
يضبط لون خلفية شاشة الافتتاح (splashscreen). يقبل هذا الإعداد اسم لون CSS، أو قيمة لونية سداسية عشرية من أربع بايتات (four-byte hex)، حيث يمثل البايت الأول قناة الشفافية ألفا (alpha channel)، فيما تمثل البايتات الأخرى مركبات اللون RGB. يتم تجاهل قناة ألفا على الرغم من أن قيمة |
Suppresses3DTouchGesture (قيمة منطقية)
(ios) |
القيمة الافتراضية: false
اضبط هذا الإعداد عند القيمة |
SuppressesIncrementalRendering (قيمة منطقية)
(ios) |
القيمة الافتراضية: false
اضبط هذا الإعداد عند القيمة |
SuppressesLongPressGesture (قيمة منطقية)
(ios) |
القيمة الافتراضية: false
اضبط هذا الإعداد عند القيمة |
TopActivityIndicator (سلسلة نصية)
(ios) |
القيمة الافتراضية: gray
القيم المسموح بها: تتحكم هذه الخاصية في مظهر أيقونة الدوران (spinning icon) الصغيرة في شريط الحالة، والذي يشير إلى وجود نشاطٍ كبيرٍ من المعالج. |
uap-target-min-version (سلسلة نصية)
(ويندوز) |
تعيّن هذه الخاصية قيمة MinTargetVersion على Windows UAP (منصة ويندوز العامة للتطبيقات). في حال لم تُعيّن هذه الخاصية، فستُضبط عند الإصدار المبدئي 10.0.10240.0
ملاحظة: يتم تعيين هذا التفضيل في ملفات جافاسكريبت الخاصة بالمشروع وليس في ملف البيان (appxmanifest). لذلك لن يتمكن المستخدمون الذين لديهم أنظمة تشغيل ذات إصدارات أقل من هذه القيمة من تشغيل التطبيق. |
UIWebViewDecelerationSpeed (سلسلة نصية)
(ios) |
القيمة الافتراضية: normal
القيم المسموح بها: تتحكم هذه الخاصية في سرعة تباطؤ (deceleration) حركة التمرير (scrolling). السرعة الافتراضية هي السرعة العادية ( |
WindowSize (سلسلة نصية)
(OS X 4.0.0+) |
القيمة الافتراضية: auto
تحدد حجم نافذة التطبيق. تقبل الصيغة ملاحظة: الخيار العام |
WindowsDefaultUriPrefix (سلسلة نصية)
(ويندوز) |
القيم المسموح بها: ms-appx:// و ms-appx-web://
تحدد هذه الخاصية ما إذا كنت تريد أن يستهدف تطبيقك السياق المحلي أو السياق البعيد (remote context) كعنوان URI الإطلاق (startup URI). عند تطوير تطبيقات لمنصة ويندوز 10، فالإعداد الافتراضي سيكون هو السياق البعيد ( |
WindowsStoreDisplayName (سلسلة نصية)
(ويندوز) |
اسم للناشر لأجل لعرضه على المستخدمين. |
WindowsStoreIdentityName (سلسلة نصية)
(ويندوز) |
اسم التعريف المستخدم في متجر ويندوز. تحدد هذه الخاصية معرفًا فريدًا عامًّا لحزمة معينة. يُمثّل اسم تعريف الحزمة على هيئة سلسلة من خاصيات الحزمة. انظر صفحة صفحة الهوية في ملف بيان الحُزمة لمزيد من التفاصيل. |
القيمة الافتراضية: false
تشير القيمة |
اسم الناشر. |
WindowsToastCapable (قيمة منطقية)
(ويندوز) |
القيمة الافتراضية: false
تشير القيمة |
deployment-target (سلسلة نصية)
(ios) |
يعيّن هذا الإعداد قيمة IPHONEOSDEPLOYMENTTARGET عند البناء، والذي يترجم في النهاية إلى الخاصية MinimumOSVersion في ملف الأرشيف ipa. لمزيد من التفاصيل، يرجى الرجوع إلى وثائق Apple حول إعدادات النشر.
|
target-device (سلسلة نصية)
(ios) |
لقيمة الافتراضية: universal
القيم المسموح بها: ترتبط هذه الخاصية مباشرة بالخاصية |
windows-phone-target-version (سلسلة نصية)
(ويندوز) |
تعيّن هذه الخاصية إصدار Windows Phone الذي ستستهدفه الحزمة (الناتجة من cordova build ). إذا لم يتم تحديدها، فسيتم تعيينها عند نفس الإصدار مثل windows-target-version (إذا تم العثور عليه).
|
windows-target-version (سلسلة نصية)
(ويندوز) |
تعين هذه الخاصية إصدار ويندوز الذي ستستهدفه الحزمة (الناتجة من cordova build ). إذا لم يتم تحديدها، فسيتم تعيينها عند القيمة "8.1".
|
أمثلة:
<preference name="DisallowOverscroll" value="true"/>
<preference name="Fullscreen" value="true" />
<preference name="BackgroundColor" value="0xff0000ff"/>
<preference name="HideKeyboardFormAccessoryBar" value="true"/>
<preference name="Orientation" value="landscape" />
<!-- iOS تفضيلات خاصة بمنصة -->
<preference name="EnableViewportScale" value="true"/>
<preference name="MediaPlaybackAllowsAirPlay" value="false"/>
<preference name="MediaPlaybackRequiresUserAction" value="true"/>
<preference name="AllowInlineMediaPlayback" value="true"/>
<preference name="BackupWebStorage" value="local"/>
<preference name="TopActivityIndicator" value="white"/>
<preference name="SuppressesIncrementalRendering" value="true"/>
<preference name="GapBetweenPages" value="0"/>
<preference name="PageLength" value="0"/>
<preference name="PaginationBreakingMode" value="page"/>
<preference name="PaginationMode" value="unpaginated"/>
<preference name="UIWebViewDecelerationSpeed" value="fast" />
<preference name="ErrorUrl" value="myErrorPage.html"/>
<preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" />
<preference name="AppendUserAgent" value="My Browser" />
<preference name="target-device" value="universal" />
<preference name="deployment-target" value="7.0" />
<preference name="CordovaWebViewEngine" value="CDVUIWebViewEngine" />
<preference name="CordovaDefaultWebViewEngine" value="CDVUIWebViewEngine" />
<preference name="SuppressesLongPressGesture" value="true" />
<preference name="Suppresses3DTouchGesture" value="true" />
<!-- Android تفضيلات خاصة بمنصة -->
<preference name="KeepRunning" value="false"/>
<preference name="LoadUrlTimeoutValue" value="10000"/>
<preference name="InAppBrowserStorageEnabled" value="true"/>
<preference name="LoadingDialog" value="My Title,My Message"/>
<preference name="ErrorUrl" value="myErrorPage.html"/>
<preference name="ShowTitle" value="true"/>
<preference name="LogLevel" value="VERBOSE"/>
<preference name="AndroidLaunchMode" value="singleTop"/>
<preference name="DefaultVolumeStream" value="call" />
<preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" />
<preference name="AppendUserAgent" value="My Browser" />
<!-- Windows تفضيلات خاصة -->
<preference name="windows-phone-target-version" value="8.1" />
<preference name="windows-target-version" value="8.1" />
<preference name="Windows.Universal" value="10.0.10240.0" />
<preference name="WindowsDefaultUriPrefix" value="ms-appx://" />
<preference name="Windows.Mobile-MaxVersionTested" value="10.0.10031.0" />
<preference name="Windows.Universal-MinVersion" value="10.0.0.0" />
<preference name="WindowsStoreIdentityName" value="Cordova.Example.ApplicationDataSample" />
<preference name="WindowsStorePublisherName" value="CN=Contoso Corp, O=Contoso Corp, L=Redmond, S=Washington, C=US" />
<preference name="WindowsToastCapable" value="true" />
<preference name="uap-target-min-version" value="10.0.10586.0" />
<!-- OS X تفضيلات خاصة بمنصة -->
<preference name="HideMousePointer" value="5"/>
<preference name="OSXLocalStoragePath" value="~/.myapp/database"/>
<preference name="WindowSize" value="800x400"/>
<preference name="EnableWebGL" value="true"/>
feature
إن كنت تستخدم واجهة سطر الأوامر لإنشاء التطبيقات، فستستخدم أمر الإضافة (plugin command) لتمكين الواجهات البرمجية (APIs) للجهاز. ولن يعدّل ذلك الملف config.xml
، لذلك فإن هذا العنصر لن ينطبق على سير عملك. إذا كنت تعمل مباشرةً في بيئة العمل SDK وكنت تستخدم الملف config.xml
المخصوص بالمنصة كمصدر، فاستخدم هذا الوسم لتمكين الواجهات البرمجية على مستوى الجهاز والإضافات الخارجية. حيث غالبًا ما تظهر مع قيم مخصصة في ملفات config.xml
المخصوصة بالمنصات. راجع مرجع واجهة التطبيقات API للمزيد من التفاصيل حول كيفية تحديد كل ميزة. راجع صفحة دليل تطوير الإضافات لمزيد من المعلومات حول إضافة الإضافات.
ملاحظة: في معظم الأحيان، ليس عليك تعيين هذا الإعداد مباشرة.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
name (سلسلة نصية)
|
مطلوب
اسم الإضافة المراد تمكينها. |
param
يستخدم هذا الوسم لتحديد معاملات إضافة، مثل: ما هي الحزمة التي ستُسترد شيفة الإضافة منها، وما إذا كانت شيفرة الإضافة ستُهيؤ أثناء تهيئة العارض. الخاصيات (النوع)
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
name (سلسلة نصية)
(أندرويد - osx - ios) |
مطلوب
القيم المسموح بها: تُستخدم القيم " |
value (سلسلة نصية أو قيمة منطقية)
(أندرويد - osx - ios) |
مطلوب
تحدد اسم الحزمة التي ستُستخدم لتهيئة شيفرة الإضافة (عندما تساوي الخاصية ' |
أمثلة:
<!--هكذا تحدد الواجهة البرمجية للجهاز لتطبيقات أنردويد -->
<feature name="Device">
<param name="android-package" value="org.apache.cordova.device.Device" />
</feature>
<!-- Here's how the element appears for iOS projects -->
<feature name="Device">
<param name="ios-package" value="CDVDevice" />
<param name="onload" value="true" />
</feature>
<!-- Here's how the element appears for OS X projects -->
<!-- osx هكذا تظهر العناصر لمشاريع -->
<feature name="Device">
<param name="osx-package" value="CDVDevice" />
<param name="onload" value="true" />
</feature>
platform
عند استخدام واجهة سطر الأوامر لإنشاء التطبيقات، من الضروري في بعض الأحيان تحديد التفضيلات وغيرها من العناصر الخاصة بمنصة معينة.
استخدم العنصر platform
لتحديد الإعدادات الذي يجب أن تظهر حصرًا في الملف config.xml
الخاص بالمنصة.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
name (سلسلة نصية)
|
مطلوب
المنصة المراد تحديد تفضيلاتها. |
أمثلة:
<platform name="android">
<preference name="Fullscreen" value="true" />
</platform>
hook
يمثل هذا العنصر برنامجك النصي (script) المخصص، والذي سيٌستدعى من قبل كوردوفا عند وقوع حدثٍ معينٍ (على سبيل المثال، بعد إضافة الإضافة أو عند استدعاء سلسلة التحضير الخاصة بالمنصة). هذا مفيد عندما تحتاج إلى توسيع كوردوفا. راجع صفحة الخطافات لمزيد من المعلومات.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
type (سلسلة نصية)
|
مطلوب
يحدد الإجراء الذي يتم خلاله استدعاء البرنامج النصي المخصص. |
src (سلسلة نصية)
|
مطلوب
يحدد مكان البرنامج النصي المراد استدعاؤه عند حدوث إجراء محدد. |
أمثلة:
<hook type="after_plugin_install" src="scripts/afterPluginInstall.js" />
resource-file
يثبّت هذا الوسم الملفات المصدرية (resource files) في المنصة، وهو مماثل لوسمٍ يحمل نفس الاسم في الملف plugin.xml
.
هذا الوسم ليس مدعومًا حاليًا إلا في الإصدار cordova-ios@4.4.0
ومافوق، وفي الإصدار cordova-android@6.2.1
وما فوق.
الخاصيات (النوع)
فقط لمنصات |
الشرح |
---|---|
src (سلسلة نصية)
(أندرويد - ios) |
مطلوب
موقع الملف بالنسبة إلى |
target (سلسلة نصية)
|
المسار حيث سيُنسخ الملف داخل المجلد خاصتك. |
أمثلة:
لأجهزة الأندرويد:
<resource-file src="FooPluginStrings.xml" target="res/values/FooPluginStrings.xml" />
عينة من الملف config.xml
فيما يلي نموذج للملف config.xml
:
<?xml version='1.0' encoding='utf-8'?>
<widget id="io.cordova.hellocordova" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
<name>HelloCordova</name>
<description>
A sample Apache Cordova application that responds to the deviceready event.
</description>
<author email="dev@cordova.apache.org" href="http://cordova.io">
Apache Cordova Team
</author>
<content src="index.html" />
<plugin name="cordova-plugin-whitelist" spec="1" />
<access origin="*" />
<allow-intent href="http://*/*" />
<allow-intent href="https://*/*" />
<allow-intent href="tel:*" />
<allow-intent href="sms:*" />
<allow-intent href="mailto:*" />
<allow-intent href="geo:*" />
<platform name="android">
<allow-intent href="market:*" />
</platform>
<platform name="ios">
<allow-intent href="itms:*" />
<allow-intent href="itms-apps:*" />
</platform>
</widget>
انظر أيضا
- صفحة الملف Plugin.xml.
- صفحة واجهة سطر الأوامر.