Cordova/config ref

SuppressesLongPressGesture (قيمة منطقية) القيمة الافتراضية: false

اضبط هذا الإعداد عند القيمة true لمنع المنصات iOS9 وما فوق من عرض ودجة زجاجية مُكبّرة (magnifying glass widget) عندما يضغط (longpresses) المستخدم على الممم. اختبر تطبيقك جيدًا، لأن هذا السلوك قد يتداخل مع إمكانيات تحديد (selection) النصوص. 

TopActivityIndicator (سلسلة نصية) القيمة الافتراضية: gray القيم المسموح بها: whiteLarge و white و gray.

يتحكم في مظهر أيقونة الدوران (spinning icon) الصغيرة في شريط الحالة الذي يشير إلى وجود نشاطٍ كبيرٍ من المعالج. uap-target-min-version (سلسلة نصية) تعيّن هذه الخاصية قيمة MinTargetVersion على Windows UAP (منصة ويندوز العامة للتطبيقات). في حال لم تُعيّن هذه الخاصية، فستُضبط عند الإصدار المبدئي 10.0.10240.0 XXXXX يتم تعيين هذا التفضيل في الملف jsproj وليس في ملف البيان appxmanifest. لذلك لن يتمكن المستخدمون الذين لديهم أنظمة تشغيل ذات إصدارات أقل من هذه القيمة من تشغيل التطبيق. UIWebViewDecelerationSpeed ​​(سلسلة نصية) القيمة الافتراضية: normal القيم المسموح بها: normal و fast

تتحكم هذه الخاصية في سرعة تباطؤ (deceleration) حركة التمرير (scrolling). السرعة الافتراضية هي السرعة العادية (normal) لمعظم التطبيقات المحلية، أما في منصة Mobile Safari، فالسرعة الافتراضية هي fast. 

WindowSize (سلسلة نصية) القيمة الافتراضية: auto XXXXX تحدد حجم نافذة التطبيق. تقبل الصيغة XXXXX، والتي تحدد عرضًا وارتفاعًا معينًا، أو القيم الخاصة XXXXX و XXXXX. الخيار الأخير سيفتح نافذة بلا حدود (borderless) تمتد على كامل حيز سطح المكتب. يرجى ملاحظة أن هذا يختلف عن الوضع fullscreen العادي في منصات OS X، والذي لن يمتد على عدة شاشات. XXXXX: الخيار العام XXXXX ليس له أي تأثير على منصات OS X. WindowsDefaultUriPrefix (سلسلة نصية) القيم المسموح بها: XXXXX، XXXXX

يحدد ما إذا كنت تريد أن يستهدف تطبيقك السياق المحلي أو السياق البعيد كعنوان URI لبدء التشغيل. عند تطوير تطبيقات لمنصة ويندوز 10، فالإعداد الافتراضي سيكون هو السياق البعيد (XXXXX). 

لكي يكون لديك تطبيق في وضع محلي، وغير متأثر بقيود الوضع البعيد (Remote Mode)، فيجب عليك تعيين هذا الإعداد عند القيمة XXXXX، وعدم إعطاء أيٍّ من عناصر XXXXX عناوين URI بعيدة. الوضع المحلي هو الوضع الافتراضي لمنصة ويندوز 8.1 WindowsStoreDisplayName (سلسلة نصية) اسم للناشر مناسب لعرضه على المستخدمين. WindowsStoreIdentityName (سلسلة نصية) اسم التعريف المستخدم في متجر ويندوز. تحدد هذه الخاصية معرفًا فريدًا عامًّا لحزمة معينة. يمثل اسم تعريف الحزمة على هيئة سلسلة من خاصيات الحزمة. انظر XXXXX لمزيد من التفاصيل. WindowsStorePublisherName (سلسلة نصية) اسم الناشر. WindowsToastCapable (قيمة منطقية) القيمة الافتراضية: false

تشير القيمة XXXXX إلى أنه يُسمح للتطبيق بتقديم "الإشعارات السريعة" (toast notifications). 

deployment-target (سلسلة نصية) يعيّن هذا الإعداد قيمة IPHONEOSDEPLOYMENTTARGET عند البناء، والذي يترجم في النهاية إلى الخاصية MinimumOSVersion في ملف الأرشيف ipa. لمزيد من التفاصيل، يرجى الرجوع إلى وثائق Apple حول إعدادات النشر. target-device (سلسلة نصية) القيمة الافتراضية: universal القيم المسموح بها: handset و tablet و universal

ترتبط هذه الخاصية مباشرة بالخاصية TARGETEDDEVICEFAMYY في مشروع xcode. في حال اختيار القيمة Universal (وهو الإعداد الافتراضي)، فستحتاج إلى توفير لقطات الشاشة لكل من iPhone و iPad أو قد يُرفض تطبيقك. 

