Most visited

Recently visited

Results for

VpnService

public class VpnService
extends Service

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	android.net.VpnService

VpnService is a base class for applications to extend and build their own VPN solutions. In general, it creates a virtual network interface, configures addresses and routing rules, and returns a file descriptor to the application. Each read from the descriptor retrieves an outgoing packet which was routed to the interface. Each write to the descriptor injects an incoming packet just like it was received from the interface. The interface is running on Internet Protocol (IP), so packets are always started with IP headers. The application then completes a VPN connection by processing and exchanging packets with the remote server over a tunnel.

Letting applications intercept packets raises huge security concerns. A VPN application can easily break the network. Besides, two of them may conflict with each other. The system takes several actions to address these issues. Here are some key points:

User action is required the first time an application creates a VPN connection.
There can be only one VPN connection running at the same time. The existing interface is deactivated when a new one is created.
A system-managed notification is shown during the lifetime of a VPN connection.
A system-managed dialog gives the information of the current VPN connection. It also provides a button to disconnect.
The network is restored automatically when the file descriptor is closed. It also covers the cases when a VPN application is crashed or killed by the system.

There are two primary methods in this class: prepare(Context) and Builder#establish. The former deals with user action and stops the VPN connection created by another application. The latter creates a VPN interface using the parameters supplied to the Builder. An application must call prepare(Context) to grant the right to use other methods in this class, and the right can be revoked at any time. Here are the general steps to create a VPN connection:

When the user presses the button to connect, call prepare(Context) and launch the returned intent, if non-null.
When the application becomes prepared, start the service.
Create a tunnel to the remote server and negotiate the network parameters for the VPN connection.
Supply those parameters to a Builder and create a VPN interface by calling Builder#establish.
Process and exchange packets between the tunnel and the returned file descriptor.
When onRevoke() is invoked, close the file descriptor and shut down the tunnel gracefully.

Services extending this class need to be declared with an appropriate permission and intent filter. Their access must be secured by Manifest.permission.BIND_VPN_SERVICE permission, and their intent filter must match SERVICE_INTERFACE action. Here is an example of declaring a VPN service in AndroidManifest.xml:

 <service android:name=".ExampleVpnService"
         android:permission="android.permission.BIND_VPN_SERVICE">
     <intent-filter>
         <action android:name="android.net.VpnService"/>
     </intent-filter>
 </service>

The Android system starts a VPN in the background by calling startService(). In Android 8.0 (API level 26) and higher, the system places VPN apps on the temporary whitelist for a short period so the app can start in the background. The VPN app must promote itself to the foreground after it's launched or the system will shut down the app.

Developer's guide

To learn more about developing VPN apps, read the VPN developer's guide.

See also:

VpnService.Builder

Summary

Nested classes
`class`	`VpnService.Builder` Helper class to create a VPN interface.

Constants
`String`	`SERVICE_INTERFACE` The action must be matched by the intent filter of this service.
`String`	`SERVICE_META_DATA_SUPPORTS_ALWAYS_ON` Key for boolean meta-data field indicating whether this VpnService supports always-on mode.

Inherited constants

From class android.app.Service

`int`	`START_CONTINUATION_MASK` Bits returned by `onStartCommand(Intent, int, int)` describing how to continue the service if it is killed.
`int`	`START_FLAG_REDELIVERY` This flag is set in `onStartCommand(Intent, int, int)` if the Intent is a re-delivery of a previously delivered intent, because the service had previously returned `START_REDELIVER_INTENT` but had been killed before calling `stopSelf(int)` for that Intent.
`int`	`START_FLAG_RETRY` This flag is set in `onStartCommand(Intent, int, int)` if the Intent is a retry because the original attempt never got to or returned from `onStartCommand(android.content.Intent, int, int)`.
`int`	`START_NOT_STICKY` Constant to return from `onStartCommand(Intent, int, int)`: if this service's process is killed while it is started (after returning from `onStartCommand(Intent, int, int)`), and there are no new start intents to deliver to it, then take the service out of the started state and don't recreate until a future explicit call to `Context#startService`.
`int`	`START_REDELIVER_INTENT` Constant to return from `onStartCommand(Intent, int, int)`: if this service's process is killed while it is started (after returning from `onStartCommand(Intent, int, int)`), then it will be scheduled for a restart and the last delivered Intent re-delivered to it again via `onStartCommand(Intent, int, int)`.
`int`	`START_STICKY` Constant to return from `onStartCommand(Intent, int, int)`: if this service's process is killed while it is started (after returning from `onStartCommand(Intent, int, int)`), then leave it in the started state but don't retain this delivered intent.
`int`	`START_STICKY_COMPATIBILITY` Constant to return from `onStartCommand(Intent, int, int)`: compatibility version of `START_STICKY` that does not guarantee that `onStartCommand(Intent, int, int)` will be called again after being killed.
`int`	`STOP_FOREGROUND_DETACH` Flag for `stopForeground(int)`: if set, the notification previously provided to `startForeground(int, Notification)` will be detached from the service.
`int`	`STOP_FOREGROUND_REMOVE` Flag for `stopForeground(int)`: if set, the notification previously provided to `startForeground(int, Notification)` will be removed.

From class android.content.Context

