<alias-de-actividad>

sintaxis:

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

se incluye en:

<application>

puede contener:

<intent-filter>
<meta-data>

descripción:

Es un alias para una actividad, nombrado por el atributo targetActivity. El objetivo debe estar en la misma aplicación que el alias y debe declararse en el manifiesto antes que el alias.

El alias presenta la actividad objetivo como una entidad independiente y puede tener su propio conjunto de filtros de intents. Son estos (en lugar de los filtros de intents de la actividad objetivo) los que determinan qué intents pueden activar el objetivo mediante el alias y cómo el sistema trata el alias.

Por ejemplo, los filtros de intents en el alias podrían especificar las marcas "android.intent.action.MAIN" y "android.intent.category.LAUNCHER", lo que hace que se represente en el selector de aplicaciones, incluso si ninguno de los filtros de la actividad objetivo configuró estas marcas.

A excepción de targetActivity, los atributos <activity-alias> son un subconjunto de atributos <activity>. En el caso de los atributos del subconjunto, ninguno de los valores establecidos en el objetivo se transmite al alias. Sin embargo, en el caso de los atributos que no forman parte del subconjunto, los valores establecidos para la actividad objetivo también se aplican al alias.

atributos:

android:enabled

Determina si el sistema puede crear una instancia de la actividad objetivo mediante este alias. Es "true" si eso es posible y "false" si no lo es. El valor predeterminado es "true".

El elemento <application> tiene su propio atributo enabled que se aplica a todos los componentes de la aplicación, incluidos los alias de la actividad. Los atributos <application> y <activity-alias> deben ser "true" para que el sistema pueda crear instancias de la actividad objetivo por medio del alias. Si alguno es "false", el alias no funcionará.

android:exported

Indica si los componentes de otras aplicaciones pueden iniciar la actividad objetivo por medio de este alias. Es "true" si eso es posible y "false" si no lo es. Si es "false", solo los componentes de la misma aplicación y los alias o aplicaciones con el mismo ID de usuario pueden iniciar la actividad objetivo mediante el alias.

El valor predeterminado depende de si el alias contiene filtros de intents. La ausencia de filtros indica que la actividad solo puede invocarse mediante el alias si se especifica el nombre exacto de este, lo que significa que el alias está destinado únicamente al uso interno de la aplicación, ya que otros no conocen su nombre. Por lo tanto, el valor predeterminado es "false". Por otro lado, la presencia de al menos un filtro significa que el alias está destinado al uso externo; en consecuencia, el valor predeterminado es "true".

android:icon

Es un ícono para la actividad objetivo cuando se presenta a los usuarios por medio del alias. Para obtener más información, consulta el atributo icon del elemento <activity>.

android:label

Es una etiqueta legible por el usuario para el alias cuando se presenta a los usuarios mediante el alias. Para obtener más información, consulta el atributo label del elemento <activity>.

android:name

Es un nombre único para el alias. El nombre se asemeja a un nombre de clase completamente calificado. Pero, a diferencia del nombre de la actividad objetivo, el nombre del alias es arbitrario. No hace referencia a una clase real.

android:permission

Es el nombre de un permiso que deben tener los clientes para iniciar la actividad objetivo o que deben obtener para realizar acciones mediante el alias. Si un llamador de startActivity() o startActivityForResult() no recibe el permiso especificado, la actividad objetivo no se activa.

Este atributo reemplaza cualquier conjunto de permisos para la actividad objetivo. Si no está configurado, no se necesita un permiso para activar el objetivo mediante el alias.

Para obtener más información sobre los permisos, consulta la sección Permisos en la descripción general del manifiesto de la app.

android:targetActivity

Es el nombre de la actividad que puede activarse mediante el alias. Este nombre debe coincidir con el atributo name de un elemento <activity> que antecede al alias en el manifiesto.

primera inclusión:

Nivel de API 1

consulta también:

<activity>