<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 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>, 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:

Nível 1 da API

confira também:

<activity>