<alias-attività>

:
<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>
contenuto in:
<application>
può contenere:
<intent-filter>
<meta-data>
description:
Un alias per un'attività, denominato dall'attributo targetActivity. La destinazione deve trovarsi nella stessa applicazione dell'alias e deve essere dichiarata prima dell'alias nel file manifest.

L'alias presenta l'attività target come un'entità indipendente e può avere il proprio set di filtri per intent. Invece di applicare filtri di intent in base all'attività di destinazione, determinano quali intent possono attivare la destinazione tramite l'alias e in che modo il sistema tratta l'alias.

Ad esempio, i filtri per intent sull'alias potrebbero specificare i flag "android.intent.action.MAIN" e "android.intent.category.LAUNCHER", rendendoli così rappresentati in Avvio applicazioni, anche se nessuno dei filtri nell'attività di destinazione stessa imposta questi flag.

Ad eccezione di targetActivity, gli attributi <activity-alias> sono un sottoinsieme di attributi <activity>. Per gli attributi nel sottoinsieme, nessuno dei valori impostati per la destinazione viene trasferito all'alias. Tuttavia, per gli attributi non nel sottoinsieme, i valori impostati per l'attività target si applicano anche all'alias.

:
android:enabled
Indica se il sistema può creare un'istanza dell'attività target tramite questo alias. "true" se può esserlo e "false" in caso contrario. Il valore predefinito è "true".

L'elemento <application> ha il proprio attributo enabled che si applica a tutti i componenti dell'applicazione, inclusi gli alias attività. Gli attributi <application> e <activity-alias> devono essere entrambi "true" affinché il sistema sia in grado di creare un'istanza dell'attività di destinazione tramite l'alias. Se uno dei due è "false", l'alias non funziona.

android:exported
Indica se i componenti di altre applicazioni possono avviare l'attività di destinazione tramite questo alias. "true" se possono e "false" in caso contrario. Se "false", l'attività target può essere avviata tramite l'alias solo dai componenti della stessa applicazione dell'alias o dalle applicazioni con lo stesso ID utente.

Il valore predefinito dipende dalla presenza o meno di filtri per intent nell'alias. L'assenza di filtri significa che l'attività può essere richiamata solo tramite l'alias specificando il nome esatto dell'alias. Ciò implica che l'alias deve essere utilizzato solo per uso interno all'applicazione, in quanto gli altri utenti non ne conoscono il nome. Pertanto, il valore predefinito è "false". D'altra parte, la presenza di almeno un filtro implica che l'alias è destinato a un uso esterno, quindi il valore predefinito è "true".

android:icon
Un'icona dell'attività target quando viene presentata agli utenti tramite l'alias. Per ulteriori informazioni, consulta l'attributo icon dell'elemento <activity>.
android:label
Un'etichetta leggibile per l'alias quando viene presentata agli utenti tramite l'alias. Per ulteriori informazioni, consulta l'attributo label dell'elemento <activity>.

android:name
Un nome univoco per l'alias. Il nome assomiglia a un nome completo della classe. Tuttavia, a differenza del nome dell'attività di destinazione, il nome dell'alias è arbitrario. non si riferisce a un corso vero e proprio.

android:permission
Il nome di un'autorizzazione che i client devono avere per avviare l'attività di destinazione o per fare in modo che esegua un'azione utilizzando l'alias. Se al chiamante di startActivity() o startActivityForResult() non viene concessa l'autorizzazione specificata, l'attività target non viene attivata.

Questo attributo sostituisce qualsiasi set di autorizzazioni per l'attività target stessa. Se non è impostato, non è necessaria un'autorizzazione per attivare la destinazione tramite l'alias.

Per ulteriori informazioni sulle autorizzazioni, consulta la sezione Autorizzazioni nella panoramica del file manifest dell'app.

android:targetActivity
Il nome dell'attività che può essere attivata tramite l'alias. Questo nome deve corrispondere all'attributo name di un elemento <activity> che precede l'alias nel file manifest.

introdotto in:
Livello API 1
consulta anche:
<activity>