`String`	`ACCESSIBILITY_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `AccessibilityManager` for giving the user feedback for UI events through the registered event listeners.
`String`	`ACCOUNT_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `AccountManager` for receiving intents at a time of your choosing.
`String`	`ACTIVITY_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `ActivityManager` for interacting with the global system state.
`String`	`ALARM_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `AlarmManager` for receiving intents at a time of your choosing.
`String`	`APPWIDGET_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `AppWidgetManager` for accessing AppWidgets.
`String`	`APP_OPS_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `AppOpsManager` for tracking application operations on the device.
`String`	`AUDIO_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `AudioManager` for handling management of volume, ringer modes and audio routing.
`String`	`BATTERY_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `BatteryManager` for managing battery state.
`int`	`BIND_ABOVE_CLIENT` Flag for `bindService(Intent, ServiceConnection, int)`: indicates that the client application binding to this service considers the service to be more important than the app itself.
`int`	`BIND_ADJUST_WITH_ACTIVITY` Flag for `bindService(Intent, ServiceConnection, int)`: If binding from an activity, allow the target service's process importance to be raised based on whether the activity is visible to the user, regardless whether another flag is used to reduce the amount that the client process's overall importance is used to impact it.
`int`	`BIND_ALLOW_OOM_MANAGEMENT` Flag for `bindService(Intent, ServiceConnection, int)`: allow the process hosting the bound service to go through its normal memory management.
`int`	`BIND_AUTO_CREATE` Flag for `bindService(Intent, ServiceConnection, int)`: automatically create the service as long as the binding exists.
`int`	`BIND_DEBUG_UNBIND` Flag for `bindService(Intent, ServiceConnection, int)`: include debugging help for mismatched calls to unbind.
`int`	`BIND_EXTERNAL_SERVICE` Flag for `bindService(Intent, ServiceConnection, int)`: The service being bound is an `isolated`, `external` service.
`int`	`BIND_IMPORTANT` Flag for `bindService(Intent, ServiceConnection, int)`: this service is very important to the client, so should be brought to the foreground process level when the client is.
`int`	`BIND_INCLUDE_CAPABILITIES` Flag for `bindService(Intent, ServiceConnection, int)`: If binding from an app that has specific capabilities due to its foreground state such as an activity or foreground service, then this flag will allow the bound app to get the same capabilities, as long as it has the required permissions as well.
`int`	`BIND_NOT_FOREGROUND` Flag for `bindService(Intent, ServiceConnection, int)`: don't allow this binding to raise the target service's process to the foreground scheduling priority.
`int`	`BIND_NOT_PERCEPTIBLE` Flag for `bindService(Intent, ServiceConnection, int)`: If binding from an app that is visible or user-perceptible, lower the target service's importance to below the perceptible level.
`int`	`BIND_WAIVE_PRIORITY` Flag for `bindService(Intent, ServiceConnection, int)`: don't impact the scheduling or memory management priority of the target service's hosting process.
`String`	`BIOMETRIC_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `BiometricManager` for handling biometric and PIN/pattern/password authentication.
`String`	`BLOB_STORE_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `BlobStoreManager` for contributing and accessing data blobs from the blob store maintained by the system.
`String`	`BLUETOOTH_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `BluetoothManager` for using Bluetooth.
`String`	`CAMERA_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `CameraManager` for interacting with camera devices.
`String`	`CAPTIONING_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `CaptioningManager` for obtaining captioning properties and listening for changes in captioning preferences.
`String`	`CARRIER_CONFIG_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `CarrierConfigManager` for reading carrier configuration values.
`String`	`CLIPBOARD_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `ClipboardManager` for accessing and modifying the contents of the global clipboard.
`String`	`COMPANION_DEVICE_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `CompanionDeviceManager` for managing companion devices
`String`	`CONNECTIVITY_DIAGNOSTICS_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `ConnectivityDiagnosticsManager` for performing network connectivity diagnostics as well as receiving network connectivity information from the system.
`String`	`CONNECTIVITY_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `ConnectivityManager` for handling management of network connections.
`String`	`CONSUMER_IR_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `ConsumerIrManager` for transmitting infrared signals from the device.
`int`	`CONTEXT_IGNORE_SECURITY` Flag for use with `createPackageContext(String, int)`: ignore any security restrictions on the Context being requested, allowing it to always be loaded.
`int`	`CONTEXT_INCLUDE_CODE` Flag for use with `createPackageContext(String, int)`: include the application code with the context.
`int`	`CONTEXT_RESTRICTED` Flag for use with `createPackageContext(String, int)`: a restricted context may disable specific features.
`String`	`CROSS_PROFILE_APPS_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `CrossProfileApps` for cross profile operations.
`String`	`DEVICE_POLICY_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `DevicePolicyManager` for working with global device policy management.
`String`	`DISPLAY_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `DisplayManager` for interacting with display devices.
`String`	`DOWNLOAD_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `DownloadManager` for requesting HTTP downloads.
`String`	`DROPBOX_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `DropBoxManager` instance for recording diagnostic logs.
`String`	`EUICC_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `EuiccManager` to manage the device eUICC (embedded SIM).
`String`	`FILE_INTEGRITY_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve an `FileIntegrityManager`.
`String`	`FINGERPRINT_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `FingerprintManager` for handling management of fingerprints.
`String`	`HARDWARE_PROPERTIES_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `HardwarePropertiesManager` for accessing the hardware properties service.
`String`	`INPUT_METHOD_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `InputMethodManager` for accessing input methods.
`String`	`INPUT_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `InputManager` for interacting with input devices.
`String`	`IPSEC_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `IpSecManager` for encrypting Sockets or Networks with IPSec.
`String`	`JOB_SCHEDULER_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `JobScheduler` instance for managing occasional background tasks.
`String`	`KEYGUARD_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `KeyguardManager` for controlling keyguard.
`String`	`LAUNCHER_APPS_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `LauncherApps` for querying and monitoring launchable apps across profiles of a user.
`String`	`LAYOUT_INFLATER_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `LayoutInflater` for inflating layout resources in this context.
`String`	`LOCATION_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `LocationManager` for controlling location updates.
`String`	`MEDIA_PROJECTION_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `MediaProjectionManager` instance for managing media projection sessions.
`String`	`MEDIA_ROUTER_SERVICE` Use with `getSystemService(Class)` to retrieve a `MediaRouter` for controlling and managing routing of media.
`String`	`MEDIA_SESSION_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `MediaSessionManager` for managing media Sessions.
`String`	`MIDI_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `MidiManager` for accessing the MIDI service.
`int`	`MODE_APPEND` File creation mode: for use with `openFileOutput(String, int)`, if the file already exists then write data to the end of the existing file instead of erasing it.
`int`	`MODE_ENABLE_WRITE_AHEAD_LOGGING` Database open flag: when set, the database is opened with write-ahead logging enabled by default.
`int`	`MODE_MULTI_PROCESS` This constant is deprecated. MODE_MULTI_PROCESS does not work reliably in some versions of Android, and furthermore does not provide any mechanism for reconciling concurrent modifications across processes. Applications should not attempt to use it. Instead, they should use an explicit cross-process data management approach such as `ContentProvider`.
`int`	`MODE_NO_LOCALIZED_COLLATORS` Database open flag: when set, the database is opened without support for localized collators.
`int`	`MODE_PRIVATE` File creation mode: the default mode, where the created file can only be accessed by the calling application (or all applications sharing the same user ID).
`int`	`MODE_WORLD_READABLE` This constant is deprecated. Creating world-readable files is very dangerous, and likely to cause security holes in applications. It is strongly discouraged; instead, applications should use more formal mechanism for interactions such as `ContentProvider`, `BroadcastReceiver`, and `Service`. There are no guarantees that this access mode will remain on a file, such as when it goes through a backup and restore.
`int`	`MODE_WORLD_WRITEABLE` This constant is deprecated. Creating world-writable files is very dangerous, and likely to cause security holes in applications. It is strongly discouraged; instead, applications should use more formal mechanism for interactions such as `ContentProvider`, `BroadcastReceiver`, and `Service`. There are no guarantees that this access mode will remain on a file, such as when it goes through a backup and restore.
`String`	`NETWORK_STATS_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `NetworkStatsManager` for querying network usage stats.
`String`	`NFC_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `NfcManager` for using NFC.
`String`	`NOTIFICATION_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `NotificationManager` for informing the user of background events.
`String`	`NSD_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `NsdManager` for handling management of network service discovery
`String`	`POWER_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `PowerManager` for controlling power management, including "wake locks," which let you keep the device on while you're running long tasks.
`String`	`PRINT_SERVICE` `PrintManager` for printing and managing printers and print tasks.
`int`	`RECEIVER_VISIBLE_TO_INSTANT_APPS` Flag for `registerReceiver(BroadcastReceiver, IntentFilter)`: The receiver can receive broadcasts from Instant Apps.
`String`	`RESTRICTIONS_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `RestrictionsManager` for retrieving application restrictions and requesting permissions for restricted operations.
`String`	`ROLE_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `RoleManager` for managing roles.
`String`	`SEARCH_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `SearchManager` for handling searches.
`String`	`SENSOR_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `SensorManager` for accessing sensors.
`String`	`SHORTCUT_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `ShortcutManager` for accessing the launcher shortcut service.
`String`	`STORAGE_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `StorageManager` for accessing system storage functions.
`String`	`STORAGE_STATS_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `StorageStatsManager` for accessing system storage statistics.
`String`	`SYSTEM_HEALTH_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `SystemHealthManager` for accessing system health (battery, power, memory, etc) metrics.
`String`	`TELECOM_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `TelecomManager` to manage telecom-related features of the device.
`String`	`TELEPHONY_IMS_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve an `ImsManager`.
`String`	`TELEPHONY_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `TelephonyManager` for handling management the telephony features of the device.
`String`	`TELEPHONY_SUBSCRIPTION_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `SubscriptionManager` for handling management the telephony subscriptions of the device.
`String`	`TEXT_CLASSIFICATION_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `TextClassificationManager` for text classification services.
`String`	`TEXT_SERVICES_MANAGER_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `TextServicesManager` for accessing text services.
`String`	`TV_INPUT_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `TvInputManager` for interacting with TV inputs on the device.
`String`	`UI_MODE_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `UiModeManager` for controlling UI modes.
`String`	`USAGE_STATS_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `UsageStatsManager` for querying device usage stats.
`String`	`USB_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `UsbManager` for access to USB devices (as a USB host) and for controlling this device's behavior as a USB device.
`String`	`USER_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `UserManager` for managing users on devices that support multiple users.
`String`	`VIBRATOR_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `Vibrator` for interacting with the vibration hardware.
`String`	`VPN_MANAGEMENT_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `VpnManager` to manage profiles for the platform built-in VPN.
`String`	`WALLPAPER_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a com.android.server.WallpaperService for accessing wallpapers.
`String`	`WIFI_AWARE_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `WifiAwareManager` for handling management of Wi-Fi Aware.
`String`	`WIFI_P2P_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `WifiP2pManager` for handling management of Wi-Fi peer-to-peer connections.
`String`	`WIFI_RTT_RANGING_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `WifiRttManager` for ranging devices with wifi.
`String`	`WIFI_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `WifiManager` for handling management of Wi-Fi access.
`String`	`WINDOW_SERVICE` Use with `getSystemService(java.lang.String)` to retrieve a `WindowManager` for accessing the system's window manager.

