- Syntax:
<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>
- enthalten in:
<application>
- kann Folgendes enthalten:
<intent-filter>
<meta-data>
- description:
- Ein Alias für eine Aktivität, benannt nach dem
targetActivity
. Das Ziel muss sich in derselben Anwendung wie die Alias und im Manifest vor dem Alias deklariert.Der Alias stellt die Zielaktivität als unabhängige Entität dar und kann einen eigenen Intent haben Filter. Sie und nicht die Intents nach der Zielaktivität selbst filtern und bestimmen, welche Intents das Ziel über den Alias aktivieren kann und wie das System behandelt.
Beispielsweise könnten die Intent-Filter für den Alias
"android.intent.action.MAIN"
angeben und"android.intent.category.LAUNCHER"
" Flags, die dazu führen, dass in der Anwendungsstartleiste dargestellt werden, obwohl keiner der Filter für die Zielaktivität selbst setzen diese Flags.Mit Ausnahme von
targetActivity
,<activity-alias>
sind eine Teilmenge der<activity>
-Attribute. Bei Attributen in der Teilmenge wird keiner der für das Ziel festgelegten Werte übernommen mit dem Alias. Für Attribute, die nicht in dieser Teilmenge enthalten sind, werden jedoch die für gilt die Zielaktivität auch für den Alias. - Attribute:
android:enabled
- Ob die Zielaktivität vom System instanziiert werden kann:
diesem Alias.
"true"
, wenn dies möglich ist, und"false"
, wenn nicht. Der Standardwert ist"true"
.Das
<application>
-Element hat eine eigene Attributenabled
, das für alle gilt Anwendungskomponenten wie Aktivitätsaliasse. Die<application>
und<activity-alias>
Attribute müssen beide"true"
sein, damit das System eine Instanz die Zielaktivität über den Alias. Wenn einer der beiden Werte"false"
ist, wird das Alias nicht funktioniert. android:exported
- Ob die Komponenten anderer Apps die Zielaktivität starten können
über diesen Alias.
"true"
, wenn dies möglich ist, und"false"
, wenn nicht. Wenn"false"
, kann die Zielaktivität nur über den Alias gestartet werden, indem Komponenten derselben Anwendung wie der Alias oder Anwendungen mit derselben Nutzer-IDDer Standardwert hängt davon ab, ob der Alias Intent-Filter enthält. Die Wenn keine Filter vorhanden sind, kann die Aktivität über das Alias indem Sie den genauen Namen des Alias angeben. Dies impliziert, dass das Alias ist nur für die anwendungsinterne Verwendung vorgesehen, da andere den Namen nicht kennen. Der Standardwert ist also
"false"
. Andererseits bedeutet das Vorhandensein mindestens eines Filters, dass der Alias ist für die externe Verwendung vorgesehen, daher ist der Standardwert"true"
. android:icon
- Ein Symbol für die Zielaktivität, wenn es Nutzern über den Alias angezeigt wird.
Weitere Informationen findest du in den
<activity>
-Elementenicon
-Attribut. android:label
- Ein für Nutzer lesbares Label für den Alias, das Nutzern über den Alias angezeigt wird.
Weitere Informationen findest du in den
<activity>
-Elementenlabel
-Attribut. android:name
- Ein eindeutiger Name für den Alias. Der Name ähnelt einer qualifizierter Klassenname. Aber im Gegensatz zum Namen der Zielaktivität Der Aliasname ist beliebig. Es bezieht sich nicht auf eine tatsächliche Klasse.
android:permission
- Der Name einer Berechtigung, die Kunden haben müssen, um die Zielaktivität zu starten
oder mithilfe des Alias eine Aktion ausführen lassen. Wenn ein Aufrufer von
startActivity()
oderstartActivityForResult()
die angegebene Berechtigung nicht gewährt wird, ist die Zielaktivität nicht aktiviert.Dieses Attribut ersetzt alle Berechtigungen, die für die Zielaktivität selbst festgelegt wurden. Wenn nicht festgelegt ist, ist keine Berechtigung erforderlich, um das Ziel über den Alias zu aktivieren.
Weitere Informationen zu Berechtigungen finden Sie in der Berechtigungen in der App-Manifestübersicht.
android:targetActivity
- Der Name der Aktivität, die über den Alias aktiviert werden kann.
Dieser Name muss mit dem Attribut
name
einer<activity>
-Element vor Alias im Manifest.
- eingeführt in:
- API-Level 1
- Siehe auch:
<activity>
<Aktivitätsalias>
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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)"]]