<Aktivitätsalias>

<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>

Der Alias stellt die Zielaktivität als unabhängige Entität dar und kann eigene Intent-Filter haben. Anstelle der Intent-Filter für die Zielaktivität selbst bestimmen sie, welche Intents das Ziel über den Alias aktivieren können und wie das System den Alias behandelt.

Beispielsweise können die Intent-Filter für den Alias die Flags "android.intent.action.MAIN" und "android.intent.category.LAUNCHER" angeben, wodurch die Flags im Anwendungsstarter dargestellt werden, obwohl keiner der Filter der Zielaktivität selbst diese Flags festgelegt hat.

Mit Ausnahme von targetActivity sind <activity-alias>-Attribute eine Teilmenge von <activity>-Attributen. Bei Attributen in der Teilmenge wird keiner der für das Ziel festgelegten Werte an den Alias übernommen. Bei Attributen, die nicht in der Teilmenge enthalten sind, gelten die für die Zielaktivität festgelegten Werte jedoch auch für den Alias.

android:enabled

Gibt an, ob die Zielaktivität vom System über diesen Alias instanziiert werden kann. "true", wenn das möglich ist, und "false", wenn nicht. Der Standardwert ist "true".

Das <application>-Element hat ein eigenes enabled-Attribut, das für alle Anwendungskomponenten einschließlich Aktivitätsaliassen gilt. Die Attribute <application> und <activity-alias> müssen beide den Wert "true" haben, damit das System die Zielaktivität über den Alias instanziieren kann. Ist einer der beiden Werte "false", funktioniert der Alias nicht.

android:exported

Gibt an, ob die Komponenten anderer Anwendungen die Zielaktivität über diesen Alias starten können. "true", wenn möglich, und "false", wenn nicht. Bei "false" kann die Zielaktivität nur von Komponenten der Anwendung wie der Alias oder von Anwendungen mit derselben Nutzer-ID über den Alias gestartet werden.

Der Standardwert hängt davon ab, ob der Alias Intent-Filter enthält. Wenn keine Filter vorhanden sind, kann die Aktivität nur über den Alias aufgerufen werden, wenn der genaue Name des Alias angegeben wird. Dies impliziert, dass der Alias nur für die anwendungsinterne Verwendung bestimmt ist, da andere seinen Namen nicht kennen. Der Standardwert ist also "false". Andererseits impliziert das Vorhandensein eines Filters, dass der Alias für die externe Verwendung vorgesehen ist. Daher ist der Standardwert "true".

android:icon

Ein Symbol für die Zielaktivität, wenn sie Nutzern über den Alias angezeigt wird. Weitere Informationen finden Sie im Attribut icon des <activity>-Elements.

android:label

Ein für Nutzer lesbares Label für das Alias, das Nutzern über den Alias angezeigt wird. Weitere Informationen finden Sie im Attribut label des <activity>-Elements.

android:name

Ein eindeutiger Name für den Alias. Der Name ähnelt einem voll qualifizierten Klassennamen. Im Gegensatz zum Namen der Zielaktivität ist der Aliasname jedoch beliebig. Sie bezieht sich nicht auf eine wirkliche Klasse.

android:permission

Der Name einer Berechtigung, die Clients haben müssen, um die Zielaktivität zu starten oder etwas über den Alias zu tun. Wenn einem Aufrufer von startActivity() oder startActivityForResult() die angegebene Berechtigung nicht gewährt wird, wird die Zielaktivität nicht aktiviert.

Dieses Attribut ersetzt alle Berechtigungen, die für die Zielaktivität selbst festgelegt wurden. Wenn sie nicht festgelegt ist, ist keine Berechtigung erforderlich, um das Ziel über den Alias zu aktivieren.

Weitere Informationen zu Berechtigungen finden Sie in der App-Manifest-Übersicht im Abschnitt Berechtigungen.

android:targetActivity

Der Name der Aktivität, die über den Alias aktiviert werden kann. Dieser Name muss mit dem Attribut name eines <activity>-Elements übereinstimmen, das im Manifest vor dem Alias steht.