<alias-attività>

sintassi:

<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 targetActivity . La destinazione deve trovarsi nella stessa applicazione e dichiarato prima dell'alias nel file manifest.

L'alias presenta l'attività target come un'entità indipendente e può avere il proprio insieme di intent filtri corretti. L'azienda, invece che i filtri per intent in base all'attività target stessa, determinano quali intent attivare la destinazione tramite l'alias e come il sistema gestisce l'alias.

Ad esempio, i filtri per intent sull'alias specificare "android.intent.action.MAIN" e "android.intent.category.LAUNCHER"" tramite flag, causando così un essere rappresentati in Avvio applicazioni, anche se nessuna delle i filtri in base all'attività target stessa impostano questi flag.

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

attributi:

android:enabled

Possibilità di creare un'istanza dell'attività target dal sistema 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 componenti dell'applicazione, inclusi gli alias di attività. La <application> e <activity-alias> devono essere entrambi "true" per consentire al sistema di creare un'istanza l'attività target tramite l'alias. Se uno dei due è "false", l'alias non funziona.

android:exported

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

Il valore predefinito dipende dalla presenza o meno di filtri per intent nell'alias. La l'assenza di filtri significa che l'attività può essere richiamata tramite l'alias specificando solo il nome esatto dell'alias. Ciò implica che l'alias è destinato solo all'uso interno all'applicazione, poiché gli altri 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 per l'attività target quando presentata agli utenti tramite l'alias. Per ulteriori informazioni, consulta la sezione <activity> Attributo icon.

android:label

Un'etichetta leggibile per l'alias, quando presentata agli utenti tramite l'alias. Per ulteriori informazioni, consulta la sezione <activity> Attributo label.

android:name

Un nome univoco per l'alias. Il nome ricorda un esempio nome della classe qualificato. A differenza del nome dell'attività target, il nome dell'alias è arbitrario. e non si riferisce a un corso vero e proprio.

android:permission

Il nome di un'autorizzazione di cui i clienti devono disporre per avviare l'attività target o fargli compiere un'azione usando l'alias. Se un chiamante di startActivity() o startActivityForResult() non riceve l'autorizzazione specificata, l'attività target non viene attivata.

Questo attributo sostituisce qualsiasi autorizzazione impostata per l'attività target stessa. Se non è impostato, non è necessaria un'autorizzazione per attivare il target tramite l'alias.

Per ulteriori informazioni sulle autorizzazioni, consulta 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 manifest.

introdotto in:

Livello API 1

vedi anche:

<activity>