Langue

LauncherApps.GetActivityList(String, UserHandle) Méthode

Définition

Récupère une liste d’activités qui spécifient Intent#ACTION_MAIN et Intent#CATEGORY_LAUNCHER, dans toutes les applications, pour un utilisateur spécifié.

[Android.Runtime.Register("getActivityList", "(Ljava/lang/String;Landroid/os/UserHandle;)Ljava/util/List;", "GetGetActivityList_Ljava_lang_String_Landroid_os_UserHandle_Handler")]
public virtual System.Collections.Generic.IList<Android.Content.PM.LauncherActivityInfo>? GetActivityList(string? packageName, Android.OS.UserHandle? user);
[<Android.Runtime.Register("getActivityList", "(Ljava/lang/String;Landroid/os/UserHandle;)Ljava/util/List;", "GetGetActivityList_Ljava_lang_String_Landroid_os_UserHandle_Handler")>]
abstract member GetActivityList : string * Android.OS.UserHandle -> System.Collections.Generic.IList<Android.Content.PM.LauncherActivityInfo>
override this.GetActivityList : string * Android.OS.UserHandle -> System.Collections.Generic.IList<Android.Content.PM.LauncherActivityInfo>

Paramètres

packageName
String

Package spécifique à interroger. Si la valeur est null, elle vérifie tous les packages installés dans le profil.

user
UserHandle

UserHandle du profil.

Retours

Liste des activités pouvant être lancées. Il peut s’agir d’une liste vide, mais ne sera pas null.

Attributs

Remarques

Récupère une liste d’activités qui spécifient Intent#ACTION_MAIN et Intent#CATEGORY_LAUNCHER, dans toutes les applications, pour un utilisateur spécifié. Si une application n’a pas d’activités qui spécifient ACTION_MAIN ou CATEGORY_LAUNCHER, le système ajoute une activité synthétisée à la liste. Cette activité synthétisée représente la page des détails de l’application dans les paramètres système.

<b>Remarque : </b>Il est possible pour les applications système, telles que les magasins d’applications, d’empêcher le système d’ajouter des activités synthétisées à la liste retournée.

À compter d’Android Q, au moins une des activités de l’application ou des activités synthétisées apparaît dans la liste retournée, sauf si l’application remplit au moins l’une des conditions suivantes :

<ul><li>L’application est une application système.</li li><>L’application ne demande aucune autorisation. </li li><>L’application n’a pas d’activité<</em> de lanceur em>activée par défaut. Une activité de lanceur a une intention contenant l’action ACTION_MAIN et la CATEGORY_LAUNCHER catégorie.</li></ul>

En outre, le système masque les activités synthétisées pour certaines ou toutes les applications dans les cas d’entreprise suivants :

<ul><li>Si l’appareil est un appareil entièrement géré, aucune activité synthétisée pour une application n’apparaît dans la liste retournée.</li li>><Si l’utilisateur actuel a un profil professionnel, aucune activité synthétisée pour les applications professionnelles de l’utilisateur apparaît dans la liste retournée.</li></ul>

Si l’utilisateur en question est un profil UserManager#USER_TYPE_PROFILE_PRIVATEmasqué, l’appelant doit disposer d’autorisations normales android.Manifest.permission#ACCESS_HIDDEN_PROFILES et du android.app.role.RoleManager#ROLE_HOME rôle.

Java documentation pour android.content.pm.LauncherApps.getActivityList(java.lang.String, android.os.UserHandle).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à