windows-phone-target-version (سلسلة نصية) تعيّن هذه الخاصية إصدار Windows Phone الذي ستستهدفه الحزمة (الناتجة من XXXXX). إذا لم يتم تحديدها، فسيتم تعيينها عند نفس الإصدار مثل XXXXX (إذا تم العثور عليه). windows-target-version (سلسلة نصية) تعين هذه الخاصية إصدار ويندوز الذي ستستهدفه الحزمة (الناتجة من XXXXX). إذا لم يتم تحديدها، فسيتم تعيينها عند القيمة "8.1".

أمثلة: XXXXX

feature

إن كنت تستخدم ووو لإنشاء التطبيقات، وكنت تستخدم أمر الإضافة (plugin command) لتمكين الواجهات البرمجية (APIs) للجهاز. فهذا لا يعدّل الملف config.xml، لذلك فإن العنصر لا ينطبق على سير عملك. إذا كنت تعمل مباشرةً في بيئة العمل SDK وكنت تستخدم الملف config.xml المخصوص بالمنصة كمصدر، فاستخدم الوسم لتمكين الواجهات البرمجية على مستوى الجهاز والإضافات الخارجية. وغالبًا ما تظهر مع قيم مخصصة في ملفات config.xml الخاصة بالمنصات. راجع مرجع واجهة التطبيقتن API للمزيد من التفاصيل حول كيفية تحديد كل ميزة. راجع صفحة XXXXX لمزيد من المعلومات حول إضافة الإضافات. ملاحظة: في معظم الأحيان، ليس عليك تعيين هذا الإعداد مباشرة. الخاصيات(النوع)

فقط للمنصة: الوصف name (سلسلة نصية) مطلوب اسم الإضافة المراد تمكينها.

param

تُستخدم لتحديد معاملات إضافة معينة مثل: ما هي الحزمة التي ستُسترد شيفة الإضافة منها، وما إذا كانت شيفرة الإضافة ستُهيؤ أثناء تهيئة الممم. الخاصيات (النوع)

فقط للمنصة: الوصف name (سلسلة نصية) مطلوب القيم المسموح بها: android-package، و ios-package، و osx-package، و onload.

تُستخدم "ios-package" و "osx-package" و "android-package" لتحديد اسم الحزمة (كما هو محدد بواسطة الخاصية "value") لاستخدامها في تهيئة شيفرة الإضافة، بينما تُستخدم "onload" لتحديد ما إذا كان يجب أن يتم إنشاء الإضافة المقابلة (كما هو محدد في الخاصية"value") عند تهيئة وحدة التحكم (controller). 

القيمة (سلسلة نصية أو قيمة منطقية) مطلوب

تحدد اسم الحزمة التي ستُستخدم لتهيئة شيفرة الإضافة (عندما تساوي الخاصية 'name' إحدى القيم android-package، أو ios-package أو osx-package)، تحدد اسم الإضافة التي ستُحمّل أثناء تهيئة وحدة التحكم - controller - (عند تعيين "name" عند القيمة "onload"). 

أمثلة: XXXXX

platform

عند استخدام ووو لإنشاء التطبيقات، من الضروري في بعض الأحيان تحديد التفضيلات وغيرها من العناصر الخاصة بمنصة معينة. استخدم العنصر platform لتحديد الإعدادات الذي يجب أن تظهر فقط في الملف config.xml الخاص بالمنصة. الخاصيات (النوع)

فقط للمنصة: الوصف name (سلسلة نصية) مطلوب المنصة المراد تحديد تفضيلاتها.

أمثلة: XXXXX

hook

يمثل هذا الإعداد برنامجك النصي (script) المخصص والذي سيٌستدعى من قبل كوردوفا عند وقوع حدثٍ معينٍ (على سبيل المثال، بعد إضافة الإضافة أو عند استدعاء سلسلة التحضير الخاصة بالمنصة). هذا مفيد عندما تحتاج إلى توسيع كوردوفا. راجع صفحة XXXXX لمزيد من المعلومات. الخاصيات (النوع)

فقط للمنصة: الوصف type (سلسلة نصية) مطلوب يحدد الإجراء الذي يتم خلاله استدعاء البرنامج النصي المخصص. src (سلسلة نصية) مطلوب يحدد مكان البرنامج النصي المراد استدعاؤه عند حدوث إجراء محدد.

أمثلة: XXXXX

resource-file

يثبّت هذا الوسم الملفات المصدرية (resource files) في المنصة، وهو مماثل للوسم الذي يحمل نفس الاسم في الملف plugin.xml. هذه الوسم ليس مدعومًا حاليًا إلا في الإصدار XXXXX ومافوق، وفي الإصدار XXXXX وما فوق. الخاصيات (النوع)

فقط للمنصة: الوصف src (سلسلة نصية) مطلوب موقع الملف بالنسبة إلى XXXXX. target (سلسلة نصية) المسار حيث سيُنسخ الملف داخل المجلد خاصتك.

أمثلة:

لأجهزة الأندرويد: XXXXX

مثال عن الملف config.xml

فيما يلي نموذج للملف config.xml: XXXXX