- 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 Attributoenabled
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>
Attributoicon
. android:label
- Un'etichetta leggibile per l'alias, quando presentata agli utenti tramite l'alias.
Per ulteriori informazioni, consulta la sezione
<activity>
Attributolabel
. 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()
ostartActivityForResult()
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>
<alias-attività>
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)"]]