- תחביר:
<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 מצהיר על היכולות של רכיב ההורה שלו: מה פעילות או שירות יכולים לעשות ואילו סוגים של שידורים מקלט יכול לטפל בהם.
הוא פותח את הרכיב לקבלת כוונות מהסוג שפורסם, וסינון של כוונות שלא רלוונטיות לרכיב. רוב התוכן של המסנן מתואר על ידי רכיבי המשנה שלו:
לדיון מפורט יותר על מסננים, קראו את הקטע כוונות ומסנני כוונות ואת הקטע מסנני כוונות בסקירה הכללית על קובץ המניפסט של האפליקציה.
- מאפיינים:
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>
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-12-02 (שעון UTC).
[[["התוכן קל להבנה","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 (שעון UTC)."],[],[]]