語言

LauncherApps.GetActivityList(String, UserHandle) 方法

定義

命名空間:
Android.Content.PM
組件:
Mono.Android.dll

取得一份指定 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

該設定檔的使用者暱稱。

傳回

IList<LauncherActivityInfo>

可發射活動列表。 可以是空清單，但不會是空的。

屬性
RegisterAttribute

備註

取得一份指定 Intent#ACTION_MAIN 和 Intent#CATEGORY_LAUNCHER的活動清單，涵蓋所有應用程式，針對指定使用者。 如果應用程式沒有指定 ACTION_MAIN 或 CATEGORY_LAUNCHER的活動，系統會將合成的活動加入清單。 這些綜合活動代表系統設定中的應用程式詳細頁面。

<b>注意： </b>系統應用程式（如應用商店）可以阻止系統將合成的活動加入返回清單。

自 Android Q 起，除非應用程式符合以下至少一項條件，否則至少會出現在回傳清單中：

<李翊><>：這個應用程式是一個系統應用程式。</li><li>這個應用程式不會要求任何權限。 </li>li 這個應用程式沒有<預設啟用的 em>啟動器<活動/em>。>< 啟動器活動包含動作與CATEGORY_LAUNCHER類別的意圖ACTION_MAIN。</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 文件 android.content.pm.LauncherApps.getActivityList(java.lang.String, android.os.UserHandle)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於