<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>
<property>
תיאור:
כינוי לפעילות, שנקבע על ידי מאפיין targetActivity. היעד חייב להיות באותה אפליקציה כמו הכינוי, וצריך להצהיר עליו לפני הכינוי במניפסט.

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

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

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

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

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

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

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

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

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

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

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

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

android:targetActivity
השם של הפעילות שאפשר להפעיל באמצעות הכינוי. השם הזה צריך להיות זהה לערך המאפיין name של רכיב <activity> שמופיע לפני הכינוי במניפסט.

הושק ב:
רמת API‏ 1
ראו גם:
<activity>