<activity-alias>

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>, exceto targetActivity, 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 atributo enabled 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() ou startActivityForResult() 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>