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

תיאור:

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

הוא פותח את הרכיב לקבלת כוונות מודעה מהסוג שפורסם, תוך סינון של כוונות שאינן בעל משמעות לרכיב. רוב התוכן של המסנן מתואר לפי <action>, <category>, וגם <data> רכיבים משניים.

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

:

android:icon

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

המאפיין הזה מוגדר כהפניה למשאב שניתן להזזה שמכיל את הגדרת התמונה. ערך ברירת המחדל הוא הסמל שמוגדר לפי המאפיין icon של רכיב ההורה. אם ההורה לא מציין סמל, ברירת המחדל היא הסמל שנקבע על ידי רכיב <application>.

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

android:label

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

התווית מוגדרת כהפניה למשאב של מחרוזת, כך אפשר להתאים אותו לשוק המקומי כמו מחרוזות אחרות בממשק המשתמש. עם זאת, לנוחיותכם במהלך הפיתוח של האפליקציה, אפשר להגדיר אותו גם כמחרוזת גולמית.

ערך ברירת המחדל הוא התווית שהוגדרה על ידי רכיב ההורה. אם שלא מציין תווית, ברירת המחדל היא התווית שהוגדרה של רכיב <application> label.

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

android:priority

העדיפות שניתנה לרכיב ההורה ביחס לטיפול בכוונות (Intent) מהסוג שמתואר על ידי המסנן. למאפיין הזה יש המשמעות של הפעילויות ושל מקלטי השידור.

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

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

כדאי להשתמש במאפיין הזה רק אם צריך לקבוע סדר ספציפי שבהם השידורים מתקבלים או שהם רוצים לאלץ את Android להעדיף פעילות אחת על פני פעילות אחרת.

הערך הוא מספר שלם, למשל 100. למספרים גבוהים יותר יש בעדיפות גבוהה יותר. ערך ברירת המחדל הוא 0.

בנסיבות מסוימות, המערכת מתעלמת מהעדיפות המבוקשת ומהערך מוגבל ל-0. מצב זה מתרחש כאשר:

• אפליקציה ללא הרשאות מבקשת עדיפות גבוהה מ-0.
• אפליקציה בעלת הרשאות מבקשת עדיפות גבוהה מ-0 עבור ACTION_VIEW, ACTION_SEND, ACTION_SENDTO או ACTION_SEND_MULTIPLE

מידע נוסף זמין כאן: setPriority().

android:order

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

order שונה מ-priority בכך שהפרמטר priority חל באפליקציות שונות, בעוד ש-order מבחינה בין כמה מסננים תואמים אפליקציה.

אם יש כמה מסננים שיכולים להתאים, צריך להשתמש במקום זאת ב-Intent מכוון.

הערך הוא מספר שלם, למשל 100. קודם כל תהיה התאמה למספרים גבוהים יותר. ערך ברירת המחדל הוא 0.

המאפיין הזה נוסף ברמת API 28.

android:autoVerify

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

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

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

המאפיין הזה נוסף ברמת API 23.

הושקו ב:

רמת API 1

למידע נוסף:

<action>
<category>
<data>