Language

LauncherApps.GetActivityList(String, UserHandle) メソッド

定義

指定したユーザーのすべてのアプリで、 Intent#ACTION_MAIN と Intent#CATEGORY_LAUNCHERを指定するアクティビティの一覧を取得します。

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

パラメーター

packageName
String

クエリを実行する特定のパッケージ。 null の場合は、プロファイルにインストールされているすべてのパッケージがチェックされます。

user
UserHandle

プロファイルの UserHandle。

返品

起動可能なアクティビティの一覧。 空のリストを指定できますが、null にすることはできません。

属性

注釈

指定したユーザーのすべてのアプリで、 Intent#ACTION_MAIN と Intent#CATEGORY_LAUNCHERを指定するアクティビティの一覧を取得します。 アプリに ACTION_MAIN または CATEGORY_LAUNCHERを指定するアクティビティがない場合、システムは合成されたアクティビティを一覧に追加します。 この合成アクティビティは、システム設定内のアプリの詳細ページを表します。

<b>Note: </b>システム ストアなどのシステム アプリで、システムが合成されたアクティビティを返されたリストに追加できないようにすることができます。

Android Q の時点では、アプリが次の条件の少なくとも 1 つを満たしていない限り、返される一覧にアプリのアクティビティまたは合成されたアクティビティの少なくとも 1 つが表示されます。

<ul><li>アプリはシステム app.</li><li>アプリはアクセス許可を要求しません。 </li><li>アプリには、既定で有効になっている <em>launcher アクティビティ</em> がありません。 ランチャー アクティビティには、 ACTION_MAIN アクションと CATEGORY_LAUNCHER category.< を含む意図があります。/li></ul>

さらに、次のエンタープライズ関連のケースでは、一部またはすべてのアプリの合成アクティビティが非表示になります。

<ul><li>デバイスが フル マネージド デバイスの場合、返されたリストにアプリの合成アクティビティは表示されません</li><li>現在のユーザーが 仕事用プロファイルを持っている場合、返されたリストにユーザーの作業アプリの合成されたアクティビティは表示されません</li></ul>

問題のユーザーが非表示のプロファイル UserManager#USER_TYPE_PROFILE_PRIVATEである場合、呼び出し元には通常の android.Manifest.permission#ACCESS_HIDDEN_PROFILES アクセス許可と android.app.role.RoleManager#ROLE_HOME ロールが必要です。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象