管理中心
我的
API参考MDM能力com.huawei.android.app.adminClass SummaryDeviceHwSystemManager

DeviceHwSystemManager

展开

Class Info

public class DeviceHwSystemManager

系统相关类。

Public Method Summary

展开

Qualifier and Type

Method Name and Description

ArrayList<String>

getSuperTrustListForHwSystemManger(ComponentName admin)

获取可信任应用列表。

ArrayList<String>

getSuperWhiteListForHwSystemManger(ComponentName admin)

EMUI 11.0.0该方法已废弃,请使用ArrayList<String> getSuperTrustListForHwSystemManger(ComponentName admin)。

boolean

setSuperTrustListForHwSystemManger(ComponentName admin,ArrayList<String> list)

设置可信任应用列表。

boolean

setSuperWhiteListForHwSystemManger(ComponentName admin,ArrayList<String> list)

EMUI 11.0.0该方法已废弃,请使用boolean setSuperTrustListForHwSystemManger(ComponentName admin,ArrayList<String> list)。

boolean

removeSuperTrustListForHwSystemManger(ComponentName admin,ArrayList<String> list)

从可信任应用列表中删除应用。

boolean

removeSuperWhiteListForHwSystemManger(ComponentName admin,ArrayList<String> list)

EMUI 11.0.0该方法已废弃,请使用boolean removeSuperTrustListForHwSystemManger(ComponentName admin,ArrayList<String> list)。

boolean

setDataSaverMode(ComponentName who, boolean isDisabled)

设置禁止/允许关闭省流量模式。

boolean

getDataSaverMode(ComponentName who, boolean isDisabled)

获取省流量模式状态。

boolean

addEnterpriseTrustList(ComponentName admin, ArrayList<String> list)

添加企业应用白名单。

boolean

addEnterpriseWhiteList(ComponentName admin, ArrayList<String> list)

EMUI 11.0.0该方法已废弃,请使用boolean addEnterpriseTrustList(ComponentName admin, ArrayList<String> list)。

ArrayList<String>

getEnterpriseTrustList(ComponentName admin)

获取网络应用白名单。

ArrayList<String>

getEnterpriseWhiteList(ComponentName admin)

EMUI 11.0.0该方法已废弃,请使用ArrayList<String> getEnterpriseTrustList(ComponentName admin)。

boolean

removeEnterpriseTrustList(ComponentName admin, ArrayList<String> list)

删除网络应用白名单。

boolean

removeEnterpriseWhiteList(ComponentName admin, ArrayList<String> list)

EMUI 11.0.0该方法已废弃,请使用boolean removeEnterpriseTrustList(ComponentName admin, ArrayList<String> list)。

boolean

setPowerSaveModeDisabled(ComponentName admin, Boolean isDisabled)

禁用/启用省电模式。

boolean

isPowerSaveModeDisabled(ComponentName admin)

查询省电模式是否被禁用。

ArrayList<String>

addDataSaverTrustList(ComponentName admin, ArrayList<String> list)

添加省流量白名单。

ArrayList<String>

removeDataSaverTrustList(ComponentName admin, ArrayList<String> list)

移除省流量白名单。

ArrayList<String>

getDataSaverTrustList(ComponentName admin)

查询省流量白名单。

Public Methods

getSuperTrustListForHwSystemManger

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

智慧屏

HarmonyOS 2.0及以上

展开

Method

public ArrayList<String> getSuperTrustListForHwSystemManger(ComponentName admin)

获取可信任应用列表。

Parameters

展开

Name

Description

admin

调用该接口的的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的综合策略结果。

Return

展开

Type

Description

ArrayList<String>

可信任应用列表。

getSuperWhiteListForHwSystemManger

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 5.1~EMUI 10.1

智慧屏

HarmonyOS 2.0

展开

Method

public ArrayList<String> getSuperWhiteListForHwSystemManger(ComponentName admin)

EMUI 11.0.0该方法废弃,请使用getSuperTrustListForHwSystemManger。

获取可信任应用列表。

Parameters

展开

Name

Description

admin

调用该接口的的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的综合策略结果。

Return

展开

Type

Description

ArrayList<String>

可信任应用列表。

