新聞中心
IBundleManager

public interface IBundleManagerextends IRemoteBroker獲取與應(yīng)用程序包相關(guān)的信息。
字段摘要
| 修飾符和類型 | 字段 | 描述 |
|---|---|---|
| static int | ERROR_CODE_DOWNLOAD_FAILED | 表示下載失敗 |
| static int | ERROR_CODE_INSTALL_FAILED | 表示安裝失敗 |
| static int | ERROR_CODE_QUERY_FAILED | 表示查詢失敗 |
| static int | GET_ABILITY_INFO_WITH_APPLICATION | 表示要返回的捆綁信息包括 AbilityInfo 中的應(yīng)用程序信息。 |
| static int | GET_ABILITY_INFO_WITH_PERMISSION | 表示要返回的捆綁信息包括 AbilityInfo 中的權(quán)限信息。 |
| static int | GET_APPLICATION_INFO_WITH_PERMISSION | 表示要返回的捆綁信息包括 ApplicationInfo 中的權(quán)限信息。 |
| static int | GET_BUNDLE_DEFAULT | 表示要返回的捆綁包信息不包括ability信息。 |
| static int | GET_BUNDLE_WITH_ABILITIES | 表示要返回的捆綁包信息包括能力信息。 |
| static int | GET_BUNDLE_WITH_REQUESTED_PERMISSION | 表示要返回的捆綁信息包括請(qǐng)求的權(quán)限信息。 |
| static int | PERMISSION_DENIED | 表示應(yīng)用程序沒有特定權(quán)限。 |
| static int | PERMISSION_GRANTED | 表示應(yīng)用程序已被授予特定權(quán)限。 |
| static int | QUERY_SHORTCUT_HOME | 查詢主頁(yè)快捷方式的標(biāo)志。 |
| static int | SHORTCUT_EXISTENCE_EXISTS | 表示存在快捷方式。 |
| static int | SHORTCUT_EXISTENCE_NOT_EXISTS | 表示該快捷方式不存在。 |
| static int | SHORTCUT_EXISTENCE_UNKNOW | 表示存在未知快捷方式。 |
| static int | SIGNATURE_MATCHED | 表示兩個(gè)捆綁包具有相同的簽名。 |
| static int | SIGNATURE_NOT_MATCHED | 表示兩個(gè)捆綁包具有不同的簽名。 |
| static int | SIGNATURE_UNKNOWN_BUNDLE | 表示系統(tǒng)中未安裝兩個(gè)捆綁包之一。 |
方法總結(jié)
| 修飾符和類型 | 方法 | 描述 |
|---|---|---|
| boolean | addHomeShortcut(ShortcutInfo shortcutInfo) | 添加將固定在主屏幕上的主屏幕快捷方式。 |
| int | checkPermission(String bundleName, String permission) | 檢查指定的包是否已被授予特定權(quán)限。 |
| int | checkPublicKeys(String firstBundleName, String secondBundleName) | 檢查兩個(gè)捆綁包的公鑰是否相同。 |
| void | cleanBundleCacheFiles(String bundleName, ICleanCacheCallback callback) | 清除指定應(yīng)用程序的緩存數(shù)據(jù)。 |
| void | disableHomeShortcuts(ListString shortcutIds) | 禁用不再使用的指定主屏幕快捷方式。 |
| void | enableHomeShortcuts(ListString shortcutIds) | 啟用指定的主屏幕快捷方式。 |
| int | executeBackupTask(int sessionId, String taskCmd) | 執(zhí)行備份或恢復(fù)任務(wù)。 |
| int | finishBackupSession(int sessionId) | 完成備份或恢復(fù)會(huì)話。 |
| PixelMap | getAbilityIcon(String bundleName, String className) | 獲取指定ability的圖標(biāo)。 |
| String | getAbilityLabel(String bundleName, String className) | 獲取指定ability的標(biāo)簽。 |
| default ListFormInfo | getAllForms() | 已棄用。 請(qǐng)改用 getAllFormsInfo()。 |
| ListFormInfo | getAllFormsInfo() | 獲取設(shè)備上所有ohos應(yīng)用提供的FormInfo對(duì)象。 |
| OptionalListPermissionGroupDef | getAllPermissionGroupDefs() | 獲取系統(tǒng)中所有已知的權(quán)限組。 |
| ApplicationInfo | getApplicationInfo(String bundleName, int flags, int userId) | 根據(jù)給定的包名稱獲取 ApplicationInfo。 |
| ListApplicationInfo | getApplicationInfos(int flags, int userId) | 獲取指定用戶的所有已安裝應(yīng)用程序的信息。 |
| ListString | getAppsGrantedPermissions(String[] permissions) | 獲取具有指定權(quán)限的應(yīng)用程序列表。 |
| String | getAppType(String bundleName) | 根據(jù)給定的包名稱獲取指定應(yīng)用程序的類型。 |
| BundleInfo | getBundleArchiveInfo(String hapFilePath, int flags) | 獲取有關(guān) ohos ability包 (HAP) 中包含的應(yīng)用程序包的信息。 |
| int[] | getBundleGids(String bundleName) | 獲取與指定捆綁包關(guān)聯(lián)的所有組 ID 的數(shù)組。 |
| BundleInfo | getBundleInfo(String bundleName, int flags) | 根據(jù)給定的包名稱獲取 BundleInfo。 |
| BundleInfo | getBundleInfo(String networkId, String bundleName, int flags) | 根據(jù)給定的 networkId 和包名稱獲取 BundleInfo。 |
| ListBundleInfo | getBundleInfos(int flags) | 獲取系統(tǒng)中所有可用捆綁包的 BundleInfo。 |
| IBundleInstaller | getBundleInstaller() | 獲取用于安裝 bundle 的接口。 |
| ListString | getBundlesForUid(int uid) | 根據(jù)給定的應(yīng)用程序 UID 獲取指定應(yīng)用程序的所有捆綁包名稱。 |
| boolean | getClearUserDataFlag(String bundleName, String moduleName) | 根據(jù)給定的包名稱獲取指定應(yīng)用程序的類型。 |
| default ListFormInfo | getFormsByApp(String bundleName) | 已棄用。 請(qǐng)改用 getFormsInfoByApp(java.lang.String) 。 |
| default ListFormInfo | getFormsByModule(String bundleName, String moduleName) | 已棄用。 請(qǐng)改用 getFormsInfoByModule(java.lang.String,java.lang.String) 。 |
| ListFormInfo | getFormsInfoByApp(String bundleName) | 獲取設(shè)備上指定的ohos應(yīng)用提供的FormInfo對(duì)象。 |
| ListFormInfo | getFormsInfoByModule(String bundleName, String moduleName) | 獲取設(shè)備上指定應(yīng)用模塊提供的FormInfo對(duì)象。 |
| ListShortcutInfo | getHomeShortcutInfos() | 獲取所有主屏幕快捷方式。 |
| Intent | getLaunchIntentForBundle(String bundleName) | 根據(jù)給定的包名稱獲取啟動(dòng)應(yīng)用程序主要功能的意圖。 |
| AbilityInfo | getModuleMainAbility(String bundleName, String moduleName) | 通過 bundleName 和 moduleName 獲取 mainAbility 信息。 |
| String | getNameForUid(int uid) | 獲取與給定 UID 關(guān)聯(lián)的正式名稱。 |
| PermissionDef | getPermissionDef(String permissionName) | 獲取指定權(quán)限的詳細(xì)信息。 |
| OptionalListPermissionDef | getPermissionDefByGroup(String permissionGroupName) | 獲取指定權(quán)限組中所有權(quán)限的信息。 |
| OptionalPermissionGroupDef | getPermissionGroupDef(String permissionGroupName) | 獲取指定權(quán)限組的信息。 |
| ListShortcutInfo | getShortcutInfos(String bundleName) | 獲取有關(guān)應(yīng)用程序快捷方式的信息。 |
| ListString | getSystemAvailableCapabilities() | 獲取系統(tǒng)中可用的ability。 |
| int | getUidByBundleName(String bundleName, int userId) | 根據(jù)給定的包名稱和用戶 ID 獲取應(yīng)用程序 UID。 |
| boolean | hasSystemCapability(String name) | 檢查系統(tǒng)是否具有指定的ability。 |
| boolean | isAbilityEnabled(AbilityInfo abilityInfo) | 檢查是否啟用了指定的ability。 |
| boolean | isApplicationEnabled(String bundleName) | 檢查是否啟用了指定的應(yīng)用程序。 |
| boolean | isHomeShortcutSupported() | 檢查是否可以將快捷方式添加到應(yīng)用程序所在的主屏幕。 |
| boolean | isSafeMode() | 檢查當(dāng)前設(shè)備是否已在安全模式下啟動(dòng)。 |
| boolean | isShortcutExist(String shortcutId) | 檢查指定的快捷方式是否可用。 |
| int | isShortcutExist(String shortcutId, int flag) | 檢查指定的快捷方式是否可用。 |
| ListAbilityInfo | queryAbilityByIntent(Intent intent, int flags, int userId) | 根據(jù)給定的意圖查詢所有 AbilityInfo 信息。 |
| void | registerAllPermissionsChanged(IRemoteObject callback) | 注冊(cè)一個(gè)回調(diào)來(lái)監(jiān)聽所有 UID 的權(quán)限變化。 |
| void | registerPermissionsChanged(int[] uids, IRemoteObject callback) | 注冊(cè)一個(gè)回調(diào),用于監(jiān)聽指定 UID 的權(quán)限變化。 |
| void | setAbilityEnabled(AbilityInfo abilityInfo, boolean isEnabled) | 設(shè)置是否啟用指定的能力。 |
| void | setApplicationEnabled(String bundleName, boolean isEnabled) | 設(shè)置是否啟用指定的應(yīng)用程序。 |
| boolean | setClearUserDataFlag(String packageName, boolean flag) | 根據(jù)給定的包名稱獲取指定應(yīng)用程序的類型。 |
| boolean | setFormEnabled(FormBaseInfo baseInfo, boolean isEnabled) | 設(shè)置表單啟用或禁用。 |
| int | startBackupSession(IBackupSessionCallback callback) | 啟動(dòng)備份或恢復(fù)會(huì)話。 |
| void | startShortcut(String shortcutId, String bundleName) | 根據(jù)給定的快捷方式 ID 和包名稱啟動(dòng)快捷方式。 |
| void | unregisterPermissionsChanged(IRemoteObject callback) | 取消注冊(cè)指定的回調(diào)以偵聽權(quán)限更改。 |
| boolean | updateShortcuts(ListShortcutInfo shortcutInfos) | 更新有關(guān)已添加的指定主屏幕快捷方式的信息。 |
| 從接口 ohos.rpc.IRemoteBroker 繼承的方法 |
|---|
| asObject |
字段詳細(xì)信息
ERROR_CODE_DOWNLOAD_FAILED
static final int ERROR_CODE_DOWNLOAD_FAILED
表示下載失敗
ERROR_CODE_INSTALL_FAILED
static final int ERROR_CODE_INSTALL_FAILED
表示安裝失敗
ERROR_CODE_QUERY_FAILED
static final int ERROR_CODE_QUERY_FAILED
表示查詢失敗
GET_ABILITY_INFO_WITH_APPLICATION
static final int GET_ABILITY_INFO_WITH_APPLICATION
表示要返回的捆綁信息包括 AbilityInfo 中的應(yīng)用程序信息。
值為 0x00000004。
GET_ABILITY_INFO_WITH_PERMISSION
static final int GET_ABILITY_INFO_WITH_PERMISSION
表示要返回的捆綁信息包括 AbilityInfo 中的權(quán)限信息。
值為 0x00000002。
GET_APPLICATION_INFO_WITH_PERMISSION
static final int GET_APPLICATION_INFO_WITH_PERMISSION
表示要返回的捆綁信息包括 ApplicationInfo 中的權(quán)限信息。
值為 0x00000008。
GET_BUNDLE_DEFAULT
static final int GET_BUNDLE_DEFAULT
表示要返回的捆綁包信息不包括ability信息。
值為 0x00000000。
GET_BUNDLE_WITH_ABILITIES
static final int GET_BUNDLE_WITH_ABILITIES
表示要返回的捆綁包信息包括ability信息。
值為 0x00000001。
GET_BUNDLE_WITH_REQUESTED_PERMISSION
static final int GET_BUNDLE_WITH_REQUESTED_PERMISSION
表示要返回的捆綁信息包括請(qǐng)求的權(quán)限信息。
值為 0x00000010。
PERMISSION_DENIED
static final int PERMISSION_DENIED
表示應(yīng)用程序沒有特定權(quán)限。
權(quán)限檢查時(shí),如果應(yīng)用程序沒有特定權(quán)限或其他原因檢查失敗,則返回該值。
PERMISSION_GRANTED
static final int PERMISSION_GRANTED
表示應(yīng)用程序已被授予特定權(quán)限。
在權(quán)限檢查時(shí),如果應(yīng)用程序已經(jīng)擁有特定權(quán)限,則返回此值。 否則,返回 PERMISSION_DENIED。
QUERY_SHORTCUT_HOME
static final int QUERY_SHORTCUT_HOME
查詢主頁(yè)快捷方式的標(biāo)志。
SHORTCUT_EXISTENCE_EXISTS
static final int SHORTCUT_EXISTENCE_EXISTS
表示存在快捷方式。
SHORTCUT_EXISTENCE_NOT_EXISTS
static final int SHORTCUT_EXISTENCE_NOT_EXISTS
表示該快捷方式不存在。
SHORTCUT_EXISTENCE_UNKNOW
static final int SHORTCUT_EXISTENCE_UNKNOW
表示存在未知快捷方式。
SIGNATURE_MATCHED
static final int SIGNATURE_MATCHED
表示兩個(gè)捆綁包具有相同的簽名。
SIGNATURE_NOT_MATCHED
static final int SIGNATURE_NOT_MATCHED
表示兩個(gè)捆綁包具有不同的簽名。
SIGNATURE_UNKNOWN_BUNDLE
static final int SIGNATURE_UNKNOWN_BUNDLE
表示系統(tǒng)中未安裝兩個(gè)捆綁包之一。
方法詳情
getBundleInfo
BundleInfo getBundleInfo(String bundleName, int flags) throws RemoteException
根據(jù)給定的包名稱獲取 BundleInfo。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 權(quán)限。 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限為簽名|特權(quán)級(jí)別, ohos.permission.GET_BUNDLE_INFO 權(quán)限為普通級(jí)別。
要返回的 BundleInfo 對(duì)象中包含的信息取決于 flags 參數(shù)的值。
- 0x00000000: 返回基本的 BundleInfo 對(duì)象。
- 0x00000001: 返回指定了ability信息的 BundleInfo 對(duì)象。
- Other value: 返回與 0x00000000 相同的結(jié)果。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示要查詢的應(yīng)用程序包名稱。 |
| flags | 指示用于指定將返回的 BundleInfo 中包含的信息的標(biāo)志。 |
返回:
返回 BundleInfo 對(duì)象。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
getBundleInfo
BundleInfo getBundleInfo(String networkId, String bundleName, int flags) throws RemoteException
根據(jù)給定的 networkId 和包名稱獲取 BundleInfo。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 權(quán)限。 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限為簽名|特權(quán)級(jí)別, ohos.permission.GET_BUNDLE_INFO 權(quán)限為普通級(jí)別。
要返回的 BundleInfo 對(duì)象中包含的信息取決于 flags 參數(shù)的值。
- 0x00000000: 返回基本的 BundleInfo 對(duì)象。
- 0x00000001: 返回指定了ability信息的 BundleInfo 對(duì)象。
- Other value: 返回與 0x00000000 相同的結(jié)果。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| networkId | 表示局域網(wǎng)中的設(shè)備networkId。 |
| bundleName | 指示要查詢的應(yīng)用程序包名稱。 |
| flags | 指示用于指定將返回的 BundleInfo 中包含的信息的標(biāo)志。 |
返回:
返回 BundleInfo 對(duì)象。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
getBundleInstaller
IBundleInstaller getBundleInstaller() throws RemoteException
獲取用于安裝 bundle 的接口。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.INSTALL_BUNDLE 權(quán)限。
返回:
返回 IBundleInstaller 接口。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
getApplicationInfo
ApplicationInfo getApplicationInfo(String bundleName, int flags, int userId) throws RemoteException
根據(jù)給定的包名稱獲取 ApplicationInfo。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 權(quán)限。 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限為簽名|特權(quán)級(jí)別, ohos.permission.GET_BUNDLE_INFO 權(quán)限為普通級(jí)別。
要返回的 ApplicationInfo 對(duì)象中包含的信息取決于 flags 參數(shù)的值。
- 0x00000000: 返回基本的 ApplicationInfo 對(duì)象。
- 0x00000008: 返回具有指定權(quán)限的 ApplicationInfo 對(duì)象。
- Other value: 返回與 0x00000000 相同的結(jié)果。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示要查詢的應(yīng)用程序包名稱。 |
| flags | 指示用于指定將返回的 ApplicationInfo 對(duì)象中包含的信息的標(biāo)志。 |
| userId | 表示用戶標(biāo)識(shí) |
返回:
返回 ApplicationInfo 對(duì)象。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
checkPermission
int checkPermission(String bundleName, String permission)
檢查指定的包是否已被授予特定權(quán)限。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示要檢查的捆綁包的名稱。 |
| permission | 表示檢查的權(quán)限。 |
返回:
如果 bundle 有權(quán)限,則返回 0; 否則返回 -1。
queryAbilityByIntent
ListAbilityInfo queryAbilityByIntent(Intent intent, int flags, int userId) throws RemoteException
根據(jù)給定的意圖查詢所有 AbilityInfo 信息。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 權(quán)限。 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限為簽名|特權(quán)級(jí)別, ohos.permission.GET_BUNDLE_INFO 權(quán)限為普通級(jí)別。
要返回的 AbilityInfo 對(duì)象中包含的信息取決于 flags 參數(shù)的值。
- 0x00000000: 返回基本 AbilityInfo 對(duì)象。
- 0x00000002: 返回具有指定權(quán)限的 AbilityInfo 對(duì)象。
- 0x00000004: 返回指定 applicationInfo 的 AbilityInfo 對(duì)象。
- Other value: 返回與 0x00000000 相同的結(jié)果。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| intent | 指示包含要查詢的應(yīng)用程序包名稱的 Intent。 |
| flags | 指示用于指定將返回的 AbilityInfo 對(duì)象中包含的信息的標(biāo)志。 |
| userId | 表示用戶標(biāo)識(shí) |
返回:
返回 AbilityInfo 對(duì)象的列表。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
getBundleInfos
ListBundleInfo getBundleInfos(int flags) throws RemoteException
獲取系統(tǒng)中所有可用捆綁包的 BundleInfo。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限。 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限屬于簽名|特權(quán)級(jí)別。
要返回的 BundleInfo 對(duì)象中包含的信息取決于 flags 參數(shù)的值。
- 0x00000000: 返回基本的 BundleInfo 對(duì)象。
- 0x00000001: 返回具有指定ability信息的 BundleInfo 對(duì)象。
- Other value: 返回與 0x00000000 相同的結(jié)果。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| flags | 指示用于指定將返回的 BundleInfo 中包含的信息的標(biāo)志。 |
返回:
返回 BundleInfo 對(duì)象的列表。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
getUidByBundleName
int getUidByBundleName(String bundleName, int userId) throws RemoteException
根據(jù)給定的包名稱和用戶 ID 獲取應(yīng)用程序 UID。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 權(quán)限。 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限為簽名|特權(quán)級(jí)別, ohos.permission.GET_BUNDLE_INFO 權(quán)限為普通級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示應(yīng)用程序的捆綁包名稱。 |
| userId | 表示用戶標(biāo)識(shí) |
Returns:
返回應(yīng)用程序的UID
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
getBundlesForUid
ListString getBundlesForUid(int uid) throws RemoteException
根據(jù)給定的應(yīng)用程序 UID 獲取指定應(yīng)用程序的所有捆綁包名稱。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限。 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限屬于簽名|特權(quán)級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| uid | 表示應(yīng)用程序UID |
返回:
返回捆綁包名稱的列表。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
registerAllPermissionsChanged
void registerAllPermissionsChanged(IRemoteObject callback) throws RemoteException
注冊(cè)一個(gè)回調(diào)來(lái)監(jiān)聽所有 UID 的權(quán)限變化。
調(diào)用此方法后,當(dāng)任何 UID 的權(quán)限發(fā)生變化時(shí),都會(huì)通知調(diào)用者。 您可以調(diào)用 unregisterPermissionsChanged(ohos.rpc.IRemoteObject) 取消注冊(cè)監(jiān)聽器。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.LISTEN_PERMISSION_CHANGE 權(quán)限。 ohos.permission.LISTEN_PERMISSION_CHANGE 權(quán)限屬于簽名|特權(quán)級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| callback | 表示要注冊(cè)的回調(diào)方法。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
registerPermissionsChanged
void registerPermissionsChanged(int[] uids, IRemoteObject callback) throws RemoteException
注冊(cè)一個(gè)回調(diào),用于監(jiān)聽指定 UID 的權(quán)限變化。
調(diào)用該方法后,當(dāng)給定UID的權(quán)限發(fā)生變化時(shí),會(huì)通知調(diào)用者。 您可以調(diào)用 unregisterPermissionsChanged(ohos.rpc.IRemoteObject) 取消注冊(cè)監(jiān)聽器。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.LISTEN_PERMISSION_CHANGE 權(quán)限。 ohos.permission.LISTEN_PERMISSION_CHANGE 權(quán)限屬于簽名|特權(quán)級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| uids | 表示將監(jiān)控其權(quán)限更改的UID列表。 |
| callback | 表示要注冊(cè)的回調(diào)方法。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
unregisterPermissionsChanged
void unregisterPermissionsChanged(IRemoteObject callback) throws RemoteException
取消注冊(cè)指定的回調(diào)以偵聽權(quán)限更改。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.LISTEN_PERMISSION_CHANGE 權(quán)限。 ohos.permission.LISTEN_PERMISSION_CHANGE 權(quán)限屬于簽名|特權(quán)級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| callback | 表示要注銷的回調(diào)方法。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
getApplicationInfos
ListApplicationInfo getApplicationInfos(int flags, int userId) throws RemoteException
獲取指定用戶的所有已安裝應(yīng)用程序的信息。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_OTHER_USERS_BUNDLE_INFO 或 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限。 ohos.permission.GET_OTHER_USERS_BUNDLE_INFO 權(quán)限為普通級(jí)別, ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限為簽名|特權(quán)級(jí)別。
要返回的 ApplicationInfo 對(duì)象中包含的信息取決于 flags 參數(shù)的值。
- 0x00000000: 返回基本的 ApplicationInfo 對(duì)象。
- 0x00000008: 返回具有指定權(quán)限的 ApplicationInfo 對(duì)象。
- Other value: 返回與 0x00000000 相同的結(jié)果。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| flags | 指示用于指定將返回的 ApplicationInfo 對(duì)象中包含的信息的標(biāo)志。 |
| userId | 表示用戶標(biāo)識(shí) |
返回:
返回 ApplicationInfo 對(duì)象的列表。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
getSystemAvailableCapabilities
ListString getSystemAvailableCapabilities()
獲取系統(tǒng)中可用的能力。
返回:
返回系統(tǒng)中可用功能的列表。
hasSystemCapability
boolean hasSystemCapability(String name)
檢查系統(tǒng)是否具有指定的能力。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| name | 指示要檢查的系統(tǒng)功能的名稱。 |
返回:
如果 name 指定的給定功能在系統(tǒng)中可用,則返回 true; 否則返回 false。
getBundleGids
int[] getBundleGids(String bundleName)
獲取與指定捆綁包關(guān)聯(lián)的所有組 ID 的數(shù)組。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示應(yīng)用程序的捆綁包名稱。 |
返回:
返回一個(gè) int 數(shù)組,其中包含與指定捆綁包關(guān)聯(lián)的組 ID。
checkPublicKeys
int checkPublicKeys(String firstBundleName, String secondBundleName) throws RemoteException
檢查兩個(gè)捆綁包的公鑰是否相同。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_OTHER_USERS_BUNDLE_INFO 權(quán)限。 ohos.permission.GET_OTHER_USERS_BUNDLE_INFO 權(quán)限為正常級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| firstBundleName | 指示要比較的捆綁包的名稱。 |
| secondBundleName | 指示要比較的另一個(gè)捆綁包的名稱。 |
返回:
如果未找到至少一個(gè)給定的捆綁包,則返回 SIGNATURE_UNKNOWN_BUNDLE; 如果它們的公鑰不同,則返回 SIGNATURE_NOT_MATCHED; 如果它們的公鑰相同,則返回 SIGNATURE_MATCHED。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
getNameForUid
String getNameForUid(int uid) throws RemoteException
獲取與給定 UID 關(guān)聯(lián)的正式名稱。 正式名稱永遠(yuǎn)不會(huì)改變,但 UID 可以。 因此,如果要存儲(chǔ)有關(guān) UID 的信息,則應(yīng)存儲(chǔ)其正式名稱而不是原始 UID。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| uid | 表示應(yīng)用程序的UID。 |
返回:
如果在 config.json 文件中配置了 shared-userid,則以 shared-userid:uid 格式返回與 UID 關(guān)聯(lián)的唯一名稱; 否則返回包名。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
getBundleArchiveInfo
BundleInfo getBundleArchiveInfo(String hapFilePath, int flags)
獲取有關(guān) ohos ability包 (HAP) 中包含的應(yīng)用程序包的信息。
要返回的 BundleInfo 對(duì)象中包含的信息取決于 flags 參數(shù)的值。
- 0x00000000: 返回基本的 BundleInfo 對(duì)象。
- 0x00000001: 返回指定了ability信息的 BundleInfo 對(duì)象。
- Other value: 返回與 0x00000000 相同的結(jié)果。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| hapFilePath | HAP存儲(chǔ)路徑。 路徑應(yīng)該是當(dāng)前應(yīng)用程序數(shù)據(jù)目錄的相對(duì)路徑。 |
| flags | 指示用于指定要返回的 BundleInfo 對(duì)象中包含的信息的標(biāo)志。 |
返回:
返回 BundleInfo 對(duì)象。
isSafeMode
boolean isSafeMode()
檢查當(dāng)前設(shè)備是否已在安全模式下啟動(dòng)。
返回:
如果設(shè)備處于安全模式,則返回 true; 否則返回 false。
getLaunchIntentForBundle
Intent getLaunchIntentForBundle(String bundleName) throws RemoteException
根據(jù)給定的包名稱獲取啟動(dòng)應(yīng)用程序主要功能的意圖。 應(yīng)用程序的主要ability是在應(yīng)用程序的 config.json 文件中設(shè)置 Intent.ACTION_HOME 和 Intent.ENTITY_HOME intent過濾器的ability。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限。 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限屬于簽名|特權(quán)級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示應(yīng)用程序的捆綁包名稱。 |
返回:
返回啟動(dòng)應(yīng)用程序主要ability的intent(如果有); 如果給定的捆綁包不存在或不包含任何主要ability,則返回 null。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
setApplicationEnabled
void setApplicationEnabled(String bundleName, boolean isEnabled) throws IllegalArgumentException
設(shè)置是否啟用指定的應(yīng)用程序。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.CHANGE_ABILITY_ENABLED_STATE 權(quán)限。 ohos.permission.CHANGE_ABILITY_ENABLED_STATE 權(quán)限屬于簽名|特權(quán)級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示應(yīng)用程序的捆綁包名稱。 |
| isEnabled | 指定是否啟用應(yīng)用程序。 值 true 表示啟用它,值 false 表示禁用它。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果給定的包不存在,則拋出此異常。 |
| SecurityException | 引發(fā)此異常以指示安全違規(guī)。 |
setAbilityEnabled
void setAbilityEnabled(AbilityInfo abilityInfo, boolean isEnabled) throws IllegalArgumentException
設(shè)置是否啟用指定的ability。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.CHANGE_ABILITY_ENABLED_STATE 權(quán)限。 ohos.permission.CHANGE_ABILITY_ENABLED_STATE 權(quán)限屬于簽名|特權(quán)級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| abilityInfo | 表示有關(guān)設(shè)置ability的信息。 |
| isEnabled | 指定是否啟用該ability。 值 true 表示啟用它,值 false 表示禁用它。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果給定的ability不存在,則拋出此異常。 |
| SecurityException | 引發(fā)此異常以指示安全違規(guī)。 |
isApplicationEnabled
boolean isApplicationEnabled(String bundleName) throws IllegalArgumentException
檢查是否啟用了指定的應(yīng)用程序。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示應(yīng)用程序的捆綁包名稱。 |
返回:
如果應(yīng)用程序已啟用,則返回 true; 否則返回 false。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果給定的包不存在,則拋出此異常。 |
isAbilityEnabled
boolean isAbilityEnabled(AbilityInfo abilityInfo) throws IllegalArgumentException
檢查是否啟用了指定的ability。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| abilityInfo | 表示有關(guān)檢查ability的信息。 |
返回:
如果啟用該能力,則返回 true; 否則返回 false。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果給定的ability不存在,則拋出此異常。 |
startBackupSession
int startBackupSession(IBackupSessionCallback callback)
啟動(dòng)備份或恢復(fù)會(huì)話。 應(yīng)該在執(zhí)行備份或恢復(fù)任務(wù)之前調(diào)用此方法。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| callback | 指示用于通知應(yīng)用程序備份或恢復(fù)任務(wù)狀態(tài)的IBackupSessionCallback。 |
返回:
如果會(huì)話成功啟動(dòng),則返回一個(gè)正整數(shù),用作進(jìn)一步任務(wù)處理的會(huì)話 ID; 如果發(fā)生常見故障,則返回 -1;如果您的應(yīng)用程序無(wú)權(quán)調(diào)用此方法,則返回 -2。
executeBackupTask
int executeBackupTask(int sessionId, String taskCmd)
執(zhí)行備份或恢復(fù)任務(wù)。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| sessionId | 指示備份或恢復(fù)任務(wù)的會(huì)話 ID。 |
| taskCmd | 指示要執(zhí)行的任務(wù)命令。 |
返回:
任務(wù)啟動(dòng)成功返回0; 如果發(fā)生常見故障,則返回 -1; 如果您的應(yīng)用程序無(wú)權(quán)調(diào)用此方法,則返回 -2; 如果不支持任務(wù)命令,則返回 -3;如果已發(fā)出任務(wù)命令,則返回 -4。
finishBackupSession
int finishBackupSession(int sessionId)
完成備份或恢復(fù)會(huì)話。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| sessionId | 指示要完成的會(huì)話的 ID。 |
返回:
如果會(huì)話成功結(jié)束,則返回 0; 如果發(fā)生常見故障,則返回 -1; 如果您的應(yīng)用程序無(wú)權(quán)調(diào)用此方法,則返回 -2。
getShortcutInfos
ListShortcutInfo getShortcutInfos(String bundleName) throws RemoteException
獲取有關(guān)應(yīng)用程序快捷方式的信息。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_OTHER_USERS_BUNDLE_INFO 和 ohos.permission.MANAGE_SHORTCUTS 權(quán)限。 ohos.permission.GET_OTHER_USERS_BUNDLE_INFO 權(quán)限為普通級(jí)別, ohos.permission.MANAGE_SHORTCUTS 權(quán)限為簽名級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示應(yīng)用程序的捆綁包名稱。 |
返回:
返回包含有關(guān)應(yīng)用程序的快捷方式信息的 ShortcutInfo 對(duì)象列表。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
getPermissionDef
PermissionDef getPermissionDef(String permissionName)
獲取指定權(quán)限的詳細(xì)信息。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| permissionName | 表示 ohos 權(quán)限的名稱。 |
返回:
返回包含有關(guān)給定 ohos 權(quán)限的詳細(xì)信息的 PermissionDef 對(duì)象。
getPermissionGroupDef
OptionalPermissionGroupDef getPermissionGroupDef(String permissionGroupName)
獲取指定權(quán)限組的信息。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| permissionGroupName | 權(quán)限組名稱 |
返回:
返回包含有關(guān)給定權(quán)限組的詳細(xì)信息的 PermissionGroupDef 對(duì)象。
getPermissionDefByGroup
OptionalListPermissionDef getPermissionDefByGroup(String permissionGroupName)
獲取指定權(quán)限組中所有權(quán)限的信息。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| permissionGroupName | 權(quán)限組名稱 |
返回:
返回 PermissionDef 對(duì)象,其中包含有關(guān)給定權(quán)限組中所有權(quán)限的詳細(xì)信息。
cleanBundleCacheFiles
void cleanBundleCacheFiles(String bundleName, ICleanCacheCallback callback)
清除指定應(yīng)用程序的緩存數(shù)據(jù)。
要使用此方法,您的應(yīng)用程序必須已獲得 ohos.permission.REMOVE_CACHE_FILES 權(quán)限。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 表示要清除緩存數(shù)據(jù)的應(yīng)用的bundle名稱。 |
| callback | 表示為返回操作結(jié)果而調(diào)用的回調(diào)。 有關(guān)詳細(xì)信息,請(qǐng)參閱 ICleanCacheCallback。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
startShortcut
void startShortcut(String shortcutId, String bundleName) throws RemoteException
根據(jù)給定的快捷方式 ID 和包名稱啟動(dòng)快捷方式。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.MANAGE_SHORTCUTS 權(quán)限。 ohos.permission.MANAGE_SHORTCUTS 權(quán)限屬于簽名級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| shortcutId | 指示要啟動(dòng)的快捷方式的 ID。 |
| bundleName | BundleName 表示快捷方式所屬的應(yīng)用程序的包名。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 如果您的應(yīng)用程序沒有所需的權(quán)限,則引發(fā)此異常。 |
getAppType
String getAppType(String bundleName) throws RemoteException
根據(jù)給定的包名稱獲取指定應(yīng)用程序的類型。
要使用此方法,您需要向系統(tǒng)請(qǐng)求 ohos.permission.GET_OTHER_USERS_BUNDLE_INFO 權(quán)限。 ohos.permission.GET_OTHER_USERS_BUNDLE_INFO 權(quán)限為正常級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示應(yīng)用程序的捆綁包名稱。 |
返回:
如果應(yīng)用程序是系統(tǒng)應(yīng)用程序,則返回系統(tǒng); 如果在 Ohos AppGallery 中發(fā)布,則返回正常; 如果由第三方供應(yīng)商發(fā)布,則返回其他; 如果查詢失敗,則返回一個(gè)空字符串。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
isShortcutExist
int isShortcutExist(String shortcutId, int flag)
檢查指定的快捷方式是否可用。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| shortcutId | 表示要檢查的快捷方式的ID。 |
| flag | 指示要檢查的快捷方式的類型。 目前,只有主屏幕快捷方式 IBundleManager#QUERY_SHORTCUT_HOME 可用。 |
返回:
如果指定的快捷方式可用,則返回 IBundleManager#SHORTCUT_EXISTENCE_EXISTS; 如果不可用,則返回 IBundleManager#SHORTCUT_EXISTENCE_NOT_EXISTS; 如果發(fā)生錯(cuò)誤,則返回 IBundleManager.SHORTCUT_EXISTENCE_UNKNOW。
isShortcutExist
boolean isShortcutExist(String shortcutId)
檢查指定的快捷方式是否可用。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| shortcutId | 表示要檢查的快捷方式的ID。 |
返回:
如果指定的快捷方式可用,則返回 true; 否則返回 false。
isHomeShortcutSupported
boolean isHomeShortcutSupported()
檢查是否可以將快捷方式添加到應(yīng)用程序所在的主屏幕。
返回:
如果可以將快捷方式添加到主屏幕,則返回 true; 否則返回 false。
addHomeShortcut
boolean addHomeShortcut(ShortcutInfo shortcutInfo) throws IllegalArgumentException, IllegalStateException
添加將固定在主屏幕上的主屏幕快捷方式。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| shortcutInfo | 指示包含有關(guān)要添加的主屏幕快捷方式信息的 ShortcutInfo 對(duì)象。 必須指定此參數(shù)的 id、label 和 intent 屬性。 |
返回:
如果快捷方式添加成功,則返回 true; 否則返回 false。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果shortcutInfo 參數(shù)的id、label 或intents 屬性為null,或者要添加的快捷方式已存在但被禁用,則引發(fā)此異常。 |
| IllegalStateException | 如果調(diào)用應(yīng)用程序在后臺(tái)運(yùn)行,則引發(fā)此異常。 |
updateShortcuts
boolean updateShortcuts(ListShortcutInfo shortcutInfos)
更新有關(guān)已添加的指定主屏幕快捷方式的信息。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| shortcutInfos | 指示要更新的快捷方式列表。 |
返回:
如果操作成功,則返回 true; 否則返回 false。
disableHomeShortcuts
void disableHomeShortcuts(ListString shortcutIds) throws IllegalArgumentException
禁用不再使用的指定主屏幕快捷方式。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| shortcutIds | 指示要禁用的快捷方式 ID 列表。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果在 shortcutIds 中指定了靜態(tài)快捷方式,則引發(fā)此異常。 |
enableHomeShortcuts
void enableHomeShortcuts(ListString shortcutIds) throws IllegalArgumentException
啟用指定的主屏幕快捷方式。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| shortcutIds | 指示要啟用的快捷方式 ID 列表。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果在 shortcutIds 中指定了靜態(tài)快捷方式,則引發(fā)此異常。 |
getHomeShortcutInfos
ListShortcutInfo getHomeShortcutInfos()
獲取所有主屏幕快捷方式
返回:
返回所有主屏幕快捷方式的列表。
getAllPermissionGroupDefs
OptionalListPermissionGroupDef getAllPermissionGroupDefs()
獲取系統(tǒng)中所有已知的權(quán)限組。
返回:
返回包含權(quán)限組信息的 PermissionGroupDef 對(duì)象列表。
getAppsGrantedPermissions
ListString getAppsGrantedPermissions(String[] permissions) throws RemoteException
獲取具有指定權(quán)限的應(yīng)用程序列表。
權(quán)限:SystemPermission.GET_BUNDLE_INFO_PRIVILEGED
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| permissions | 表示權(quán)限數(shù)組。 |
返回:
返回具有指定權(quán)限的應(yīng)用程序列表。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
| SecurityException | 引發(fā)此異常以指示安全違規(guī)。 |
getAbilityIcon
PixelMap getAbilityIcon(String bundleName, String className) throws RemoteException
獲取指定能力的圖標(biāo)。
權(quán)限:SystemPermission.GET_BUNDLE_INFO、SystemPermission.GET_BUNDLE_INFO_PRIVILEGED
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 表示該ability所屬的應(yīng)用程序的捆綁包名稱。 |
| className | 表示ability的類名。 |
返回:
返回表示指定ability圖標(biāo)的 PixelMap 對(duì)象。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
getAbilityLabel
String getAbilityLabel(String bundleName, String className) throws RemoteException
獲取指定ability的標(biāo)簽。
權(quán)限:SystemPermission.GET_BUNDLE_INFO、SystemPermission.GET_BUNDLE_INFO_PRIVILEGED
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 表示該ability所屬的應(yīng)用程序的捆綁包名稱。 |
| className | 表示ability的類名。 |
返回:
返回表示指定ability的標(biāo)簽。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果系統(tǒng)無(wú)法獲取捆綁管理器服務(wù),則拋出此異常。 |
getAllFormsInfo
ListFormInfo getAllFormsInfo() throws RemoteException
獲取設(shè)備上所有ohos應(yīng)用提供的FormInfo對(duì)象。
權(quán)限:SystemPermission.GET_BUNDLE_INFO_PRIVILEGED
返回:
如果獲得,則返回 FormInfo 對(duì)象的列表; 如果設(shè)備上沒有可用的 FormInfo,則返回一個(gè)空列表。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果由于應(yīng)用程序和包管理器服務(wù)之間的連接錯(cuò)誤而無(wú)法獲取 FormInfo,則拋出此異常。 |
| SecurityException | 如果未授予應(yīng)用程序 SystemPermission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限,則引發(fā)此異常。 |
getAllForms
@Deprecated default ListFormInfo getAllForms() throws RemoteException
已棄用。 請(qǐng)改用 getAllFormsInfo()。
獲取設(shè)備上所有ohos應(yīng)用提供的FormInfo對(duì)象。
權(quán)限:SystemPermission.GET_BUNDLE_INFO_PRIVILEGED
返回:
如果獲得,則返回 FormInfo 對(duì)象的列表; 如果設(shè)備上沒有可用的 FormInfo,則返回一個(gè)空列表。
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| RemoteException | 如果由于應(yīng)用程序和包管理器服務(wù)之間的連接錯(cuò)誤而無(wú)法獲取 FormInfo,則拋出此異常。 |
| SecurityException | 如果未授予應(yīng)用程序 SystemPermission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限,則引發(fā)此異常。 |
getFormsInfoByApp
ListFormInfo getFormsInfoByApp(String bundleName) throws RemoteException
獲取設(shè)備上指定的ohos應(yīng)用提供的FormInfo對(duì)象。 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 權(quán)限是簽名|特權(quán)級(jí)別, ohos.permission.GET_OTHER_USERS_BUNDLE_INFO 權(quán)限是普通級(jí)別。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示 ohos 應(yīng)用程序 分享題目:創(chuàng)新互聯(lián)鴻蒙OS教程:鴻蒙OS IBundleManager 轉(zhuǎn)載源于:http://www.dlmjj.cn/article/djiojdo.html |


咨詢
建站咨詢