From interface android.content.ComponentCallbacks2

`int`	`TRIM_MEMORY_BACKGROUND` Level for `onTrimMemory(int)`: the process has gone on to the LRU list.
`int`	`TRIM_MEMORY_COMPLETE` Level for `onTrimMemory(int)`: the process is nearing the end of the background LRU list, and if more memory isn't found soon it will be killed.
`int`	`TRIM_MEMORY_MODERATE` Level for `onTrimMemory(int)`: the process is around the middle of the background LRU list; freeing memory can help the system keep other processes running later in the list for better overall performance.
`int`	`TRIM_MEMORY_RUNNING_CRITICAL` Level for `onTrimMemory(int)`: the process is not an expendable background process, but the device is running extremely low on memory and is about to not be able to keep any background processes running.
`int`	`TRIM_MEMORY_RUNNING_LOW` Level for `onTrimMemory(int)`: the process is not an expendable background process, but the device is running low on memory.
`int`	`TRIM_MEMORY_RUNNING_MODERATE` Level for `onTrimMemory(int)`: the process is not an expendable background process, but the device is running moderately low on memory.
`int`	`TRIM_MEMORY_UI_HIDDEN` Level for `onTrimMemory(int)`: the process had been showing a user interface, and is no longer doing so.

Public constructors
`VpnService()`

Public methods
`final boolean`	`isAlwaysOn()` Returns whether the service is running in always-on VPN mode.
`final boolean`	`isLockdownEnabled()` Returns whether the service is running in always-on VPN lockdown mode.
`IBinder`	`onBind(Intent intent)` Return the communication interface to the service.
`void`	`onRevoke()` Invoked when the application is revoked.
`static Intent`	`prepare(Context context)` Prepare to establish a VPN connection.
`boolean`	`protect(Socket socket)` Convenience method to protect a `Socket` from VPN connections.
`boolean`	`protect(int socket)` Protect a socket from VPN connections.
`boolean`	`protect(DatagramSocket socket)` Convenience method to protect a `DatagramSocket` from VPN connections.
`boolean`	`setUnderlyingNetworks(Network[] networks)` Sets the underlying networks used by the VPN for its upstream connections.

Inherited methods

From class


        
          android.app.Service

`void`	`attachBaseContext(Context newBase)` Set the base context for this ContextWrapper.
`void`	`dump(FileDescriptor fd, PrintWriter writer, String[] args)` Print the Service's state into the given stream.
`final Application`	`getApplication()` Return the application that owns this service.
`final int`	`getForegroundServiceType()` If the service has become a foreground service by calling `startForeground(int, android.app.Notification)` or `startForeground(int, android.app.Notification, int)`, `getForegroundServiceType()` returns the current foreground service type.
`abstract IBinder`	`onBind(Intent intent)` Return the communication channel to the service.
`void`	`onConfigurationChanged(Configuration newConfig)` Called by the system when the device configuration changes while your component is running.
`void`	`onCreate()` Called by the system when the service is first created.
`void`	`onDestroy()` Called by the system to notify a Service that it is no longer used and is being removed.
`void`	`onLowMemory()` This is called when the overall system is running low on memory, and actively running processes should trim their memory usage.
`void`	`onRebind(Intent intent)` Called when new clients have connected to the service, after it had previously been notified that all had disconnected in its `onUnbind(Intent)`.
`void`	`onStart(Intent intent, int startId)` This method is deprecated. Implement `onStartCommand(android.content.Intent, int, int)` instead.
`int`	`onStartCommand(Intent intent, int flags, int startId)` Called by the system every time a client explicitly starts the service by calling `Context.startService(Intent)`, providing the arguments it supplied and a unique integer token representing the start request.
`void`	`onTaskRemoved(Intent rootIntent)` This is called if the service is currently running and the user has removed a task that comes from the service's application.
`void`	`onTrimMemory(int level)` Called when the operating system has determined that it is a good time for a process to trim unneeded memory from its process.
`boolean`	`onUnbind(Intent intent)` Called when all clients have disconnected from a particular interface published by the service.
`final void`	`startForeground(int id, Notification notification)` If your service is started (running through `Context#startService(Intent)`), then also make this service run in the foreground, supplying the ongoing notification to be shown to the user while in this state.
`final void`	`startForeground(int id, Notification notification, int foregroundServiceType)` An overloaded version of `startForeground(int, android.app.Notification)` with additional foregroundServiceType parameter.
`final void`	`stopForeground(int flags)` Remove this service from foreground state, allowing it to be killed if more memory is needed.
`final void`	`stopForeground(boolean removeNotification)` Synonym for `stopForeground(int)`.
`final void`	`stopSelf()` Stop the service, if it was previously started.
`final void`	`stopSelf(int startId)` Old version of `stopSelfResult(int)` that doesn't return a result.
`final boolean`	`stopSelfResult(int startId)` Stop the service if the most recent time it was started was `startId`.