setSuperTrustListForHwSystemManger

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

智慧屏

HarmonyOS 2.0及以上

展开

Method

public boolean setSuperTrustListForHwSystemManger(ComponentName admin, ArrayList<String> list)

设置可信任应用列表。

  • 1、默认允许显示该应用的通知,用户不可修改。
  • 2、禁止用户修改APK的联网权限(包括数据业务和WLAN);
  • 3、设置应用为信任应用,允许开启悬浮窗,悬浮窗不需要用户确认,禁止用户取消/修改APK的相关权限。
  • 4、接口不具备保活功能。
  • 5、默认允许开机自启;允许关联启动;用户不可修改。
  • 6、添加白名单后将不允许电池优化。

注意:

  1. 需要申请com.huawei.systemmanager.permission.ACCESS_INTERFACE 和com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。
  2. 功能2,3从EMUI 9.0.1开始支持。其中禁止用户取消/修改APK的相关权限功能在EMUI 11.0及之后请使用addRuntimePermissionFixAppList接口。
  3. 功能5从EMUI 9.0开始支持。
  4. 功能6从EMUI 9.0到HarmonyOS2.0支持。
  5. 需与接口addPersistentApp配合使用。

Parameters

展开

Name

Description

admin

调用该接口的组件名称,不能为null。

list

需要设置为可信任应用的应用列表。

Return

展开

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.com.huawei.systemmanager.permission.ACCESS_INTERFACE 和com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。

IllegalArgumentException

输入的包名为null。

setSuperWhiteListForHwSystemManger

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 5.1~EMUI 10.1

智慧屏

HarmonyOS 2.0

展开

Method

public boolean setSuperWhiteListForHwSystemManger(ComponentName who, ArrayList<String> list)

EMUI 11.0.0该方法废弃,请使用setSuperTrustListForHwSystemManger。

设置可信任应用列表。

  • 1、默认允许显示该应用的通知,用户不可修改。
  • 2、禁止用户修改APK的联网权限(包括数据业务和WLAN)。
  • 3、设置应用为信任应用,允许开启悬浮窗,悬浮窗不需要用户确认,禁止用户取消/修改APK的相关权限。
  • 4、接口不具备保活功能。
  • 5、默认允许开机自启;允许关联启动;用户不可修改。
  • 6、添加白名单后将不允许电池优化。

注意:

  1. 需要申请com.huawei.systemmanager.permission.ACCESS_INTERFACE和com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。
  2. 功能2,3从EMUI 9.0.1开始支持。其中禁止用户取消/修改APK的相关权限功能在EMUI 11.0及之后请使用addRuntimePermissionFixAppList接口实现。
  3. 功能5,6从EMUI 9.0开始支持。
  4. 需与接口addPersistentApp配合使用。

Parameters

展开

Name

Description

who

调用该接口的组件名称,不能为null。

list

需要设置为可信任应用的应用列表。

Return

展开

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.systemmanager.permission.ACCESS_INTERFACE和com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。

IllegalArgumentException

输入的包名为null。

removeSuperTrustListForHwSystemManger

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

智慧屏

HarmonyOS 2.0及以上

展开

Method

public boolean removeSuperTrustListForHwSystemManger(ComponentName admin, ArrayList<String> list)

从可信任应用列表中删除应用。

注意:需要申请com.huawei.systemmanager.permission.ACCESS_INTERFACE和com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。

Parameters

展开

Name

Description

admin

调用该接口的组件名称,不能为null。

list

需要删除可信应用的列表。

Return

展开

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 此APK没有 com.huawei.systemmanager.permission.ACCESS_INTERFACE和com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。

IllegalArgumentException

输入的包名为null。

removeSuperWhiteListForHwSystemManger

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 5.1~EMUI 10.1

智慧屏

HarmonyOS 2.0

展开

Method

public boolean removeSuperWhiteListForHwSystemManger(ComponentName who, ArrayList<String> list)

EMUI 11.0.0该方法废弃,请使用removeSuperTrustListForHwSystemManger。

从可信任应用列表中删除应用。

注意:需要申请com.huawei.systemmanager.permission.ACCESS_INTERFACE和com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。

Parameters

展开

Name

