This page provides an overview of the new APIs, features, and behavior changes introduced in Android 8.0 (API level 26) that affect Android in the enterprise.
New APIs and features
We've made the profile owner and device owner management modes more powerful, productive, and easier to provision than ever before. We've also enabled a whole new deployment scenario—work profiles on fully managed devices. These and other features are described in the following sections.
Work profiles on fully managed devices
In Android 8.0, fully managed devices can also have work profiles. This gives enterprises the ability to separate apps and policies while maintaining control and visibility across both profiles. The existing device owner, or a different device policy controller (DPC), can create the managed profile.
With work profiles on fully managed devices, device owners can:
- Create a managed profile without user interaction by calling
- Receive notifications when secondary users or managed profiles are created or
removed. The callbacks are
- Prevent other DPCs from creating managed profiles using
DISALLOW_ADD_MANAGED_PROFILE. This setting is the default in Android 8.0 for device owners on newly provisioned devices or devices upgraded to Android 8.0.
- Device owners can also prevent users from removing existing managed profiles
Device owners and profile owners can communicate with each other if they're from the same APK and the owners are affiliated (see User affiliation below).
For more detailed information on supporting this new deployment scenario, see the dedicated page for work profiles on fully managed devices.
When a device owner and a profile owner represent the same organization:
The device and profile owners can communicate with each other within the same APK—they might want to share policies or status (see Work profiles on fully managed devices above).
Device-wide features, such as logging or whitelisting lock task mode, can apply to affiliated users.
Affiliation IDs, attached to a profile or user, identify organizations. When affiliation IDs match, the users become affiliated. Device owners and profile owners use setAffiliationIds() to set their affiliation IDs. Represent organizations using long, difficult to guess, string IDs.
New access for affiliated users
If all the secondary users and profiles on a device are affiliated with the device owner, then the following features are available:
- Security logging using
- Network activity logging using
- Bug reporting using
Security logging and bug reporting were previously only available to single-user devices, or devices with only one profile and one user.
Lock task mode is available to secondary users and managed profiles when
affiliated with the device owner through
For more detailed information on user affiliation, see Affiliated
Customized provisioning disclaimers
DPCs can now show their own disclaimers to users during provisioning. Use
to supply styled text disclaimers. A DPC's custom disclaimers appear in the
collapsible Terms list.
Profile owners and device owners can use
to configure a timeout period for unlocking a device or a profile with a
secondary authentication method, such as fingerprints or trust agents. After the
timeout period expires, the user must unlock the device or profile using a
strong authentication method, such as a password, PIN, or pattern.
Device owners and profile owners can securely reset device and work profile
For devices that support
this API is available before a user unlocks their device or profile, provided
the DPC is encryption-aware.
When locking a work profile on a device that supports file-based encryption,
optionally evict the work profile's master encryption keys using
The encryption keys are also evicted if the user turns their work profile
Also, device owners can use
to turn on network logging of DNS queries and TCP connections initiated from
corporate-owned devices. For more information, see Network Activity
Profile owners can restrict which of the primary user's packages can observe
work profile notifications. Call
to set the whitelisted packages that receive events through a
NotificationListenerService. Setting the
permitted listeners to
null (the default) disables the whitelisting and all
packages can listen for notifications. To limit events to system packages, pass
an empty Set. To view apps that can't access work profile notifications, users
can tap Settings > Apps & notifications > Special app access >
Finally, profile owners and device owners can retrieve information about the
pending system updates that are available on a device using
App management API delegation
API delegation enables device owners and profile owners to fully offload app
management to other applications. The
DevicePolicyManager class provides methods to manage
the delegation scopes that device and profile owners can grant to a package:
setDelegatedScopes()method allows device owners and profile owners to grant access to privileged APIs to other apps.
getDelegatedScopes()method returns the scopes granted to a package.
getDelegatePackages()returns the packages that have a scope.
The following table shows how various methods in
DevicePolicyManager are organized into the different
Long-running background services
Device and profile owners can subclass
DeviceAdminService to create background services. The
Android system attempts to keep the service running while the user is running.
If you want to run periodic tasks, consider using
JobScheduler before creating a background service.
Controlling the backup service
Device owners can toggle the Android Backup Service
using new methods in
DevicePolicyManager. Enable and
disable the backup service using
Check the backup service status using
Wi-Fi proxy configuration
Device owners and profile owners can configure HTTP proxy servers for Wi-Fi
networks. Use a PAC file or manual settings to configure a proxy server for each
Wi-Fi network. To set or remove the proxy for a
WifiConfiguration, call its
method. To get the proxy settings call
Explanation dialogs for admin-disabled features
Your app should show a useful explanation to users trying to use an
admin-disabled feature. All apps can now use
to create an intent that displays an explanation dialog when passed to
Intents include customized, localized explanations for disabled cameras,
disabled screen captures, and all the
Device owners can disable Bluetooth—affecting all users and profiles on the
device. To turn off Bluetooth, add the user restriction
Device owners and profile owners can prevent users sending files over Bluetooth
DISALLOW_BLUETOOTH_SHARING. Receiving files
isn't affected. When set by a device owner,
to all users on the device. This setting is the default in Android 8.0 for new
profiles and existing profiles on devices upgraded to Android 8.0.
If you're building apps for businesses, including DPCs, you should review the following behavior changes in Android 8.0 and modify your app accordingly.
The following changes have taken effect in the
lockNow()method only locks the work profile if a separate work challenge is active.
resetPassword()method is no longer available to DPCs that act as device owners or profile owners and target Android 8.0. If called, a security exception is thrown. Instead, DPCs should use
Note: DPCs targeting Android 7.1.1 (API level 25) or lower, as well as DPCs with only device admin privileges, aren't affected by this change.
- For devices that support file-based encryption,
isActivePasswordSufficient()isn't available before the user unlocks the device for the first time after a reboot. If called before the user unlocks the device, an exception is thrown.
Data from locked work profiles
Android 8.0 includes user interface changes to separate data from a locked work profile.
- Notifications for apps in the work profile might now hide their content. Previously, the notification drawer showed the content for work apps from a locked work profile.
- The Recents screen now shows a plain panel for running apps from a locked work profile. The plain, color-keyed panel contains an app's icon and name. Previously, activities or tasks from a locked work profile showed a preview in the Recents screen.
ENSURE_VERIFY_APPSflag is now a global user restriction. If any user on the device has this restriction, app verification is enforced across all users on the device. For example, if a profile owner sets the restriction on the work profile, app verification is enforced on the user's personal profile.
onSystemUpdatePending()method is now invoked for profile owners in addition to device owners.
- When using the
SystemUpdatePolicyclass, the postpone policy no longer applies to security patches, so security patches can no longer be postponed. The behavior of other policy types, such as automatic and windowed, aren't affected, however.
- Device owners can trigger a factory reset using
wipeData(), even if
Android 8.0 includes user interface changes to help users understand the status of always-on VPN connections:
- When always-on VPN connections disconnect or can't connect, users see a non-dismissible notification. Tapping the notification shows the VPN configuration settings. The notification disappears when the VPN reconnects or the user turns off the always-on VPN option.
- Always-on VPN allows the person using a device to block any network connections that don't use the VPN. When turning this option on, the Settings app warns the user that they won't have an internet connection until the VPN connects. Settings prompts the user to continue or cancel.
VpnService of VPN apps must now call its
method after launch. Because the Android system starts a VPN app's service
directly, transitioning to the foreground is the app's responsibility. Android 8.0
shuts down VPN apps that don't transition the VPN service to the foreground.
The password change callbacks of
now include a
user parameter to identify the user or profile the password
belongs to. The new method signatures are:
onPasswordChanged(Context, Intent, UserHandle)
onPasswordExpiring(Context, Intent, UserHandle)
onPasswordFailed(Context, Intent, UserHandle)
onPasswordSucceeded(Context, Intent, UserHandle)
The default implementation of each new method calls the previous version—dropping the user argument. Android 8.0 deprecates the previous methods.
App management API delegation
The following methods in the
are now deprecated:
Also, it's now possible to delegate a single scope to multiple packages. In other words, device owners and profile owners can grant two different packages access to the same set of APIs simultaneously.