From class


        
          android.content.ContextWrapper

`void`	`attachBaseContext(Context base)` Set the base context for this ContextWrapper.
`boolean`	`bindIsolatedService(Intent service, int flags, String instanceName, Executor executor, ServiceConnection conn)` Variation of `bindService(Intent, ServiceConnection, int)` that, in the specific case of isolated services, allows the caller to generate multiple instances of a service from a single component declaration.
`boolean`	`bindService(Intent service, int flags, Executor executor, ServiceConnection conn)` Same as `bindService(android.content.Intent, android.content.ServiceConnection, int)` with executor to control ServiceConnection callbacks.
`boolean`	`bindService(Intent service, ServiceConnection conn, int flags)` Connect to an application service, creating it if needed.
`int`	`checkCallingOrSelfPermission(String permission)` Determine whether the calling process of an IPC or you have been granted a particular permission.
`int`	`checkCallingOrSelfUriPermission(Uri uri, int modeFlags)` Determine whether the calling process of an IPC or you has been granted permission to access a specific URI.
`int`	`checkCallingPermission(String permission)` Determine whether the calling process of an IPC you are handling has been granted a particular permission.
`int`	`checkCallingUriPermission(Uri uri, int modeFlags)` Determine whether the calling process and user ID has been granted permission to access a specific URI.
`int`	`checkPermission(String permission, int pid, int uid)` Determine whether the given permission is allowed for a particular process and user ID running in the system.
`int`	`checkSelfPermission(String permission)` Determine whether you have been granted a particular permission.
`int`	`checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)` Check both a Uri and normal permission.
`int`	`checkUriPermission(Uri uri, int pid, int uid, int modeFlags)` Determine whether a particular process and user ID has been granted permission to access a specific URI.
`void`	`clearWallpaper()` This method is deprecated. Use `WallpaperManager.clear()` instead. This method requires the caller to hold the permission `Manifest.permission.SET_WALLPAPER`.
`Context`	`createAttributionContext(String attributionTag)` Return a new Context object for the current Context but attribute to a different tag.
`Context`	`createConfigurationContext(Configuration overrideConfiguration)` Return a new Context object for the current Context but whose resources are adjusted to match the given Configuration.
`Context`	`createDeviceProtectedStorageContext()` Return a new Context object for the current Context but whose storage APIs are backed by device-protected storage.
`Context`	`createDisplayContext(Display display)` Return a new Context object for the current Context but whose resources are adjusted to match the metrics of the given Display.
`Context`	`createPackageContext(String packageName, int flags)` Return a new Context object for the given application name.
`Context`	`createWindowContext(int type, Bundle options)` Creates a Context for a non-activity window.
`String[]`	`databaseList()` Returns an array of strings naming the private databases associated with this Context's application package.
`boolean`	`deleteDatabase(String name)` Delete an existing private SQLiteDatabase associated with this Context's application package.
`boolean`	`deleteFile(String name)` Delete the given private file associated with this Context's application package.
`boolean`	`deleteSharedPreferences(String name)` Delete an existing shared preferences file.
`void`	`enforceCallingOrSelfPermission(String permission, String message)` If neither you nor the calling process of an IPC you are handling has been granted a particular permission, throw a `SecurityException`.
`void`	`enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)` If the calling process of an IPC or you has not been granted permission to access a specific URI, throw `SecurityException`.
`void`	`enforceCallingPermission(String permission, String message)` If the calling process of an IPC you are handling has not been granted a particular permission, throw a `SecurityException`.
`void`	`enforceCallingUriPermission(Uri uri, int modeFlags, String message)` If the calling process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`void`	`enforcePermission(String permission, int pid, int uid, String message)` If the given permission is not allowed for a particular process and user ID running in the system, throw a `SecurityException`.
`void`	`enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)` Enforce both a Uri and normal permission.
`void`	`enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)` If a particular process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`String[]`	`fileList()` Returns an array of strings naming the private files associated with this Context's application package.
`Context`	`getApplicationContext()` Return the context of the single, global Application object of the current process.
`ApplicationInfo`	`getApplicationInfo()` Return the full application info for this context's package.
`AssetManager`	`getAssets()` Returns an AssetManager instance for the application's package.
`Context`	`getBaseContext()`
`File`	`getCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem.
`ClassLoader`	`getClassLoader()` Return a class loader you can use to retrieve classes in this package.
`File`	`getCodeCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem designed for storing cached code.
`ContentResolver`	`getContentResolver()` Return a ContentResolver instance for your application's package.
`File`	`getDataDir()` Returns the absolute path to the directory on the filesystem where all private files belonging to this app are stored.
`File`	`getDatabasePath(String name)` Returns the absolute path on the filesystem where a database created with `openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory)` is stored.
`File`	`getDir(String name, int mode)` Retrieve, creating if needed, a new directory in which the application can place its own custom data files.
`Display`	`getDisplay()` Get the display this context is associated with.
`File`	`getExternalCacheDir()` Returns absolute path to application-specific directory on the primary shared/external storage device where the application can place cache files it owns.
`File[]`	`getExternalCacheDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place cache files it owns.
`File`	`getExternalFilesDir(String type)` Returns the absolute path to the directory on the primary shared/external storage device where the application can place persistent files it owns.
`File[]`	`getExternalFilesDirs(String type)` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place persistent files it owns.
`File[]`	`getExternalMediaDirs()` This method is deprecated. These directories still exist and are scanned, but developers are encouraged to migrate to inserting content into a `MediaStore` collection directly, as any app can contribute new media to `MediaStore` with no permissions required, starting in `Build.VERSION_CODES.Q`.
`File`	`getFileStreamPath(String name)` Returns the absolute path on the filesystem where a file created with `openFileOutput(String, int)` is stored.
`File`	`getFilesDir()` Returns the absolute path to the directory on the filesystem where files created with `openFileOutput(String, int)` are stored.
`Executor`	`getMainExecutor()` Return an `Executor` that will run enqueued tasks on the main thread associated with this context.
`Looper`	`getMainLooper()` Return the Looper for the main thread of the current process.
`File`	`getNoBackupFilesDir()` Returns the absolute path to the directory on the filesystem similar to `getFilesDir()`.
`File`	`getObbDir()` Return the primary shared/external storage directory where this application's OBB files (if there are any) can be found.
`File[]`	`getObbDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application's OBB files (if there are any) can be found.
`String`	`getPackageCodePath()` Return the full path to this context's primary Android package.
`PackageManager`	`getPackageManager()` Return PackageManager instance to find global package information.
`String`	`getPackageName()` Return the name of this application's package.
`String`	`getPackageResourcePath()` Return the full path to this context's primary Android package.
`Resources`	`getResources()` Returns a Resources instance for the application's package.
`SharedPreferences`	`getSharedPreferences(String name, int mode)` Retrieve and hold the contents of the preferences file 'name', returning a SharedPreferences through which you can retrieve and modify its values.
`Object`	`getSystemService(String name)` Return the handle to a system-level service by name.
`String`	`getSystemServiceName(Class<?> serviceClass)` Gets the name of the system-level service that is represented by the specified class.
`Resources.Theme`	`getTheme()` Return the Theme object associated with this Context.
`Drawable`	`getWallpaper()` This method is deprecated. Use `WallpaperManager.get()` instead.
`int`	`getWallpaperDesiredMinimumHeight()` This method is deprecated. Use `WallpaperManager.getDesiredMinimumHeight()` instead.
`int`	`getWallpaperDesiredMinimumWidth()` This method is deprecated. Use `WallpaperManager.getDesiredMinimumWidth()` instead.
`void`	`grantUriPermission(String toPackage, Uri uri, int modeFlags)` Grant permission to access a specific Uri to another package, regardless of whether that package has general permission to access the Uri's content provider.
`boolean`	`isDeviceProtectedStorage()` Indicates if the storage APIs of this Context are backed by device-protected storage.
`boolean`	`isRestricted()` Indicates whether this Context is restricted.
`boolean`	`moveDatabaseFrom(Context sourceContext, String name)` Move an existing database file from the given source storage context to this context.
`boolean`	`moveSharedPreferencesFrom(Context sourceContext, String name)` Move an existing shared preferences file from the given source storage context to this context.
`FileInputStream`	`openFileInput(String name)` Open a private file associated with this Context's application package for reading.
`FileOutputStream`	`openFileOutput(String name, int mode)` Open a private file associated with this Context's application package for writing.
`SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)` Open a new private SQLiteDatabase associated with this Context's application package.
`SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)` Open a new private SQLiteDatabase associated with this Context's application package.
`Drawable`	`peekWallpaper()` This method is deprecated. Use `WallpaperManager.peek()` instead.
`Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter)` Register a BroadcastReceiver to be run in the main activity thread.
`Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, int flags)` Register to receive intent broadcasts, with the receiver optionally being exposed to Instant Apps.
`Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler, int flags)` Register to receive intent broadcasts, to run in the context of `scheduler`.
`Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)` Register to receive intent broadcasts, to run in the context of `scheduler`.
`void`	`removeStickyBroadcast(Intent intent)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`removeStickyBroadcastAsUser(Intent intent, UserHandle user)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`revokeUriPermission(Uri uri, int modeFlags)` Remove all permissions to access a particular content provider Uri that were previously added with `grantUriPermission(String, Uri, int)` or any other mechanism.
`void`	`revokeUriPermission(String targetPackage, Uri uri, int modeFlags)` Remove permissions to access a particular content provider Uri that were previously added with `grantUriPermission(String, Uri, int)` for a specific target package.
`void`	`sendBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, allowing an optional required permission to be enforced.
`void`	`sendBroadcast(Intent intent)` Broadcast the given intent to all interested BroadcastReceivers.
`void`	`sendBroadcastAsUser(Intent intent, UserHandle user)` Version of `sendBroadcast(android.content.Intent)` that allows you to specify the user the broadcast will be sent to.
`void`	`sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)` Version of `sendBroadcast(android.content.Intent, java.lang.String)` that allows you to specify the user the broadcast will be sent to.
`void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, String receiverAppOp, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendOrderedBroadcast(android.content.Intent, java.lang.String, android.content.BroadcastReceiver, android.os.Handler, int, java.lang.String, android.os.Bundle)` that allows you to specify the App Op to enforce restrictions on which receivers the broadcast will be sent to.
`void`	`sendOrderedBroadcast(Intent intent, int initialCode, String receiverPermission, String receiverAppOp, BroadcastReceiver resultReceiver, Handler scheduler, String initialData, Bundle initialExtras, Bundle options)`
`void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendBroadcast(android.content.Intent)` that allows you to receive data back from the broadcast.
`void`	`sendOrderedBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, delivering them one at a time to allow more preferred receivers to consume the broadcast before it is delivered to less preferred receivers.
`void`	`sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendOrderedBroadcast(android.content.Intent, java.lang.String, android.content.BroadcastReceiver, android.os.Handler, int, java.lang.String, android.os.Bundle)` that allows you to specify the user the broadcast will be sent to.
`void`	`sendStickyBroadcast(Intent intent)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`sendStickyBroadcastAsUser(Intent intent, UserHandle user)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`setTheme(int resid)` Set the base theme for this context.
`void`	`setWallpaper(Bitmap bitmap)` This method is deprecated. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `Manifest.permission.SET_WALLPAPER`.
`void`	`setWallpaper(InputStream data)` This method is deprecated. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `Manifest.permission.SET_WALLPAPER`.
`void`	`startActivities(Intent[] intents, Bundle options)` Launch multiple new activities.
`void`	`startActivities(Intent[] intents)` Same as `startActivities(android.content.Intent[], android.os.Bundle)` with no options specified.
`void`	`startActivity(Intent intent)` Same as `startActivity(android.content.Intent, android.os.Bundle)` with no options specified.
`void`	`startActivity(Intent intent, Bundle options)` Launch a new activity.
`ComponentName`	`startForegroundService(Intent service)` Similar to `startService(android.content.Intent)`, but with an implicit promise that the Service will call `startForeground(int, android.app.Notification)` once it begins running.
`boolean`	`startInstrumentation(ComponentName className, String profileFile, Bundle arguments)` Start executing an `Instrumentation` class.
`void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)` Same as `startIntentSender(android.content.IntentSender, android.content.Intent, int, int, int, android.os.Bundle)` with no options specified.
`void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)` Like `startActivity(android.content.Intent, android.os.Bundle)`, but taking a IntentSender to start.
`ComponentName`	`startService(Intent service)` Request that a given application service be started.
`boolean`	`stopService(Intent name)` Request that a given application service be stopped.
`void`	`unbindService(ServiceConnection conn)` Disconnect from an application service.
`void`	`unregisterReceiver(BroadcastReceiver receiver)` Unregister a previously registered BroadcastReceiver.
`void`	`updateServiceGroup(ServiceConnection conn, int group, int importance)` For a service previously bound with `bindService(Intent, ServiceConnection, int)` or a related method, change how the system manages that service's process in relation to other processes.