Description

who

调用该接口的组件名称,不能为null。

list

需要删除可信应用的列表。

Return

展开

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 此APK没有 com.huawei.systemmanager.permission.ACCESS_INTERFACE和com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。

IllegalArgumentException

输入的包名为null。

setDataSaverMode

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method

public boolean setDataSaverMode(ComponentName who, boolean isDisabled)

设置禁止/允许关闭省流量模式。

注意:需要申请com.huawei.systemmanager.permission.ACCESS_INTERFACE和com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。

Parameters

展开

Name

Description

admin

调用该接口的组件名称,不能为null。

isDisabled

  • true:禁止关闭省流量模式。
  • false:允许关闭省流量模式。

Return

展开

Type

Description

boolean

  • true:设置成功。
  • false:设置失败。

Throws

展开

Name

Description

SecurityException

  • 此APK 经设备管理激活。
  • 无com.huawei.permission.sec.MDM_NETWORK_MANAGER权限。
  • 此APK不属于当前用户。

IllegalArgumentException

参数admin为null。

getDataSaverMode

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method

public boolean getDataSaverMode(ComponentName who, boolean isDisabled)

获取省流量模式状态。

Parameters

展开

Name

Description

admin

调用该接口的组件名称。

isDisabled

忽略,无意义。

Return

展开

Type

Description

boolean

  • true:关闭省流量模式被禁用。
  • false:关闭省流量模式未被禁用。

addEnterpriseTrustList

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

展开

Method

public boolean addEnterpriseTrustList(ComponentName admin, ArrayList<String> list)

添加到此白名单的应用才能连接网络。

注意:需要申请com.huawei.systemmanager.permission.ACCESS_INTERFACE权限。

Parameters

展开

Name

Description

admin

调用该接口的组件名称,不能为null。

list

由包名组成的list。

Return

展开

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.systemmanager.permission.ACCESS_INTERFACE权限。
  • 此APK不属于当前用户。

IllegalArgumentException

输入的包名为null。

addEnterpriseWhiteList

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 9.0~EMUI 10.1

展开

Method

public boolean addEnterpriseWhiteList(ComponentName who, ArrayList<String> list)

EMUI 11.0.0该方法废弃,请使用addEnterpriseTrustList。

添加到此白名单的应用才能连接网络。

注意:需要申请com.huawei.systemmanager.permission.ACCESS_INTERFACE权限。

Parameters

展开

Name

Description

who

调用该接口的组件名称,不能为null。

list

由包名组成的list。

Return

展开

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.systemmanager.permission.ACCESS_INTERFACE权限。
  • 此APK不属于当前用户。

IllegalArgumentException

输入的包名为null。

getEnterpriseTrustList

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

展开

Method

public ArrayList<String> getEnterpriseTrustList(ComponentName admin)

获取网络应用白名单。

Parameters

展开

Name

Description

admin

调用该接口的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的综合策略结果。

Return

展开

Type

Description

ArrayList<String>

由包名组成的list。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 此APK不属于当前用户。

IllegalArgumentException

输入的包名为null。

getEnterpriseWhiteList

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 9.0~EMUI 10.1

展开

Method

public ArrayList<String> getEnterpriseWhiteList(ComponentName who)

EMUI 11.0.0该方法废弃,请使用getEnterpriseTrustList。

获取网络应用白名单。

Parameters

展开

Name

Description

who

调用该接口的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的综合策略结果。

Return

展开

Type

Description

ArrayList<String>

由包名组成的list。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 此APK不属于当前用户。

IllegalArgumentException

输入的包名为null。

removeEnterpriseTrustList

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

展开

Method

public boolean removeEnterpriseTrustList(ComponentName admin, ArrayList<String> list)

删除网络应用白名单。

注意:需要申请com.huawei.systemmanager.permission.ACCESS_INTERFACE权限。

Parameters

展开

Name

Description

admin

调用该接口的组件名称,不能为null。

list

由包名组成的list。

Return

展开

Type

Description

boolean

  • true:删除成功。
  • false:删除失败。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.systemmanager.permission.ACCESS_INTERFACE权限。
  • 此APK不属于当前用户。

IllegalArgumentException

输入的包名为null。

