<intent-filter>

תחביר:

<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:

מציין את סוגי הכוונות שפעילות, שירות או מקלט שידור יכולים להגיב עליהן. מסנן Intent מצהיר על היכולות של רכיב ההורה שלו: מה פעילות או שירות יכולים לעשות ואילו סוגים של שידורים מקלט יכול לטפל בהם.

הוא פותח את הרכיב לקבלת כוונות מהסוג שפורסם, וסינון של כוונות שלא רלוונטיות לרכיב. רוב התוכן של המסנן מתואר על ידי רכיבי המשנה שלו:

• <action>,
• <category>,
• <data>, וגם
• <uri-relative-filter-group>.

לדיון מפורט יותר על מסננים, קראו את הקטע כוונות ומסנני כוונות ואת הקטע מסנני כוונות בסקירה הכללית על קובץ המניפסט של האפליקציה.

מאפיינים:

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.

המאפיין הזה הוצג ברמת API 28.

android:autoVerify

אם מערכת Android צריכה לאמת שקובץ ה-JSON של Digital Asset Links מהמארח שצוין תואם לאפליקציה הזו.

מידע נוסף זמין במאמר אימות קישורים לאפליקציות ל-Android.

ערך ברירת המחדל הוא false.

המאפיין הזה הוצג ברמת API 23.

הופיע לראשונה:

רמת API 1

מידע נוסף:

<action>
<category>
<data>
<uri-relative-filter-group>