From class


        
          android.content.Context

`boolean`	`bindIsolatedService(Intent service, int flags, String instanceName, Executor executor, ServiceConnection conn)` Variation of `bindService(Intent, ServiceConnection, int)` that, in the specific case of isolated services, allows the caller to generate multiple instances of a service from a single component declaration.
`boolean`	`bindService(Intent service, int flags, Executor executor, ServiceConnection conn)` Same as `bindService(android.content.Intent, android.content.ServiceConnection, int)` with executor to control ServiceConnection callbacks.
`abstract boolean`	`bindService(Intent service, ServiceConnection conn, int flags)` Connect to an application service, creating it if needed.
`boolean`	`bindServiceAsUser(Intent service, ServiceConnection conn, int flags, UserHandle user)` Binds to a service in the given `user` in the same manner as `bindService(android.content.Intent, android.content.ServiceConnection, int)`.
`abstract int`	`checkCallingOrSelfPermission(String permission)` Determine whether the calling process of an IPC or you have been granted a particular permission.
`abstract int`	`checkCallingOrSelfUriPermission(Uri uri, int modeFlags)` Determine whether the calling process of an IPC or you has been granted permission to access a specific URI.
`abstract int`	`checkCallingPermission(String permission)` Determine whether the calling process of an IPC you are handling has been granted a particular permission.
`abstract int`	`checkCallingUriPermission(Uri uri, int modeFlags)` Determine whether the calling process and user ID has been granted permission to access a specific URI.
`abstract int`	`checkPermission(String permission, int pid, int uid)` Determine whether the given permission is allowed for a particular process and user ID running in the system.
`abstract int`	`checkSelfPermission(String permission)` Determine whether you have been granted a particular permission.
`abstract int`	`checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)` Check both a Uri and normal permission.
`abstract int`	`checkUriPermission(Uri uri, int pid, int uid, int modeFlags)` Determine whether a particular process and user ID has been granted permission to access a specific URI.
`abstract void`	`clearWallpaper()` This method is deprecated. Use `WallpaperManager.clear()` instead. This method requires the caller to hold the permission `Manifest.permission.SET_WALLPAPER`.
`Context`	`createAttributionContext(String attributionTag)` Return a new Context object for the current Context but attribute to a different tag.
`abstract Context`	`createConfigurationContext(Configuration overrideConfiguration)` Return a new Context object for the current Context but whose resources are adjusted to match the given Configuration.
`abstract Context`	`createContextForSplit(String splitName)` Return a new Context object for the given split name.
`abstract Context`	`createDeviceProtectedStorageContext()` Return a new Context object for the current Context but whose storage APIs are backed by device-protected storage.
`abstract Context`	`createDisplayContext(Display display)` Return a new Context object for the current Context but whose resources are adjusted to match the metrics of the given Display.
`abstract Context`	`createPackageContext(String packageName, int flags)` Return a new Context object for the given application name.
`Context`	`createWindowContext(int type, Bundle options)` Creates a Context for a non-activity window.
`abstract String[]`	`databaseList()` Returns an array of strings naming the private databases associated with this Context's application package.
`abstract boolean`	`deleteDatabase(String name)` Delete an existing private SQLiteDatabase associated with this Context's application package.
`abstract boolean`	`deleteFile(String name)` Delete the given private file associated with this Context's application package.
`abstract boolean`	`deleteSharedPreferences(String name)` Delete an existing shared preferences file.
`abstract void`	`enforceCallingOrSelfPermission(String permission, String message)` If neither you nor the calling process of an IPC you are handling has been granted a particular permission, throw a `SecurityException`.
`abstract void`	`enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)` If the calling process of an IPC or you has not been granted permission to access a specific URI, throw `SecurityException`.
`abstract void`	`enforceCallingPermission(String permission, String message)` If the calling process of an IPC you are handling has not been granted a particular permission, throw a `SecurityException`.
`abstract void`	`enforceCallingUriPermission(Uri uri, int modeFlags, String message)` If the calling process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`abstract void`	`enforcePermission(String permission, int pid, int uid, String message)` If the given permission is not allowed for a particular process and user ID running in the system, throw a `SecurityException`.
`abstract void`	`enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)` Enforce both a Uri and normal permission.
`abstract void`	`enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)` If a particular process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`abstract String[]`	`fileList()` Returns an array of strings naming the private files associated with this Context's application package.
`abstract Context`	`getApplicationContext()` Return the context of the single, global Application object of the current process.
`abstract ApplicationInfo`	`getApplicationInfo()` Return the full application info for this context's package.
`abstract AssetManager`	`getAssets()` Returns an AssetManager instance for the application's package.
`String`	`getAttributionTag()` Attribution can be used in complex apps to logically separate parts of the app.
`abstract File`	`getCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem.
`abstract ClassLoader`	`getClassLoader()` Return a class loader you can use to retrieve classes in this package.
`abstract File`	`getCodeCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem designed for storing cached code.
`final int`	`getColor(int id)` Returns a color associated with a particular resource ID and styled for the current theme.
`final ColorStateList`	`getColorStateList(int id)` Returns a color state list associated with a particular resource ID and styled for the current theme.
`abstract ContentResolver`	`getContentResolver()` Return a ContentResolver instance for your application's package.
`abstract File`	`getDataDir()` Returns the absolute path to the directory on the filesystem where all private files belonging to this app are stored.
`abstract File`	`getDatabasePath(String name)` Returns the absolute path on the filesystem where a database created with `openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory)` is stored.
`abstract File`	`getDir(String name, int mode)` Retrieve, creating if needed, a new directory in which the application can place its own custom data files.
`Display`	`getDisplay()` Get the display this context is associated with.
`final Drawable`	`getDrawable(int id)` Returns a drawable object associated with a particular resource ID and styled for the current theme.
`abstract File`	`getExternalCacheDir()` Returns absolute path to application-specific directory on the primary shared/external storage device where the application can place cache files it owns.
`abstract File[]`	`getExternalCacheDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place cache files it owns.
`abstract File`	`getExternalFilesDir(String type)` Returns the absolute path to the directory on the primary shared/external storage device where the application can place persistent files it owns.
`abstract File[]`	`getExternalFilesDirs(String type)` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place persistent files it owns.
`abstract File[]`	`getExternalMediaDirs()` This method is deprecated. These directories still exist and are scanned, but developers are encouraged to migrate to inserting content into a `MediaStore` collection directly, as any app can contribute new media to `MediaStore` with no permissions required, starting in `Build.VERSION_CODES.Q`.
`abstract File`	`getFileStreamPath(String name)` Returns the absolute path on the filesystem where a file created with `openFileOutput(String, int)` is stored.
`abstract File`	`getFilesDir()` Returns the absolute path to the directory on the filesystem where files created with `openFileOutput(String, int)` are stored.
`Executor`	`getMainExecutor()` Return an `Executor` that will run enqueued tasks on the main thread associated with this context.
`abstract Looper`	`getMainLooper()` Return the Looper for the main thread of the current process.
`abstract File`	`getNoBackupFilesDir()` Returns the absolute path to the directory on the filesystem similar to `getFilesDir()`.
`abstract File`	`getObbDir()` Return the primary shared/external storage directory where this application's OBB files (if there are any) can be found.
`abstract File[]`	`getObbDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application's OBB files (if there are any) can be found.
`String`	`getOpPackageName()` Return the package name that should be used for `AppOpsManager` calls from this context, so that app ops manager's uid verification will work with the name.
`abstract String`	`getPackageCodePath()` Return the full path to this context's primary Android package.
`abstract PackageManager`	`getPackageManager()` Return PackageManager instance to find global package information.
`abstract String`	`getPackageName()` Return the name of this application's package.
`abstract String`	`getPackageResourcePath()` Return the full path to this context's primary Android package.
`abstract Resources`	`getResources()` Returns a Resources instance for the application's package.
`abstract SharedPreferences`	`getSharedPreferences(String name, int mode)` Retrieve and hold the contents of the preferences file 'name', returning a SharedPreferences through which you can retrieve and modify its values.
`final String`	`getString(int resId, Object... formatArgs)` Returns a localized formatted string from the application's package's default string table, substituting the format arguments as defined in `Formatter` and `String.format(String, Object...)`.
`final String`	`getString(int resId)` Returns a localized string from the application's package's default string table.
`final <T> T`	`getSystemService(Class<T> serviceClass)` Return the handle to a system-level service by class.
`abstract Object`	`getSystemService(String name)` Return the handle to a system-level service by name.
`abstract String`	`getSystemServiceName(Class<?> serviceClass)` Gets the name of the system-level service that is represented by the specified class.
`final CharSequence`	`getText(int resId)` Return a localized, styled CharSequence from the application's package's default string table.
`abstract Resources.Theme`	`getTheme()` Return the Theme object associated with this Context.
`abstract Drawable`	`getWallpaper()` This method is deprecated. Use `WallpaperManager.get()` instead.
`abstract int`	`getWallpaperDesiredMinimumHeight()` This method is deprecated. Use `WallpaperManager.getDesiredMinimumHeight()` instead.
`abstract int`	`getWallpaperDesiredMinimumWidth()` This method is deprecated. Use `WallpaperManager.getDesiredMinimumWidth()` instead.
`abstract void`	`grantUriPermission(String toPackage, Uri uri, int modeFlags)` Grant permission to access a specific Uri to another package, regardless of whether that package has general permission to access the Uri's content provider.
`abstract boolean`	`isDeviceProtectedStorage()` Indicates if the storage APIs of this Context are backed by device-protected storage.
`boolean`	`isRestricted()` Indicates whether this Context is restricted.
`abstract boolean`	`moveDatabaseFrom(Context sourceContext, String name)` Move an existing database file from the given source storage context to this context.
`abstract boolean`	`moveSharedPreferencesFrom(Context sourceContext, String name)` Move an existing shared preferences file from the given source storage context to this context.
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs)` Retrieve styled attribute information in this Context's theme.
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)` Retrieve styled attribute information in this Context's theme.
`final TypedArray`	`obtainStyledAttributes(int resid, int[] attrs)` Retrieve styled attribute information in this Context's theme.
`final TypedArray`	`obtainStyledAttributes(int[] attrs)` Retrieve styled attribute information in this Context's theme.
`abstract FileInputStream`	`openFileInput(String name)` Open a private file associated with this Context's application package for reading.
`abstract FileOutputStream`	`openFileOutput(String name, int mode)` Open a private file associated with this Context's application package for writing.
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)` Open a new private SQLiteDatabase associated with this Context's application package.
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)` Open a new private SQLiteDatabase associated with this Context's application package.
`abstract Drawable`	`peekWallpaper()` This method is deprecated. Use `WallpaperManager.peek()` instead.
`void`	`registerComponentCallbacks(ComponentCallbacks callback)` Add a new `ComponentCallbacks` to the base application of the Context, which will be called at the same times as the ComponentCallbacks methods of activities and other components are called.
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter)` Register a BroadcastReceiver to be run in the main activity thread.
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, int flags)` Register to receive intent broadcasts, with the receiver optionally being exposed to Instant Apps.
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler, int flags)` Register to receive intent broadcasts, to run in the context of `scheduler`.
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)` Register to receive intent broadcasts, to run in the context of `scheduler`.
`abstract void`	`removeStickyBroadcast(Intent intent)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`removeStickyBroadcastAsUser(Intent intent, UserHandle user)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`revokeUriPermission(Uri uri, int modeFlags)` Remove all permissions to access a particular content provider Uri that were previously added with `grantUriPermission(String, Uri, int)` or any other mechanism.
`abstract void`	`revokeUriPermission(String toPackage, Uri uri, int modeFlags)` Remove permissions to access a particular content provider Uri that were previously added with `grantUriPermission(String, Uri, int)` for a specific target package.
`abstract void`	`sendBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, allowing an optional required permission to be enforced.
`abstract void`	`sendBroadcast(Intent intent)` Broadcast the given intent to all interested BroadcastReceivers.
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user)` Version of `sendBroadcast(android.content.Intent)` that allows you to specify the user the broadcast will be sent to.
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)` Version of `sendBroadcast(android.content.Intent, java.lang.String)` that allows you to specify the user the broadcast will be sent to.
`void`	`sendBroadcastWithMultiplePermissions(Intent intent, String[] receiverPermissions)` Broadcast the given intent to all interested BroadcastReceivers, allowing an array of required permissions to be enforced.
`void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, String receiverAppOp, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendOrderedBroadcast(android.content.Intent, java.lang.String, android.content.BroadcastReceiver, android.os.Handler, int, java.lang.String, android.os.Bundle)` that allows you to specify the App Op to enforce restrictions on which receivers the broadcast will be sent to.
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendBroadcast(android.content.Intent)` that allows you to receive data back from the broadcast.
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, delivering them one at a time to allow more preferred receivers to consume the broadcast before it is delivered to less preferred receivers.
`abstract void`	`sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendOrderedBroadcast(android.content.Intent, java.lang.String, android.content.BroadcastReceiver, android.os.Handler, int, java.lang.String, android.os.Bundle)` that allows you to specify the user the broadcast will be sent to.
`abstract void`	`sendStickyBroadcast(Intent intent)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`sendStickyBroadcastAsUser(Intent intent, UserHandle user)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method is deprecated. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`setTheme(int resid)` Set the base theme for this context.
`abstract void`	`setWallpaper(Bitmap bitmap)` This method is deprecated. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `Manifest.permission.SET_WALLPAPER`.
`abstract void`	`setWallpaper(InputStream data)` This method is deprecated. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `Manifest.permission.SET_WALLPAPER`.
`abstract void`	`startActivities(Intent[] intents, Bundle options)` Launch multiple new activities.
`abstract void`	`startActivities(Intent[] intents)` Same as `startActivities(android.content.Intent[], android.os.Bundle)` with no options specified.
`abstract void`	`startActivity(Intent intent)` Same as `startActivity(android.content.Intent, android.os.Bundle)` with no options specified.
`abstract void`	`startActivity(Intent intent, Bundle options)` Launch a new activity.
`abstract ComponentName`	`startForegroundService(Intent service)` Similar to `startService(android.content.Intent)`, but with an implicit promise that the Service will call `startForeground(int, android.app.Notification)` once it begins running.
`abstract boolean`	`startInstrumentation(ComponentName className, String profileFile, Bundle arguments)` Start executing an `Instrumentation` class.
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)` Same as `startIntentSender(android.content.IntentSender, android.content.Intent, int, int, int, android.os.Bundle)` with no options specified.
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)` Like `startActivity(android.content.Intent, android.os.Bundle)`, but taking a IntentSender to start.
`abstract ComponentName`	`startService(Intent service)` Request that a given application service be started.
`abstract boolean`	`stopService(Intent service)` Request that a given application service be stopped.
`abstract void`	`unbindService(ServiceConnection conn)` Disconnect from an application service.
`void`	`unregisterComponentCallbacks(ComponentCallbacks callback)` Remove a `ComponentCallbacks` object that was previously registered with `registerComponentCallbacks(android.content.ComponentCallbacks)`.
`abstract void`	`unregisterReceiver(BroadcastReceiver receiver)` Unregister a previously registered BroadcastReceiver.
`void`	`updateServiceGroup(ServiceConnection conn, int group, int importance)` For a service previously bound with `bindService(Intent, ServiceConnection, int)` or a related method, change how the system manages that service's process in relation to other processes.

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