removeEnterpriseWhiteList

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 9.0~EMUI 10.1

展开

Method

public boolean removeEnterpriseWhiteList(ComponentName who, ArrayList<String> list)

EMUI 11.0.0该方法废弃,请使用removeEnterpriseTrustList。

删除网络应用白名单。

注意:需要申请com.huawei.systemmanager.permission.ACCESS_INTERFACE权限。

Parameters

展开

Name

Description

who

调用该接口的组件名称,不能为null。

list

由包名组成的list。

Return

展开

Type

Description

boolean

  • true:删除成功。
  • false:删除失败。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.systemmanager.permission.ACCESS_INTERFACE权限。
  • 此APK不属于当前用户。

IllegalArgumentException

输入的包名为null。

setPowerSaveModeDisabled

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 10.0.1及以上或HarmonyOS 2.0及以上

展开

Method

public boolean setPowerSaveModeDisabled(ComponentName admin, Boolean isDisabled)

禁用/启用省电模式。

禁用效果为不可点击手机管家中的省电模式和超级省电模式菜单,并且电池电量降低时,系统也不会提示进入省电模式或超级省电模式。

注意:需要申请com.huawei.systemmanager.permission.ACCESS_INTERFACE权限。

Parameters

展开

Name

Description

admin

调用该接口APK的组件名称,不能为null。

isDisabled

  • true:禁止打开省电模式。
  • false:允许打开省电模式。

Return

展开

Type

Description

boolean

  • true:设置成功。
  • false:设置失败。

Throws

展开

Name

Description

  • SecurityException
  • 此APK未经设备管理激活。
  • 无com.huawei.systemmanager.permission.ACCESS_INTERFACE权限。
  • 此APK不属于当前用户。

IllegalArgumentException

参数admin为null时。

isPowerSaveModeDisabled

Supported Devices

展开

Device Type

OS Version

手机、平板

EMUI 10.0.1及以上或HarmonyOS 2.0及以上

展开

Method

public boolean isPowerSaveModeDisabled(ComponentName admin)

查询省电模式是否被禁用。

Parameters

展开

Name

Description

admin

调用该接口的APK的组件名称。

Return

展开

Type

Description

boolean

  • true:省电模式被禁用。
  • false:省电模式被启用。

Throws

展开

Name

Description

SecurityException

此APK不属于当前用户。

addDataSaverTrustList

Supported Devices

展开

Device Type

OS Version

手机、平板

HarmonyOS 2.1及以上

展开

Method

public boolean addDataSaverTrustList(ComponentName admin, ArrayList<String> list)

添加省流量白名单。

注意:需要申请com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。

Parameters

展开

Name

Description

admin

调用该接口的组件名称,不能为null。

list

需要更新省流量白名单的应用列表。

Return

展开

Type

Description

boolean

  • true:添加省流量白名单列表成功。
  • false:添加省流量白名单列表失败。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。

IllegalArgumentException

  • 参数admin为null。
  • list为empty。
  • list包含无效包名。

removeDataSaverTrustList

Supported Devices

展开

Device Type

OS Version

手机、平板

HarmonyOS 2.1及以上

展开

Method

public boolean removeDataSaverTrustList(ComponentName admin, ArrayList<String> list)

移除省流量白名单。

注意:需要申请com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。

Parameters

展开

Name

Description

admin

调用该接口的组件名称,不能为null。

list

需要移除省流量白名单的应用列表。

Return

展开

Type

Description

boolean

  • true:移除省流量白名单列表成功。
  • false:移除省流量白名单列表失败。

Throws

展开

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_APP_MANAGEMENT权限。

IllegalArgumentException

参数admin为null。

getDataSaverTrustList

Supported Devices

展开

Device Type

OS Version

手机、平板

HarmonyOS 2.1及以上

展开

Method

public ArrayList<String> getDataSaverTrustList(ComponentName admin)

查询省流量白名单。

Parameters

展开

Name

Description

admin

调用该接口的组件名称,为null时获取的是全局策略值。

Return

展开

Type

Description

ArrayList<String>

省流量白名单的应用列表。

Throws

展开

Name

Description

SecurityException

此APK未经设备管理激活。