<alias-activité>

Syntaxe :

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

Contenu dans :

<application>

Peut contenir :

<intent-filter>
<meta-data>

Description :

Alias d'une activité, nommé par l'attribut targetActivity. La cible doit se trouver dans la même application que et déclaré avant l'alias dans le fichier manifeste.

L'alias présente l'activité cible en tant qu'entité indépendante et peut avoir son propre ensemble d'intents des filtres. Ils, et non les les filtres d'intent sur l'activité cible elle-même, déterminer les intents peut activer la cible via l'alias et comment le système traite l'alias.

Par exemple, les filtres d'intent sur l'alias peuvent spécifiez "android.intent.action.MAIN" et "android.intent.category.LAUNCHER"" des indicateurs, ce qui entraîne dans le lanceur d'applications, même si aucun des les filtres sur l'activité cible elle-même définissent ces indicateurs.

À l'exception de targetActivity, les attributs <activity-alias> constituent un sous-ensemble des attributs <activity>. Pour les attributs du sous-ensemble, aucune des valeurs définies pour la cible ne s'applique à l'alias. Toutefois, pour les attributs qui ne font pas partie du sous-ensemble, les valeurs définies pour l'activité cible s'appliquent également à l'alias.

Attributs :

android:enabled

Indique si l'activité cible peut être instanciée par le système via cet alias. "true" si tel est le cas, et "false" dans le cas contraire. La valeur par défaut est "true".

L'élément <application> possède son propre attribut enabled qui s'applique à tous les composants d'application, y compris les alias d'activité. La <application> et <activity-alias> Les attributs doivent tous les deux être "true" pour que le système puisse être instancié l'activité cible via l'alias. Si l'une des valeurs est "false", l'alias ne fonctionne pas.

android:exported

Indique si les composants d'autres applications peuvent lancer l'activité cible. via cet alias. "true" si c'est le cas, et "false" dans le cas contraire. Si la valeur est "false", l'activité cible ne peut être lancée via l'alias qu'en de la même application que l'alias ou les applications ayant le même ID utilisateur.

La valeur par défaut varie selon que l'alias contient des filtres d'intent ou non. En l'absence de filtres, l'activité ne peut être appelée via l'alias qu'en spécifiant le nom exact de l'alias. Cela implique que l'alias est destiné uniquement à un usage interne à l’application, car les autres utilisateurs ne connaissent pas son nom. Ainsi, la valeur par défaut est "false". En revanche, la présence d'au moins un filtre implique que l'alias est destiné à un usage externe. La valeur par défaut est donc "true".

android:icon

Icône de l'activité cible lorsqu'elle est présentée aux utilisateurs via l'alias. Pour en savoir plus, consultez les éléments <activity> icon.

android:label

Libellé lisible pour l'alias lorsqu'il est présenté aux utilisateurs via l'alias. Pour en savoir plus, consultez les éléments <activity> label.

android:name

Nom unique de l'alias. Son nom ressemble à une image nom de classe qualifié. Mais, contrairement au nom de l'activité cible, le nom de l'alias est arbitraire. Il ne s'agit pas d'une classe réelle.

android:permission

Nom d'une autorisation que les clients doivent avoir pour lancer l'activité cible ou lui demander d'effectuer quelque chose en utilisant l'alias. Si un appelant de startActivity() ou startActivityForResult() ne dispose pas de l'autorisation spécifiée, l'activité cible n'est pas activée.

Cet attribut supplante toute autorisation définie pour l'activité cible elle-même. Si s'il n'est pas défini, une autorisation n'est pas nécessaire pour activer la cible via l'alias.

Pour en savoir plus sur les autorisations, consultez la Autorisations dans la présentation du fichier manifeste d'application.

android:targetActivity

Nom de l'activité pouvant être activée via l'alias. Ce nom doit correspondre à l'attribut name d'un élément <activity> qui précède l'alias dans le fichier manifeste.

Première apparition :

Niveau d'API 1

Voir aussi :

<activity>