From interface


        
          android.content.ComponentCallbacks2


      onTrimMemory(int level)

Called when the operating system has determined that it is a good time for a process to trim unneeded memory from its process.

From interface


        
          android.content.ComponentCallbacks

`abstract void`	`onConfigurationChanged(Configuration newConfig)` Called by the system when the device configuration changes while your component is running.
`abstract void`	`onLowMemory()` This is called when the overall system is running low on memory, and actively running processes should trim their memory usage.

Constants

SERVICE_INTERFACE

public static final String SERVICE_INTERFACE

The action must be matched by the intent filter of this service. It also needs to require Manifest.permission.BIND_VPN_SERVICE permission so that other applications cannot abuse it.

Constant Value: "android.net.VpnService"

SERVICE_META_DATA_SUPPORTS_ALWAYS_ON

public static final String SERVICE_META_DATA_SUPPORTS_ALWAYS_ON

Key for boolean meta-data field indicating whether this VpnService supports always-on mode.

For a VPN app targeting API 24 or above, Android provides users with the ability to set it as always-on, so that VPN connection is persisted after device reboot and app upgrade. Always-on VPN can also be enabled by device owner and profile owner apps through DevicePolicyManager#setAlwaysOnVpnPackage.

VPN apps not supporting this feature should opt out by adding this meta-data field to the VpnService component of AndroidManifest.xml. In case there is more than one VpnService component defined in AndroidManifest.xml, opting out any one of them will opt out the entire app. For example,

 <service android:name=".ExampleVpnService"
         android:permission="android.permission.BIND_VPN_SERVICE">
     <intent-filter>
         <action android:name="android.net.VpnService"/>
     </intent-filter>
     <meta-data android:name="android.net.VpnService.SUPPORTS_ALWAYS_ON"
             android:value=false/>
 </service>

