<activity-alias>

תחביר:

<activity-alias android:enabled=["true" | "false"]
                android:exported=["true" | "false"]
                android:icon="drawable resource"
                android:label="string resource"
                android:name="string"
                android:permission="string"
                android:targetActivity="string" >
    ...
</activity-alias>

בתוך:

<application>

יכול להכיל:

<intent-filter>
<meta-data>

תיאור:

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

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

לדוגמה, מסנני Intent בכתובת האימייל החלופית עשויים לציין את "android.intent.action.MAIN" ו-"android.intent.category.LAUNCHER" אינץ' דגלים, וכתוצאה מכך מיוצגים במרכז האפליקציות, למרות שאף אחד המסננים בפעילות היעד עצמה מגדירים את הדגלים האלה.

מלבד targetActivity, <activity-alias> הם קבוצת משנה של מאפייני <activity>. לגבי מאפיינים בקבוצת המשנה, אף אחד מהערכים שהוגדרו ליעד לא מועבר לכתובת האימייל החלופית. עם זאת, לגבי מאפיינים שלא נכללים בקבוצת המשנה, הערכים שהוגדרו פעילות היעד תחול גם על הכינוי.

:

android:enabled

אם המערכת יכולה ליצור מופע של פעילות היעד באמצעות כתובת האימייל החלופית הזו "true" אם אפשר, ו-"false" אם לא. ערך ברירת המחדל הוא "true".

לרכיב <application> יש ערך משלו מאפיין enabled שחל על כל הפריטים כולל כינויי פעילות. <application> ו-<activity-alias> שניהם חייבים להיות "true" כדי שהמערכת תוכל ליצור מופע פעילות היעד באמצעות הכינוי. אם אחד מהם הוא "false", הכינוי לא עובדת.

android:exported

אם הרכיבים של אפליקציות אחרות יכולים להפעיל את פעילות היעד באמצעות הכינוי הזה. "true" אם כן, ו-"false" אם לא. אם הערך שלו הוא "false", אפשר להפעיל את פעילות היעד דרך הכינוי רק באמצעות רכיבים של אותה אפליקציה כמו הכינוי או אפליקציות שיש להן אותו מזהה משתמש.

ערך ברירת המחדל תלוי בשאלה אם הכינוי מכיל מסנני Intent. אם חסרים מסננים, המשמעות היא שאפשר להפעיל את הפעילות דרך הכינוי. רק על ידי ציון השם המדויק של הכינוי. הכוונה היא שהכינוי מיועד לשימוש פנימי בלבד, כי אחרים לא יודעים את שם. לכן, ערך ברירת המחדל הוא "false". מצד שני, נוכחות של מסנן אחד לפחות מרמזת שהכינוי מיועד לשימוש חיצוני, ולכן ערך ברירת המחדל הוא "true".

android:icon

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

android:label

תווית של כינוי שהמשתמש יכול לקרוא, כשהיא תוצג למשתמשים דרך הכינוי. למידע נוסף, אפשר לעיין ברכיב <activity> label.

android:name

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

android:permission

שם ההרשאה שהלקוחות צריכים כדי להפעיל את פעילות היעד או לבקש ממנו לבצע פעולה כלשהי באמצעות הכינוי. אם מתקשר של startActivity() או startActivityForResult() לא קיבל את ההרשאה שצוינה, פעילות היעד לא תופעל.

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

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

android:targetActivity

שם הפעילות שאפשר להפעיל באמצעות הכינוי. השם הזה חייב להתאים למאפיין name של רכיב <activity> שקודם את הכינוי במניפסט.

הושקו ב:

רמת API 1

למידע נוסף:

<activity>