<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>
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# <activity-alias\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cactivity-alias android:enabled=[\"true\" | \"false\"]\n android:exported=[\"true\" | \"false\"]\n android:icon=\"drawable resource\"\n android:label=\"string resource\"\n android:name=\"string\"\n android:permission=\"string\"\n android:targetActivity=\"string\" \u003e\n ...\n \u003c/activity-alias\u003e\n ```\n\ncontained in:\n: [\u003capplication\u003e](/guide/topics/manifest/application-element)\n\ncan contain:\n: [\u003cintent-filter\u003e](/guide/topics/manifest/intent-filter-element)\n\n [\u003cmeta-data\u003e](/guide/topics/manifest/meta-data-element)\n\ndescription:\n: An alias for an activity, named by the `targetActivity`\n attribute. The target must be in the same application as the\n alias and declared before the alias in the manifest.\n\n\n The alias presents the target activity as an independent entity, and can have its own set of intent\n filters. They, rather than the\n intent filters on the target activity itself, determine which intents\n can activate the target through the alias and how the system\n treats the alias.\n\n For example, the intent filters on the alias might\n specify the [\"android.intent.action.MAIN\"](/reference/android/content/Intent#ACTION_MAIN)\n and [\"android.intent.category.LAUNCHER\"](/reference/android/content/Intent#CATEGORY_LAUNCHER)\" flags, causing it to\n be represented in the application launcher, even though none of the\n filters on the target activity itself set these flags.\n\n\n With the exception of `targetActivity`, `\u003cactivity-alias\u003e`\n attributes are a subset of [\u003cactivity\u003e](/guide/topics/manifest/activity-element) attributes.\n For attributes in the subset, none of the values set for the target carry over\n to the alias. However, for attributes not in the subset, the values set for\n the target activity also apply to the alias.\n\nattributes:\n:\n\n `android:enabled`\n : Whether the target activity can be instantiated by the system through\n this alias. `\"true\"` if it can be, and `\"false\"` if not.\n The default value is `\"true\"`.\n\n\n The [\u003capplication\u003e](/guide/topics/manifest/application-element) element has its own\n [enabled](/guide/topics/manifest/application-element#enabled) attribute that applies to all\n application components, including activity aliases. The\n `\u003capplication\u003e` and `\u003cactivity-alias\u003e`\n attributes must both be `\"true\"` for the system to be able to instantiate\n the target activity through the alias. If either is `\"false\"`, the alias\n doesn't work.\n\n `android:exported`\n : Whether the components of other applications can launch the target activity\n through this alias. `\"true\"` if they can, and `\"false\"` if not.\n If `\"false\"`, the target activity can be launched through the alias only by\n components of the same application as the alias or applications with the same user ID.\n\n\n The default value depends on whether the alias contains intent filters. The\n absence of any filters means that the activity can be invoked through the alias\n only by specifying the exact name of the alias. This implies that the alias\n is intended only for application-internal use, since others don't know its name.\n So, the default value is `\"false\"`.\n On the other hand, the presence of at least one filter implies that the alias\n is intended for external use, so the default value is `\"true\"`.\n\n `android:icon`\n : An icon for the target activity when presented to users through the alias.\n For more information, see the [\u003cactivity\u003e](/guide/topics/manifest/activity-element) element's\n [icon](/guide/topics/manifest/activity-element#icon) attribute.\n\n `android:label`\n : A user-readable label for the alias when presented to users through the alias.\n For more information, see the [\u003cactivity\u003e](/guide/topics/manifest/activity-element) element's\n [label](/guide/topics/manifest/activity-element#label) attribute.\n\n \u003cbr /\u003e\n\n `android:name`\n\n : A unique name for the alias. The name resembles a fully qualified class name. But, unlike the name of the target activity, the alias name is arbitrary. It doesn't refer to an actual class. \u003cbr /\u003e\n\n `android:permission`\n : The name of a permission that clients must have to launch the target activity\n or get it to do something using the alias. If a caller of\n [startActivity()](/reference/android/content/Context#startActivity(android.content.Intent)) or\n [startActivityForResult()](/reference/android/app/Activity#startActivityForResult(android.content.Intent, int))\n isn't granted the specified permission, the target activity isn't activated.\n\n This attribute supplants any permission set for the target activity itself. If\n it isn't set, a permission isn't needed to activate the target through the alias.\n\n\n For more information about permissions, see the\n [Permissions](/guide/topics/manifest/manifest-intro#perms)\n section in the app manifest overview.\n\n `android:targetActivity`\n : The name of the activity that can be activated through the alias.\n This name must match the `name` attribute of an\n [\u003cactivity\u003e](/guide/topics/manifest/activity-element) element that precedes\n the alias in the manifest.\n\n \u003cbr /\u003e\n\nintroduced in:\n: API level 1\n\nsee also:\n: [\u003cactivity\u003e](/guide/topics/manifest/activity-element)"]]