This meta-data field defaults to true if absent. It will only have effect on Build.VERSION_CODES.O_MR1 or higher.

Constant Value: "android.net.VpnService.SUPPORTS_ALWAYS_ON"

Public constructors

VpnService

public VpnService ()

Public methods

isAlwaysOn

public final boolean isAlwaysOn ()

Returns whether the service is running in always-on VPN mode. In this mode the system ensures that the service is always running by restarting it when necessary, e.g. after reboot.

Returns
`boolean`

See also:

DevicePolicyManager.setAlwaysOnVpnPackage(ComponentName, String, boolean, Set)

isLockdownEnabled

public final boolean isLockdownEnabled ()

Returns whether the service is running in always-on VPN lockdown mode. In this mode the system ensures that the service is always running and that the apps aren't allowed to bypass the VPN.

Returns
`boolean`

See also:

DevicePolicyManager.setAlwaysOnVpnPackage(ComponentName, String, boolean, Set)

onBind

public IBinder onBind (Intent intent)

Return the communication interface to the service. This method returns null on Intents other than SERVICE_INTERFACE action. Applications overriding this method must identify the intent and return the corresponding interface accordingly.

Parameters
`intent`	`Intent`: The Intent that was used to bind to this service, as given to `Context.bindService`. Note that any extras that were included with the Intent at that point will not be seen here.

