![]() |
阳光的骆驼 · objectmapper对象转json - ...· 8 月前 · |
![]() |
踏实的移动电源 · Spring Batch ...· 1 年前 · |
![]() |
千杯不醉的跑步鞋 · 软件闪退问题_精易论坛· 1 年前 · |
![]() |
酒量小的葡萄酒 · How can you use ...· 1 年前 · |
string android开发 admin 用户配置文件 |
https://www.apiref.com/android-zh/android/app/admin/DevicePolicyManager.html |
![]() |
紧张的红金鱼
1 年前 |
公共接口用于管理设备上执行的策略。
大多数此类客户必须在系统中注册为
device administrator
。
此外,设备管理员可以注册为配置文件或设备所有者。
所有设备管理员都可以访问给定的方法,除非该方法的文档指定它仅限于设备或配置文件所有者。
任何调用api的应用程序只能作为它拥有的设备管理员组件的参数传递。
否则,将会抛出
SecurityException
。
有关管理设备管理策略的更多信息,请阅读 Device Administration 开发人员指南。
ENCRYPTION_STATUS_ACTIVE
结果代码为
setStorageEncryption(ComponentName, boolean)
和
getStorageEncryptionStatus()
:表示加密处于活动状态。
ENCRYPTION_STATUS_ACTIVE_DEFAULT_KEY
getStorageEncryptionStatus()
结果代码:表示加密处于活动状态,但加密密钥尚未由用户设置。
ENCRYPTION_STATUS_ACTIVE_PER_USER
getStorageEncryptionStatus()
结果代码:表示加密处于活动状态,加密密钥与用户或配置文件相关联。
ENCRYPTION_STATUS_INACTIVE
setStorageEncryption(ComponentName, boolean)
和
getStorageEncryptionStatus()
结果代码:表示支持加密,但当前未激活。
ENCRYPTION_STATUS_UNSUPPORTED
setStorageEncryption(ComponentName, boolean)
和
getStorageEncryptionStatus()
结果代码:表示不支持加密。
String
EXTRA_ADD_EXPLANATION
一个可选的CharSequence提供额外的解释为什么管理员被添加。
String
EXTRA_DEVICE_ADMIN
管理员组件的ComponentName。
String
EXTRA_PROVISIONING_ACCOUNT_TO_MIGRATE
Account
额外持有帐户要在托管配置文件设置期间迁移。
String
EXTRA_PROVISIONING_ADMIN_EXTRAS_BUNDLE
Parcelable
类型的额外
PersistableBundle
,允许启动管理供应的移动设备管理应用程序或NFC编程器应用程序在配置后将数据传递到管理应用程序实例。
String
EXTRA_PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME
ComponentName extra指示将设置为配置文件所有者或设备所有者和活动管理员的移动设备管理应用程序的设备管理接收器。
String
EXTRA_PROVISIONING_DEVICE_ADMIN_MINIMUM_VERSION_CODE
一个int额外的值,用于保存设备管理包所需的最低版本号。
String
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_CHECKSUM
额外的字符串,用于保存位于
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION
指定的下载位置的文件的URL安全base64编码的SHA-256或SHA-1哈希(请参阅下面的注释)。
String
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_COOKIE_HEADER
一个额外的字符串,用于保存一个http cookie头,该头应该在http请求中用于
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION
指定的url。
String
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION
一个额外的字符串,其中包含指定设备管理包的下载位置的url。
String
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_NAME
此常数在API级别23中已弃用。请使用
EXTRA_PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME
。
此额外功能仍受支持,但
BIND_DEVICE_ADMIN
是只有一个设备管理接收器需要
BIND_DEVICE_ADMIN
权限。
String
EXTRA_PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM
额外的字符串,用于保存
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION
指定的下载位置处的android包归档的任何签名的URL安全base64编码SHA-256校验和。
String
EXTRA_PROVISIONING_EMAIL_ADDRESS
额外的一个字符串,用于保存为其创建托管配置文件的帐户的电子邮件地址。
String
EXTRA_PROVISIONING_LEAVE_ALL_SYSTEM_APPS_ENABLED
移动设备管理应用程序可以使用布尔值,用于在设置期间跳过禁用系统应用程序时设置为
true
。
String
EXTRA_PROVISIONING_LOCALE
一个额外的
Locale
,用于保存设备将要设置的
Locale
。
String
EXTRA_PROVISIONING_LOCAL_TIME
需要在设备的
AlarmManager
上设置一个长时间额外的挂钟时间(以毫秒为单位)。
String
EXTRA_PROVISIONING_LOGO_URI
一个
Uri
额外指向一个标志图像。
String
EXTRA_PROVISIONING_MAIN_COLOR
一个额外的整数,表示在配置过程中显示的主要颜色。
String
EXTRA_PROVISIONING_SKIP_ENCRYPTION
一个额外的布尔值,指示是否可以跳过设备加密,作为设备所有者或托管配置文件设置的一部分。
String
EXTRA_PROVISIONING_TIME_ZONE
额外的字符串,用于保存设备将设置为的时区
AlarmManager
。
String
EXTRA_PROVISIONING_WIFI_HIDDEN
一个额外的布尔值,指示
EXTRA_PROVISIONING_WIFI_SSID
的WiFi网络是否隐藏。
String
EXTRA_PROVISIONING_WIFI_PAC_URL
额外的字符串,用于
EXTRA_PROVISIONING_WIFI_SSID
WiFi网络的代理自动配置(PAC)URL。
String
EXTRA_PROVISIONING_WIFI_PASSWORD
在
EXTRA_PROVISIONING_WIFI_SSID
额外持有WiFi网络密码的
EXTRA_PROVISIONING_WIFI_SSID
。
String
EXTRA_PROVISIONING_WIFI_PROXY_BYPASS
一个额外的字符串,用于保存
EXTRA_PROVISIONING_WIFI_SSID
WiFi网络的代理旁路。
String
EXTRA_PROVISIONING_WIFI_PROXY_HOST
一个额外的字符串,用于保存
EXTRA_PROVISIONING_WIFI_SSID
的WiFi网络的代理主机。
String
EXTRA_PROVISIONING_WIFI_PROXY_PORT
一个int额外的
EXTRA_PROVISIONING_WIFI_SSID
WiFi网络的代理端口。
String
EXTRA_PROVISIONING_WIFI_SECURITY_TYPE
一个String额外指示WiFi网络的安全类型
EXTRA_PROVISIONING_WIFI_SSID
,可能是一个
NONE
,
WPA
或者
WEP
。
String
EXTRA_PROVISIONING_WIFI_SSID
一个额外的字符串,用于保存nfc设备所有者配置期间应用于下载移动设备管理应用程序的wifi网络的ssid。
FLAG_MANAGED_CAN_ACCESS_PARENT
由
addCrossProfileIntentFilter(ComponentName, IntentFilter, int)
使用的标志允许受管配置文件中的活动访问从父配置文件发送的意图。
FLAG_PARENT_CAN_ACCESS_MANAGED
由
addCrossProfileIntentFilter(ComponentName, IntentFilter, int)
使用的标志允许父配置文件中的活动访问从管理配置文件发送的意图。
KEYGUARD_DISABLE_FEATURES_ALL
禁用所有当前和未来的keyguard定制。
KEYGUARD_DISABLE_FEATURES_NONE
小键盘在键盘锁中启用
KEYGUARD_DISABLE_FINGERPRINT
在键盘安全屏幕上禁用指纹传感器(例如,
KEYGUARD_DISABLE_REMOTE_INPUT
禁用文本输入到安全键盘屏幕上的通知(例如,
KEYGUARD_DISABLE_SECURE_CAMERA
禁用安全键盘屏幕上的相机(例如,
KEYGUARD_DISABLE_SECURE_NOTIFICATIONS
禁用在安全键盘屏幕上显示所有通知(例如,
KEYGUARD_DISABLE_TRUST_AGENTS
在安全键盘屏幕上忽略信任代理状态(例如,
KEYGUARD_DISABLE_UNREDACTED_NOTIFICATIONS
只允许在安全键盘屏幕上进行编辑通知(例如,
KEYGUARD_DISABLE_WIDGETS_ALL
禁用所有键盘控件。
String
MIME_TYPE_PROVISIONING_NFC
此MIME类型用于启动设备所有者设置。
PASSWORD_QUALITY_ALPHABETIC
常量
setPasswordQuality(ComponentName, int)
:用户必须输入至少包含字母(或其他符号)字符的密码。
PASSWORD_QUALITY_ALPHANUMERIC
常数
setPasswordQuality(ComponentName, int)
:用户必须输入含有至少
两个>
数字
和
字母(或其它符号)的字符的口令。
PASSWORD_QUALITY_BIOMETRIC_WEAK
持续
setPasswordQuality(ComponentName, int)
:该政策允许低安全性生物识别技术。
PASSWORD_QUALITY_COMPLEX
用于
setPasswordQuality(ComponentName, int)
常量:默认情况下,用户必须输入了至少包含字母,数字和特殊符号的密码。
PASSWORD_QUALITY_NUMERIC
常量
setPasswordQuality(ComponentName, int)
:用户必须输入至少包含数字字符的密码。
PASSWORD_QUALITY_NUMERIC_COMPLEX
用于
setPasswordQuality(ComponentName, int)
常量:用户必须输入的密码至少包含数字字符,且不含重复(4444)或有序(1234,4321,2468)序列。
PASSWORD_QUALITY_SOMETHING
常量为
setPasswordQuality(ComponentName, int)
:策略需要某种密码或模式,但不关心它是什么。
PASSWORD_QUALITY_UNSPECIFIED
常量为
setPasswordQuality(ComponentName, int)
:该策略对密码没有要求。
PERMISSION_GRANT_STATE_DEFAULT
运行时权限状态:用户可以通过UI管理权限。
PERMISSION_GRANT_STATE_DENIED
运行时权限状态:权限被拒绝给应用程序,用户无法通过UI管理权限。
PERMISSION_GRANT_STATE_GRANTED
运行时权限状态:权限授予应用程序,用户无法通过UI管理权限。
PERMISSION_POLICY_AUTO_DENY
权限策略始终拒绝运行时权限的新权限请求。
PERMISSION_POLICY_AUTO_GRANT
权限策略始终为运行时权限授予新的权限请求。
PERMISSION_POLICY_PROMPT
权限策略提示用户提供运行时权限的新权限请求。
RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOT
标记为
resetPassword(String, int)
:请勿在设备引导时要求提供用户凭据。
RESET_PASSWORD_REQUIRE_ENTRY
标记为
resetPassword(String, int)
:不允许其他管理员在用户输入密码之前再次更改密码。
SKIP_SETUP_WIZARD
创建新用户后,由
createAndManageUser(ComponentName, String, ComponentName, PersistableBundle, int)
使用的标志跳过设置向导。
WIPE_EXTERNAL_STORAGE
标记为
wipeData(int)
:也会擦除设备的外部存储设备(如SD卡)。
WIPE_RESET_PROTECTION_DATA
标记为
wipeData(int)
:也擦除出厂重置保护数据。
addCrossProfileIntentFilter
(
ComponentName
admin,
IntentFilter
filter, int flags)
由托管配置文件的配置文件所有者调用,以便在托管配置文件中发送的某些意向也可以在父级中解析,反之亦然。
boolean
addCrossProfileWidgetProvider
(
ComponentName
admin,
String
packageName)
由托管配置文件的配置文件所有者调用,以使来自给定包的小部件提供程序在父配置文件中可用。
addPersistentPreferredActivity
(
ComponentName
admin,
IntentFilter
filter,
ComponentName
activity)
由配置文件所有者或设备所有者调用,以便为与某个意图过滤器匹配的意图添加默认意图处理程序活动。
addUserRestriction
(
ComponentName
admin,
String
key)
由配置文件或设备所有者调用以设置由该密钥指定的用户限制。
clearCrossProfileIntentFilters
(
ComponentName
admin)
由受管配置文件的配置文件所有者调用,以删除从受管配置文件转到父配置文件或从父配置文件转到受管配置文件的跨配置文件意向过滤器。
clearDeviceOwnerApp
(
String
packageName)
清除当前设备所有者。
clearPackagePersistentPreferredActivities
(
ComponentName
admin,
String
packageName)
由配置文件所有者或设备所有者调用以删除与
addPersistentPreferredActivity(ComponentName, IntentFilter, ComponentName)
设置的给定包关联的所有持久性意向处理程序首选项。
clearProfileOwner
(
ComponentName
admin)
清除活动配置文件所有者并删除所有用户限制。
clearUserRestriction
(
ComponentName
admin,
String
key)
由配置文件或设备所有者调用以清除由该密钥指定的用户限制。
UserHandle
createAndManageUser
(
ComponentName
admin,
String
name,
ComponentName
profileOwner,
PersistableBundle
adminExtras, int flags)
由设备所有者调用以创建具有指定名称和调用包的给定组件作为配置文件所有者的用户。
enableSystemApp
(
ComponentName
admin,
Intent
intent)
由配置文件或设备所有者调用以通过意图重新启用系统应用程序,这些应用程序在用户初始化时被默认禁用。
enableSystemApp
(
ComponentName
admin,
String
packageName)
由配置文件或设备所有者调用,以重新启用在初始化用户时默认禁用的系统应用程序。
String[]
getAccountTypesWithManagementDisabled
()
获取配置文件所有者禁用其帐户管理的帐户数组。
List
<
ComponentName
>
getActiveAdmins
()
返回所有当前活动的设备管理员组件名称的列表。
String
getAlwaysOnVpnPackage
(
ComponentName
admin)
由设备或配置文件所有者调用以读取为当前用户管理始终在线的VPN连接的软件包名称。
Bundle
getApplicationRestrictions
(
ComponentName
admin,
String
packageName)
检索在主叫用户中运行的给定目标应用程序的应用程序限制。
String
getApplicationRestrictionsManagingPackage
(
ComponentName
admin)
由配置文件所有者或设备所有者调用以检索当前用户的应用程序限制管理包,如果没有设置,则
null
。
boolean
getAutoTimeRequired
()
boolean
getBluetoothContactSharingDisabled
(
ComponentName
admin)
由管理配置文件的配置文件所有者调用,以确定蓝牙设备是否无法访问企业联系人。
boolean
getCameraDisabled
(
ComponentName
admin)
确定设备的摄像头是否已被该用户禁用,或者由主叫管理员(如果指定)或所有管理员禁用。
String
getCertInstallerPackage
(
ComponentName
admin)
由配置文件所有者或设备所有者调用以检索用户的证书安装程序。
boolean
getCrossProfileCallerIdDisabled
(
ComponentName
admin)
由管理配置文件的配置文件所有者调用以确定是否已禁用呼叫者ID信息。
boolean
getCrossProfileContactsSearchDisabled
(
ComponentName
admin)
由受管配置文件的配置文件所有者调用以确定联系人搜索是否已被禁用。
List
<
String
>
getCrossProfileWidgetProviders
(
ComponentName
admin)
由托管配置文件的配置文件所有者调用,以查询父配置文件中哪些包可用。
getCurrentFailedPasswordAttempts
()
检索自上次成功输入密码后用户输入密码失败的次数。
CharSequence
getDeviceOwnerLockScreenInfo
()
List
<byte[]>
getInstalledCaCerts
(
ComponentName
admin)
返回当前信任的所有CA证书,不包括系统CA证书。
getKeyguardDisabledFeatures
(
ComponentName
admin)
确定Keyguard中的功能是否已由主叫管理员(如果已指定)或设置此用户及其参与配置文件的限制的所有管理员禁用。
CharSequence
getLongSupportMessage
(
ComponentName
admin)
由设备管理员调用以获取长期支持消息。
getMaximumFailedPasswordsForWipe
(
ComponentName
admin)
检索在设备或配置文件被擦除之前允许的当前最大登录尝试次数,针对特定管理员或所有管理员设置此用户及其参与配置文件的限制。
getMaximumTimeToLock
(
ComponentName
admin)
检索当前最大时间以解锁特定管理员或所有管理员,该管理员设置此用户及其参与配置文件的限制。
getOrganizationColor
(
ComponentName
admin)
由受管配置文件的配置文件所有者调用以检索用于自定义的颜色。
CharSequence
getOrganizationName
(
ComponentName
admin)
由管理配置文件的配置文件所有者调用以检索管理中的组织的名称。
DevicePolicyManager
getParentProfileInstance
(
ComponentName
admin)
由受管配置文件的配置文件所有者调用以获取其调用在父配置文件上的
DevicePolicyManager
。
getPasswordExpiration
(
ComponentName
admin)
获取特定管理员或所有管理员的当前密码到期时间,该管理员或设置此用户及其参与配置文件的限制的所有管理员。
getPasswordExpirationTimeout
(
ComponentName
admin)
获取给定管理员的密码到期超时。
getPasswordHistoryLength
(
ComponentName
admin)
检索特定管理员或所有管理员的当前密码历史记录长度,该管理员设置此用户及其参与配置文件的限制条件。
getPasswordMaximumLength
(int quality)
返回设备支持的特定密码质量的最大密码长度。
getPasswordMinimumLength
(
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的当前最小密码长度。
getPasswordMinimumLetters
(
ComponentName
admin)
检索特定管理员或设置此用户及其参与配置文件的限制的所有管理员的密码所需的当前字母数。
getPasswordMinimumLowerCase
(
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的密码所需的当前小写字母数。
getPasswordMinimumNonLetter
(
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的密码中所需的非字母字符的当前数目。
getPasswordMinimumNumeric
(
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的密码所需的当前数字位数。
getPasswordMinimumSymbols
(
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的密码中所需的当前符号数。
getPasswordMinimumUpperCase
(
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的密码中所需的当前大写字母数。
getPasswordQuality
(
ComponentName
admin)
为特定管理员或所有管理员检索当前的最低密码质量,这些管理员为此用户及其参与配置文件设置了限制。
getPermissionGrantState
(
ComponentName
admin,
String
packageName,
String
permission)
返回特定应用程序的运行时权限的当前授予状态。
getPermissionPolicy
(
ComponentName
admin)
返回设备或配置文件所有者设置的当前运行时权限策略。
List
<
String
>
getPermittedAccessibilityServices
(
ComponentName
admin)
返回此设备或配置文件所有者设置的允许的辅助功能服务的列表。
List
<
String
>
getPermittedInputMethods
(
ComponentName
admin)
返回此设备或配置文件所有者设置的允许输入方法的列表。
boolean
getScreenCaptureDisabled
(
ComponentName
admin)
确定屏幕捕获是否已被主叫管理员(如果指定)或所有管理员禁用。
CharSequence
getShortSupportMessage
(
ComponentName
admin)
由设备管理员调用以获取简短支持消息。
boolean
getStorageEncryption
(
ComponentName
admin)
由正在管理设备的应用程序调用以确定安全存储的请求设置。
getStorageEncryptionStatus
()
由正在管理设备的应用程序调用以确定设备的当前加密状态。
SystemUpdatePolicy
getSystemUpdatePolicy
()
检索先前由
setSystemUpdatePolicy(ComponentName, SystemUpdatePolicy)
设置的本地系统更新策略。
List
<
PersistableBundle
>
getTrustAgentConfiguration
(
ComponentName
admin,
ComponentName
agent)
基于将所有设备管理员的所有呼叫汇总到
setTrustAgentConfiguration(ComponentName, ComponentName, PersistableBundle)
,获取给定信任代理程序的配置。
Bundle
getUserRestrictions
(
ComponentName
admin)
由配置文件或设备所有者调用以获取用
addUserRestriction(ComponentName, String)
设置的用户限制。
String
getWifiMacAddress
(
ComponentName
admin)
由设备所有者调用以获取Wi-Fi设备的MAC地址。
boolean
hasCaCertInstalled
(
ComponentName
admin, byte[] certBuffer)
返回此证书是否作为受信任的CA安装。
boolean
hasGrantedPolicy
(
ComponentName
admin, int usesPolicy)
如果管理员已被授予特定设备策略,则返回true。
boolean
installCaCert
(
ComponentName
admin, byte[] certBuffer)
将给定证书安装为用户CA.
boolean
installKeyPair
(
ComponentName
admin,
PrivateKey
privKey,
Certificate[]
certs,
String
alias, boolean requestAccess)
由设备或配置文件所有者或委派证书安装程序调用以安装证书链和相应的叶证书的私钥。
boolean
installKeyPair
(
ComponentName
admin,
PrivateKey
privKey,
Certificate
cert,
String
alias)
由设备或配置文件所有者或委派的证书安装程序调用以安装证书和相应的专用密钥。
boolean
isActivePasswordSufficient
()
确定用户设置的当前密码是否足以满足政策要求(例如,
boolean
isAdminActive
(
ComponentName
admin)
如果给定的管理员组件当前处于活动状态(启用),则返回true。
boolean
isApplicationHidden
(
ComponentName
admin,
String
packageName)
由配置文件或设备所有者调用以确定包是否隐藏。
boolean
isCallerApplicationRestrictionsManagingPackage
()
由任何应用程序调用以确定是否已通过
setApplicationRestrictionsManagingPackage(ComponentName, String)
授予权限来管理主叫用户的应用程序限制。
boolean
isDeviceOwnerApp
(
String
packageName)
用于确定某个包是否已注册为设备所有者应用程序。
boolean
isLockTaskPermitted
(
String
pkg)
该函数让调用者知道给定组件是否被允许启动锁定任务模式。
boolean
isManagedProfile
(
ComponentName
admin)
如果此用户是其他用户的托管个人资料,则返回。
boolean
isMasterVolumeMuted
(
ComponentName
admin)
由配置文件或设备所有者调用以检查主音量静音是打开还是关闭。
boolean
isPackageSuspended
(
ComponentName
admin,
String
packageName)
由设备或配置文件所有者调用以确定包是否被暂停。
boolean
isProfileOwnerApp
(
String
packageName)
用于确定特定包是否注册为用户的配置文件所有者。
boolean
isProvisioningAllowed
(
String
action)
如果设置托管配置文件或设备是可能的,则返回。
boolean
isSecurityLoggingEnabled
(
ComponentName
admin)
返回设备所有者是否启用安全日志记录。
boolean
isUninstallBlocked
(
ComponentName
admin,
String
packageName)
检查用户是否被设备策略阻止了卸载软件包。
lockNow
()
立即锁定设备,就好像锁定屏幕超时在此次呼叫时已过期一样。
reboot
(
ComponentName
admin)
由设备所有者调用重启设备。
removeActiveAdmin
(
ComponentName
admin)
删除当前的管理组件。
boolean
removeCrossProfileWidgetProvider
(
ComponentName
admin,
String
packageName)
由托管配置文件的配置文件所有者调用,以禁用来自给定包的小部件提供程序在父配置文件中可用。
boolean
removeKeyPair
(
ComponentName
admin,
String
alias)
由设备或配置文件所有者或委派证书安装程序调用,以移除安装在给定别名下的证书和私钥对。
boolean
removeUser
(
ComponentName
admin,
UserHandle
userHandle)
由设备所有者调用以删除用户和所有相关数据。
boolean
requestBugreport
(
ComponentName
admin)
由设备所有者调用以请求错误报告。
boolean
resetPassword
(
String
password, int flags)
强制用户使用新的设备解锁密码(访问整个设备所需的密码,而不是个人帐户)。
List
<
SecurityLog.SecurityEvent
>
retrievePreRebootSecurityLogs
(
ComponentName
admin)
由设备所有者调用以从设备上次重新启动之前检索设备日志。
List
<
SecurityLog.SecurityEvent
>
retrieveSecurityLogs
(
ComponentName
admin)
由设备所有者调用以检索自设备引导后上次调用此API以来所有新的安全日志条目。
setAccountManagementDisabled
(
ComponentName
admin,
String
accountType, boolean disabled)
由设备所有者或配置文件所有者调用以禁用特定类型帐户的帐户管理。
setAlwaysOnVpnPackage
(
ComponentName
admin,
String
vpnPackage, boolean lockdownEnabled)
由设备或配置文件所有者调用,通过当前用户的特定应用程序配置始终开启的VPN连接。
boolean
setApplicationHidden
(
ComponentName
admin,
String
packageName, boolean hidden)
由配置文件或设备所有者调用以隐藏或取消隐藏包。
setApplicationRestrictions
(
ComponentName
admin,
String
packageName,
Bundle
settings)
设置在主叫用户中运行的给定目标应用程序的应用程序限制。
setApplicationRestrictionsManagingPackage
(
ComponentName
admin,
String
packageName)
由配置文件所有者或设备所有者调用以授予包的权限,以通过
setApplicationRestrictions(ComponentName, String, Bundle)
和
getApplicationRestrictions(ComponentName, String)
管理主叫用户的应用程序限制。
setAutoTimeRequired
(
ComponentName
admin, boolean required)
由设备所有者调用以设置是否需要自动时间。
setBluetoothContactSharingDisabled
(
ComponentName
admin, boolean disabled)
由管理配置文件的配置文件所有者调用,以设置蓝牙设备是否可以访问企业联系人。
setCameraDisabled
(
ComponentName
admin, boolean disabled)
由正在管理该设备的应用程序调用,以禁用该设备上的所有摄像头。
setCertInstallerPackage
(
ComponentName
admin,
String
installerPackage)
由配置文件所有者或设备所有者调用,以将对特权证书操作API的访问权限授予第三方证书安装程序应用程序。
setCrossProfileCallerIdDisabled
(
ComponentName
admin, boolean disabled)
由受管配置文件的配置文件所有者调用,以设置来自受管配置文件的来电者ID信息是否将显示在父配置文件中,用于传入呼叫。
setCrossProfileContactsSearchDisabled
(
ComponentName
admin, boolean disabled)
由受管配置文件的配置文件所有者调用,以设置来自受管配置文件的联系人搜索是否将显示在父配置文件中,用于传入呼叫。
setDeviceOwnerLockScreenInfo
(
ComponentName
admin,
CharSequence
info)
设置设备所有者信息以显示在锁定屏幕上。
setGlobalSetting
(
ComponentName
admin,
String
setting,
String
value)
由设备所有者调用以更新
Settings.Global
设置。
boolean
setKeyguardDisabled
(
ComponentName
admin, boolean disabled)
由设备所有者调用以完全禁用键盘锁。
setKeyguardDisabledFeatures
(
ComponentName
admin, int which)
由正在管理设备的应用程序调用以禁用keyguard自定义,例如小部件。
setLockTaskPackages
(
ComponentName
admin,
String[]
packages)
设置哪些包可以进入锁定任务模式。
setLongSupportMessage
(
ComponentName
admin,
CharSequence
message)
由设备管理员调用以设置长支持消息。
setMasterVolumeMuted
(
ComponentName
admin, boolean on)
由配置文件或设备所有者调用以设置主音量静音的开启或关闭。
setMaximumFailedPasswordsForWipe
(
ComponentName
admin, int num)
将其设置为大于零的值将启用内置策略,该策略将在输入了太多不正确的设备解锁密码后执行设备或配置文件擦除。
setMaximumTimeToLock
(
ComponentName
admin, long timeMs)
由正在管理设备的应用程序调用,以设置用户活动的最长时间,直到设备锁定。
setOrganizationColor
(
ComponentName
admin, int color)
由托管配置文件的配置文件所有者调用以设置用于自定义的颜色。
setOrganizationName
(
ComponentName
admin,
CharSequence
title)
由托管配置文件的配置文件所有者调用以设置正在管理的组织的名称。
String[]
setPackagesSuspended
(
ComponentName
admin,
String[]
packageNames, boolean suspended)
由设备或配置文件所有者调用以暂停此用户的包。
setPasswordExpirationTimeout
(
ComponentName
admin, long timeout)
由设备管理员调用以设置密码到期超时。
setPasswordHistoryLength
(
ComponentName
admin, int length)
由正在管理设备的应用程序调用以设置密码历史记录的长度。
setPasswordMinimumLength
(
ComponentName
admin, int length)
由正在管理设备的应用程序调用以设置允许的最小密码长度。
setPasswordMinimumLetters
(
ComponentName
admin, int length)
由正在管理设备的应用程序调用以设置密码中所需的最少字母数。
setPasswordMinimumLowerCase
(
ComponentName
admin, int length)
由正在管理设备的应用程序调用以设置密码中所需的最小数量的小写字母。
setPasswordMinimumNonLetter
(
ComponentName
admin, int length)
由正在管理设备的应用程序调用,以设置密码中所需的最小数量的非字母字符(数字或符号)。
setPasswordMinimumNumeric
(
ComponentName
admin, int length)
由正在管理设备的应用程序调用以设置密码中所需的最小数字位数。
setPasswordMinimumSymbols
(
ComponentName
admin, int length)
由正在管理设备的应用程序调用以设置密码中所需的最小符号数。
setPasswordMinimumUpperCase
(
ComponentName
admin, int length)
由正在管理设备的应用程序调用,以设置密码中所需的最小大写字母数。
setPasswordQuality
(
ComponentName
admin, int quality)
由正在管理设备的应用程序调用以设置它正在施加的密码限制。
boolean
setPermissionGrantState
(
ComponentName
admin,
String
packageName,
String
permission, int grantState)
为特定应用程序设置运行时权限的授予状态。
setPermissionPolicy
(
ComponentName
admin, int policy)
由配置文件或设备所有者调用以设置应用程序未来运行时权限请求的默认响应。
boolean
setPermittedAccessibilityServices
(
ComponentName
admin,
List
<
String
> packageNames)
由配置文件或设备所有者调用以设置允许的无障碍服务。
boolean
setPermittedInputMethods
(
ComponentName
admin,
List
<
String
> packageNames)
由配置文件或设备所有者调用以设置允许的输入法服务。
setProfileEnabled
(
ComponentName
admin)
设置配置文件的启用状态。
setProfileName
(
ComponentName
admin,
String
profileName)
设置配置文件的名称。
setRecommendedGlobalProxy
(
ComponentName
admin,
ProxyInfo
proxyInfo)
设置独立于网络的全局HTTP代理。
setRestrictionsProvider
(
ComponentName
admin,
ComponentName
provider)
指定一个特定的服务组件作为用户的本地或远程管理员的权限请求的提供者。
setScreenCaptureDisabled
(
ComponentName
admin, boolean disabled)
由设备/配置文件所有者调用以设置是否禁用屏幕捕获。
setSecureSetting
(
ComponentName
admin,
String
setting,
String
value)
由配置文件或设备所有者调用以更新
Settings.Secure
设置。
setSecurityLoggingEnabled
(
ComponentName
admin, boolean enabled)
由设备所有者调用以控制安全日志记录功能。
setShortSupportMessage
(
ComponentName
admin,
CharSequence
message)
由设备管理员调用以设置短支持消息。
boolean
setStatusBarDisabled
(
ComponentName
admin, boolean disabled)
由设备所有者调用以禁用状态栏。
setStorageEncryption
(
ComponentName
admin, boolean encrypt)
由正在管理设备的应用程序调用以请求对存储系统进行加密。
setSystemUpdatePolicy
(
ComponentName
admin,
SystemUpdatePolicy
policy)
由设备所有者调用以设置本地系统更新策略。
setTrustAgentConfiguration
(
ComponentName
admin,
ComponentName
target,
PersistableBundle
configuration)
设置为TrustAgent组件启用的配置功能列表。
setUninstallBlocked
(
ComponentName
admin,
String
packageName, boolean uninstallBlocked)
由配置文件或设备所有者调用以更改用户是否可以卸载软件包。
setUserIcon
(
ComponentName
admin,
Bitmap
icon)
由个人资料或设备所有者调用以设置用户的照片。
boolean
switchUser
(
ComponentName
admin,
UserHandle
userHandle)
由设备所有者调用以将指定的用户切换到前景。
uninstallAllUserCaCerts
(
ComponentName
admin)
从配置文件中卸载所有自定义的可信CA证书。
uninstallCaCert
(
ComponentName
admin, byte[] certBuffer)
如果存在,请从受信任的用户CA卸载给定的证书。
wipeData
(int flags)
要求擦除用户数据。
final void
wait
(long millis, int nanos)
导致当前线程等待,直到另一个线程为该对象调用
notify()
方法或
notifyAll()
方法,或者某个其他线程中断当前线程,或者经过一定的实时时间。
final void
wait
(long millis)
导致当前线程等待,直到另一个线程调用此对象的
notify()
方法或
notifyAll()
方法或经过了指定的时间量。
final void
wait
()
导致当前线程等待,直到另一个线程调用此对象的
notify()
方法或
notifyAll()
方法。
活动操作:要求用户将新设备管理员添加到系统。
所需策略是
EXTRA_DEVICE_ADMIN
额外字段中策略的ComponentName。
这将调用UI以使用户通过添加设备管理员到系统(或允许他们拒绝它)。
您可以选择包含
EXTRA_ADD_EXPLANATION
字段,以向用户提供有关正在添加的内容的附加说明(除了组件的说明)。
如果您的管理员已处于活动状态,则通常会立即返回(无需用户干预)。 但是,如果您的管理员已更新且正在请求更多使用策略标志,则用户将看到新列表。 在用户接受新列表之前,新策略不会提供给更新的管理员。
常量值:“android.app.action.ADD_DEVICE_ADMIN”
广播操作:当设备所有者被设置或更改时发送。 该广播仅发送给主用户。
也可以看看:
ACTION_PROVISION_MANAGED_DEVICE
常量值:“android.app.action.DEVICE_OWNER_CHANGED”
广播动作:发送此广播以指示管理的配置文件的配置已成功完成。
广播仅限于主配置文件,限于采用操作
ACTION_PROVISION_MANAGED_PROFILE
的配置意向中指定的应用程序。
该意图将包含额外的
EXTRA_PROVISIONING_ACCOUNT_TO_MIGRATE
,该额外的
EXTRA_PROVISIONING_ACCOUNT_TO_MIGRATE
对应于在供应时请求迁移的账户(如果有的话)。
常量值:“android.app.action.MANAGED_PROFILE_PROVISIONED”
活动操作:启动设置受管设备的供应流程。
必须以
startActivityForResult(Intent, int)
开始。
在设备所有者设置期间,设备管理员应用程序被设置为设备的所有者。 设备所有者可以完全控制设备。 设备所有者不能被用户修改。
一个典型的用例是一个由公司拥有的设备,但由员工或客户使用。
使用此操作的意图只能在未提供的设备上发送。
通过查询方法
isProvisioningAllowed(String)
可以检查是否允许
isProvisioningAllowed(String)
。
意图包含以下额外内容:
EXTRA_PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME
EXTRA_PROVISIONING_SKIP_ENCRYPTION
, optional
EXTRA_PROVISIONING_LEAVE_ALL_SYSTEM_APPS_ENABLED
, optional
EXTRA_PROVISIONING_ADMIN_EXTRAS_BUNDLE
, optional
EXTRA_PROVISIONING_LOGO_URI
, optional
EXTRA_PROVISIONING_MAIN_COLOR
, optional
当设备所有者配置完成后,类型
ACTION_PROFILE_PROVISIONING_COMPLETE
的意图被广播给设备所有者。
如果设置失败,设备将恢复出厂设置。
结果代码
RESULT_OK
意味着供应流程的同步部分已成功,但这并不能保证完整的流程会成功。
相反,结果代码
RESULT_CANCELED
意味着用户退出配置或某种配置先决条件未得到满足。
常量值:“android.app.action.PROVISION_MANAGED_DEVICE”
活动操作:启动设置托管配置文件的供应流程。
托管配置文件允许将数据分离,例如将设备用作个人和公司设备。 从哪个用户开始配置,并且管理的配置文件共享一个启动器。
这个意图通常会由移动设备管理应用程序(MDM)发送。 供应添加了托管配置文件,并将MDM设置为完全控制配置文件的配置文件所有者。
通过查询方法
isProvisioningAllowed(String)
可以检查是否允许
isProvisioningAllowed(String)
。
在版本
LOLLIPOP
,此意图必须包含额外的
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_NAME
。
从
M
,它应该包含额外的
EXTRA_PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME
,但仍然只支持
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_NAME
。
意图还可能包含以下附加内容:
EXTRA_PROVISIONING_ACCOUNT_TO_MIGRATE
, optional
EXTRA_PROVISIONING_SKIP_ENCRYPTION
, optional, supported from
N
EXTRA_PROVISIONING_ADMIN_EXTRAS_BUNDLE
, optional
EXTRA_PROVISIONING_LOGO_URI
, optional
EXTRA_PROVISIONING_MAIN_COLOR
, optional
当管理配置完成后,广播将发送到配置意向中指定的应用程序。
所述
ACTION_PROFILE_PROVISIONING_COMPLETE
广播在管理的个人资料发送和
ACTION_MANAGED_PROFILE_PROVISIONED
广播在主简档发送。
如果设置失败,managedProfile将被删除,以便设备返回到先前的状态。
如果使用
startActivityForResult(Intent, int)
启动,结果代码
RESULT_OK
意味着供应流程的同步部分成功,但这并不能保证完整的流程会成功。
相反,结果代码
RESULT_CANCELED
意味着用户退出配置,或者没有满足配置的一些先决条件。
常量值:“android.app.action.PROVISION_MANAGED_PROFILE”
活动操作:让用户输入父配置文件的新密码。
如果意图从托管配置文件中启动,则会触发为配置文件父项输入新密码。
在所有其他情况下,行为与
ACTION_SET_NEW_PASSWORD
相同。
常量值:“android.app.action.SET_NEW_PARENT_PROFILE_PASSWORD”
活动操作:让用户输入新密码。
在使用
setPasswordQuality(ComponentName, int)
或
setPasswordMinimumLength(ComponentName, int)
让用户输入符合当前要求的新密码后,应启动此活动。
您可以使用
isActivePasswordSufficient()
来确定是否需要让用户选择新密码才能满足当前的限制。
从此活动恢复后,您可以检查新的密码特征以查看它们是否足够。
如果意图是从配置文件所有者根据
M
或以前构建的托管配置文件中
M
,则会触发为配置文件的父级输入新密码。
对于所有其他情况,它将触发为用户或其启动的配置文件输入新密码。
也可以看看:
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
常量值:“android.app.action.SET_NEW_PASSWORD”
活动操作:开始加密设备上的数据。
在使用
setStorageEncryption(ComponentName, boolean)
请求激活加密之后,应该启动此活动。
从此活动恢复后,请使用
getStorageEncryption(ComponentName)
检查加密状态。
但是,在某些设备上,此活动可能永远不会返回,因为它可能会触发重新启动,并且在某些情况下会完成设备的数据擦除。
常量值:“android.app.action.START_ENCRYPTION”
广播操作:通知设备所有者已设置新的本地系统更新策略。
新政策可以通过
getSystemUpdatePolicy()
检索。
常量值:“android.app.action.SYSTEM_UPDATE_POLICY_CHANGED”
getStorageEncryptionStatus()
结果代码:表示加密当前未激活,但当前正在激活。
只有支持数据加密的设备才会报告,并且只有当存储当前正在进行加密处理时才会报告。
必须重新启动和/或擦除数据才能加密的设备永远不会返回此值。
常量值:2(0x00000002)
结果代码为
setStorageEncryption(ComponentName, boolean)
和
getStorageEncryptionStatus()
:表示加密处于活动状态。
另见
ENCRYPTION_STATUS_ACTIVE_PER_USER
。
常量值:3(0x00000003)
getStorageEncryptionStatus()
结果代码:表示加密处于活动状态,但加密密钥尚未由用户设置。
常量值:4(0x00000004)
getStorageEncryptionStatus()
结果代码:表示加密处于活动状态,加密密钥与用户或配置文件相关联。
该值仅返回到API级别为24以及更高的应用。
对于定位较早API级别的应用,即使加密密钥特定于用户或配置文件,也会返回
ENCRYPTION_STATUS_ACTIVE
。
常量值:5(0x00000005)
结果代码为
setStorageEncryption(ComponentName, boolean)
和
getStorageEncryptionStatus()
:表示支持加密,但当前未激活。
常数值:1(0x00000001)
setStorageEncryption(ComponentName, boolean)
和
getStorageEncryptionStatus()
结果代码:表示不支持加密。
常量值:0(0x00000000)
一个可选的CharSequence提供额外的解释为什么管理员被添加。
也可以看看:
ACTION_ADD_DEVICE_ADMIN
常量值:“android.app.extra.ADD_EXPLANATION”
管理员组件的ComponentName。
也可以看看:
ACTION_ADD_DEVICE_ADMIN
常量值:“android.app.extra.DEVICE_ADMIN”
一个
Account
额外持有帐户要在托管配置文件设置期间迁移。
如果提供的帐户存在于主要用户中,则会将其复制到凭证中并从主要用户中删除。
与
ACTION_PROVISION_MANAGED_PROFILE
使用。
常量值:“android.app.extra.PROVISIONING_ACCOUNT_TO_MIGRATE”
Parcelable
类型为
Parcelable
额外
PersistableBundle
,允许启动管理供应的移动设备管理应用程序或NFC编程器应用程序在供应之后将数据传递到管理应用程序实例。
如果与
ACTION_PROVISION_MANAGED_PROFILE
一起使用,则可以由发送意图在新创建的配置文件中将数据传递给自己的应用程序使用。
如果与
ACTION_PROVISION_MANAGED_DEVICE
使用,它允许将数据传递给主用户上相同的应用程序实例。
从开始
M
,如果与使用
MIME_TYPE_PROVISIONING_NFC
作为NFC的一部分管理的设备配置中,NFC消息应包含一个字符串化
Properties
实例,其字符串属性将被转换成一个
PersistableBundle
供应之后,并传递到管理应用程序。
在这两种情况下,应用程序
onProfileProvisioningComplete(Context, Intent)
通过动作
ACTION_PROFILE_PROVISIONING_COMPLETE
收到
onProfileProvisioningComplete(Context, Intent)
的数据。
在管理供应期间,捆绑包不会更改。
常量值:“android.app.extra.PROVISIONING_ADMIN_EXTRAS_BUNDLE”
ComponentName extra指示将设置为配置文件所有者或设备所有者和活动管理员的移动设备管理应用程序的设备管理接收器。
如果应用程序直接通过动作
ACTION_PROVISION_MANAGED_PROFILE
或
ACTION_PROVISION_MANAGED_DEVICE
开始供应,则此组件的软件包名称必须与开始供应的应用程序的软件包名称匹配。
当设备所有者设置由具有操作
ACTION_PROVISION_MANAGED_DEVICE
的意图或包含具有MIME类型
MIME_TYPE_PROVISIONING_NFC
的NFC记录的NFC消息启动时,此组件被设置为设备所有者和活动管理员。
对于NFC记录,组件名称必须通过
flattenToShortString()
为一个字符串。
也可以看看:
DeviceAdminReceiver
常量值:“android.app.extra.PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME”
一个int额外的值,用于保存设备管理包所需的最低版本号。
如果设备管理器已安装在设备上,则只有在安装的软件包版本低于此版本代码时才会从
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION
重新下载设备管理器。
通过
MIME_TYPE_PROVISIONING_NFC
在NFC记录中使用,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_DEVICE_ADMIN_MINIMUM_VERSION_CODE”
额外的字符串,用于保存位于
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION
指定的下载位置的文件的URL安全base64编码的SHA-256或SHA-1哈希(请参阅下面的注释)。
这个额外的或者
EXTRA_PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM
必须存在。
提供的校验和必须与下载位置处文件的校验和相匹配。
如果校验和不匹配,则会向用户显示错误,并要求用户重置设备。
与
MIME_TYPE_PROVISIONING_NFC
一起使用的NFC记录通过NFC凸点启动设备所有者配置。
注意:
对于运行
LOLLIPOP
和
LOLLIPOP_MR1
设备,仅支持SHA-1散列。
从
M
开始,此参数接受除SHA-1之外的SHA-256。
未来的操作系统版本可能会删除对SHA-1的支持。
常量值:“android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_CHECKSUM”
一个额外的字符串,用于保存一个http cookie头,该头应该在http请求中用于
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION
指定的url。
与
MIME_TYPE_PROVISIONING_NFC
一起使用的NFC记录,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_COOKIE_HEADER”
一个额外的字符串,其中包含指定设备管理包的下载位置的url。 如果未提供,则假定设备管理包已安装。
与
MIME_TYPE_PROVISIONING_NFC
一起使用的NFC记录,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION”
此常数在API级别23中已弃用。
使用
EXTRA_PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME
。
只有当包中只有一个设备管理员接收器需要权限
BIND_DEVICE_ADMIN
,才支持该额外
BIND_DEVICE_ADMIN
。
额外字符串,用于保存将设置为配置文件所有者或设备所有者的移动设备管理应用程序的包名称。
如果应用程序直接通过动作
ACTION_PROVISION_MANAGED_PROFILE
开始供应,
ACTION_PROVISION_MANAGED_PROFILE
此软件包必须与开始供应的应用程序的软件包名称匹配。
在这种情况下,该包将被设置为配置文件所有者。
当包含NFC记录的NFC消息启动设备所有者配置时,此包将被设置为设备所有者,其中包含MIME类型为
MIME_TYPE_PROVISIONING_NFC
的NFC记录。
当这个额外设置时,应用程序必须只有一个设备管理员接收器。 此接收器将设置为配置文件或设备所有者和活动管理员。
也可以看看:
DeviceAdminReceiver
常量值:“android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_NAME”
额外的字符串,用于保存
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION
指定的下载位置处的android包归档的任何签名的URL安全base64编码SHA-256校验和。
可以使用
getPackageArchiveInfo(String, int)
和
GET_SIGNATURES
标志获取android包归档的签名。
这个额外的或者
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_CHECKSUM
必须存在。
提供的校验和必须与下载位置文件的任何签名的校验和相匹配。
如果校验和不匹配,则会向用户显示错误,并要求用户重置设备。
与
MIME_TYPE_PROVISIONING_NFC
的NFC记录一起
MIME_TYPE_PROVISIONING_NFC
,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM”
额外的一个字符串,用于保存为其创建托管配置文件的帐户的电子邮件地址。
与
ACTION_PROVISION_MANAGED_PROFILE
和
ACTION_PROFILE_PROVISIONING_COMPLETE
。
这额外是
EXTRA_PROVISIONING_ADMIN_EXTRAS_BUNDLE
一部分。
如果启动管理配置的
ACTION_PROVISION_MANAGED_PROFILE
意图包含此额外信息,则它会以
ACTION_PROFILE_PROVISIONING_COMPLETE
意图转发到在配置期间设置为配置文件所有者的移动设备管理应用程序。
它通常用于避免用户必须输入两次他们的电子邮件地址。
常量值:“android.app.extra.PROVISIONING_EMAIL_ADDRESS”
移动设备管理应用程序可以使用一个布尔值,用于在设置期间跳过禁用系统应用程序时设置为
true
。
在带有
MIME_TYPE_PROVISIONING_NFC
的NFC记录中使用,或使用启动设备所有者配置的操作
ACTION_PROVISION_MANAGED_DEVICE
的意图。
常量值:“android.app.extra.PROVISIONING_LEAVE_ALL_SYSTEM_APPS_ENABLED”
一个额外的
Locale
,用于保存设备将要设置的
Locale
。
格式:xx_yy,其中xx是语言代码,yy是国家/地区代码。
与
MIME_TYPE_PROVISIONING_NFC
的NFC记录一起
MIME_TYPE_PROVISIONING_NFC
,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_LOCALE”
需要在设备的
AlarmManager
上设置一个额外的长时间(以毫秒为单位)。
通过
MIME_TYPE_PROVISIONING_NFC
在NFC记录中使用,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_LOCAL_TIME”
额外指向徽标图像的
Uri
。
该图像将在配置期间显示。
如果这个额外的不通过,一个默认的图像将被显示。
SCHEME_CONTENT
)
SCHEME_ANDROID_RESOURCE
)
调用者的责任是为设备提供合理的像素密度的图像。
如果传递了content:URI,意图应该有标志
FLAG_GRANT_READ_URI_PERMISSION
,并且uri也应该被添加到意图的
ClipData
。
用于采取行动
ACTION_PROVISION_MANAGED_PROFILE
或
ACTION_PROVISION_MANAGED_DEVICE
的意图
常量值:“android.app.extra.PROVISIONING_LOGO_URI”
一个额外的整数,表示在配置过程中显示的主要颜色。
有关如何表示颜色,请参阅
Color
。
与
ACTION_PROVISION_MANAGED_PROFILE
或
ACTION_PROVISION_MANAGED_DEVICE
。
常量值:“android.app.extra.PROVISIONING_MAIN_COLOR”
一个额外的布尔值,指示是否可以跳过设备加密,作为设备所有者或托管配置文件设置的一部分。
用于带有
MIME_TYPE_PROVISIONING_NFC
的NFC记录或用于启动设备所有者设置的操作
ACTION_PROVISION_MANAGED_DEVICE
的意图。
从
N
开始,对于采取措施
ACTION_PROVISION_MANAGED_PROFILE
的意图,也支持此操作。
常量值:“android.app.extra.PROVISIONING_SKIP_ENCRYPTION”
额外的字符串,用于保存设备将设置为的时区
AlarmManager
。
与
MIME_TYPE_PROVISIONING_NFC
一起使用的NFC记录,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_TIME_ZONE”
一个额外的布尔值,指示
EXTRA_PROVISIONING_WIFI_SSID
的WiFi网络是否隐藏。
通过
MIME_TYPE_PROVISIONING_NFC
在NFC记录中使用,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_WIFI_HIDDEN”
一个额外的字符串,用于
EXTRA_PROVISIONING_WIFI_SSID
WiFi网络的代理自动配置(PAC)URL。
通过
MIME_TYPE_PROVISIONING_NFC
与NFC记录一起
MIME_TYPE_PROVISIONING_NFC
,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_WIFI_PAC_URL”
在
EXTRA_PROVISIONING_WIFI_SSID
额外持有WiFi网络密码的
EXTRA_PROVISIONING_WIFI_SSID
。
与
MIME_TYPE_PROVISIONING_NFC
一起使用的NFC记录通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_WIFI_PASSWORD”
在
EXTRA_PROVISIONING_WIFI_SSID
额外持有WiFi网络代理旁路的
EXTRA_PROVISIONING_WIFI_SSID
。
通过
MIME_TYPE_PROVISIONING_NFC
在NFC记录中使用,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_WIFI_PROXY_BYPASS”
在
EXTRA_PROVISIONING_WIFI_SSID
额外持有WiFi网络的代理主机的
EXTRA_PROVISIONING_WIFI_SSID
。
与
MIME_TYPE_PROVISIONING_NFC
一起使用的NFC记录,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_WIFI_PROXY_HOST”
一个int额外的保存
EXTRA_PROVISIONING_WIFI_SSID
的WiFi网络的代理端口。
与
MIME_TYPE_PROVISIONING_NFC
一起使用的NFC记录,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_WIFI_PROXY_PORT”
一个String额外指示WiFi网络的安全类型
EXTRA_PROVISIONING_WIFI_SSID
,可能是一个
NONE
,
WPA
或者
WEP
。
与
MIME_TYPE_PROVISIONING_NFC
一起使用的NFC记录,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_WIFI_SECURITY_TYPE”
一个额外的字符串,用于保存nfc设备所有者配置期间应用于下载移动设备管理应用程序的wifi网络的ssid。
通过
MIME_TYPE_PROVISIONING_NFC
在NFC记录中使用,通过NFC凸点启动设备所有者配置。
常量值:“android.app.extra.PROVISIONING_WIFI_SSID”
由
addCrossProfileIntentFilter(ComponentName, IntentFilter, int)
使用的标志允许受管配置文件中的活动访问从父配置文件发送的意图。
也就是说,当父配置文件中的应用程序调用
startActivity(Intent)
,可以通过托管配置文件中的匹配活动来解析意图。
常量值:2(0x00000002)
由
addCrossProfileIntentFilter(ComponentName, IntentFilter, int)
使用的标志允许父配置文件中的活动访问从管理配置文件发送的意图。
也就是说,当托管配置文件中的应用程序调用
startActivity(Intent)
,可以通过父配置文件中的匹配活动来解析意图。
常数值:1(0x00000001)
禁用所有当前和未来的keyguard定制。
常量值:2147483647(0x7fffffff)
小键盘在键盘锁中启用
常量值:0(0x00000000)
禁用键盘安全屏幕上的指纹传感器(例如PIN /图案/密码)。
常量值:32(0x00000020)
禁止将文本输入到安全锁键盘屏幕上的通知中(例如PIN /图案/密码)。
常量值:64(0x00000040)
禁用安全锁键盘屏幕上的相机(例如PIN /图案/密码)
常量值:2(0x00000002)
禁用在安全键盘保护屏幕上显示所有通知(例如PIN /图案/密码)
常量值:4(0x00000004)
忽略安全锁键盘屏幕上的信任代理状态(例如PIN /模式/密码)。
常量值:16(0x00000010)
只允许在安全键盘屏幕上进行编辑通知(例如PIN /图案/密码)
常量值:8(0x00000008)
禁用所有键盘控件。 没有效果。
常数值:1(0x00000001)
此MIME类型用于启动设备所有者设置。
在设备所有者设置期间,设备管理员应用程序被设置为设备的所有者。 设备所有者可以完全控制设备。 设备所有者不能被用户修改,并且重置设备的唯一方式是设备所有者应用程序调用工厂重置。
一个典型的用例是一个由公司拥有的设备,但由员工或客户使用。
NFC消息必须发送给未提供的设备。
NFC记录必须包含一个序列化的
Properties
对象,其中包含以下属性:
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_NAME
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION
, optional
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_COOKIE_HEADER
, optional
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_CHECKSUM
, optional
EXTRA_PROVISIONING_LOCAL_TIME
(convert to String), optional
EXTRA_PROVISIONING_TIME_ZONE
, optional
EXTRA_PROVISIONING_LOCALE
, optional
EXTRA_PROVISIONING_WIFI_SSID
, optional
EXTRA_PROVISIONING_WIFI_HIDDEN
(convert to String), optional
EXTRA_PROVISIONING_WIFI_SECURITY_TYPE
, optional
EXTRA_PROVISIONING_WIFI_PASSWORD
, optional
EXTRA_PROVISIONING_WIFI_PROXY_HOST
, optional
EXTRA_PROVISIONING_WIFI_PROXY_PORT
(convert to String), optional
EXTRA_PROVISIONING_WIFI_PROXY_BYPASS
, optional
EXTRA_PROVISIONING_WIFI_PAC_URL
, optional
EXTRA_PROVISIONING_ADMIN_EXTRAS_BUNDLE
, optional, supported from
M
从
M
,属性应包含
EXTRA_PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME
而不是
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_NAME
(尽管仅指定
EXTRA_PROVISIONING_DEVICE_ADMIN_PACKAGE_NAME
仍受支持)。
常量值:“application / com.android.managedprovisioning”
用于
setPasswordQuality(ComponentName, int)
常量:用户必须输入至少包含字母(或其他符号)字符的密码。
请注意质量常数是有序的,以便更高的值更具限制性。
常量值:262144(0x00040000)
常数
setPasswordQuality(ComponentName, int)
:用户必须输入含有至少
两个>
数字
和
字母(或其它符号)的字符的口令。
请注意质量常数是有序的,以便更高的值更具限制性。
常量值:327680(0x00050000)
不变
setPasswordQuality(ComponentName, int)
:该政策允许低安全性生物特征识别技术。
这意味着可以识别个人身份的技术大约是3位数字的PIN(错误检测小于千分之一)。
请注意质量常数是有序的,以便更高的值更具限制性。
常量值:32768(0x00008000)
用于
setPasswordQuality(ComponentName, int)
常量:默认情况下,用户必须输入了至少包含字母,数字和特殊符号的密码。
使用此密码质量,可以限制密码以包含各种字符集,如至少一个大写字母等。这些字符使用各种方法指定,如
setPasswordMinimumLowerCase(ComponentName, int)
。
请注意质量常数是有序的,以便更高的值更具限制性。
常量值:393216(0x00060000)
常量
setPasswordQuality(ComponentName, int)
:用户必须输入了至少包含数字字符的密码。
请注意质量常数是有序的,以便更高的值更具限制性。
常量值:131072(0x00020000)
常量
setPasswordQuality(ComponentName, int)
:用户必须输入的密码至少包含数字字符,且不包含重复(4444)或已排序(1234,4321,2468)序列。
请注意质量常数是有序的,以便更高的值更具限制性。
常量值:196608(0x00030000)
常量为
setPasswordQuality(ComponentName, int)
:策略需要某种密码或模式,但不关心它是什么。
请注意质量常数是有序的,以便更高的值更具限制性。
常量值:65536(0x00010000)
常量为
setPasswordQuality(ComponentName, int)
:该策略对密码没有要求。
请注意质量常数是有序的,以便更高的值更具限制性。
常量值:0(0x00000000)
运行时权限状态:用户可以通过UI管理权限。
常量值:0(0x00000000)
运行时权限状态:权限被拒绝给应用程序,用户无法通过UI管理权限。
常量值:2(0x00000002)
运行时权限状态:权限授予应用程序,用户无法通过UI管理权限。
常数值:1(0x00000001)
权限策略始终拒绝运行时权限的新权限请求。 已经授予或拒绝的权限不受此影响。
常量值:2(0x00000002)
权限策略始终为运行时权限授予新的权限请求。 已经授予或拒绝的权限不受此影响。
常数值:1(0x00000001)
权限策略提示用户提供运行时权限的新权限请求。 已经授予或拒绝的权限不受此影响。
常量值:0(0x00000000)
标记为
resetPassword(String, int)
:请勿在设备引导时要求提供用户凭据。
如果该标志已设置,则可以在不询问用户密码的情况下引导设备。
此标志的缺失不会改变当前的启动要求。
该标志只能由设备所有者设置。
如果该应用程序不是设备所有者,则该标志被忽略。
一旦该标志被设置,在不将设备重置为出厂默认设置的情况下它不能被恢复。
常量值:2(0x00000002)
标志为
resetPassword(String, int)
:不允许其他管理员在用户输入密码之前再次更改密码。
常数值:1(0x00000001)
创建新用户后,由
createAndManageUser(ComponentName, String, ComponentName, PersistableBundle, int)
使用的标志跳过设置向导。
常数值:1(0x00000001)
标记为
wipeData(int)
:也会擦除设备的外部存储设备(如SD卡)。
常数值:1(0x00000001)
标志为
wipeData(int)
:也擦除出厂重置保护数据。
该标志只能由设备所有者管理员设置;
如果它由其他管理员设置,则会引发
SecurityException
。
常量值:2(0x00000002)
filter
IntentFilter
: The
IntentFilter
the intent has to match to be also resolved in the other profile
flags
int
:
FLAG_MANAGED_CAN_ACCESS_PARENT
and
FLAG_PARENT_CAN_ACCESS_MANAGED
are supported.
boolean addCrossProfileWidgetProvider (
ComponentName
admin,
String
packageName)
由托管配置文件的配置文件所有者调用,以使来自给定包的小部件提供程序在父配置文件中可用。 因此,用户将能够将配置文件下运行的白名单软件包中的小部件添加到在父配置文件下运行的小部件主机,例如主屏幕。 请注意,包可能有零个或多个提供程序组件,其中每个组件都提供了不同的窗口小部件类型。
注意: 默认情况下,没有任何小部件提供程序包是白名单。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
packageName
String
: The package from which widget providers are white-listed.
void addPersistentPreferredActivity (
ComponentName
admin,
IntentFilter
filter,
ComponentName
activity)
由配置文件所有者或设备所有者调用,以便为与某个意图过滤器匹配的意图添加默认意图处理程序活动。 即使意图过滤器的潜在事件处理程序集发生更改以及意向首选项已重置,此活动仍将保留为默认意图处理程序。
如果活动未安装(再),默认的消歧机制会接管。 活动(重新)安装后,会自动重置为筛选器的默认意向处理程序。
主叫设备管理员必须是个人资料所有者或设备所有者。 如果不是,则会引发安全异常。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
filter
IntentFilter
: The IntentFilter for which a default handler is added.
activity
ComponentName
: The Activity that is added as default intent handler.
void clearPackagePersistentPreferredActivities (
ComponentName
admin,
String
packageName)
由配置文件所有者或设备所有者调用,以移除与由
addPersistentPreferredActivity(ComponentName, IntentFilter, ComponentName)
设置的给定包关联的所有持久性意向处理程序首选项。
主叫设备管理员必须是个人资料所有者。 如果不是,则会引发安全异常。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
packageName
String
: The name of the package for which preferences are removed.
void clearProfileOwner (
ComponentName
admin)
清除活动配置文件所有者并删除所有用户限制。 调用者必须来自与此用户的活动配置文件所有者相同的包,否则将引发SecurityException。
这对管理的配置文件所有者不起作用。
Parameters
admin
ComponentName
: The component to remove as the profile owner.
UserHandle
createAndManageUser (
ComponentName
admin,
String
name,
ComponentName
profileOwner,
PersistableBundle
adminExtras,
int flags)
由设备所有者调用以创建具有指定名称和调用包的给定组件作为配置文件所有者的用户。
此方法返回的UserHandle不应该保留,因为用户句柄在用户被删除和创建时被回收。
如果您需要为该用户保留一个标识符,请使用
getSerialNumberForUser(UserHandle)
。
新用户将不会在后台启动。
admin是设备所有者
DeviceAdminReceiver
。
profileOwner也是与Admin相同的软件包中的DeviceAdminReceiver,并且将成为配置文件所有者,并将作为新用户的活动管理员注册。
配置文件所有者包将安装在新用户上。
如果adminExtras不为空,它们将被存储在设备上,直到用户第一次启动。 然后,当onEnable被调用时,附加内容将被传递给管理员。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
String
: The user's name.
profileOwner
ComponentName
: Which
DeviceAdminReceiver
will be profile owner. Has to be in the same package as admin, otherwise no user is created and an IllegalArgumentException is thrown.
adminExtras
PersistableBundle
: Extras that will be passed to onEnable of the admin receiver on the new user.
flags
int
:
SKIP_SETUP_WIZARD
is supported.
Bundle
getApplicationRestrictions (
ComponentName
admin,
String
packageName)
检索在主叫用户中运行的给定目标应用程序的应用程序限制。
调用者必须是该用户的配置文件或设备所有者,或者该包允许通过
setApplicationRestrictionsManagingPackage(ComponentName, String)
来管理应用程序限制;
否则会引发安全异常。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with, or
null
if called by the application restrictions managing package.
packageName
String
: The name of the package to fetch restricted settings of.
boolean getBluetoothContactSharingDisabled (
ComponentName
admin)
由管理配置文件的配置文件所有者调用,以确定蓝牙设备是否无法访问企业联系人。
主叫设备管理员必须是个人资料所有者。 如果不是,则会引发安全异常。
该API仅适用于托管配置文件。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
boolean getCrossProfileCallerIdDisabled (
ComponentName
admin)
由管理配置文件的配置文件所有者调用以确定是否已禁用呼叫者ID信息。
主叫设备管理员必须是个人资料所有者。 如果不是,则会引发安全异常。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
boolean getCrossProfileContactsSearchDisabled (
ComponentName
admin)
由受管配置文件的配置文件所有者调用以确定联系人搜索是否已被禁用。
主叫设备管理员必须是个人资料所有者。 如果不是,则会引发安全异常。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
int getCurrentFailedPasswordAttempts ()
检索自上次成功输入密码后用户输入密码失败的次数。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父用户未能密码attemts的数量。
主叫设备管理员必须要求
USES_POLICY_WATCH_LOGIN
能够调用此方法;
如果没有,则会抛出安全异常。
确定Keyguard中的功能是否已由主叫管理员(如果已指定)或设置此用户及其参与配置文件的限制的所有管理员禁用。 没有考虑对具有单独挑战的配置文件的限制。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
admin
ComponentName
: The name of the admin component to check, or
null
to check whether any admins have disabled features in keyguard.
int getMaximumFailedPasswordsForWipe (
ComponentName
admin)
检索在设备或配置文件被擦除之前允许的当前最大登录尝试次数,针对特定管理员或所有管理员设置此用户及其参与配置文件的限制。 没有考虑对具有单独挑战的配置文件的限制。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父配置文件中的值。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
long getMaximumTimeToLock (
ComponentName
admin)
检索当前最大时间以解锁特定管理员或所有管理员,该管理员设置此用户及其参与配置文件的限制。 没有考虑对具有单独挑战的配置文件的限制。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
DevicePolicyManager
getParentProfileInstance (
ComponentName
admin)
由托管配置文件的配置文件所有者调用以获取其调用在父配置文件上的
DevicePolicyManager
。
父实例支持以下方法,所有其他方法在父实例上调用时将引发SecurityException:
getPasswordQuality(ComponentName)
setPasswordQuality(ComponentName, int)
getPasswordMinimumLength(ComponentName)
setPasswordMinimumLength(ComponentName, int)
getPasswordMinimumUpperCase(ComponentName)
setPasswordMinimumUpperCase(ComponentName, int)
getPasswordMinimumLowerCase(ComponentName)
setPasswordMinimumLowerCase(ComponentName, int)
getPasswordMinimumLetters(ComponentName)
setPasswordMinimumLetters(ComponentName, int)
getPasswordMinimumNumeric(ComponentName)
setPasswordMinimumNumeric(ComponentName, int)
getPasswordMinimumSymbols(ComponentName)
setPasswordMinimumSymbols(ComponentName, int)
getPasswordMinimumNonLetter(ComponentName)
setPasswordMinimumNonLetter(ComponentName, int)
getPasswordHistoryLength(ComponentName)
setPasswordHistoryLength(ComponentName, int)
getPasswordExpirationTimeout(ComponentName)
setPasswordExpirationTimeout(ComponentName, long)
getPasswordExpiration(ComponentName)
isActivePasswordSufficient()
getCurrentFailedPasswordAttempts()
getMaximumFailedPasswordsForWipe(ComponentName)
setMaximumFailedPasswordsForWipe(ComponentName, int)
getMaximumTimeToLock(ComponentName)
setMaximumTimeToLock(ComponentName, long)
lockNow()
getKeyguardDisabledFeatures(ComponentName)
setKeyguardDisabledFeatures(ComponentName, int)
getTrustAgentConfiguration(ComponentName, ComponentName)
setTrustAgentConfiguration(ComponentName, ComponentName, PersistableBundle)
获取特定管理员或所有管理员的当前密码到期时间,该管理员或设置此用户及其参与配置文件的限制的所有管理员。
没有考虑对具有单独挑战的配置文件的限制。
如果管理员是
null
,那么将返回所有到期时间的组合 - 这将是所有这些时间的最小值。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父配置文件中的密码过期。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
long getPasswordExpirationTimeout (
ComponentName
admin)
获取给定管理员的密码到期超时。
到期超时是在
setPasswordExpirationTimeout(ComponentName, long)
针对给定管理员的呼叫或所有参与策略管理员的聚合(如果
admin
为空)中提供的循环到期超时。
对具有单独挑战的配置文件设置了限制的管理员未被考虑在内。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
int getPasswordHistoryLength (
ComponentName
admin)
检索特定管理员或所有管理员的当前密码历史记录长度,该管理员设置此用户及其参与配置文件的限制条件。 没有考虑对具有单独挑战的配置文件的限制。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
int getPasswordMinimumLength (
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的当前最小密码长度。 没有考虑对具有单独挑战的配置文件的限制。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
用户及其配置文件或特定用户。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
int getPasswordMinimumLetters (
ComponentName
admin)
检索特定管理员或设置此用户及其参与配置文件的限制的所有管理员的密码所需的当前字母数。
没有考虑对具有单独挑战的配置文件的限制。
这与
setPasswordMinimumLetters(ComponentName, int)
设置的值相同,仅适用于密码质量为
PASSWORD_QUALITY_COMPLEX
。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
int getPasswordMinimumLowerCase (
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的密码所需的当前小写字母数。
没有考虑对具有单独挑战的配置文件的限制。
这与
setPasswordMinimumLowerCase(ComponentName, int)
设置的值相同,仅适用于密码质量为
PASSWORD_QUALITY_COMPLEX
。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
int getPasswordMinimumNonLetter (
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的密码中所需的非字母字符的当前数目。
没有考虑对具有单独挑战的配置文件的限制。
这与
setPasswordMinimumNonLetter(ComponentName, int)
设置的值相同,仅适用于密码质量为
PASSWORD_QUALITY_COMPLEX
。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
int getPasswordMinimumNumeric (
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的密码所需的当前数字位数。
没有考虑对具有单独挑战的配置文件的限制。
这与
setPasswordMinimumNumeric(ComponentName, int)
设置的值相同,仅适用于密码质量为
PASSWORD_QUALITY_COMPLEX
。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
int getPasswordMinimumSymbols (
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的密码中所需的当前符号数。
没有考虑对具有单独挑战的配置文件的限制。
这与
setPasswordMinimumSymbols(ComponentName, int)
设置的值相同,仅适用于密码质量为
PASSWORD_QUALITY_COMPLEX
。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
int getPasswordMinimumUpperCase (
ComponentName
admin)
检索特定管理员或为此用户及其参与配置文件设置限制的所有管理员的密码中所需的当前大写字母数。
没有考虑对具有单独挑战的配置文件的限制。
这与
setPasswordMinimumUpperCase(ComponentName, int)
设置的值相同,仅适用于密码质量为
PASSWORD_QUALITY_COMPLEX
。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
int getPasswordQuality (
ComponentName
admin)
为特定管理员或所有管理员检索当前的最低密码质量,这些管理员为此用户及其参与配置文件设置了限制。 没有考虑对具有单独挑战的配置文件的限制。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便检索父轮廓限制。
admin
ComponentName
: The name of the admin component to check, or
null
to aggregate all admins.
the current grant state specified by device policy. If the profile or device owner has not set a grant state, the return value is
PERMISSION_GRANT_STATE_DEFAULT
. This does not indicate whether or not the permission is currently granted for the package.
If a grant state was set by the profile or device owner, then the return value will be one of
PERMISSION_GRANT_STATE_DENIED
or
PERMISSION_GRANT_STATE_GRANTED
, which indicates if the permission is currently denied or granted.
List
<
String
> getPermittedAccessibilityServices (
ComponentName
admin)
返回此设备或配置文件所有者设置的允许的辅助功能服务的列表。
一个空列表意味着除了系统服务被允许之外,没有辅助服务 空表示允许所有无障碍服务。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
int getStorageEncryptionStatus ()
由正在管理设备的应用程序调用以确定设备的当前加密状态。
根据返回的状态码,呼叫者可能会以不同的方式继续。
如果结果为
ENCRYPTION_STATUS_UNSUPPORTED
,则存储系统不支持加密。
如果结果为
ENCRYPTION_STATUS_INACTIVE
,请使用
ACTION_START_ENCRYPTION
开始加密或解密存储的过程。
如果结果为
ENCRYPTION_STATUS_ACTIVE_DEFAULT_KEY
,则存储系统已启用加密,但未设置密码,因此可能需要采取进一步的操作。
如果结果是
ENCRYPTION_STATUS_ACTIVATING
,
ENCRYPTION_STATUS_ACTIVE
或者
ENCRYPTION_STATUS_ACTIVE_PER_USER
,则不需要采取进一步的行动。
ENCRYPTION_STATUS_UNSUPPORTED
,
ENCRYPTION_STATUS_INACTIVE
,
ENCRYPTION_STATUS_ACTIVATING
,
ENCRYPTION_STATUS_ACTIVE_DEFAULT_KEY
,
ENCRYPTION_STATUS_ACTIVE
, or
ENCRYPTION_STATUS_ACTIVE_PER_USER
.
List
<
PersistableBundle
> getTrustAgentConfiguration (
ComponentName
admin,
ComponentName
agent)
基于将所有设备管理员的呼叫汇总到
setTrustAgentConfiguration(ComponentName, ComponentName, PersistableBundle)
,获取给定信任代理程序的配置。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以获取配置父配置文件中设置。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with. If null, this function returns a list of configurations for all admins that declare
KEYGUARD_DISABLE_TRUST_AGENTS
. If any admin declares
KEYGUARD_DISABLE_TRUST_AGENTS
but doesn't call
setTrustAgentConfiguration(ComponentName, ComponentName, PersistableBundle)
for this or calls it with a null configuration, null is returned.
agent
ComponentName
: Which component to get enabled features for.
Bundle
getUserRestrictions (
ComponentName
admin)
由配置文件或设备所有者调用以获取用
addUserRestriction(ComponentName, String)
设置的用户限制。
目标用户可能会有更多由系统或其他设备所有者/配置文件所有者设置的限制。
要获取当前设置的所有用户限制,请使用
getUserRestrictions()
。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with, or
null
if calling from a delegated certificate installer.
certBuffer
byte
: encoded form of the certificate to look up.
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with. Must be an active administrator, or an exception will be thrown.
usesPolicy
int
: Which uses-policy to check, as defined in
DeviceAdminInfo
.
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with, or
null
if calling from a delegated certificate installer.
certBuffer
byte
: encoded form of the certificate to install.
String
alias,
boolean requestAccess)
由设备或配置文件所有者或委派证书安装程序调用以安装证书链和相应的叶证书的私钥。 在配置文件中的所有应用程序都可以访问证书链并使用私钥,只要用户直接批准。
该API的调用者可以在没有用户批准的情况下立即授予自己对证书和私钥的访问权限。 除非严格必要,否则最好不要这样做,因为这会带来额外的安全漏洞。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with, or
null
if calling from a delegated certificate installer.
privKey
PrivateKey
: The private key to install.
certs
Certificate
: The certificate chain to install. The chain should start with the leaf certificate and include the chain of trust in order. This will be returned by
getCertificateChain(Context, String)
.
alias
String
: The private key alias under which to install the certificate. If a certificate with that alias already exists, it will be overwritten.
requestAccess
boolean
:
true
to request that the calling app be granted access to the credentials immediately. Otherwise, access to the credentials will be gated by user approval.
Certificate
cert,
String
alias)
由设备或配置文件所有者或委派的证书安装程序调用以安装证书和相应的专用密钥。 只要用户直接批准,配置文件中的所有应用程序都将能够访问证书并使用私钥。
未经用户直接批准,访问已安装的凭证将不会被授予该API的调用者。 这是为了安全 - 如果证书安装程序受到威胁,它已经安装的证书将受到保护。
如果安装程序必须有权访问凭据,请调用
installKeyPair(ComponentName, PrivateKey, Certificate[], String, boolean)
。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with, or
null
if calling from a delegated certificate installer.
privKey
PrivateKey
: The private key to install.
Certificate
: The certificate to install.
alias
String
: The private key alias under which to install the certificate. If a certificate with that alias already exists, it will be overwritten.
boolean isActivePasswordSufficient ()
确定用户设置的当前密码是否足以满足该用户的管理员及其参与配置文件请求的策略要求(例如质量,最小长度)。 没有考虑对具有单独挑战的配置文件的限制。
主叫设备管理员必须要求
USES_POLICY_LIMIT_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以确定是否对父配置文件设置的密码就足够了。
boolean
Returns true if the password meets the current requirements, else false.
boolean isCallerApplicationRestrictionsManagingPackage ()
由任何应用程序调用以确定是否已通过
setApplicationRestrictionsManagingPackage(ComponentName, String)
授予权限来管理主叫用户的应用程序限制。
这是通过将调用的Linux uid与该方法指定的包的uid进行比较来完成的。
Returns
boolean
boolean isDeviceOwnerApp (
String
packageName)
用于确定某个包是否已注册为设备所有者应用程序。
设备所有者应用是一种特殊的设备管理员,一旦作为设备管理员激活,就不能被用户停用。
它也不能被卸载。
要检查某个包是否当前已注册为设备所有者应用程序,请将包名称从
getPackageName()
给此方法。
This is useful for device admin apps that want to check whether they are also registered as the device owner app. The exact mechanism by which a device admin app is registered as a device owner app is defined by the setup process. boolean isUninstallBlocked ( ComponentName admin, String packageName)
检查用户是否被设备策略阻止了卸载软件包。 如果检查特定管理员的政策,则需要调用者成为配置文件所有者。
注意:
从
LOLLIPOP_MR1
开始,此API的行为已更改,因此如果任何管理员阻止了卸载,将传回
null
作为参数将返回
admin
。
在L MR1之前,传递
null
将引发NullPointerException
null
。
admin
ComponentName
: The name of the admin component whose blocking policy will be checked, or
null
to check whether any admin has blocked the uninstallation.
packageName
String
: package to check.
void lockNow ()
立即锁定设备,就好像锁定屏幕超时在此次呼叫时已过期一样。
主叫设备管理员必须要求
USES_POLICY_FORCE_LOCK
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以锁定父轮廓。
SecurityException
if the calling application does not own an active administrator that uses
USES_POLICY_FORCE_LOCK
void removeActiveAdmin (
ComponentName
admin)
删除当前的管理组件。 这只能由拥有管理组件的应用程序调用; 如果您尝试删除其他人的组件,则会引发安全异常。
请注意,该操作不同步,并且在此方法返回时管理员可能仍处于活动状态(如
getActiveAdmins()
)。
admin
ComponentName
: The administration compononent to remove.
boolean removeCrossProfileWidgetProvider (
ComponentName
admin,
String
packageName)
由托管配置文件的配置文件所有者调用,以禁用来自给定包的小部件提供程序在父配置文件中可用。
为使此方法生效,应该通过
addCrossProfileWidgetProvider(android.content.ComponentName, String)
添加
addCrossProfileWidgetProvider(android.content.ComponentName, String)
。
注意: 默认情况下,没有任何小部件提供程序包是白名单。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
packageName
String
: The package from which widget providers are no longer white-listed.
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with, or
null
if calling from a delegated certificate installer.
alias
String
: The private key alias under which the certificate is installed.
boolean resetPassword (
String
password,
int flags)
强制用户使用新的设备解锁密码(访问整个设备所需的密码,而不是个人帐户)。 这会立即生效。
注意:对于不是设备所有者而不是设备所有者的设备管理员,此API限制为
N
。
现在只有当前没有设置密码时才能更改密码。
设备所有者和配置文件所有者仍然可以在用户解锁并且没有托管配置文件时执行此操作。
给定的密码必须足以满足
getPasswordQuality(ComponentName)
和
getPasswordMinimumLength(ComponentName)
返回的当前密码质量和长度限制;
如果它不符合这些限制条件,那么它将被拒绝并返回错误。
请注意,密码的质量可能更高(当请求质量仅为数字时,包含字母数字字符),在这种情况下,当前活动质量将会增加以匹配。
如果当前密码限制允许,使用空密码或空密码进行呼叫将清除任何现有PIN,模式或密码。
注意:这不适用于
N
及更高版本的托管配置文件或非设备所有者或配置文件所有者的设备管理员。
一旦设置,密码不能更改为空或空,除非由这些管理员。
主叫设备管理员必须要求
USES_POLICY_RESET_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
password
String
: The new password for the user. Null or empty clears the password.
flags
int
: May be 0 or combination of
RESET_PASSWORD_REQUIRE_ENTRY
and
RESET_PASSWORD_DO_NOT_ASK_CREDENTIALS_ON_BOOT
.
SecurityException
if the calling application does not own an active administrator that uses
USES_POLICY_RESET_PASSWORD
IllegalStateException
if the calling user is locked or has a managed profile.
List
<
SecurityLog.SecurityEvent
> retrievePreRebootSecurityLogs (
ComponentName
admin)
由设备所有者调用以从设备上次重新启动之前检索设备日志。
此API在所有设备上都不受支持。
在不支持的设备上调用此API将导致返回
null
。
设备日志是从RAM区域检索的,因此在断电期间不能保证无损坏,因此请谨慎分析解析时的数据损坏情况。
设备所有者只能管理一位用户。
否则会抛出
SecurityException
。
admin
ComponentName
: Which device owner this request is associated with.
List
<
SecurityLog.SecurityEvent
> retrieveSecurityLogs (
ComponentName
admin)
由设备所有者调用以检索自设备引导后上次调用此API以来所有新的安全日志条目。
访问日志的速率是有限的,只有在设备所有者通过
onSecurityLogsAvailable(Context, Intent)
收到通知后才能返回新的日志。
设备所有者只能管理一位用户。
否则会抛出
SecurityException
。
admin
ComponentName
: Which device owner this request is associated with.
void setAccountManagementDisabled (
ComponentName
admin,
String
accountType,
boolean disabled)
由设备所有者或配置文件所有者调用以禁用特定类型帐户的帐户管理。
主叫设备管理员必须是设备所有者或配置文件所有者。 如果不是,则会引发安全异常。
如果帐户类型的帐户管理被禁用,则添加或删除该类型的帐户将无法进行。
从
N
配置文件或设备所有者仍然可以使用
AccountManager
API在禁用特定类型的帐户管理时添加或删除帐户。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
accountType
String
: For which account management is disabled or enabled.
disabled
boolean
: The boolean indicating that account management will be disabled (true) or enabled (false).
void setAlwaysOnVpnPackage (
ComponentName
admin,
String
vpnPackage,
boolean lockdownEnabled)
由设备或配置文件所有者调用,通过当前用户的特定应用程序配置始终开启的VPN连接。 此连接自动授予并在重新启动后保留。
指定的软件包应该在
VpnService
保护下
BIND_VPN_SERVICE
,否则呼叫将失败。
admin
ComponentName
vpnPackage
String
: The package name for an installed VPN app on the device, or
null
to remove an existing always-on VPN configuration.
lockdownEnabled
boolean
:
true
to disallow networking when the VPN is not connected or
false
otherwise. This carries the risk that any failure of the VPN provider could break networking for all apps. This has no effect when clearing.
void setApplicationRestrictions (
ComponentName
admin,
String
packageName,
Bundle
settings)
设置在主叫用户中运行的给定目标应用程序的应用程序限制。
来电者必须是该用户的个人资料或设备所有者,或者该包允许通过
setApplicationRestrictionsManagingPackage(ComponentName, String)
管理应用程序限制;
否则会引发安全异常。
提供的
Bundle
由键值对组成,值的类型可以是:
boolean
String
or
String[]
M
,
Bundle
or
Bundle[]
如果限制尚不可用,但可能在不久的将来应用,则调用者可以通过将
KEY_RESTRICTIONS_PENDING
添加到设置参数来通知目标应用程序。
除了配置文件或设备所有者以及通过
getApplicationRestrictions(ComponentName, String)
管理包的应用程序限制之外,应用程序限制仅通过
getApplicationRestrictions(String)
对目标应用程序可见。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with, or
null
if called by the application restrictions managing package.
packageName
String
: The name of the package to update restricted settings for.
settings
Bundle
: A
Bundle
to be parsed by the receiving application, conveying a new set of active restrictions.
void setApplicationRestrictionsManagingPackage (
ComponentName
admin,
String
packageName)
由配置文件所有者或设备所有者调用以授予包的权限,以通过
setApplicationRestrictions(ComponentName, String, Bundle)
和
getApplicationRestrictions(ComponentName, String)
管理主叫用户的应用程序限制。
此权限是持久性的,直到稍后通过调用具有
null
值的此方法或卸载管理包来清除此权限。
调用此API时必须安装提供的应用程序限制管理包,否则将引发
PackageManager.NameNotFoundException
。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
packageName
String
: The package name which will be given access to application restrictions APIs. If
null
is given the current package will be cleared.
void setAutoTimeRequired (
ComponentName
admin,
boolean required)
由设备所有者调用以设置是否需要自动时间。 如果需要自动时间,用户不能设置日期和时间,但必须使用网络日期和时间。
注意:如果需要自动时间,用户仍然可以手动设置时区。
主叫设备管理员必须是设备所有者。 如果不是,则会引发安全异常。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
required
boolean
: Whether auto time is set required or not.
void setBluetoothContactSharingDisabled (
ComponentName
admin,
boolean disabled)
由管理配置文件的配置文件所有者调用,以设置蓝牙设备是否可以访问企业联系人。
主叫设备管理员必须是个人资料所有者。 如果不是,则会引发安全异常。
该API仅适用于托管配置文件。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
disabled
boolean
: If true, bluetooth devices cannot access enterprise contacts.
void setCameraDisabled (
ComponentName
admin,
boolean disabled)
由正在管理该设备的应用程序调用,以禁用该设备上的所有摄像头。 设置完成后,没有任何以该用户身份运行的应用程序将能够访问设备上的任何摄像头。
如果主叫方是设备所有者,则该限制将应用于所有用户。
主叫设备管理员必须要求
USES_POLICY_DISABLE_CAMERA
能够调用此方法;
如果没有,则会抛出安全异常。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
disabled
boolean
: Whether or not the camera should be disabled.
void setCertInstallerPackage (
ComponentName
admin,
String
installerPackage)
由配置文件所有者或设备所有者调用,以将对特权证书操作API的访问权限授予第三方证书安装程序应用程序。
诚然API包括
getInstalledCaCerts(ComponentName)
,
hasCaCertInstalled(ComponentName, byte[])
,
installCaCert(ComponentName, byte[])
,
uninstallCaCert(ComponentName, byte[])
,
uninstallAllUserCaCerts(ComponentName)
和
installKeyPair(ComponentName, PrivateKey, Certificate, String)
。
委派证书安装程序是按用户状态。 委托访问是持久性的,直到稍后通过使用空值调用此方法或卸载证书安装程序清除它。
注意:
从
N
开始,如果调用者应用程序的目标SDK版本是
N
或更新,则在调用此API时必须安装提供的证书安装程序包,否则将引发
IllegalArgumentException
。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
installerPackage
String
: The package name of the certificate installer which will be given access. If
null
is given the current package will be cleared.
void setCrossProfileCallerIdDisabled (
ComponentName
admin,
boolean disabled)
由受管配置文件的配置文件所有者调用,以设置来自受管配置文件的来电者ID信息是否将显示在父配置文件中,用于传入呼叫。
主叫设备管理员必须是个人资料所有者。 如果不是,则会引发安全异常。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
disabled
boolean
: If true caller-Id information in the managed profile is not displayed.
void setCrossProfileContactsSearchDisabled (
ComponentName
admin,
boolean disabled)
由受管配置文件的配置文件所有者调用,以设置来自受管配置文件的联系人搜索是否将显示在父配置文件中,用于传入呼叫。
主叫设备管理员必须是个人资料所有者。 如果不是,则会引发安全异常。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
disabled
boolean
: If true contacts search in the managed profile is not displayed.
void setDeviceOwnerLockScreenInfo (
ComponentName
admin,
CharSequence
info)
设置设备所有者信息以显示在锁定屏幕上。
如果设备所有者信息为
null
或为空,则设备所有者信息将被清除,并且用户所有者信息会在锁定屏幕上显示(如果已设置)。
如果设备所有者信息仅包含空格,则锁定屏幕上的消息将为空,并且用户将不被允许更改它。
如果设备所有者信息需要本地化,则
DeviceAdminReceiver
负责监听
ACTION_LOCALE_CHANGED
广播并相应地设置此字符串的新版本。
admin
ComponentName
: The name of the admin component to check.
CharSequence
: Device owner information which will be displayed instead of the user owner info.
USB_MASS_STORAGE_ENABLED
WIFI_SLEEP_POLICY
STAY_ON_WHILE_PLUGGED_IN
This setting is only available from
M
onwards and can only be set if
setMaximumTimeToLock(ComponentName, long)
is not used to set a timeout.
WIFI_DEVICE_OWNER_CONFIGS_LOCKDOWN
M
onwards.
BLUETOOTH_ON
. Use
enable()
and
disable()
instead.
DEVELOPMENT_SETTINGS_ENABLED
MODE_RINGER
. Use
setRingerMode(int)
instead.
NETWORK_PREFERENCE
WIFI_ON
. Use
setWifiEnabled(boolean)
instead.
由正在管理设备的应用程序调用以禁用keyguard自定义,例如小部件。 设置完成后,根据提供的功能列表,Keyguard功能将被禁用。
主叫设备管理员必须要求
USES_POLICY_DISABLE_KEYGUARD_FEATURES
能够调用此方法;
如果没有,则会抛出安全异常。
在版本
M
之前从管理的配置文件调用此
M
将引发安全异常。
从版本
M
管理的配置文件的配置文件所有者可以设置:
KEYGUARD_DISABLE_TRUST_AGENTS
, which affects the parent user, but only if there is no separate challenge set on the managed profile.
KEYGUARD_DISABLE_FINGERPRINT
which affects the managed profile challenge if there is one, or the parent user otherwise.
KEYGUARD_DISABLE_UNREDACTED_NOTIFICATIONS
which affects notifications generated by applications in the managed profile.
KEYGUARD_DISABLE_TRUST_AGENTS
and
KEYGUARD_DISABLE_FINGERPRINT
can also be set on the
DevicePolicyManager
instance returned by
getParentProfileInstance(ComponentName)
in order to set restrictions on the parent profile.
要求禁用托管配置文件中的其他功能将被忽略。
管理员可以通过调用
getKeyguardDisabledFeatures(ComponentName)
来检查哪些功能已被禁用
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
which
int
:
KEYGUARD_DISABLE_FEATURES_NONE
(default),
KEYGUARD_DISABLE_WIDGETS_ALL
,
KEYGUARD_DISABLE_SECURE_CAMERA
,
KEYGUARD_DISABLE_SECURE_NOTIFICATIONS
,
KEYGUARD_DISABLE_TRUST_AGENTS
,
KEYGUARD_DISABLE_UNREDACTED_NOTIFICATIONS
,
KEYGUARD_DISABLE_FINGERPRINT
,
KEYGUARD_DISABLE_FEATURES_ALL
startLockTask()
onLockTaskModeEntering(Context, Intent, String)
onLockTaskModeExiting(Context, Intent)
DISALLOW_CREATE_WINDOWS
由设备管理员调用以设置长支持消息。 这将在设备管理员设置屏幕中显示给用户。
如果需要对长期支持消息进行本地化,则
DeviceAdminReceiver
负责监听
ACTION_LOCALE_CHANGED
广播并相应地设置此字符串的新版本。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
message
CharSequence
: Long message to be displayed to the user in settings or null to clear the existing message.
void setMaximumFailedPasswordsForWipe (
ComponentName
admin,
int num)
将其设置为大于零的值将启用内置策略,该策略将在输入了太多不正确的设备解锁密码后执行设备或配置文件擦除。
该内置策略结合了查看失败的密码和擦除设备,并要求您同时请求
USES_POLICY_WATCH_LOGIN
和
USES_POLICY_WIPE_DATA
}。
要实施任何其他策略(例如,仅擦除特定应用程序的数据,擦除或撤消证书或向服务器报告故障),应该实施
onPasswordFailed(Context, android.content.Intent)
。
请勿使用此API,因为如果达到最大计数,设备或配置文件将立即被擦除,并且您的回调将不会被调用。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓的值。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
int
: The number of failed password attempts at which point the device or profile will be wiped.
void setMaximumTimeToLock (
ComponentName
admin,
long timeMs)
由正在管理设备的应用程序调用,以设置用户活动的最长时间,直到设备锁定。 这限制了用户可以设置的长度。 它立即生效。
主叫设备管理员必须要求
USES_POLICY_FORCE_LOCK
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓限制。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
timeMs
long
: The new desired maximum time to lock in milliseconds. A value of 0 means there is no restriction.
void setOrganizationColor (
ComponentName
admin,
int color)
由托管配置文件的配置文件所有者调用以设置用于自定义的颜色。 该颜色用作该用户的确认凭证屏幕的背景颜色。 默认颜色是蓝绿色(#00796B)。
确认凭证屏幕可以使用
createConfirmDeviceCredentialIntent(CharSequence, CharSequence)
创建。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
color
int
: The 24bit (0xRRGGBB) representation of the color to be used.
void setOrganizationName (
ComponentName
admin,
CharSequence
title)
由托管配置文件的配置文件所有者调用以设置正在管理的组织的名称。
如果组织名称需要本地化,则
DeviceAdminReceiver
负责监听
ACTION_LOCALE_CHANGED
广播并相应地设置此字符串的新版本。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
title
CharSequence
: The organization name or
null
to clear a previously set name.
String[]
setPackagesSuspended (
ComponentName
admin,
String[]
packageNames,
boolean suspended)
由设备或配置文件所有者调用以暂停此用户的包。
暂停的套餐将无法启动活动。 它的通知将被隐藏,它不会显示在最近的内容中,也不会显示吐司或对话框或者打开设备。
该软件包必须已安装。
如果程序包在挂起时被卸载,程序包将不再被挂起。
管理员可以通过使用
setUninstallBlocked(ComponentName, String, boolean)
来阻止此
setUninstallBlocked(ComponentName, String, boolean)
。
admin
ComponentName
: The name of the admin component to check.
packageNames
String
: The package names to suspend or unsuspend.
suspended
boolean
: If set to
true
than the packages will be suspended, if set to
false
the packages will be unsuspended.
void setPasswordExpirationTimeout (
ComponentName
admin,
long timeout)
由设备管理员调用以设置密码到期超时。 调用此方法将重新启动给定管理员的密码过期倒计时,同时将更改设备密码(对于所有管理员)。
提供的超时值是以毫秒为单位的时间增量,并将添加到当前时间。 例如,要从现在开始5天后密码过期,超时时间为5 * 86400 * 1000 = 432000000毫秒。
要禁用密码过期,可以使用值0来超时。
主叫设备管理员必须要求
USES_POLICY_EXPIRE_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
请注意,设置密码将自动重置所有活动管理员的到期时间。 在这种情况下,主动管理员不需要显式调用此方法。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓限制。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
timeout
long
: The limit (in ms) that a password can remain in effect. A value of 0 means there is no restriction (unlimited).
void setPasswordHistoryLength (
ComponentName
admin,
int length)
由正在管理设备的应用程序调用以设置密码历史记录的长度。
设置完成后,用户将无法输入与历史记录中任何密码相同的新密码。
请注意,当前密码将保留到用户设置新密码为止,因此更改不会立即生效。
要提示用户输入新密码,
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
在设置此值后使用
ACTION_SET_NEW_PASSWORD
或
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
。
这个约束只规定如果管理员还要求无论是
PASSWORD_QUALITY_NUMERIC
,
PASSWORD_QUALITY_NUMERIC_COMPLEX
PASSWORD_QUALITY_ALPHABETIC
,或
PASSWORD_QUALITY_ALPHANUMERIC
与
setPasswordQuality(ComponentName, int)
。
主叫设备管理员必须要求
USES_POLICY_LIMIT_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓限制。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
length
int
: The new desired length of password history. A value of 0 means there is no restriction.
void setPasswordMinimumLength (
ComponentName
admin,
int length)
由正在管理设备的应用程序调用以设置允许的最小密码长度。
设置完成后,用户将无法输入与已设置的限制不同的新密码。
请注意,当前密码将保留到用户设置新密码为止,因此更改不会立即生效。
要提示用户输入新密码,
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
在设置此值后使用
ACTION_SET_NEW_PASSWORD
或
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
。
如果管理员还要求这个约束只征收两种
PASSWORD_QUALITY_NUMERIC
,
PASSWORD_QUALITY_NUMERIC_COMPLEX
,
PASSWORD_QUALITY_ALPHABETIC
,
PASSWORD_QUALITY_ALPHANUMERIC
,或
PASSWORD_QUALITY_COMPLEX
与
setPasswordQuality(ComponentName, int)
。
主叫设备管理员必须要求
USES_POLICY_LIMIT_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓限制。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
length
int
: The new desired minimum password length. A value of 0 means there is no restriction.
void setPasswordMinimumLetters (
ComponentName
admin,
int length)
由正在管理设备的应用程序调用以设置密码中所需的最少字母数。
设置完成后,用户将无法输入与已设置的限制不同的新密码。
请注意,当前密码将保留到用户设置新密码为止,因此更改不会立即生效。
要提示用户输入新密码,
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
在设置此值后使用
ACTION_SET_NEW_PASSWORD
或
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
。
只有在管理员还要求
PASSWORD_QUALITY_COMPLEX
和
setPasswordQuality(ComponentName, int)
才会施加此限制。
默认值是1。
主叫设备管理员必须要求
USES_POLICY_LIMIT_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓限制。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
length
int
: The new desired minimum number of letters required in the password. A value of 0 means there is no restriction.
void setPasswordMinimumLowerCase (
ComponentName
admin,
int length)
由正在管理设备的应用程序调用以设置密码中所需的最小数量的小写字母。
设置完成后,用户将无法输入与已设置的限制不同的新密码。
请注意,当前密码将保留到用户设置新密码为止,因此更改不会立即生效。
要提示用户输入新密码,
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
在设置此值后使用
ACTION_SET_NEW_PASSWORD
或
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
。
如果管理员还请求
PASSWORD_QUALITY_COMPLEX
和
setPasswordQuality(ComponentName, int)
则仅限此限制。
默认值是0。
主叫设备管理员必须要求
USES_POLICY_LIMIT_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓限制。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
length
int
: The new desired minimum number of lower case letters required in the password. A value of 0 means there is no restriction.
void setPasswordMinimumNonLetter (
ComponentName
admin,
int length)
由正在管理设备的应用程序调用,以设置密码中所需的最小数量的非字母字符(数字或符号)。
设置完成后,用户将无法输入与已设置的限制不同的新密码。
请注意,当前密码将保留到用户设置新密码为止,因此更改不会立即生效。
要提示用户输入新密码,
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
在设置此值后使用
ACTION_SET_NEW_PASSWORD
或
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
。
如果管理员还请求
PASSWORD_QUALITY_COMPLEX
和
setPasswordQuality(ComponentName, int)
则仅限此限制。
默认值是0。
主叫设备管理员必须要求
USES_POLICY_LIMIT_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓限制。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
length
int
: The new desired minimum number of letters required in the password. A value of 0 means there is no restriction.
void setPasswordMinimumNumeric (
ComponentName
admin,
int length)
由正在管理设备的应用程序调用以设置密码中所需的最小数字位数。
设置完成后,用户将无法输入与已设置的限制不同的新密码。
请注意,当前密码将保留到用户设置新密码为止,因此更改不会立即生效。
要提示用户输入新密码,
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
在设置此值后使用
ACTION_SET_NEW_PASSWORD
或
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
。
如果管理员还要求
PASSWORD_QUALITY_COMPLEX
和
setPasswordQuality(ComponentName, int)
则仅限此限制。
默认值是1。
主叫设备管理员必须要求
USES_POLICY_LIMIT_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓限制。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
length
int
: The new desired minimum number of numerical digits required in the password. A value of 0 means there is no restriction.
void setPasswordMinimumSymbols (
ComponentName
admin,
int length)
由正在管理设备的应用程序调用以设置密码中所需的最小符号数。
设置完成后,用户将无法输入与已设置的限制不同的新密码。
请注意,当前密码将保留到用户设置新密码为止,因此更改不会立即生效。
要提示用户输入新密码,
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
在设置此值后使用
ACTION_SET_NEW_PASSWORD
或
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
。
只有在管理员还要求
PASSWORD_QUALITY_COMPLEX
与
setPasswordQuality(ComponentName, int)
才会强制实施此限制。
默认值是1。
主叫设备管理员必须要求
USES_POLICY_LIMIT_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓限制。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
length
int
: The new desired minimum number of symbols required in the password. A value of 0 means there is no restriction.
void setPasswordMinimumUpperCase (
ComponentName
admin,
int length)
由正在管理设备的应用程序调用,以设置密码中所需的最小大写字母数。
设置完成后,用户将无法输入与已设置的限制不同的新密码。
请注意,当前密码将保留到用户设置新密码为止,因此更改不会立即生效。
要提示用户输入新密码,
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
在设置此值后使用
ACTION_SET_NEW_PASSWORD
或
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
。
只有在管理员还要求
PASSWORD_QUALITY_COMPLEX
与
setPasswordQuality(ComponentName, int)
才会强制实施此限制。
默认值是0。
主叫设备管理员必须要求
USES_POLICY_LIMIT_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓限制。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
length
int
: The new desired minimum number of upper case letters required in the password. A value of 0 means there is no restriction.
void setPasswordQuality (
ComponentName
admin,
int quality)
由正在管理设备的应用程序调用以设置它正在施加的密码限制。
设置完成后,用户将无法输入与已设置的限制不同的新密码。
请注意,当前密码将保留到用户设置新密码为止,因此更改不会立即生效。
要提示用户输入新密码,
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
在调用此方法后使用
ACTION_SET_NEW_PASSWORD
或
ACTION_SET_NEW_PARENT_PROFILE_PASSWORD
。
质量常数是有序的,以便更高的值更具限制性; 因此要求的最高质量常数(在此设置的策略,用户的偏好以及任何其他考虑因素之间)是有效的。
主叫设备管理员必须要求
USES_POLICY_LIMIT_PASSWORD
能够调用此方法;
如果没有,则会抛出安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父轮廓限制。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
quality
int
: The new desired quality. One of
PASSWORD_QUALITY_UNSPECIFIED
,
PASSWORD_QUALITY_SOMETHING
,
PASSWORD_QUALITY_NUMERIC
,
PASSWORD_QUALITY_NUMERIC_COMPLEX
,
PASSWORD_QUALITY_ALPHABETIC
,
PASSWORD_QUALITY_ALPHANUMERIC
or
PASSWORD_QUALITY_COMPLEX
.
boolean setPermissionGrantState (
ComponentName
admin,
String
packageName,
String
permission,
int grantState)
为特定应用程序设置运行时权限的授予状态。
状态可以是
default
,其中用户可以通过界面
denied
(其中权限被拒绝并且用户无法通过UI进行管理)和
granted
(其中授予权限并且用户无法通过UI。
这可能会影响运行时权限所属的组中的所有权限。
此方法只能由配置文件或设备所有者调用。
Setting the grant state to
default
does not revoke the permission. It retains the previous grant, if any.
Permissions can be granted or revoked only for applications built with a
targetSdkVersion
of
M
or later.
void setPermissionPolicy (
ComponentName
admin,
int policy)
由配置文件或设备所有者调用以设置应用程序未来运行时权限请求的默认响应。
该策略可以允许正常操作,该操作提示用户授予权限,或者允许应用程序自动授予或拒绝运行时权限请求。
这也适用于由应用更新声明的新权限。
当以这种方式拒绝或授予权限时,效果等同于通过
setPermissionGrantState(ComponentName, String, String, int)
设置权限授予状态。
As this policy only acts on runtime permission requests, it only applies to applications built with a
targetSdkVersion
of
M
or later.
boolean setPermittedAccessibilityServices (
ComponentName
admin,
List
<
String
> packageNames)
由配置文件或设备所有者调用以设置允许的无障碍服务。 当由设备所有者或配置文件所有者设置时,限制适用于设备所有者或配置文件所有者是管理员的用户的所有配置文件。 默认情况下,用户可以使用任何可访问性服务。 当添加零个或多个软件包时,用户无法启用不在列表中但不属于系统一部分的可访问性服务。
使用列表的空值调用将禁用限制,以便可以使用所有服务,使用空列表进行调用只允许内置系统的服务。
系统可访问性服务始终对用户可用,列表无法修改此项。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
packageNames
List
: List of accessibility service package names.
boolean setPermittedInputMethods (
ComponentName
admin,
List
<
String
> packageNames)
由配置文件或设备所有者调用以设置允许的输入法服务。 当由设备所有者或配置文件所有者设置时,限制适用于设备所有者或配置文件所有者是管理员的用户的所有配置文件。 默认情况下,用户可以使用任何输入法。 当添加零个或多个软件包时,用户无法启用不在列表中而不在系统中的输入法。 如果调用的管理员不是前台用户或前台用户的配置文件,则此方法将失败。
使用列表的空值调用将禁用限制,以便可以使用所有输入方法,使用空列表调用将禁用除系统自己的输入方法以外的所有输入方法。
系统输入法始终可供用户使用,此方法无法修改此操作。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
packageNames
List
: List of input method package names.
void setRecommendedGlobalProxy (
ComponentName
admin,
ProxyInfo
proxyInfo)
设置独立于网络的全局HTTP代理。 这通常不是您想要的典型HTTP代理 - 它们通常取决于网络。 但是,如果你正在做一些不寻常的事情,如一般的内部过滤,这可能是有用 在代理服务器无法访问的专用网络上,您可能会使用它来破坏HTTP。
此方法要求主叫方是设备所有者。
这个代理只是一个建议,有些应用程序可能会忽略它。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
proxyInfo
ProxyInfo
: The a
ProxyInfo
object defining the new global HTTP proxy. A
null
value will clear the global HTTP proxy.
void setRestrictionsProvider (
ComponentName
admin,
ComponentName
provider)
指定一个特定的服务组件作为用户的本地或远程管理员的权限请求的提供者。
Only a profile owner can designate the restrictions provider. void setScreenCaptureDisabled ( ComponentName admin, boolean disabled)
由设备/配置文件所有者调用以设置是否禁用屏幕捕获。
禁用屏幕捕获还会阻止在没有安全视频输出的显示设备上显示内容。
有关安全表面和安全显示的更多详细信息,请参阅
FLAG_SECURE
。
主叫设备管理员必须是设备或配置文件所有者。 如果不是,则会引发安全异常。
从版本
M
禁用屏幕捕获还会阻止相关用户的所有活动的协助请求。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
disabled
boolean
: Whether screen capture is disabled or not.
String
value)
由配置文件或设备所有者调用以更新
Settings.Secure
设置。
验证设置值的设置值是否正确,应由调用者执行。
配置文件或设备所有者可以使用此方法更新的设置是:
DEFAULT_INPUT_METHOD
INSTALL_NON_MARKET_APPS
SKIP_FIRST_USE_HINTS
设备所有者可以另外更新以下设置:
LOCATION_MODE
由设备所有者调用以控制安全日志记录功能。 日志只能在设备所有者管理唯一用户的单个用户设备上启用。
安全日志包含用于安全审计目的的各种信息。
详情请参阅
SecurityLog.SecurityEvent
。
设备所有者只能管理一位用户。
否则会抛出
SecurityException
。
admin
ComponentName
: Which device owner this request is associated with.
enabled
boolean
: whether security logging should be enabled or not.
void setShortSupportMessage (
ComponentName
admin,
CharSequence
message)
由设备管理员调用以设置短支持消息。 这将在管理员禁用功能的设置屏幕中显示给用户。 该信息应限于简短的陈述,例如“此设置已被管理员禁用,请联系 [email protected] 以获得支持。” 如果邮件超过200个字符,则可能会被截断。
如果短支持消息需要本地化,则
DeviceAdminReceiver
负责监听
ACTION_LOCALE_CHANGED
广播并相应地设置该字符串的新版本。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
message
CharSequence
: Short message to be displayed to the user in settings or null to clear the existing message.
int setStorageEncryption (
ComponentName
admin,
boolean encrypt)
由正在管理设备的应用程序调用以请求对存储系统进行加密。
当多个设备管理员试图控制设备加密时,将始终使用最安全,受支持的设置。
如果任何设备管理员请求设备加密,它将被启用;
相反,如果设备管理员尝试禁用设备加密,而其他设备管理员启用了该设备,则禁用的呼叫将失败(通常返回
ENCRYPTION_STATUS_ACTIVE
)。
此策略控制安全(应用程序数据)存储区域的加密。
写入其他存储区域的数据可能会或可能不会被加密,并且此策略不要求或控制任何其他存储区域的加密。
有一个例外:如果
isExternalStorageEmulated()
是
true
,则必须将
getExternalStorageDirectory()
返回的目录写入加密存储区域内的磁盘。
重要说明:在某些设备上,可以在不需要用户创建设备PIN或密码的情况下对存储进行加密。 在这种情况下,存储是加密的,但加密密钥可能不完全安全。 为了最大限度地提高安全性,管理员还应该要求(并检查)模式,PIN或密码。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
encrypt
boolean
: true to request encryption, false to release any previous request
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with. All components in the device owner package can set system update policies and the most recent policy takes effect.
policy
SystemUpdatePolicy
: the new policy, or
null
to clear the current policy.
void setTrustAgentConfiguration (
ComponentName
admin,
ComponentName
target,
PersistableBundle
configuration)
设置为TrustAgent组件启用的配置功能列表。
这意味着要与
KEYGUARD_DISABLE_TRUST_AGENTS
一起使用,它会禁用所有信任代理,但会禁用此函数调用所启用的那些代理。
如果未设置标志
KEYGUARD_DISABLE_TRUST_AGENTS
,则此调用不起作用。
主叫设备管理员必须要求
USES_POLICY_DISABLE_KEYGUARD_FEATURES
能够调用此方法;
如果不是,则会引发安全异常。
这种方法可以在被称为
DevicePolicyManager
通过返回的实例
getParentProfileInstance(ComponentName)
,以便设置父配置文件中的配置。
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
target
ComponentName
: Component name of the agent to be enabled.
configuration
PersistableBundle
: TrustAgent-specific feature bundle. If null for any admin, agent will be strictly disabled according to the state of the
KEYGUARD_DISABLE_TRUST_AGENTS
flag.
如果设置了
KEYGUARD_DISABLE_TRUST_AGENTS
且所有管理员的选项不为空,则由TrustAgent本身负责汇总所有设备管理员的值。
请咨询特定TrustAgent的文档以确定合法选项参数。
void setUninstallBlocked ( ComponentName admin, String packageName, boolean uninstallBlocked)由配置文件或设备所有者调用以更改用户是否可以卸载软件包。
Parameters
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with.
packageName
String
: package to change.
uninstallBlocked
boolean
: true if the user shouldn't be able to uninstall the package.
admin
ComponentName
: Which
DeviceAdminReceiver
this request is associated with, or
null
if calling from a delegated certificate installer.
certBuffer
byte
: encoded form of the certificate to remove.
![]() |
千杯不醉的跑步鞋 · 软件闪退问题_精易论坛 1 年前 |