- Sintaxe:
<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>
- contido em:
<application>- pode conter:
<intent-filter><meta-data>- descrição:
- Um alias para uma atividade, nomeado pelo
atributo
targetActivity. O destino precisa estar no mesmo aplicativo que o alias e ser declarado antes do alias no manifesto.O alias apresenta a atividade de destino como uma entidade independente e pode ter o próprio conjunto de filtros de intent. Em vez de determinar os filtros de intent na própria atividade de destino, eles determinam quais intents podem ativar o destino usando o alias e de que forma o sistema trata o alias.
Por exemplo, os filtros de intent no alias podem especificar as flags
"android.intent.action.MAIN"e"android.intent.category.LAUNCHER", fazendo com que ele seja representado no inicializador do aplicativo, mesmo que nenhum dos filtros na atividade de destino defina essas flags.Os atributos
<activity-alias>, excetotargetActivity, são um subconjunto dos atributos<activity>. Em atributos do subconjunto, nenhum dos valores definidos para o destino é transferido ao alias. No entanto, para atributos que não estão no subconjunto, os valores definidos da atividade de destino também se aplicam ao alias. - Atributos:
android:enabled- Define se a atividade de destino pode ser instanciada pelo sistema usando
esse alias:
"true", se puder, ou, caso contrário,"false". O valor padrão é"true".O elemento
<application>tem o próprio atributoenabledpara todos os componentes de aplicativo, incluindo os aliases de atividade. Tanto o atributo<application>quanto o<activity-alias>precisam ser"true"para que o sistema possa instanciar a atividade de destino usando o alias. Se um deles for"false", o alias não vai funcionar. android:exported- Define se os componentes de outros aplicativos podem iniciar a atividade de destino
com esse alias:
"true", se puderem, ou, caso contrário,"false". Se o valor for"false", a atividade de destino pode ser iniciada com o alias somente por componentes do mesmo aplicativo que o alias ou aplicativos com o mesmo ID de usuário.O valor padrão depende de o alias conter ou não filtros de intents. A ausência de filtros significa que a atividade só pode ser invocada pelo alias com a especificação do nome exato dele. Isso indica que o alias se destina somente ao uso interno do aplicativo, já que outros não sabem o nome dele. Portanto, o valor padrão é
"false". Por outro lado, a presença de pelo menos um filtro implica que o alias se destina a uso externo. Assim, o valor padrão é"true". android:icon- Um ícone para a atividade de destino quando apresentado aos usuários pelo alias.
Para saber mais, consulte o atributo
icondo elemento<activity>. android:label- Rótulo legível pelo usuário para o alias quando apresentado aos usuários pelo alias.
Para saber mais, consulte o atributo
labeldo elemento<activity>. android:name- O nome exclusivo do alias. O nome é parecido com um nome de classe totalmente qualificado. No entanto, ao contrário do nome da atividade de destino, o nome do alias é arbitrário. Ele não se refere a uma classe real.
android:permission- O nome de uma permissão que os clientes precisam ter para iniciar a atividade de destino
ou conseguir que ela faça algo usando o alias. Se um autor da chamada de
startActivity()oustartActivityForResult()não receber a permissão especificada, a atividade de destino não será ativada.Esse atributo substitui qualquer conjunto de permissões para a atividade de destino em si. Se ele não for definido, não será necessária uma permissão para ativar o destino pelo alias.
Para saber mais sobre permissões, consulte a seção Permissões na visão geral do manifesto do app.
android:targetActivity- O nome da atividade que pode ser ativada pelo alias.
Esse nome precisa corresponder ao atributo
namede um elemento<activity>que precede o alias no manifesto.
- Introduzido no:
- Nível 1 da API
- confira também:
<activity>
<activity-alias>
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 2025-07-27 UTC."],[],[]]