Returns
`IBinder`	Return an IBinder through which clients can call on to the service.

See also:

Service.onBind(Intent)

onRevoke

public void onRevoke ()

Invoked when the application is revoked. At this moment, the VPN interface is already deactivated by the system. The application should close the file descriptor and shut down gracefully. The default implementation of this method is calling Service#stopSelf().

Calls to this method may not happen on the main thread of the process.

See also:

prepare(Context)

prepare

public static Intent prepare (Context context)

Prepare to establish a VPN connection. This method returns null if the VPN application is already prepared or if the user has previously consented to the VPN application. Otherwise, it returns an Intent to a system activity. The application should launch the activity using Activity#startActivityForResult to get itself prepared. The activity may pop up a dialog to require user action, and the result will come back via its Activity#onActivityResult. If the result is Activity#RESULT_OK, the application becomes prepared and is granted to use other methods in this class.

Only one application can be granted at the same time. The right is revoked when another application is granted. The application losing the right will be notified via its onRevoke(). Unless it becomes prepared again, subsequent calls to other methods in this class will fail.

The user may disable the VPN at any time while it is activated, in which case this method will return an intent the next time it is executed to obtain the user's consent again.

Parameters
`context`	`Context`

Returns
`Intent`

See also:

onRevoke()

protect

public boolean protect (Socket socket)

Convenience method to protect a Socket from VPN connections.

Parameters
`socket`	`Socket`

Returns
`boolean`	`true` on success.

See also:

protect(int)

protect

public boolean protect (int socket)

Protect a socket from VPN connections. After protecting, data sent through this socket will go directly to the underlying network, so its traffic will not be forwarded through the VPN. This method is useful if some connections need to be kept outside of VPN. For example, a VPN tunnel should protect itself if its destination is covered by VPN routes. Otherwise its outgoing packets will be sent back to the VPN interface and cause an infinite loop. This method will fail if the application is not prepared or is revoked.

The socket is NOT closed by this method.

Parameters
`socket`	`int`

Returns
`boolean`	`true` on success.

protect

public boolean protect (DatagramSocket socket)

Convenience method to protect a DatagramSocket from VPN connections.

Parameters
`socket`	`DatagramSocket`

Returns
`boolean`	`true` on success.

See also:

protect(int)

setUnderlyingNetworks

public boolean setUnderlyingNetworks (Network[] networks)

Sets the underlying networks used by the VPN for its upstream connections.

Used by the system to know the actual networks that carry traffic for apps affected by this VPN in order to present this information to the user (e.g., via status bar icons).

This method only needs to be called if the VPN has explicitly bound its underlying communications channels — such as the socket(s) passed to protect(int) — to a Network using APIs such as Network#bindSocket(Socket) or Network#bindSocket(DatagramSocket). The VPN should call this method every time the set of Networks it is using changes.

networks is one of the following:

a non-empty array: an array of one or more Networks, in decreasing preference order. For example, if this VPN uses both wifi and mobile (cellular) networks to carry app traffic, but prefers or uses wifi more than mobile, wifi should appear first in the array.
an empty array: a zero-element array, meaning that the VPN has no underlying network connection, and thus, app traffic will not be sent or received.
null: (default) signifies that the VPN uses whatever is the system's default network. I.e., it doesn't use the bindSocket or bindDatagramSocket APIs mentioned above to send traffic over specific channels.

This call will succeed only if the VPN is currently established. For setting this value when the VPN has not yet been established, see Builder#setUnderlyingNetworks.

Parameters
`networks`	`Network`: An array of networks the VPN uses to tunnel traffic to/from its servers.

Returns
`boolean`	`true` on success.

Interfaces

Classes

Enums

Exceptions

Most visited

Recently visited

Results for

VpnService

Developer's guide

Summary

Nested classes

Constants

Inherited constants

Public constructors

Public methods

Inherited methods

Constants

SERVICE_INTERFACE

SERVICE_META_DATA_SUPPORTS_ALWAYS_ON

Public constructors

VpnService

Public methods

isAlwaysOn

isLockdownEnabled

onBind

onRevoke

prepare

protect

protect

protect

setUnderlyingNetworks