- 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 sinalizações
"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 atributoenabled
para 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
icon
do 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
label
do 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
name
de um elemento<activity>
que precede o alias no manifesto.
- Introduzido no:
- API de nível 1
- confira também:
<activity>
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 2024-02-16 UTC.
[]
[]
{
"last_modified": "Última atualização 2024-02-16 UTC.",
"state": ""
}