- البنية:
<intent-filter android:icon="drawable resource" android:label="string resource" android:priority="integer" > ... </intent-filter>
- المحتوى المضمّن في:
<activity>
<activity-alias>
<service>
<receiver>
<provider>
- يجب أن تتضمّن:
<action>
- يمكن أن تحتوي على ما يلي:
<category>
<data>
<uri-relative-filter-group>
- description:
- تُحدِّد أنواع النوايا التي يمكن لمستقبل البث أو النشاط أو الخدمة الردّ عليها. يعلن فلتر الأهداف عن إمكانات المكوّن
الرئيسي: ما يمكن أن يفعله النشاط أو الخدمة وأنواع
البث التي يمكن لجهاز الاستقبال معالجتها.
ويفتح المكوّن لتلقّي النوايا من النوع المعلَن عنه مع فلترة تلك التي ليست مفيدة للمكوّن. يتم وصف معظم محتوى الفلتر من خلال عناصره الفرعية:
لمناقشة أكثر تفصيلاً عن الفلاتر، يُرجى الاطّلاع على Intents وIntent Filters وIntent filters في قسم النظرة العامة على بيان التطبيق.
- السمات:
android:icon
- رمز يمثّل النشاط الرئيسي أو الخدمة أو جهاز استقبال البث
عندما يتم عرض هذا المكوّن للمستخدم على أنّه يمتلك
القدرة الموضّحة في الفلتر
يتم ضبط هذه السمة كمرجع لمورد قابل للرسم يحتوي على تعريف الصورة. القيمة التلقائية هي الرمز الذي تم ضبطه بواسطة سمة
icon
للمكوّن الرئيسي. إذا لم يحدّد العنصر родительский رمزًا، يكون الرمز التلقائي هو الرمز الذي يحدّده العنصر<application>
.لمزيد من المعلومات عن رموز فلاتر الأهداف، اطّلِع على القسم الرموز والعلامات في النظرة العامة على بيان التطبيق.
android:label
- تصنيف يسهل على المستخدم قراءته للمكوّن الرئيسي ويُستخدَم هذا التصنيف، بدلاً من
التصنيف الذي يضبطه المكوّن الرئيسي، عند عرض المكوّن
للمستخدم على أنّه يمتلك الإمكانية الموضّحة في الفلتر.
يتم ضبط التصنيف كإشارة إلى مورد سلسلة حتى تتمكّن من ترجمة السلسلة مثل سلاسل النصوص الأخرى في واجهة المستخدم. ومع ذلك، لتسهيل عملية تطوير التطبيق، يمكن أيضًا ضبطه كسلسلة غير مفسَّرة.
القيمة التلقائية هي التصنيف الذي يضبطه المكوّن الرئيسي. إذا لم يحدِّد العنصر الرئيسي تصنيفًا، يكون التصنيف التلقائي هو التصنيف الذي تم ضبطه من خلال سمة
label
لعنصر<application>
.لمزيد من المعلومات عن تصنيفات فلاتر الأهداف، اطّلِع على القسم الرموز والتصنيفات في النظرة العامة على بيان التطبيق.
android:priority
- الأولوية الممنوحة للمكوِّن الرئيسي في ما يتعلّق
بمعالجة النوايا من النوع الموضّح في الفلتر لهذه السمة
معنى لكل من الأنشطة وأجهزة استقبال البث.
- تقدّم هذه السمة معلومات عن مدى قدرة نشاط معيّن على الاستجابة لطلب يتطابق مع الفلتر، مقارنةً بالأنشطة الأخرى التي يمكنها أيضًا الاستجابة للطلب. عندما يمكن تنفيذ نية من خلال عدة أنشطة ذات أولويات مختلفة، لا يأخذ Android في الاعتبار سوى الأنشطة التي تتضمن قيم أولوية أعلى كأهداف محتملة للنية.
وتتحكّم هذه القيمة في ترتيب تنفيذ أجهزة استقبال البث لتلقّي رسائل البث، مع استدعاء تلك التي تحتوي على قيم أولوية أعلى قبل تلك التي تحتوي على قيم أقل. لا ينطبق الترتيب إلا على الرسائل المتزامنة. ويتم تجاهله للرسائل غير المتزامنة.
لا تستخدِم هذه السمة إلا إذا كنت بحاجة إلى فرض ترتيب محدّد لتلقّي البثّات أو إذا كنت تريد إجبار Android على تفضيل أحد الأنشطة على الأنشطة الأخرى.
القيمة عدد صحيح، مثل
100
. تكون الأرقام الأعلى برمجةً لها أولوية أعلى. تكون القيمة التلقائية0
.في بعض الحالات، يتم تجاهل الأولوية المطلوبة ويتم حصر القيمة ب
0
. يحدث ذلك في الحالات التالية:- يطلب تطبيق غير مفوَّض أي أولوية > 0.
- يطلب تطبيق مميّز الحصول على الأولوية >0 لملف
ACTION_VIEW
أو ACTION_SEND
أو ACTION_SENDTO
أو ACTION_SEND_MULTIPLE
.
لمزيد من المعلومات، يُرجى الاطّلاع على
setPriority()
. android:order
ترتيب معالجة الفلتر عند تطابق فلاتر متعددة
تختلف دالة
order
عن دالةpriority
من حيث أنّpriority
تُطبَّق على مستوى التطبيقات، في حين أنّorder
تزيل الغموض عن فلاتر المطابقة المتعدّدة في تطبيق واحد.عندما يمكن أن تتطابق فلاتر متعدّدة، استخدِم نية موجّهة بدلاً من ذلك.
القيمة عدد صحيح، مثل
100
. تتم مطابقة الأرقام الأعلى أولاً. تكون القيمة التلقائية0
.تمّ تقديم هذه السمة في مستوى واجهة برمجة التطبيقات 28.
android:autoVerify
- ما إذا كان نظام Android بحاجة إلى التحقّق من أنّ ملف روابط التنقل إلى مواد العرض الرقمية بتنسيق JSON من المضيف المُحدَّد يتطابق مع هذا التطبيق.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التحقّق من روابط تطبيقات Android.
تكون القيمة التلقائية
false
.تمّ تقديم هذه السمة في المستوى 23 من واجهة برمجة التطبيقات.
- تمّت إتاحة هذه الميزة لأول مرة في:
- المستوى 1 من واجهة برمجة التطبيقات
- راجِع أيضًا:
<action>
<category>
<data>
<uri-relative-filter-group>
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2024-12-02 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-12-02 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]