Context - API Reference - Android Developers
Uploaded by
Vijaykumar ChiniwarContext - API Reference - Android Developers
Uploaded by
Vijaykumar Chiniwar2/15/26, 8:49 PM Context | API reference | Android Developers
Context Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Kotlin (/reference/kotlin/android/content/Context) | Java
public abstract class Context
extends Object (/reference/java/lang/Object)
[Link] (/reference/java/lang/Object)
↳ [Link]
Known direct subclasses
ContextWrapper (/reference/android/content/ContextWrapper), MockContext
(/reference/android/test/mock/MockContext)
ContextWrapper Proxying implementation of Context that simply
(/reference/android/content/ContextWrapper) delegates all of its calls to another Context.
MockContext A mock Context
(/reference/android/test/mock/MockContext) (/reference/android/content/Context) class.
Known indirect subclasses
AbstractInputMethodService (/reference/android/inputmethodservice/AbstractInputMethodService
AccountAuthenticatorActivity (/reference/android/accounts/AccountAuthenticatorActivity), Activity (
(/reference/android/app/AliasActivity), AppFunctionService (/reference/android/app/appfunctions/A
(/reference/android/service/autofill/AutofillService), BackupAgent (/reference/android/app/backup/B
CallRedirectionService (/reference/android/telecom/CallRedirectionService), CallScreeningService (/
(/reference/android/service/media/CameraPrewarmService), CarrierMessagingClientService (/refere
AbstractInputMethodService AbstractInputMethodS
(/reference/android/inputmethodservice/AbstractInputMethodService)
AccessibilityService Accessibility services s
(/reference/android/accessibilityservice/AccessibilityService)
AccountAuthenticatorActivity This class was deprec
(/reference/android/accounts/AccountAuthenticatorActivity) AppCompat, and the f
Activity (/reference/android/app/Activity) An activity is a single,
ActivityGroup (/reference/android/app/ActivityGroup) This class was deprec
(/reference/android/ap
compatibility package
AliasActivity (/reference/android/app/AliasActivity) This class was deprec
[Link] 1/302
2/15/26, 8:49 PM Context | API reference | Android Developers
AppFunctionService Abstract base class to
(/reference/android/app/appfunctions/AppFunctionService)
Application (/reference/android/app/Application) Base class for maintai
AutofillService (/reference/android/service/autofill/AutofillService) An AutofillServic
information about auto
BackupAgent (/reference/android/app/backup/BackupAgent) Provides the central in
BackupAgentHelper (/reference/android/app/backup/BackupAgentHelper) A convenient BackupA
heterogeneous data s
CallRedirectionService (/reference/android/telecom/CallRedirectionService) This service can be im
redirection/cancellatio
CallScreeningService (/reference/android/telecom/CallScreeningService) This service can be im
(/reference/android/te
before they are shown
CameraPrewarmService Extend this class to im
(/reference/android/service/media/CameraPrewarmService)
CarrierMessagingClientService If the default SMS app
(/reference/android/service/carrier/CarrierMessagingClientService) which allows the app t
CarrierMessagingService A service that receives
(/reference/android/service/carrier/CarrierMessagingService)
CarrierService (/reference/android/service/carrier/CarrierService) A service that exposes
ChooserTargetService This class was deprec
(/reference/android/service/chooser/ChooserTargetService) [Link]
CompanionDeviceService A service that receives
(/reference/android/companion/CompanionDeviceService)
ConditionProviderService This class was deprec
(/reference/android/service/notification/ConditionProviderService) NotificationManag
(/reference/android/ap
to tell the system abou
configuration activity t
(/reference/android/ap
(/reference/android/ap
(/reference/android/ap
ConnectionService (/reference/android/telecom/ConnectionService) An abstract service th
1. Can make phone ca
ContextThemeWrapper (/reference/android/view/ContextThemeWrapper) A context wrapper tha
ControlsProviderService Service implementatio
(/reference/android/service/controls/ControlsProviderService)
CredentialProviderService Service to be extended
(/reference/android/service/credentials/CredentialProviderService)
DeviceAdminService (/reference/android/app/admin/DeviceAdminService) Base class for a servic
[Link] 2/302
2/15/26, 8:49 PM Context | API reference | Android Developers
DreamService (/reference/android/service/dreams/DreamService) Extend this class to im
ExpandableListActivity (/reference/android/app/ExpandableListActivity) This class was deprec
([Link]
(/reference/android/w
HostApduService (/reference/android/nfc/cardemulation/HostApduService) HostApduService is a
inside an Android serv
HostNfcFService (/reference/android/nfc/cardemulation/HostNfcFService) HostNfcFService is a c
inside an Android serv
InCallService (/reference/android/telecom/InCallService) This service is implem
InputMethodService InputMethodService p
(/reference/android/inputmethodservice/InputMethodService) customize.
IntentService (/reference/android/app/IntentService) This class was deprec
(/about/versions/oreo
([Link]
IsolatedContext (/reference/android/test/IsolatedContext) This class was deprec
(/tools/testing-suppo
IsolatedService Base class for services
(/reference/android/adservices/ondevicepersonalization/IsolatedService) PersistableBundle
([Link]
JobService (/reference/android/app/job/JobService) Entry point for the call
LauncherActivity (/reference/android/app/LauncherActivity) This class was deprec
([Link]
[Link]
(/reference/android/co
ListActivity (/reference/android/app/ListActivity) This class was deprec
([Link]
([Link]
MediaBrowserService Base class for media b
(/reference/android/service/media/MediaBrowserService)
MediaRoute2ProviderService Base class for media r
(/reference/android/media/MediaRoute2ProviderService)
MediaSession2Service (/reference/android/media/MediaSession2Service) This class is deprecate
MidiDeviceService (/reference/android/media/midi/MidiDeviceService) A service that impleme
MidiUmpDeviceService A service that impleme
(/reference/android/media/midi/MidiUmpDeviceService)
MockApplication (/reference/android/test/mock/MockApplication) This class was deprec
should be written usin
MutableContextWrapper Special version of Con
(/reference/android/content/MutableContextWrapper) it is initially set.
NativeActivity (/reference/android/app/NativeActivity) Convenience for imple
[Link] 3/302
2/15/26, 8:49 PM Context | API reference | Android Developers
NotificationListenerService A service that receives
(/reference/android/service/notification/NotificationListenerService)
OffHostApduService OffHostApduService is
(/reference/android/nfc/cardemulation/OffHostApduService) NFC applications that
PreferenceActivity (/reference/android/preference/PreferenceActivity) This class was deprec
(/reference/androidx/p
AndroidX Preference L
PrintService (/reference/android/printservice/PrintService) This is the base class f
QuickAccessWalletService A QuickAccessWall
(/reference/android/service/quickaccesswallet/QuickAccessWalletService)
RecognitionService (/reference/android/speech/RecognitionService) This class provides a b
RemoteViewsService (/reference/android/widget/RemoteViewsService) The service to be conn
RenamingDelegatingContext This class was deprec
(/reference/android/test/RenamingDelegatingContext) (/tools/testing-suppo
Service (/reference/android/app/Service) A Service is an applica
interacting with the us
SettingInjectorService (/reference/android/location/SettingInjectorService) Dynamically specifies
system settings app
For use only by apps t
SettingsPreferenceService Base class for a servic
(/reference/android/service/settings/preferences/SettingsPreferenceService)
SpellCheckerService SpellCheckerService p
(/reference/android/service/textservice/SpellCheckerService)
TabActivity (/reference/android/app/TabActivity) This class was deprec
devices, you can use t
Build.VERSION_COD
TextToSpeechService (/reference/android/speech/tts/TextToSpeechService) Abstract base class fo
TileService (/reference/android/service/quicksettings/TileService) A TileService provides
TvAdService (/reference/android/media/tv/ad/TvAdService) The TvAdService class
TvInputService (/reference/android/media/tv/TvInputService) The TvInputService cla
broadcast TV program
TvInteractiveAppService A TV interactive applic
(/reference/android/media/tv/interactive/TvInteractiveAppService)
VisualVoicemailService This service is implem
(/reference/android/telephony/VisualVoicemailService)
VoiceInteractionService Top-level service of th
(/reference/android/service/voice/VoiceInteractionService) VoiceInteractor (/
VoiceInteractionSessionService An active voice interac
(/reference/android/service/voice/VoiceInteractionSessionService) (/reference/android/se
[Link] 4/302
2/15/26, 8:49 PM Context | API reference | Android Developers
VpnService (/reference/android/net/VpnService) VpnService is a base c
VrListenerService (/reference/android/service/vr/VrListenerService) A service that is bound
WallpaperService (/reference/android/service/wallpaper/WallpaperService) A wallpaper service is
Interface to global information about an application environment. This is an abstract class
whose implementation is provided by the Android system. It allows access to application-
specific resources and classes, as well as up-calls for application-level operations such
as launching activities, broadcasting and receiving intents, etc.
Summary
Nested classes
class [Link]
(/reference/android/content/[Link])
Specific flags used for bindService() call, which encapsulates a 64
bits long integer.
Constants
String ACCESSIBILITY_SERVICE (/reference/android/content/Context#AC
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/view/accessibility/AccessibilityManager) for givin
String ACCOUNT_SERVICE (/reference/android/content/Context#ACCOUNT_
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
intents at a time of your choosing.
[Link] 5/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String ACTIVITY_SERVICE (/reference/android/content/Context#ACTIVITY_
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
the global system state.
String ADVANCED_PROTECTION_SERVICE (/reference/android/content/Cont
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/security/advancedprotection/AdvancedProtection
String ALARM_SERVICE (/reference/android/content/Context#ALARM_SERV
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
time of your choosing.
String APPWIDGET_SERVICE (/reference/android/content/Context#APPWID
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
accessing AppWidgets.
String APP_FUNCTION_SERVICE (/reference/android/content/Context#APP_
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/app/appfunctions/AppFunctionManager) for exec
String APP_OPS_SERVICE (/reference/android/content/Context#APP_OPS_S
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
application operations on the device.
String APP_SEARCH_SERVICE (/reference/android/content/Context#APP_SE
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
for indexing and querying app data managed by the system.
String AUDIO_SERVICE (/reference/android/content/Context#AUDIO_SERVI
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
management of volume, ringer modes and audio routing.
String BATTERY_SERVICE (/reference/android/content/Context#BATTERY_S
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
state.
[Link] 6/302
2/15/26, 8:49 PM Context | API reference | Android Developers
int BIND_ABOVE_CLIENT (/reference/android/content/Context#BIND_AB
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
application binding to this service considers the service to be more im
int BIND_ADJUST_WITH_ACTIVITY (/reference/android/content/Contex
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
allow the target service's process importance to be raised based on w
to impact it.
int BIND_ALLOW_ACTIVITY_STARTS (/reference/android/content/Conte
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
is visible, the bound service is allowed to start an activity from backgr
int BIND_ALLOW_OOM_MANAGEMENT (/reference/android/content/Contex
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
the bound service to go through its normal memory management.
int BIND_AUTO_CREATE (/reference/android/content/Context#BIND_AUT
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
service as long as the binding exists.
int BIND_DEBUG_UNBIND (/reference/android/content/Context#BIND_DE
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
mismatched calls to unbind.
int BIND_EXTERNAL_SERVICE (/reference/android/content/Context#BIN
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
an isolated (/reference/android/[Link]#isolatedProcess), external
long BIND_EXTERNAL_SERVICE_LONG (/reference/android/content/Conte
[Link] 7/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Works in the same way as BIND_EXTERNAL_SERVICE (/reference/an
(/reference/android/content/[Link]).
int BIND_IMPORTANT (/reference/android/content/Context#BIND_IMPOR
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
important to the client, so should be brought to the foreground proce
int BIND_INCLUDE_CAPABILITIES (/reference/android/content/Contex
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
has specific capabilities due to its foreground state such as an activit
int BIND_NOT_FOREGROUND (/reference/android/content/Context#BIND_
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
raise the target service's process to the foreground scheduling priorit
int BIND_NOT_PERCEPTIBLE (/reference/android/content/Context#BIND
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
is visible or user-perceptible, lower the target service's importance to
int BIND_PACKAGE_ISOLATED_PROCESS (/reference/android/content/C
Flag for bindIsolatedService(Intent, BindServiceFlags,
(/reference/android/content/Context#bindIsolatedService([Link]
: Bind the service into a shared isolated process, but only with other is
int BIND_SHARED_ISOLATED_PROCESS (/reference/android/content/Co
Flag for bindIsolatedService(Intent, BindServiceFlags,
(/reference/android/content/Context#bindIsolatedService([Link]
: Bind the service into a shared isolated process.
int BIND_WAIVE_PRIORITY (/reference/android/content/Context#BIND_
Flag for bindService(Intent, BindServiceFlags, Executor
(/reference/android/content/Context#bindService([Link]
scheduling or memory management priority of the target service's ho
[Link] 8/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String BIOMETRIC_SERVICE (/reference/android/content/Context#BIOMET
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/hardware/biometrics/BiometricManager) for han
String BLOB_STORE_SERVICE (/reference/android/content/Context#BLOB_S
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
contributing and accessing data blobs from the blob store maintained
String BLUETOOTH_SERVICE (/reference/android/content/Context#BLUETO
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
Bluetooth.
String BUGREPORT_SERVICE (/reference/android/content/Context#BUGREP
(/reference/java/lang/String)
Service to capture a bugreport.
String CAMERA_SERVICE (/reference/android/content/Context#CAMERA_SE
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
interacting with camera devices.
String CAPTIONING_SERVICE (/reference/android/content/Context#CAPTIO
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
for obtaining captioning properties and listening for changes in captio
String CARRIER_CONFIG_SERVICE (/reference/android/content/Context#C
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
for reading carrier configuration values.
String CHOOSER_SERVICE (/reference/android/content/Context#CHOOSER_
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
String CLIPBOARD_SERVICE (/reference/android/content/Context#CLIPBOA
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
accessing and modifying the contents of the global clipboard.
[Link] 9/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String COMPANION_DEVICE_SERVICE (/reference/android/content/Context#
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/companion/CompanionDeviceManager) for mana
String CONNECTIVITY_DIAGNOSTICS_SERVICE (/reference/android/conten
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/net/ConnectivityDiagnosticsManager) for perform
String CONNECTIVITY_SERVICE (/reference/android/content/Context#CON
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
handling management of network connections.
String CONSUMER_IR_SERVICE (/reference/android/content/Context#CONS
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
transmitting infrared signals from the device.
String CONTACT_KEYS_SERVICE (/reference/android/content/Context#CON
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/provider/E2eeContactKeysManager) to managing
int CONTEXT_IGNORE_SECURITY (/reference/android/content/Context#C
Flag for use with createPackageContext(String, int) (/refere
to always be loaded.
int CONTEXT_INCLUDE_CODE (/reference/android/content/Context#CON
Flag for use with createPackageContext(String, int) (/refere
int CONTEXT_RESTRICTED (/reference/android/content/Context#CONTE
Flag for use with createPackageContext(String, int) (/refere
String CREDENTIAL_SERVICE (/reference/android/content/Context#CREDE
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
authenticate a user to your app.
[Link] 10/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String CROSS_PROFILE_APPS_SERVICE (/reference/android/content/Conte
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
profile operations.
int DEVICE_ID_DEFAULT (/reference/android/content/Context#DEVICE_
The default device ID, which is the ID of the primary (non-virtual) devi
int DEVICE_ID_INVALID (/reference/android/content/Context#DEVICE_
Invalid device ID.
String DEVICE_LOCK_SERVICE (/reference/android/content/Context#DEVIC
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
String DEVICE_POLICY_SERVICE (/reference/android/content/Context#DEV
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
for working with global device policy management.
String DISPLAY_HASH_SERVICE (/reference/android/content/Context#DISP
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
to handle display hashes.
String DISPLAY_SERVICE (/reference/android/content/Context#DISPLAY_S
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
interacting with display devices.
String DOMAIN_VERIFICATION_SERVICE (/reference/android/content/Cont
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/content/pm/verify/domain/DomainVerificationMan
String DOWNLOAD_SERVICE (/reference/android/content/Context#DOWNLO
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
HTTP downloads.
[Link] 11/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String DROPBOX_SERVICE (/reference/android/content/Context#DROPBOX_
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
recording diagnostic logs.
String EUICC_SERVICE (/reference/android/content/Context#EUICC_SERVIC
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
the device eUICC (embedded SIM).
String FILE_INTEGRITY_SERVICE (/reference/android/content/Context#FI
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
String GAME_SERVICE (/reference/android/content/Context#GAME_SERVIC
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
String GRAMMATICAL_INFLECTION_SERVICE (/reference/android/content/C
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/app/GrammaticalInflectionManager).
String HARDWARE_PROPERTIES_SERVICE (/reference/android/content/Cont
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/os/HardwarePropertiesManager) for accessing t
String HEALTHCONNECT_SERVICE (/reference/android/content/Context#HEA
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/health/connect/HealthConnectManager).
String INPUT_METHOD_SERVICE (/reference/android/content/Context#INPU
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/view/inputmethod/InputMethodManager) for acc
String INPUT_SERVICE (/reference/android/content/Context#INPUT_SERVIC
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
with input devices.
[Link] 12/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String IPSEC_SERVICE (/reference/android/content/Context#IPSEC_SERVIC
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
Networks with IPSec.
String JOB_SCHEDULER_SERVICE (/reference/android/content/Context#JO
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
managing occasional background tasks.
String KEYGUARD_SERVICE (/reference/android/content/Context#KEYGUAR
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
keyguard.
String KEYSTORE_SERVICE (/reference/android/content/Context#KEYSTOR
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
accessing Android Keystore (/privacy-and-security/keystore) function
String LAUNCHER_APPS_SERVICE (/reference/android/content/Context#LAU
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
monitoring launchable apps across profiles of a user.
String LAYOUT_INFLATER_SERVICE (/reference/android/content/Context#L
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
resources in this context.
String LOCALE_SERVICE (/reference/android/content/Context#LOCALE_SER
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
String LOCATION_SERVICE (/reference/android/content/Context#LOCATION
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
controlling location updates.
String MEDIA_COMMUNICATION_SERVICE (/reference/android/content/Cont
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/media/MediaCommunicationManager) for manag
[Link] 13/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String MEDIA_METRICS_SERVICE (/reference/android/content/Context#ME
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/media/metrics/MediaMetricsManager) for interac
String MEDIA_PROJECTION_SERVICE (/reference/android/content/Context#
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/media/projection/MediaProjectionManager) insta
String MEDIA_QUALITY_SERVICE (/reference/android/content/Context#ME
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/media/quality/MediaQualityManager) for standar
String MEDIA_ROUTER_SERVICE (/reference/android/content/Context#MED
(/reference/java/lang/String)
Use with getSystemService(Class) (/reference/android/content/C
of media.
String MEDIA_SESSION_SERVICE (/reference/android/content/Context#ME
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/media/session/MediaSessionManager) for manag
String MIDI_SERVICE (/reference/android/content/Context#MIDI_SERVICE)
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
MIDI service.
int MODE_APPEND (/reference/android/content/Context#MODE_APPEND)
File creation mode: for use with openFileOutput(String, int) (
instead of erasing it.
int MODE_ENABLE_WRITE_AHEAD_LOGGING (/reference/android/content
Database open flag: when set, the database is opened with write-ahe
int MODE_MULTI_PROCESS (/reference/android/content/Context#MODE_
This constant was deprecated in API level 23. MODE_MULTI_PROCESS
processes. Applications should not attempt to use it. Instead, they sho
[Link] 14/302
2/15/26, 8:49 PM Context | API reference | Android Developers
int MODE_NO_LOCALIZED_COLLATORS (/reference/android/content/Cont
Database open flag: when set, the database is opened without suppo
int MODE_PRIVATE (/reference/android/content/Context#MODE_PRIVATE
File creation mode: the default mode, where the created file can only
int MODE_WORLD_READABLE (/reference/android/content/Context#MODE
This constant was deprecated in API level 17. Creating world-readable
mechanism for interactions such as ContentProvider (/reference/a
There are no guarantees that this access mode will remain on a file, s
int MODE_WORLD_WRITEABLE (/reference/android/content/Context#MOD
This constant was deprecated in API level 17. Creating world-writable
mechanism for interactions such as ContentProvider (/reference/a
There are no guarantees that this access mode will remain on a file, s
String NETWORK_STATS_SERVICE (/reference/android/content/Context#NE
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
for querying network usage stats.
String NFC_SERVICE (/reference/android/content/Context#NFC_SERVICE)
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
String NOTIFICATION_SERVICE (/reference/android/content/Context#NOT
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
informing the user of background events.
String NSD_SERVICE (/reference/android/content/Context#NSD_SERVICE)
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
of network service discovery
String OVERLAY_SERVICE (/reference/android/content/Context#OVERLAY_S
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
managing overlay packages.
[Link] 15/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String PEOPLE_SERVICE (/reference/android/content/Context#PEOPLE_SER
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
your published conversations.
String PERFORMANCE_HINT_SERVICE (/reference/android/content/Context#
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
for accessing the performance hinting service.
String PERSISTENT_DATA_BLOCK_SERVICE (/reference/android/content/C
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/service/persistentdata/PersistentDataBlockMana
String POWER_SERVICE (/reference/android/content/Context#POWER_SERV
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
management, including "wake locks," which let you keep the device o
String PRINT_SERVICE (/reference/android/content/Context#PRINT_SERVIC
(/reference/java/lang/String)
PrintManager (/reference/android/print/PrintManager) for printing a
String PROFILING_SERVICE (/reference/android/content/Context#PROFILIN
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
int RECEIVER_EXPORTED (/reference/android/content/Context#RECEIVE
Flag for registerReceiver(BroadcastReceiver, IntentFilt
broadcasts from other Apps.
int RECEIVER_NOT_EXPORTED (/reference/android/content/Context#REC
Flag for registerReceiver(BroadcastReceiver, IntentFilt
receive broadcasts from other Apps.
int RECEIVER_VISIBLE_TO_INSTANT_APPS (/reference/android/conten
Flag for registerReceiver(BroadcastReceiver, IntentFilt
broadcasts from Instant Apps.
[Link] 16/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String RESTRICTIONS_SERVICE (/reference/android/content/Context#REST
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
retrieving application restrictions and requesting permissions for rest
String ROLE_SERVICE (/reference/android/content/Context#ROLE_SERVICE
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
String SATELLITE_SERVICE (/reference/android/content/Context#SATELLIT
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
accessing satellite functionality.
String SEARCH_SERVICE (/reference/android/content/Context#SEARCH_SE
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
String SECURITY_STATE_SERVICE (/reference/android/content/Context#SE
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
accessing the security state manager service.
String SENSOR_SERVICE (/reference/android/content/Context#SENSOR_SE
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
sensors.
String SHORTCUT_SERVICE (/reference/android/content/Context#SHORTCU
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
accessing the launcher shortcut service.
String STATUS_BAR_SERVICE (/reference/android/content/Context#STATUS
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
with the status bar and quick settings.
String STORAGE_SERVICE (/reference/android/content/Context#STORAGE_
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
system storage functions.
[Link] 17/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String STORAGE_STATS_SERVICE (/reference/android/content/Context#STO
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
for accessing system storage statistics.
String SYSTEM_HEALTH_SERVICE (/reference/android/content/Context#SYS
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
for accessing system health (battery, power, memory, etc) metrics.
String TELECOM_SERVICE (/reference/android/content/Context#TELECOM_
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
telecom-related features of the device.
String TELEPHONY_IMS_SERVICE (/reference/android/content/Context#TEL
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
String TELEPHONY_PHONE_NUMBER_SERVICE (/reference/android/content/C
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
for parsing phone numbers.
String TELEPHONY_SERVICE (/reference/android/content/Context#TELEPHO
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
handling management the telephony features of the device.
String TELEPHONY_SUBSCRIPTION_SERVICE (/reference/android/content/C
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
handling management the telephony subscriptions of the device.
String TETHERING_SERVICE (/reference/android/content/Context#TETHERI
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
tethering functions.
String TEXT_CLASSIFICATION_SERVICE (/reference/android/content/Cont
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/view/textclassifier/TextClassificationManager) fo
[Link] 18/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String TEXT_SERVICES_MANAGER_SERVICE (/reference/android/content/C
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/view/textservice/TextServicesManager) for acces
String TV_AD_SERVICE (/reference/android/content/Context#TV_AD_SERVIC
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
TV client-side advertisement services on the device.
String TV_INPUT_SERVICE (/reference/android/content/Context#TV_INPUT
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
with TV inputs on the device.
String TV_INTERACTIVE_APP_SERVICE (/reference/android/content/Conte
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/media/tv/interactive/TvInteractiveAppManager) f
String UI_MODE_SERVICE (/reference/android/content/Context#UI_MODE_S
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
modes.
String USAGE_STATS_SERVICE (/reference/android/content/Context#USAG
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
querying device usage stats.
String USB_SERVICE (/reference/android/content/Context#USB_SERVICE)
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
devices (as a USB host) and for controlling this device's behavior as a
String USER_SERVICE (/reference/android/content/Context#USER_SERVICE
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
devices that support multiple users.
String VIBRATOR_MANAGER_SERVICE (/reference/android/content/Context#
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
device vibrators, interacting with individual ones and playing synchron
[Link] 19/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String VIBRATOR_SERVICE (/reference/android/content/Context#VIBRATOR
(/reference/java/lang/String)
This constant was deprecated in API level 31. Use VibratorManager
String VIRTUAL_DEVICE_SERVICE (/reference/android/content/Context#V
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
(/reference/android/companion/virtual/VirtualDeviceManager) for ma
String VPN_MANAGEMENT_SERVICE (/reference/android/content/Context#V
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
platform built-in VPN.
String WALLPAPER_SERVICE (/reference/android/content/Context#WALLPA
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
String WIFI_AWARE_SERVICE (/reference/android/content/Context#WIFI_AW
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
handling management of Wi-Fi Aware.
String WIFI_P2P_SERVICE (/reference/android/content/Context#WIFI_P2P_
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
management of Wi-Fi peer-to-peer connections.
String WIFI_RTT_RANGING_SERVICE (/reference/android/content/Context#
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
devices with wifi.
String WIFI_SERVICE (/reference/android/content/Context#WIFI_SERVICE)
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
management of Wi-Fi access.
String WINDOW_SERVICE (/reference/android/content/Context#WINDOW_SE
(/reference/java/lang/String)
Use with getSystemService([Link]) (/reference/an
system's window manager.
[Link] 20/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Public constructors
Context (/reference/android/content/Context#Context())()
Public methods
boolean bindIsolatedService (/reference/android/con
service, int flags, String (/reference/jav
Variation of bindService(Intent, BindServ
(/reference/android/content/Context#bindService
caller to generate multiple instances of a service f
boolean bindIsolatedService (/reference/android/con
(Intent (/reference/android/content/Intent) ser
(/reference/java/util/concurrent/Executor) execu
See bindIsolatedService([Link]
(/reference/android/content/Context#bindIsolate
(/reference/android/content/[Link]
boolean bindService (/reference/android/content/Conte
(/reference/java/util/concurrent/Executor) execu
Same as bindService(Intent, ServiceCon
boolean bindService (/reference/android/content/Conte
ServiceConnection (/reference/android/conten
See bindService([Link]
[Link](long) (/reference/and
abstract boolean bindService (/reference/android/content/Conte
(/reference/android/content/ServiceConnection)
Connects to an application service, creating it if n
boolean bindService (/reference/android/content/Conte
service, [Link] (/refe
See bindService([Link]
(/reference/android/content/Context#bindService
[Link] 21/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/content/[Link]
boolean bindServiceAsUser (/reference/android/conten
ServiceConnection (/reference/android/conten
Binds to a service in the given user in the same m
(/reference/android/content/Context#bindService
boolean bindServiceAsUser (/reference/android/conten
(/reference/android/content/Intent) service, S
(/reference/android/os/UserHandle) user)
See bindServiceAsUser([Link].
(/reference/android/content/Context#bindService
(/reference/android/content/[Link]
abstract int checkCallingOrSelfPermission (/reference/
Determine whether the calling process of an IPC o
abstract int checkCallingOrSelfUriPermission (/refere
Determine whether the calling process of an IPC o
int[] checkCallingOrSelfUriPermissions (/refer
Determine whether the calling process of an IPC o
abstract int checkCallingPermission (/reference/android
Determine whether the calling process of an IPC y
abstract int checkCallingUriPermission (/reference/and
Determine whether the calling process and uid ha
int[] checkCallingUriPermissions (/reference/an
Determine whether the calling process and uid ha
int checkContentUriPermissionFull (/reference
Determine whether a particular process and uid h
[Link] 22/302
2/15/26, 8:49 PM Context | API reference | Android Developers
abstract int checkPermission (/reference/android/content/C
Determine whether the given permission is allowe
abstract int checkSelfPermission (/reference/android/con
Determine whether you have been granted a part
abstract int checkUriPermission (/reference/android/conte
readPermission, String (/reference/java/lan
Check both a Uri and normal permission.
abstract int checkUriPermission (/reference/android/conte
Determine whether a particular process and uid h
int[] checkUriPermissions (/reference/android/con
Determine whether a particular process and uid h
abstract void clearWallpaper (/reference/android/content/Co
This method was deprecated in API level 15. Use W
This method requires the caller to hold the permis
Context (/reference/android/content/Context) createAttributionContext (/reference/andro
Return a new Context object for the current Conte
abstract Context createConfigurationContext (/reference/an
(/reference/android/content/Context)
Return a new Context object for the current Conte
Context (/reference/android/content/Context) createContext (/reference/android/content/Co
Creates a context with specific properties and be
abstract Context createContextForSplit (/reference/android/c
(/reference/android/content/Context)
Return a new Context object for the given split na
[Link] 23/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Context (/reference/android/content/Context) createDeviceContext (/reference/android/con
Returns a new Context object from the current c
abstract Context createDeviceProtectedStorageContext (/r
(/reference/android/content/Context)
Return a new Context object for the current Conte
abstract Context createDisplayContext (/reference/android/co
(/reference/android/content/Context)
Returns a new Context object from the current c
abstract Context createPackageContext (/reference/android/co
(/reference/android/content/Context)
Return a new Context object for the given applica
Context (/reference/android/content/Context) createWindowContext (/reference/android/con
Creates a Context for a non-activity window.
Context (/reference/android/content/Context) createWindowContext (/reference/android/con
options)
Creates a Context for a non- activity (/refere
abstract String[] (/reference/java/lang/String) databaseList (/reference/android/content/Cont
Returns an array of strings naming the private dat
abstract boolean deleteDatabase (/reference/android/content/Co
Delete an existing private SQLiteDatabase associa
abstract boolean deleteFile (/reference/android/content/Contex
Delete the given private file associated with this C
abstract boolean deleteSharedPreferences (/reference/androi
Delete an existing shared preferences file.
[Link] 24/302
2/15/26, 8:49 PM Context | API reference | Android Developers
abstract void enforceCallingOrSelfPermission (/referen
If neither you nor the calling process of an IPC yo
abstract void enforceCallingOrSelfUriPermission (/refe
(/reference/java/lang/String) message)
If the calling process of an IPC or you has not bee
abstract void enforceCallingPermission (/reference/andro
If the calling process of an IPC you are handling h
abstract void enforceCallingUriPermission (/reference/a
message)
If the calling process and uid has not been grante
abstract void enforcePermission (/reference/android/conten
message)
If the given permission is not allowed for a particu
abstract void enforceUriPermission (/reference/android/co
(/reference/java/lang/String) readPermission,
Enforce both a Uri and normal permission.
abstract void enforceUriPermission (/reference/android/co
(/reference/java/lang/String) message)
If a particular process and uid has not been grant
abstract String[] (/reference/java/lang/String) fileList (/reference/android/content/Context#fi
Returns an array of strings naming the private file
abstract Context getApplicationContext (/reference/android/c
(/reference/android/content/Context)
Return the context of the single, global Applicatio
abstract ApplicationInfo getApplicationInfo (/reference/android/conte
(/reference/android/content/pm/ApplicationInfo)
Return the full application info for this context's p
[Link] 25/302
2/15/26, 8:49 PM Context | API reference | Android Developers
abstract AssetManager getAssets (/reference/android/content/Context#
(/reference/android/content/res/AssetManager)
Returns an AssetManager instance for the applica
AttributionSource getAttributionSource (/reference/android/co
(/reference/android/content/AttributionSource)
String (/reference/java/lang/String) getAttributionTag (/reference/android/conten
Attribution can be used in complex apps to logica
abstract File (/reference/java/io/File) getCacheDir (/reference/android/content/Conte
Returns the absolute path to the application spec
abstract ClassLoader getClassLoader (/reference/android/content/Co
(/reference/java/lang/ClassLoader)
Return a class loader you can use to retrieve class
abstract File (/reference/java/io/File) getCodeCacheDir (/reference/android/content/C
Returns the absolute path to the application spec
final int getColor (/reference/android/content/Context#g
Returns a color associated with a particular resou
final ColorStateList getColorStateList (/reference/android/conten
(/reference/android/content/res/ColorStateList)
Returns a color state list associated with a particu
abstract ContentResolver getContentResolver (/reference/android/conte
(/reference/android/content/ContentResolver)
Return a ContentResolver instance for your applic
abstract File (/reference/java/io/File) getDataDir (/reference/android/content/Contex
Returns the absolute path to the directory on the
abstract File (/reference/java/io/File) getDatabasePath (/reference/android/content/C
Returns the absolute path on the filesystem wher
(/reference/android/content/Context#openOrCre
[Link] 26/302
2/15/26, 8:49 PM Context | API reference | Android Developers
int getDeviceId (/reference/android/content/Conte
Gets the device ID this context is associated with.
abstract File (/reference/java/io/File) getDir (/reference/android/content/Context#get
Retrieve, creating if needed, a new directory in wh
Display (/reference/android/view/Display) getDisplay (/reference/android/content/Contex
Get the display this context is associated with.
final Drawable getDrawable (/reference/android/content/Conte
(/reference/android/graphics/drawable/Drawable)
Returns a drawable object associated with a parti
abstract File (/reference/java/io/File) getExternalCacheDir (/reference/android/con
Returns absolute path to application-specific dire
abstract File[] (/reference/java/io/File) getExternalCacheDirs (/reference/android/co
Returns absolute paths to application-specific dir
abstract File (/reference/java/io/File) getExternalFilesDir (/reference/android/con
Returns the absolute path to the directory on the
abstract File[] (/reference/java/io/File) getExternalFilesDirs (/reference/android/co
Returns absolute paths to application-specific dir
abstract File[] (/reference/java/io/File) getExternalMediaDirs (/reference/android/co
This method was deprecated in API level 30. Thes
contribute new media to MediaStore (/reference
abstract File (/reference/java/io/File) getFileStreamPath (/reference/android/conten
Returns the absolute path on the filesystem wher
[Link] 27/302
2/15/26, 8:49 PM Context | API reference | Android Developers
abstract File (/reference/java/io/File) getFilesDir (/reference/android/content/Conte
Returns the absolute path to the directory on the
Executor (/reference/java/util/concurrent/Executor) getMainExecutor (/reference/android/content/C
Return an Executor (/reference/java/util/concurr
abstract Looper (/reference/android/os/Looper) getMainLooper (/reference/android/content/Co
Return the Looper for the main thread of the curr
abstract File (/reference/java/io/File) getNoBackupFilesDir (/reference/android/con
Returns the absolute path to the directory on the
abstract File (/reference/java/io/File) getObbDir (/reference/android/content/Context#
Return the primary shared/external storage direct
abstract File[] (/reference/java/io/File) getObbDirs (/reference/android/content/Contex
Returns absolute paths to application-specific dir
String (/reference/java/lang/String) getOpPackageName (/reference/android/content
Return the package name that should be used for
abstract String (/reference/java/lang/String) getPackageCodePath (/reference/android/conte
Return the full path to this context's primary Andr
abstract PackageManager getPackageManager (/reference/android/conten
(/reference/android/content/pm/PackageManager)
Return PackageManager instance to find global p
abstract String (/reference/java/lang/String) getPackageName (/reference/android/content/Co
Return the name of this application's package.
abstract String (/reference/java/lang/String) getPackageResourcePath (/reference/android
Return the full path to this context's primary Andr
[Link] 28/302
2/15/26, 8:49 PM Context | API reference | Android Developers
ContextParams getParams (/reference/android/content/Context#
(/reference/android/content/ContextParams)
Return the set of parameters which this Context w
abstract Resources getResources (/reference/android/content/Cont
(/reference/android/content/res/Resources)
Returns a Resources instance for the application's
abstract SharedPreferences getSharedPreferences (/reference/android/co
(/reference/android/content/SharedPreferences)
Retrieve and hold the contents of the preferences
final String (/reference/java/lang/String) getString (/reference/android/content/Context#
Returns a localized string from the application's p
final String (/reference/java/lang/String) getString (/reference/android/content/Context#
Returns a localized formatted string from the app
(/reference/java/lang/String#format([Link]
final <T> T getSystemService (/reference/android/content
Return the handle to a system-level service by cla
abstract Object (/reference/java/lang/Object) getSystemService (/reference/android/content
Return the handle to a system-level service by na
abstract String (/reference/java/lang/String) getSystemServiceName (/reference/android/co
Gets the name of the system-level service that is
final CharSequence getText (/reference/android/content/Context#ge
(/reference/java/lang/CharSequence)
Return a localized, styled CharSequence from the
abstract [Link] getTheme (/reference/android/content/Context#g
(/reference/android/content/res/[Link])
Return the Theme object associated with this Con
[Link] 29/302
2/15/26, 8:49 PM Context | API reference | Android Developers
abstract Drawable getWallpaper (/reference/android/content/Cont
(/reference/android/graphics/drawable/Drawable)
This method was deprecated in API level 15. Use W
abstract int getWallpaperDesiredMinimumHeight (/refer
This method was deprecated in API level 15. Use W
abstract int getWallpaperDesiredMinimumWidth (/refere
This method was deprecated in API level 15. Use W
abstract void grantUriPermission (/reference/android/conte
Grant permission to access a specific Uri to anoth
abstract boolean isDeviceProtectedStorage (/reference/andro
Indicates if the storage APIs of this Context are ba
boolean isRestricted (/reference/android/content/Cont
Indicates whether this Context is restricted.
boolean isUiContext (/reference/android/content/Conte
Returns true if the context is a UI context which
(/reference/android/app/WallpaperManager).
abstract boolean moveDatabaseFrom (/reference/android/content
Move an existing database file from the given sou
abstract boolean moveSharedPreferencesFrom (/reference/and
name)
Move an existing shared preferences file from the
final TypedArray obtainStyledAttributes (/reference/android
(/reference/android/content/res/TypedArray)
Retrieve styled attribute information in this Contex
[Link] 30/302
2/15/26, 8:49 PM Context | API reference | Android Developers
final TypedArray obtainStyledAttributes (/reference/android
(/reference/android/content/res/TypedArray) defStyleRes)
Retrieve styled attribute information in this Contex
final TypedArray obtainStyledAttributes (/reference/android
(/reference/android/content/res/TypedArray)
Retrieve styled attribute information in this Contex
final TypedArray obtainStyledAttributes (/reference/android
(/reference/android/content/res/TypedArray)
Retrieve styled attribute information in this Contex
abstract FileInputStream openFileInput (/reference/android/content/Co
(/reference/java/io/FileInputStream)
Open a private file associated with this Context's
abstract FileOutputStream openFileOutput (/reference/android/content/Co
(/reference/java/io/FileOutputStream)
Open a private file associated with this Context's
abstract SQLiteDatabase openOrCreateDatabase (/reference/android/co
(/reference/android/database/sqlite/SQLiteDatabase) (/reference/java/lang/String) name, int mode,
errorHandler)
Open a new private SQLiteDatabase associated w
abstract SQLiteDatabase openOrCreateDatabase (/reference/android/co
(/reference/android/database/sqlite/SQLiteDatabase) [Link] (/reference/
Open a new private SQLiteDatabase associated w
abstract Drawable peekWallpaper (/reference/android/content/Co
(/reference/android/graphics/drawable/Drawable)
This method was deprecated in API level 15. Use W
void registerComponentCallbacks (/reference/an
Add a new ComponentCallbacks (/reference/an
void registerDeviceIdChangeListener (/referen
IntConsumer (/reference/java/util/function/IntCo
Adds a new device ID changed listener to the Con
[Link] 31/302
2/15/26, 8:49 PM Context | API reference | Android Developers
abstract Intent registerReceiver (/reference/android/content
(/reference/android/content/Intent) (/reference/android/content/IntentFilter) filter
Register a BroadcastReceiver to be run in the mai
abstract Intent registerReceiver (/reference/android/content
(/reference/android/content/Intent) (/reference/android/content/IntentFilter) filter
Register to receive intent broadcasts, with the rec
abstract Intent registerReceiver (/reference/android/content
(/reference/android/content/Intent) (/reference/android/content/BroadcastReceiver)
int flags)
Register to receive intent broadcasts, to run in the
abstract Intent registerReceiver (/reference/android/content
(/reference/android/content/Intent) (/reference/android/content/BroadcastReceiver)
Register to receive intent broadcasts, to run in the
abstract void removeStickyBroadcast (/reference/android/c
This method was deprecated in API level 21. Sticky
broadcast to report that something has changed,
abstract void removeStickyBroadcastAsUser (/reference/a
(/reference/android/os/UserHandle) user)
This method was deprecated in API level 21. Sticky
broadcast to report that something has changed,
void revokeSelfPermissionOnKill (/reference/an
Triggers the asynchronous revocation of a runtim
void revokeSelfPermissionsOnKill (/reference/a
Triggers the revocation of one or more permission
abstract void revokeUriPermission (/reference/android/con
Remove all permissions to access a particular con
other mechanism.
[Link] 32/302
2/15/26, 8:49 PM Context | API reference | Android Developers
abstract void revokeUriPermission (/reference/android/con
Remove permissions to access a particular conten
specific target package.
void sendBroadcast (/reference/android/content/Co
receiverPermission, Bundle (/reference/an
Broadcast the given intent to all interested Broadc
abstract void sendBroadcast (/reference/android/content/Co
Broadcast the given intent to all interested Broadc
abstract void sendBroadcast (/reference/android/content/Co
Broadcast the given intent to all interested Broadc
abstract void sendBroadcastAsUser (/reference/android/con
Version of sendBroadcast([Link]
abstract void sendBroadcastAsUser (/reference/android/con
(/reference/android/os/UserHandle) user, Str
Version of sendBroadcast([Link]
void sendBroadcastWithMultiplePermissions (
(/reference/java/lang/String) receiverPermiss
Broadcast the given intent to all interested Broadc
void sendOrderedBroadcast
(/reference/android/content/Context#sendOrdere
(/reference/android/content/Intent) intent, St
resultReceiver, Handler (/reference/androi
Version of sendOrderedBroadcast(android.
(/reference/android/content/Context#sendOrdere
Op to enforce restrictions on which receivers the
abstract void sendOrderedBroadcast (/reference/android/co
(Intent (/reference/android/content/Intent) int
scheduler, int initialCode, String (/re
[Link] 33/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Version of sendBroadcast([Link]
void sendOrderedBroadcast (/reference/android/co
receiverPermission, Bundle (/reference/an
Broadcast the given intent to all interested Broadc
void sendOrderedBroadcast
(/reference/android/content/Context#sendOrdere
(/reference/android/content/Intent) intent, St
Handler (/reference/android/os/Handler) sched
Version of sendBroadcast([Link]
abstract void sendOrderedBroadcast (/reference/android/co
Broadcast the given intent to all interested Broadc
abstract void sendOrderedBroadcastAsUser
(/reference/android/content/Context#sendOrdere
(Intent (/reference/android/content/Intent) int
resultReceiver, Handler (/reference/androi
Version of sendOrderedBroadcast(android.
(/reference/android/content/Context#sendOrdere
the broadcast will be sent to.
abstract void sendStickyBroadcast (/reference/android/con
This method was deprecated in API level 21. Sticky
broadcast to report that something has changed,
void sendStickyBroadcast (/reference/android/con
This method was deprecated in API level 31. Sticky
broadcast to report that something has changed,
abstract void sendStickyBroadcastAsUser (/reference/and
(/reference/android/os/UserHandle) user)
This method was deprecated in API level 21. Sticky
broadcast to report that something has changed,
abstract void sendStickyOrderedBroadcast (/reference/an
(/reference/android/content/Intent) intent, Br
[Link] 34/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/java/lang/String) initialData, Bu
This method was deprecated in API level 21. Sticky
broadcast to report that something has changed,
abstract void sendStickyOrderedBroadcastAsUser
(/reference/android/content/Context#sendStickyO
(/reference/android/content/Intent) intent, Us
int initialCode, String (/reference/java/la
This method was deprecated in API level 21. Sticky
broadcast to report that something has changed,
abstract void setTheme (/reference/android/content/Context#s
Set the base theme for this context.
abstract void setWallpaper (/reference/android/content/Cont
This method was deprecated in API level 15. Use W
This method requires the caller to hold the permis
abstract void setWallpaper (/reference/android/content/Cont
This method was deprecated in API level 15. Use W
This method requires the caller to hold the permis
abstract void startActivities (/reference/android/content/C
Launch multiple new activities.
abstract void startActivities (/reference/android/content/C
Same as startActivities([Link]
abstract void startActivity (/reference/android/content/Co
Same as startActivity([Link].
abstract void startActivity (/reference/android/content/Co
Launch a new activity.
[Link] 35/302
2/15/26, 8:49 PM Context | API reference | Android Developers
abstract ComponentName startForegroundService (/reference/android
(/reference/android/content/ComponentName)
Similar to startService([Link].I
(/reference/android/app/Service#startForeground
abstract boolean startInstrumentation (/reference/android/co
(/reference/java/lang/String) profileFile, Bu
Start executing an Instrumentation (/referenc
abstract void startIntentSender (/reference/android/conten
(/reference/android/content/Intent) fillInInte
Same as startIntentSender([Link]
(/reference/android/content/Context#startIntentS
abstract void startIntentSender (/reference/android/conten
Intent (/reference/android/content/Intent) fill
Like startActivity([Link]
abstract ComponentName startService (/reference/android/content/Cont
(/reference/android/content/ComponentName)
Request that a given application service be starte
abstract boolean stopService (/reference/android/content/Conte
Request that a given application service be stopp
abstract void unbindService (/reference/android/content/Co
Disconnect from an application service.
void unregisterComponentCallbacks (/reference/
Remove a ComponentCallbacks (/reference/and
(/reference/android/content/Context#registerCom
void unregisterDeviceIdChangeListener (/refer
Removes a device ID changed listener from the C
abstract void unregisterReceiver (/reference/android/conte
[Link] 36/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Unregister a previously registered BroadcastRece
void updateServiceGroup (/reference/android/conte
For a service previously bound with bindServic
(/reference/android/content/Context#bindService
service's process in relation to other processes.
Inherited methods
From class [Link] (/reference/java/lang/Object)
Object (/reference/java/lang/Object) clone (/reference/java/lang/Object#clone())()
Creates and returns a copy of this object.
boolean equals
(/reference/java/lang/Object#equals([Link])
(Object (/reference/java/lang/Object) obj)
Indicates whether some other object is "equal to" this
one.
void finalize (/reference/java/lang/Object#finalize())()
Called by the garbage collector on an object when
garbage collection determines that there are no more
references to the object.
final Class (/reference/java/lang/Class)<?> getClass (/reference/java/lang/Object#getClass())()
Returns the runtime class of this Object .
int hashCode (/reference/java/lang/Object#hashCode())
()
Returns a hash code value for the object.
final void notify (/reference/java/lang/Object#notify())()
Wakes up a single thread that is waiting on this
object's monitor.
[Link] 37/302
2/15/26, 8:49 PM Context | API reference | Android Developers
final void notifyAll (/reference/java/lang/Object#notifyAll())
()
Wakes up all threads that are waiting on this object's
monitor.
String (/reference/java/lang/String) toString (/reference/java/lang/Object#toString())()
Returns a string representation of the object.
final void wait (/reference/java/lang/Object#wait(long,%20int))
(long timeoutMillis, int nanos)
Causes the current thread to wait until it is awakened,
typically by being notified or interrupted, or until a
certain amount of real time has elapsed.
final void wait (/reference/java/lang/Object#wait(long))(long
timeoutMillis)
Causes the current thread to wait until it is awakened,
typically by being notified or interrupted, or until a
certain amount of real time has elapsed.
final void wait (/reference/java/lang/Object#wait())()
Causes the current thread to wait until it is awakened,
typically by being notified or interrupted.
Constants
ACCESSIBILITY_SERVICE
Added in API level 4 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) ACCESSIBILITY_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
[Link] 38/302
2/15/26, 8:49 PM Context | API reference | Android Developers
AccessibilityManager (/reference/android/view/accessibility/AccessibilityManager) for giving
the user feedback for UI events through the registered event listeners.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
AccessibilityManager (/reference/android/view/accessibility/AccessibilityManager)
Constant Value: "accessibility"
ACCOUNT_SERVICE Added in API level 5 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) ACCOUNT_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
AccountManager (/reference/android/accounts/AccountManager) for receiving intents at a time
of your choosing.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
AccountManager (/reference/android/accounts/AccountManager)
Constant Value: "account"
ACTIVITY_SERVICE Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) ACTIVITY_SERVICE
[Link] 39/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
ActivityManager (/reference/android/app/ActivityManager) for interacting with the global
system state.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
ActivityManager (/reference/android/app/ActivityManager)
Constant Value: "activity"
ADVANCED_PROTECTION_SERVICE
Added in API level 36 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) ADVANCED_PROTECTION_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve an
AdvancedProtectionManager
(/reference/android/security/advancedprotection/AdvancedProtectionManager)
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
AdvancedProtectionManager
(/reference/android/security/advancedprotection/AdvancedProtectionManager)
Constant Value: "advanced_protection"
ALARM_SERVICE Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 40/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) ALARM_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
AlarmManager (/reference/android/app/AlarmManager) for receiving intents at a time of your
choosing.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
AlarmManager (/reference/android/app/AlarmManager)
Constant Value: "alarm"
APPWIDGET_SERVICE
Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) APPWIDGET_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
AppWidgetManager (/reference/android/appwidget/AppWidgetManager) for accessing
AppWidgets.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "appwidget"
APP_FUNCTION_SERVICE
Added in API level 36 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 41/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) APP_FUNCTION_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve an
AppFunctionManager (/reference/android/app/appfunctions/AppFunctionManager) for executing
app functions.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "app_function"
APP_OPS_SERVICE Added in API level 19 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) APP_OPS_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
AppOpsManager (/reference/android/app/AppOpsManager) for tracking application operations
on the device.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
AppOpsManager (/reference/android/app/AppOpsManager)
Constant Value: "appops"
APP_SEARCH_SERVICE
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 42/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) APP_SEARCH_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve an
AppSearchManager (/reference/android/app/appsearch/AppSearchManager) for indexing and
querying app data managed by the system.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "app_search"
AUDIO_SERVICE Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) AUDIO_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
AudioManager (/reference/android/media/AudioManager) for handling management of volume,
ringer modes and audio routing.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
AudioManager (/reference/android/media/AudioManager)
Constant Value: "audio"
BATTERY_SERVICE Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 43/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) BATTERY_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
BatteryManager (/reference/android/os/BatteryManager) for managing battery state.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "batterymanager"
BIND_ABOVE_CLIENT
Added in API level 14 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_ABOVE_CLIENT
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: indicates that the client application binding to this service considers the service to be
more important than the app itself. When set, the platform will try to have the out of
memory killer kill the app before it kills the service it is bound to, though this is not
guaranteed to be the case.
Constant Value: 8 (0x00000008)
BIND_ADJUST_WITH_ACTIVITY
Added in API level 14 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_ADJUST_WITH_ACTIVITY
[Link] 44/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: 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.
Constant Value: 128 (0x00000080)
BIND_ALLOW_ACTIVITY_STARTS
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_ALLOW_ACTIVITY_STARTS
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: If binding from an app that is visible, the bound service is allowed to start an activity
from background. This was the default behavior before SDK version
Build.VERSION_CODES.UPSIDE_DOWN_CAKE
(/reference/android/os/Build.VERSION_CODES#UPSIDE_DOWN_CAKE) . Since then, the default
behavior changed to disallow the bound service to start a background activity even if the
app bound to it is in foreground, unless this flag is specified when binding.
Constant Value: 512 (0x00000200)
BIND_ALLOW_OOM_MANAGEMENT
Added in API level 14 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_ALLOW_OOM_MANAGEMENT
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
[Link] 45/302
2/15/26, 8:49 PM Context | API reference | Android Developers
: allow the process hosting the bound service to go through its normal memory
management. It will be treated more like a running service, allowing the system to
(temporarily) expunge the process if low on memory or for some other whim it may have,
and being more aggressive about making it a candidate to be killed (and restarted) if
running for a long time.
Constant Value: 16 (0x00000010)
BIND_AUTO_CREATEAdded in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_AUTO_CREATE
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: automatically create the service as long as the binding exists. Note that while this will
create the service, its [Link](Intent, int, int)
(/reference/android/app/Service#onStartCommand([Link],%20int,%20int)) method
will still only be called due to an explicit call to startService(Intent)
(/reference/android/content/Context#startService([Link])) . Even without that,
though, this still provides you with access to the service object while the service is
created.
Note that prior to Build.VERSION_CODES.ICE_CREAM_SANDWICH
(/reference/android/os/Build.VERSION_CODES#ICE_CREAM_SANDWICH) , not supplying this flag
would also impact how important the system consider's the target service's process to
be. When set, the only way for it to be raised was by binding from a service in which case
it will only be important when that activity is in the foreground. Now to achieve this
behavior you must explicitly supply the new flag BIND_ADJUST_WITH_ACTIVITY
(/reference/android/content/Context#BIND_ADJUST_WITH_ACTIVITY) . For compatibility, old
applications that don't specify BIND_AUTO_CREATE
(/reference/android/content/Context#BIND_AUTO_CREATE) will automatically have the flags
BIND_WAIVE_PRIORITY (/reference/android/content/Context#BIND_WAIVE_PRIORITY) and
BIND_ADJUST_WITH_ACTIVITY
(/reference/android/content/Context#BIND_ADJUST_WITH_ACTIVITY) set for them in order to
achieve the same result.
[Link] 46/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Constant Value: 1 (0x00000001)
BIND_DEBUG_UNBIND
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_DEBUG_UNBIND
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: include debugging help for mismatched calls to unbind. When this flag is set, the
callstack of the following unbindService(ServiceConnection)
(/reference/android/content/Context#unbindService([Link])) call is
retained, to be printed if a later incorrect unbind call is made. Note that doing this
requires retaining information about the binding that was made for the lifetime of the app,
resulting in a leak -- this should only be used for debugging.
Constant Value: 2 (0x00000002)
BIND_EXTERNAL_SERVICE
Added in API level 24 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_EXTERNAL_SERVICE
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: The service being bound is an isolated (/reference/android/[Link]#isolatedProcess) ,
external (/reference/android/[Link]#externalService) service. This binds the service into the
calling application's package, rather than the package in which the service is declared.
When using this flag, the code for the service being bound will execute under the calling
application's package name and user ID. Because the service must be an isolated
process, it will not have direct access to the application's data, though. The purpose of
[Link] 47/302
2/15/26, 8:49 PM Context | API reference | Android Developers
this flag is to allow applications to provide services that are attributed to the app using
the service, rather than the application providing the service.
This flag is NOT compatible with BindServiceFlags
(/reference/android/content/[Link]) . If you need to use BindServiceFlags
(/reference/android/content/[Link]) , you must use
BIND_EXTERNAL_SERVICE_LONG
(/reference/android/content/Context#BIND_EXTERNAL_SERVICE_LONG) instead.
Constant Value: -2147483648 (0x80000000)
BIND_EXTERNAL_SERVICE_LONG
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final long BIND_EXTERNAL_SERVICE_LONG
Works in the same way as BIND_EXTERNAL_SERVICE
(/reference/android/content/Context#BIND_EXTERNAL_SERVICE) , but it's defined as a long value
that is compatible to BindServiceFlags (/reference/android/content/[Link]) .
Constant Value: 4611686018427387904 (0x4000000000000000)
BIND_IMPORTANT Added in API level 14 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_IMPORTANT
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: this service is very important to the client, so should be brought to the foreground
process level when the client is. Normally a process can only be raised to the visibility
level by a client, even if that client is in the foreground.
Constant Value: 64 (0x00000040)
[Link] 48/302
2/15/26, 8:49 PM Context | API reference | Android Developers
BIND_INCLUDE_CAPABILITIES
Added in API level 29 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_INCLUDE_CAPABILITIES
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: 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. If binding from a top app
and its target SDK version is at or above Build.VERSION_CODES.R
(/reference/android/os/Build.VERSION_CODES#R) , the app needs to explicitly use
BIND_INCLUDE_CAPABILITIES flag to pass all capabilities to the service so the other app
can have while-in-use access such as location, camera, microphone from background. If
binding from a top app and its target SDK version is below Build.VERSION_CODES.R
(/reference/android/os/Build.VERSION_CODES#R) , BIND_INCLUDE_CAPABILITIES is implicit.
Constant Value: 4096 (0x00001000)
BIND_NOT_FOREGROUND
Added in API level 8 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_NOT_FOREGROUND
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: don't allow this binding to raise the target service's process to the foreground
scheduling priority. It will still be raised to at least the same memory priority as the client
(so that its process will not be killable in any situation where the client is not killable), but
for CPU scheduling purposes it may be left in the background. This only has an impact in
the situation where the binding client is a foreground process and the target service is in
a background process.
Constant Value: 4 (0x00000004)
[Link] 49/302
2/15/26, 8:49 PM Context | API reference | Android Developers
BIND_NOT_PERCEPTIBLE
Added in API level 29 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_NOT_PERCEPTIBLE
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: If binding from an app that is visible or user-perceptible, lower the target service's
importance to below the perceptible level. This allows the system to (temporarily)
expunge the bound process from memory to make room for more important user-
perceptible processes.
Constant Value: 256 (0x00000100)
BIND_PACKAGE_ISOLATED_PROCESS
Added in API level 35 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_PACKAGE_ISOLATED_PROCESS
Flag for bindIsolatedService(Intent, BindServiceFlags, String, Executor,
ServiceConnection)
(/reference/android/content/Context#bindIsolatedService([Link],%[Link].
[Link],%[Link],%[Link],%[Link].S
erviceConnection))
: Bind the service into a shared isolated process, but only with other isolated services
from the same package that declare the same process name.
Specifying this flag allows multiple isolated services defined in the same package to be
running in a single shared isolated process. This shared isolated process must be
specified since this flag will not work with the default application process.
This flag is different from BIND_SHARED_ISOLATED_PROCESS
(/reference/android/content/Context#BIND_SHARED_ISOLATED_PROCESS) since it only allows
binding services from the same package in the same shared isolated process. This also
means the shared package isolated process is global, and not scoped to each potential
calling app.
[Link] 50/302
2/15/26, 8:49 PM Context | API reference | Android Developers
The shared isolated process instance is identified by the "android:process" attribute
defined by the service. This flag cannot be used without this attribute set.
Constant Value: 16384 (0x00004000)
BIND_SHARED_ISOLATED_PROCESS
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_SHARED_ISOLATED_PROCESS
Flag for bindIsolatedService(Intent, BindServiceFlags, String, Executor,
ServiceConnection)
(/reference/android/content/Context#bindIsolatedService([Link],%[Link].
[Link],%[Link],%[Link],%[Link].S
erviceConnection))
: Bind the service into a shared isolated process. Specifying this flag allows multiple
isolated services to be running in a single shared isolated process. The shared isolated
process instance is identified by the instanceName parameter in
bindIsolatedService([Link], int, [Link],
[Link], [Link])
(/reference/android/content/Context#bindIsolatedService([Link],%20int,%[Link]
.String,%[Link],%[Link]))
. Subsequent calls to bindIsolatedService(Intent, BindServiceFlags, String,
Executor, ServiceConnection)
(/reference/android/content/Context#bindIsolatedService([Link],%[Link].
[Link],%[Link],%[Link],%[Link].S
erviceConnection))
with the same instanceName will cause the isolated service to be co-located in the same
shared isolated process. Note that the shared isolated process is scoped to the calling
app; once created, only the calling app can bind additional isolated services into the
shared process. However, the services themselves can come from different APKs and
therefore different vendors. Only services that set the
[Link] (/reference/android/[Link]#allowSharedIsolatedProcess)
attribute to true are allowed to be bound into a shared isolated process.
Constant Value: 8192 (0x00002000)
[Link] 51/302
2/15/26, 8:49 PM Context | API reference | Android Developers
BIND_WAIVE_PRIORITY
Added in API level 14 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int BIND_WAIVE_PRIORITY
Flag for bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: don't impact the scheduling or memory management priority of the target service's
hosting process. Allows the service's process to be managed on the background LRU list
just like a regular application process in the background.
Constant Value: 32 (0x00000020)
BIOMETRIC_SERVICE
Added in API level 29 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) BIOMETRIC_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
BiometricManager (/reference/android/hardware/biometrics/BiometricManager) for handling
biometric and PIN/pattern/password authentication.
See also:
getSystemService(Class)
(/reference/android/content/Context#getSystemService([Link]<T>))
BiometricManager (/reference/android/hardware/biometrics/BiometricManager)
Constant Value: "biometric"
BLOB_STORE_SERVICE
Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 52/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) BLOB_STORE_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
BlobStoreManager (/reference/android/app/blob/BlobStoreManager) for contributing and
accessing data blobs from the blob store maintained by the system.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
BlobStoreManager (/reference/android/app/blob/BlobStoreManager)
Constant Value: "blob_store"
BLUETOOTH_SERVICE
Added in API level 18 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) BLUETOOTH_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
BluetoothManager (/reference/android/bluetooth/BluetoothManager) for using Bluetooth.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "bluetooth"
BUGREPORT_SERVICE
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 53/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) BUGREPORT_SERVICE
Service to capture a bugreport.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
BugreportManager (/reference/android/os/BugreportManager)
Constant Value: "bugreport"
CAMERA_SERVICE Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) CAMERA_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
CameraManager (/reference/android/hardware/camera2/CameraManager) for interacting with
camera devices.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
CameraManager (/reference/android/hardware/camera2/CameraManager)
Constant Value: "camera"
CAPTIONING_SERVICE
Added in API level 19 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 54/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) CAPTIONING_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
CaptioningManager (/reference/android/view/accessibility/CaptioningManager) for obtaining
captioning properties and listening for changes in captioning preferences.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
CaptioningManager (/reference/android/view/accessibility/CaptioningManager)
Constant Value: "captioning"
CARRIER_CONFIG_SERVICE
Added in API level 23 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) CARRIER_CONFIG_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
CarrierConfigManager (/reference/android/telephony/CarrierConfigManager) for reading
carrier configuration values.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
CarrierConfigManager (/reference/android/telephony/CarrierConfigManager)
Constant Value: "carrier_config"
CHOOSER_SERVICE Added in version 36.1 (/topic/libraries/support-library/revisions)
[Link] 55/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) CHOOSER_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
ChooserManager (/reference/android/service/chooser/ChooserManager) .
Note: This service is not available on Wear OS, Android TV, or Android Auto devices. On these form
factors, calls to #getSystemService for this service will return null.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
ChooserManager (/reference/android/service/chooser/ChooserManager)
Constant Value: "chooser"
CLIPBOARD_SERVICEAdded in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) CLIPBOARD_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
ClipboardManager (/reference/android/content/ClipboardManager) for accessing and
modifying the contents of the global clipboard.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
ClipboardManager (/reference/android/content/ClipboardManager)
Constant Value: "clipboard"
[Link] 56/302
2/15/26, 8:49 PM Context | API reference | Android Developers
COMPANION_DEVICE_SERVICE
Added in API level 26 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) COMPANION_DEVICE_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
CompanionDeviceManager (/reference/android/companion/CompanionDeviceManager) for
managing companion devices
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
CompanionDeviceManager (/reference/android/companion/CompanionDeviceManager)
Constant Value: "companiondevice"
CONNECTIVITY_DIAGNOSTICS_SERVICE
Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) CONNECTIVITY_DIAGNOSTICS_SERV
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
ConnectivityDiagnosticsManager (/reference/android/net/ConnectivityDiagnosticsManager)
for performing network connectivity diagnostics as well as receiving network connectivity
information from the system.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
ConnectivityDiagnosticsManager (/reference/android/net/ConnectivityDiagnosticsManager)
Constant Value: "connectivity_diagnostics"
[Link] 57/302
2/15/26, 8:49 PM Context | API reference | Android Developers
CONNECTIVITY_SERVICE
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) CONNECTIVITY_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
ConnectivityManager (/reference/android/net/ConnectivityManager) for handling
management of network connections.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
ConnectivityManager (/reference/android/net/ConnectivityManager)
Constant Value: "connectivity"
CONSUMER_IR_SERVICE
Added in API level 19 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) CONSUMER_IR_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
ConsumerIrManager (/reference/android/hardware/ConsumerIrManager) for transmitting
infrared signals from the device.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
ConsumerIrManager (/reference/android/hardware/ConsumerIrManager)
Constant Value: "consumer_ir"
[Link] 58/302
2/15/26, 8:49 PM Context | API reference | Android Developers
CONTACT_KEYS_SERVICE
Added in API level 35 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) CONTACT_KEYS_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
E2eeContactKeysManager (/reference/android/provider/E2eeContactKeysManager) to managing
contact keys.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
E2eeContactKeysManager (/reference/android/provider/E2eeContactKeysManager)
Constant Value: "contact_keys"
CONTEXT_IGNORE_SECURITY
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int CONTEXT_IGNORE_SECURITY
Flag for use with createPackageContext(String, int)
(/reference/android/content/Context#createPackageContext([Link],%20int)) : ignore any
security restrictions on the Context being requested, allowing it to always be loaded. For
use with CONTEXT_INCLUDE_CODE
(/reference/android/content/Context#CONTEXT_INCLUDE_CODE) to allow code to be loaded into
a process even when it isn't safe to do so. Use with extreme care!
Constant Value: 2 (0x00000002)
CONTEXT_INCLUDE_CODE
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 59/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final int CONTEXT_INCLUDE_CODE
Flag for use with createPackageContext(String, int)
(/reference/android/content/Context#createPackageContext([Link],%20int)) : include the
application code with the context. This means loading code into the caller's process, so
that getClassLoader() (/reference/android/content/Context#getClassLoader()) can be used to
instantiate the application's classes. Setting this flags imposes security restrictions on
what application context you can access; if the requested application can not be safely
loaded into your process, [Link] will be thrown. If this flag is not set,
there will be no restrictions on the packages that can be loaded, but getClassLoader()
(/reference/android/content/Context#getClassLoader()) will always return the default system
class loader.
Constant Value: 1 (0x00000001)
CONTEXT_RESTRICTED
Added in API level 4 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int CONTEXT_RESTRICTED
Flag for use with createPackageContext(String, int)
(/reference/android/content/Context#createPackageContext([Link],%20int)) : a restricted
context may disable specific features. For instance, a View associated with a restricted
context would ignore particular XML attributes.
Constant Value: 4 (0x00000004)
CREDENTIAL_SERVICE
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) CREDENTIAL_SERVICE
[Link] 60/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
CredentialManager (/reference/android/credentials/CredentialManager) to authenticate a user
to your app.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
CredentialManager (/reference/android/credentials/CredentialManager)
Constant Value: "credential"
CROSS_PROFILE_APPS_SERVICE
Added in API level 28 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) CROSS_PROFILE_APPS_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
CrossProfileApps (/reference/android/content/pm/CrossProfileApps) for cross profile
operations.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "crossprofileapps"
DEVICE_ID_DEFAULTAdded in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int DEVICE_ID_DEFAULT
[Link] 61/302
2/15/26, 8:49 PM Context | API reference | Android Developers
The default device ID, which is the ID of the primary (non-virtual) device.
Constant Value: 0 (0x00000000)
DEVICE_ID_INVALIDAdded in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int DEVICE_ID_INVALID
Invalid device ID.
Constant Value: -1 (0xffffffff)
DEVICE_LOCK_SERVICE
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) DEVICE_LOCK_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
DeviceLockManager (/reference/android/devicelock/DeviceLockManager) .
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "device_lock"
DEVICE_POLICY_SERVICE
Added in API level 8 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) DEVICE_POLICY_SERVICE
[Link] 62/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
DevicePolicyManager (/reference/android/app/admin/DevicePolicyManager) for working with
global device policy management.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "device_policy"
DISPLAY_HASH_SERVICE
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) DISPLAY_HASH_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to access
DisplayHashManager (/reference/android/view/displayhash/DisplayHashManager) to handle
display hashes.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "display_hash"
DISPLAY_SERVICE Added in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) DISPLAY_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
[Link] 63/302
2/15/26, 8:49 PM Context | API reference | Android Developers
DisplayManager (/reference/android/hardware/display/DisplayManager) for interacting with
display devices.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
DisplayManager (/reference/android/hardware/display/DisplayManager)
Constant Value: "display"
DOMAIN_VERIFICATION_SERVICE
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) DOMAIN_VERIFICATION_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to access
DomainVerificationManager
(/reference/android/content/pm/verify/domain/DomainVerificationManager) to retrieve approval
and user state for declared web domains.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
DomainVerificationManager
(/reference/android/content/pm/verify/domain/DomainVerificationManager)
Constant Value: "domain_verification"
DOWNLOAD_SERVICE
Added in API level 9 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) DOWNLOAD_SERVICE
[Link] 64/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
DownloadManager (/reference/android/app/DownloadManager) for requesting HTTP
downloads.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "download"
DROPBOX_SERVICE Added in API level 8 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) DROPBOX_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
DropBoxManager (/reference/android/os/DropBoxManager) instance for recording diagnostic
logs.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "dropbox"
EUICC_SERVICE Added in API level 28 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) EUICC_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
[Link] 65/302
2/15/26, 8:49 PM Context | API reference | Android Developers
EuiccManager (/reference/android/telephony/euicc/EuiccManager) to manage the device eUICC
(embedded SIM).
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
EuiccManager (/reference/android/telephony/euicc/EuiccManager)
Constant Value: "euicc"
FILE_INTEGRITY_SERVICE
Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) FILE_INTEGRITY_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve an
FileIntegrityManager (/reference/android/security/FileIntegrityManager) .
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
FileIntegrityManager (/reference/android/security/FileIntegrityManager)
Constant Value: "file_integrity"
GAME_SERVICE Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) GAME_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
[Link] 66/302
2/15/26, 8:49 PM Context | API reference | Android Developers
GameManager (/reference/android/app/GameManager) .
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "game"
GRAMMATICAL_INFLECTION_SERVICE
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) GRAMMATICAL_INFLECTION_SERVIC
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
GrammaticalInflectionManager (/reference/android/app/GrammaticalInflectionManager) .
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "grammatical_inflection"
HARDWARE_PROPERTIES_SERVICE
Added in API level 24 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) HARDWARE_PROPERTIES_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
HardwarePropertiesManager (/reference/android/os/HardwarePropertiesManager) for
accessing the hardware properties service.
See also:
[Link] 67/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "hardware_properties"
HEALTHCONNECT_SERVICE
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) HEALTHCONNECT_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
HealthConnectManager (/reference/android/health/connect/HealthConnectManager) .
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
HealthConnectManager (/reference/android/health/connect/HealthConnectManager)
Constant Value: "healthconnect"
INPUT_METHOD_SERVICE
Added in API level 3 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) INPUT_METHOD_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
InputMethodManager (/reference/android/view/inputmethod/InputMethodManager) for accessing
input methods.
See also:
[Link] 68/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "input_method"
INPUT_SERVICE Added in API level 16 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) INPUT_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
InputManager (/reference/android/hardware/input/InputManager) for interacting with input
devices.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
InputManager (/reference/android/hardware/input/InputManager)
Constant Value: "input"
IPSEC_SERVICE Added in API level 28 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) IPSEC_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
IpSecManager (/reference/android/net/IpSecManager) for encrypting Sockets or Networks
with IPSec.
See also:
[Link] 69/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "ipsec"
JOB_SCHEDULER_SERVICE
Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) JOB_SCHEDULER_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
JobScheduler (/reference/android/app/job/JobScheduler) instance for managing occasional
background tasks.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
JobScheduler (/reference/android/app/job/JobScheduler)
Constant Value: "jobscheduler"
KEYGUARD_SERVICEAdded in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) KEYGUARD_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
KeyguardManager (/reference/android/app/KeyguardManager) for controlling keyguard.
See also:
[Link] 70/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
KeyguardManager (/reference/android/app/KeyguardManager)
Constant Value: "keyguard"
KEYSTORE_SERVICEAdded in API level 36 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) KEYSTORE_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
KeyStoreManager (/reference/android/security/keystore/KeyStoreManager) for accessing
Android Keystore (/privacy-and-security/keystore) functions.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
KeyStoreManager (/reference/android/security/keystore/KeyStoreManager)
Constant Value: "keystore"
LAUNCHER_APPS_SERVICE
Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) LAUNCHER_APPS_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
LauncherApps (/reference/android/content/pm/LauncherApps) for querying and monitoring
launchable apps across profiles of a user.
See also:
[Link] 71/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
LauncherApps (/reference/android/content/pm/LauncherApps)
Constant Value: "launcherapps"
LAYOUT_INFLATER_SERVICE
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) LAYOUT_INFLATER_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
LayoutInflater (/reference/android/view/LayoutInflater) for inflating layout resources in this
context.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
LayoutInflater (/reference/android/view/LayoutInflater)
Constant Value: "layout_inflater"
LOCALE_SERVICE Added in API level 33 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) LOCALE_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
LocaleManager (/reference/android/app/LocaleManager) .
See also:
[Link] 72/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "locale"
LOCATION_SERVICEAdded in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) LOCATION_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
LocationManager (/reference/android/location/LocationManager) for controlling location
updates.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
LocationManager (/reference/android/location/LocationManager)
Constant Value: "location"
MEDIA_COMMUNICATION_SERVICE
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) MEDIA_COMMUNICATION_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
MediaCommunicationManager (/reference/android/media/MediaCommunicationManager) for
managing MediaSession2 (/reference/android/media/MediaSession2) .
See also:
[Link] 73/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
MediaCommunicationManager (/reference/android/media/MediaCommunicationManager)
Constant Value: "media_communication"
MEDIA_METRICS_SERVICE
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) MEDIA_METRICS_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
MediaMetricsManager (/reference/android/media/metrics/MediaMetricsManager) for interacting
with media metrics on the device.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
MediaMetricsManager (/reference/android/media/metrics/MediaMetricsManager)
Constant Value: "media_metrics"
MEDIA_PROJECTION_SERVICE
Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) MEDIA_PROJECTION_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
MediaProjectionManager (/reference/android/media/projection/MediaProjectionManager)
instance for managing media projection sessions.
See also:
[Link] 74/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
MediaProjectionManager (/reference/android/media/projection/MediaProjectionManager)
Constant Value: "media_projection"
MEDIA_QUALITY_SERVICE
Added in API level 36 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) MEDIA_QUALITY_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
MediaQualityManager (/reference/android/media/quality/MediaQualityManager) for standardize
picture and audio API parameters.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
MediaQualityManager (/reference/android/media/quality/MediaQualityManager)
Constant Value: "media_quality"
MEDIA_ROUTER_SERVICE
Added in API level 16 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) MEDIA_ROUTER_SERVICE
Use with getSystemService(Class)
(/reference/android/content/Context#getSystemService([Link]<T>)) to retrieve a
MediaRouter (/reference/android/media/MediaRouter) for controlling and managing routing of
media.
See also:
[Link] 75/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
MediaRouter (/reference/android/media/MediaRouter)
Constant Value: "media_router"
MEDIA_SESSION_SERVICE
Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) MEDIA_SESSION_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
MediaSessionManager (/reference/android/media/session/MediaSessionManager) for managing
media Sessions.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
MediaSessionManager (/reference/android/media/session/MediaSessionManager)
Constant Value: "media_session"
MIDI_SERVICE Added in API level 23 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) MIDI_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
MidiManager (/reference/android/media/midi/MidiManager) for accessing the MIDI service.
See also:
[Link] 76/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "midi"
MODE_APPEND Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int MODE_APPEND
File creation mode: for use with openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int)) , if the file already
exists then write data to the end of the existing file instead of erasing it.
See also:
openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int))
Constant Value: 32768 (0x00008000)
MODE_ENABLE_WRITE_AHEAD_LOGGING
Added in API level 16 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int MODE_ENABLE_WRITE_AHEAD_LOGGING
Database open flag: when set, the database is opened with write-ahead logging enabled
by default.
See also:
openOrCreateDatabase(String, int, CursorFactory)
(/reference/android/content/Context#openOrCreateDatabase([Link],%20int,%[Link]
[Link]))
[Link] 77/302
2/15/26, 8:49 PM Context | API reference | Android Developers
openOrCreateDatabase(String, int, CursorFactory, DatabaseErrorHandler)
(/reference/android/content/Context#openOrCreateDatabase([Link],%20int,%[Link]
[Link],%[Link]))
[Link]()
(/reference/android/database/sqlite/SQLiteDatabase#enableWriteAheadLogging())
Constant Value: 8 (0x00000008)
MODE_MULTI_PROCESS
Added in API level 11 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 23 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int MODE_MULTI_PROCESS
This constant was deprecated in API level 23.
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 (/reference/android/content/ContentProvider).
SharedPreference loading flag: when set, the file on disk will be checked for modification
even if the shared preferences instance is already loaded in this process. This behavior is
sometimes desired in cases where the application has multiple processes, all writing to
the same SharedPreferences file. Generally there are better forms of communication
between processes, though.
This was the legacy (but undocumented) behavior in and before Gingerbread (Android
2.3) and this flag is implied when targeting such releases. For applications targeting SDK
versions greater than Android 2.3, this flag must be explicitly set if desired.
See also:
getSharedPreferences(String, int)
(/reference/android/content/Context#getSharedPreferences([Link],%20int))
Constant Value: 4 (0x00000004)
[Link] 78/302
2/15/26, 8:49 PM Context | API reference | Android Developers
MODE_NO_LOCALIZED_COLLATORS
Added in API level 24 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int MODE_NO_LOCALIZED_COLLATORS
Database open flag: when set, the database is opened without support for localized
collators.
See also:
openOrCreateDatabase(String, int, CursorFactory)
(/reference/android/content/Context#openOrCreateDatabase([Link],%20int,%[Link]
[Link]))
openOrCreateDatabase(String, int, CursorFactory, DatabaseErrorHandler)
(/reference/android/content/Context#openOrCreateDatabase([Link],%20int,%[Link]
[Link],%[Link]))
SQLiteDatabase.NO_LOCALIZED_COLLATORS
(/reference/android/database/sqlite/SQLiteDatabase#NO_LOCALIZED_COLLATORS)
Constant Value: 16 (0x00000010)
MODE_PRIVATE Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final 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).
Constant Value: 0 (0x00000000)
MODE_WORLD_READABLE
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 79/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final int MODE_WORLD_READABLE
This constant was deprecated in API level 17.
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 (/reference/android/content/ContentProvider), BroadcastReceiver
(/reference/android/content/BroadcastReceiver), and Service (/reference/android/app/Service). There
are no guarantees that this access mode will remain on a file, such as when it goes through a backup
and restore.
File creation mode: allow all other applications to have read access to the created file.
Starting from Build.VERSION_CODES.N (/reference/android/os/Build.VERSION_CODES#N) ,
attempting to use this mode throws a SecurityException
(/reference/java/lang/SecurityException) .
See also:
FileProvider ([Link]
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PERMISSION)
Constant Value: 1 (0x00000001)
MODE_WORLD_WRITEABLE
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int MODE_WORLD_WRITEABLE
This constant was deprecated in API level 17.
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 (/reference/android/content/ContentProvider), BroadcastReceiver
[Link] 80/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/content/BroadcastReceiver), and Service (/reference/android/app/Service). There
are no guarantees that this access mode will remain on a file, such as when it goes through a backup
and restore.
File creation mode: allow all other applications to have write access to the created file.
Starting from Build.VERSION_CODES.N (/reference/android/os/Build.VERSION_CODES#N) ,
attempting to use this mode will throw a SecurityException
(/reference/java/lang/SecurityException) .
See also:
FileProvider ([Link]
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PERMISSION)
Constant Value: 2 (0x00000002)
NETWORK_STATS_SERVICE
Added in API level 23 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) NETWORK_STATS_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
NetworkStatsManager (/reference/android/app/usage/NetworkStatsManager) for querying
network usage stats.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
NetworkStatsManager (/reference/android/app/usage/NetworkStatsManager)
Constant Value: "netstats"
[Link] 81/302
2/15/26, 8:49 PM Context | API reference | Android Developers
NFC_SERVICE Added in API level 10 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) NFC_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a NfcManager
(/reference/android/nfc/NfcManager) for using NFC.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "nfc"
NOTIFICATION_SERVICE
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) NOTIFICATION_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
NotificationManager (/reference/android/app/NotificationManager) for informing the user of
background events.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
NotificationManager (/reference/android/app/NotificationManager)
Constant Value: "notification"
NSD_SERVICE Added in API level 16 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 82/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) NSD_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a NsdManager
(/reference/android/net/nsd/NsdManager) for handling management of network service
discovery
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
NsdManager (/reference/android/net/nsd/NsdManager)
Constant Value: "servicediscovery"
OVERLAY_SERVICE Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) OVERLAY_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
OverlayManager (/reference/android/content/om/OverlayManager) for managing overlay
packages.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
OverlayManager (/reference/android/content/om/OverlayManager)
Constant Value: "overlay"
PEOPLE_SERVICE Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 83/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) PEOPLE_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to access a
PeopleManager (/reference/android/app/people/PeopleManager) to interact with your published
conversations.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "people"
PERFORMANCE_HINT_SERVICE
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) PERFORMANCE_HINT_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
PerformanceHintManager (/reference/android/os/PerformanceHintManager) for accessing the
performance hinting service.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "performance_hint"
PERSISTENT_DATA_BLOCK_SERVICE
Added in API level 35 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 84/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) PERSISTENT_DATA_BLOCK_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
PersistentDataBlockManager
(/reference/android/service/persistentdata/PersistentDataBlockManager) instance for interacting
with a storage device that lives across factory resets.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
PersistentDataBlockManager
(/reference/android/service/persistentdata/PersistentDataBlockManager)
Constant Value: "persistent_data_block"
POWER_SERVICE Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) POWER_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
PowerManager (/reference/android/os/PowerManager) for controlling power management,
including "wake locks," which let you keep the device on while you're running long tasks.
Constant Value: "power"
PRINT_SERVICE Added in API level 19 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 85/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) PRINT_SERVICE
PrintManager (/reference/android/print/PrintManager) for printing and managing printers and
print tasks.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
PrintManager (/reference/android/print/PrintManager)
Constant Value: "print"
PROFILING_SERVICEAdded in API level 35 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) PROFILING_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve an
ProfilingManager (/reference/android/os/ProfilingManager) .
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "profiling"
RECEIVER_EXPORTED
Added in API level 33 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int RECEIVER_EXPORTED
[Link] 86/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Flag for registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
: The receiver can receive broadcasts from other Apps. Has the same behavior as marking
a statically registered receiver with "exported=true"
Constant Value: 2 (0x00000002)
RECEIVER_NOT_EXPORTED
Added in API level 33 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int RECEIVER_NOT_EXPORTED
Flag for registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
: The receiver cannot receive broadcasts from other Apps. Has the same behavior as
marking a statically registered receiver with "exported=false"
Constant Value: 4 (0x00000004)
RECEIVER_VISIBLE_TO_INSTANT_APPS
Added in API level 26 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final int RECEIVER_VISIBLE_TO_INSTANT_APPS
Flag for registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
: The receiver can receive broadcasts from Instant Apps.
Constant Value: 1 (0x00000001)
RESTRICTIONS_SERVICE
Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 87/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) RESTRICTIONS_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
RestrictionsManager (/reference/android/content/RestrictionsManager) for retrieving
application restrictions and requesting permissions for restricted operations.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
RestrictionsManager (/reference/android/content/RestrictionsManager)
Constant Value: "restrictions"
ROLE_SERVICE Added in API level 29 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) ROLE_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
RoleManager (/reference/android/app/role/RoleManager) for managing roles.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
RoleManager (/reference/android/app/role/RoleManager)
Constant Value: "role"
SATELLITE_SERVICEAdded in API level 36 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 88/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) SATELLITE_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
SatelliteManager (/reference/android/telephony/satellite/SatelliteManager) for accessing
satellite functionality.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
SatelliteManager (/reference/android/telephony/satellite/SatelliteManager)
Constant Value: "satellite"
SEARCH_SERVICE Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) SEARCH_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
SearchManager (/reference/android/app/SearchManager) for handling searches.
Configuration.UI_MODE_TYPE_WATCH
(/reference/android/content/res/Configuration#UI_MODE_TYPE_WATCH) does not support
SearchManager (/reference/android/app/SearchManager) .
See also:
getSystemService(Class)
(/reference/android/content/Context#getSystemService([Link]<T>))
SearchManager (/reference/android/app/SearchManager)
Constant Value: "search"
[Link] 89/302
2/15/26, 8:49 PM Context | API reference | Android Developers
SECURITY_STATE_SERVICE
Added in API level 35 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) SECURITY_STATE_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
SecurityStateManager (/reference/android/os/SecurityStateManager) for accessing the
security state manager service.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
SecurityStateManager (/reference/android/os/SecurityStateManager)
Constant Value: "security_state"
SENSOR_SERVICE Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) SENSOR_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
SensorManager (/reference/android/hardware/SensorManager) for accessing sensors.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
SensorManager (/reference/android/hardware/SensorManager)
Constant Value: "sensor"
[Link] 90/302
2/15/26, 8:49 PM Context | API reference | Android Developers
SHORTCUT_SERVICEAdded in API level 25 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) SHORTCUT_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
ShortcutManager (/reference/android/content/pm/ShortcutManager) for accessing the launcher
shortcut service.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
ShortcutManager (/reference/android/content/pm/ShortcutManager)
Constant Value: "shortcut"
STATUS_BAR_SERVICE
Added in API level 33 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) STATUS_BAR_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
StatusBarManager (/reference/android/app/StatusBarManager) for interacting with the status
bar and quick settings.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
StatusBarManager (/reference/android/app/StatusBarManager)
Constant Value: "statusbar"
[Link] 91/302
2/15/26, 8:49 PM Context | API reference | Android Developers
STORAGE_SERVICE Added in API level 9 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) STORAGE_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
StorageManager (/reference/android/os/storage/StorageManager) for accessing system storage
functions.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
StorageManager (/reference/android/os/storage/StorageManager)
Constant Value: "storage"
STORAGE_STATS_SERVICE
Added in API level 26 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) STORAGE_STATS_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
StorageStatsManager (/reference/android/app/usage/StorageStatsManager) for accessing
system storage statistics.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
StorageStatsManager (/reference/android/app/usage/StorageStatsManager)
Constant Value: "storagestats"
[Link] 92/302
2/15/26, 8:49 PM Context | API reference | Android Developers
SYSTEM_HEALTH_SERVICE
Added in API level 24 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) SYSTEM_HEALTH_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
SystemHealthManager (/reference/android/os/health/SystemHealthManager) for accessing
system health (battery, power, memory, etc) metrics.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "systemhealth"
TELECOM_SERVICE Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) TELECOM_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
TelecomManager (/reference/android/telecom/TelecomManager) to manage telecom-related
features of the device.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
TelecomManager (/reference/android/telecom/TelecomManager)
Constant Value: "telecom"
[Link] 93/302
2/15/26, 8:49 PM Context | API reference | Android Developers
TELEPHONY_IMS_SERVICE
Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) TELEPHONY_IMS_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve an
ImsManager (/reference/android/telephony/ims/ImsManager) .
Constant Value: "telephony_ims"
TELEPHONY_PHONE_NUMBER_SERVICE
Added in version 36.1 (/topic/libraries/support-library/revisions)
public static final String (/reference/java/lang/String) TELEPHONY_PHONE_NUMBER_SERVIC
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
PhoneNumberManager (/reference/android/telephony/PhoneNumberManager) for parsing phone
numbers.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
PhoneNumberManager (/reference/android/telephony/PhoneNumberManager)
Constant Value: "telephony_phone_number"
TELEPHONY_SERVICEAdded in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) TELEPHONY_SERVICE
[Link] 94/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
TelephonyManager (/reference/android/telephony/TelephonyManager) for handling
management the telephony features of the device.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
TelephonyManager (/reference/android/telephony/TelephonyManager)
Constant Value: "phone"
TELEPHONY_SUBSCRIPTION_SERVICE
Added in API level 22 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) TELEPHONY_SUBSCRIPTION_SERVIC
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
SubscriptionManager (/reference/android/telephony/SubscriptionManager) for handling
management the telephony subscriptions of the device.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
SubscriptionManager (/reference/android/telephony/SubscriptionManager)
Constant Value: "telephony_subscription_service"
TETHERING_SERVICE
Added in API level 36 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) TETHERING_SERVICE
[Link] 95/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
TetheringManager (/reference/android/net/TetheringManager) for managing tethering
functions.
See also:
TetheringManager (/reference/android/net/TetheringManager)
Constant Value: "tethering"
TEXT_CLASSIFICATION_SERVICE
Added in API level 26 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) TEXT_CLASSIFICATION_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
TextClassificationManager (/reference/android/view/textclassifier/TextClassificationManager)
for text classification services.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
TextClassificationManager (/reference/android/view/textclassifier/TextClassificationManager)
Constant Value: "textclassification"
TEXT_SERVICES_MANAGER_SERVICE
Added in API level 14 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) TEXT_SERVICES_MANAGER_SERVICE
[Link] 96/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
TextServicesManager (/reference/android/view/textservice/TextServicesManager) for accessing
text services.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "textservices"
TV_AD_SERVICE Added in API level 36 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) TV_AD_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
TvAdManager (/reference/android/media/tv/ad/TvAdManager) for interacting with TV client-side
advertisement services on the device.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
TvAdManager (/reference/android/media/tv/ad/TvAdManager)
Constant Value: "tv_ad"
TV_INPUT_SERVICE Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) TV_INPUT_SERVICE
[Link] 97/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
TvInputManager (/reference/android/media/tv/TvInputManager) for interacting with TV inputs
on the device.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
TvInputManager (/reference/android/media/tv/TvInputManager)
Constant Value: "tv_input"
TV_INTERACTIVE_APP_SERVICE
Added in API level 33 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) TV_INTERACTIVE_APP_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
TvInteractiveAppManager (/reference/android/media/tv/interactive/TvInteractiveAppManager)
for interacting with TV interactive applications on the device.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
TvInteractiveAppManager (/reference/android/media/tv/interactive/TvInteractiveAppManager)
Constant Value: "tv_interactive_app"
UI_MODE_SERVICE Added in API level 8 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) UI_MODE_SERVICE
[Link] 98/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
UiModeManager (/reference/android/app/UiModeManager) for controlling UI modes.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "uimode"
USAGE_STATS_SERVICE
Added in API level 22 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) USAGE_STATS_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
UsageStatsManager (/reference/android/app/usage/UsageStatsManager) for querying device
usage stats.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
UsageStatsManager (/reference/android/app/usage/UsageStatsManager)
Constant Value: "usagestats"
USB_SERVICE Added in API level 12 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) USB_SERVICE
[Link] 99/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a UsbManager
(/reference/android/hardware/usb/UsbManager) for access to USB devices (as a USB host) and
for controlling this device's behavior as a USB device.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
UsbManager (/reference/android/hardware/usb/UsbManager)
Constant Value: "usb"
USER_SERVICE Added in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) USER_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
UserManager (/reference/android/os/UserManager) for managing users on devices that
support multiple users.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
UserManager (/reference/android/os/UserManager)
Constant Value: "user"
VIBRATOR_MANAGER_SERVICE
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) VIBRATOR_MANAGER_SERVICE
[Link] 100/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
VibratorManager (/reference/android/os/VibratorManager) for accessing the device vibrators,
interacting with individual ones and playing synchronized effects on multiple vibrators.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
VibratorManager (/reference/android/os/VibratorManager)
Constant Value: "vibrator_manager"
VIBRATOR_SERVICE
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) VIBRATOR_SERVICE
This constant was deprecated in API level 31.
Use VibratorManager (/reference/android/os/VibratorManager) to retrieve the default system vibrator.
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a Vibrator
(/reference/android/os/Vibrator) for interacting with the vibration hardware.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Vibrator (/reference/android/os/Vibrator)
Constant Value: "vibrator"
VIRTUAL_DEVICE_SERVICE
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 101/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) VIRTUAL_DEVICE_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
VirtualDeviceManager (/reference/android/companion/virtual/VirtualDeviceManager) for
managing virtual devices. On devices without
PackageManager.FEATURE_COMPANION_DEVICE_SETUP
(/reference/android/content/pm/PackageManager#FEATURE_COMPANION_DEVICE_SETUP) system
feature the getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) will return null .
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
VirtualDeviceManager (/reference/android/companion/virtual/VirtualDeviceManager)
Constant Value: "virtualdevice"
VPN_MANAGEMENT_SERVICE
Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) VPN_MANAGEMENT_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a VpnManager
(/reference/android/net/VpnManager) to manage profiles for the platform built-in VPN.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "vpn_management"
[Link] 102/302
2/15/26, 8:49 PM Context | API reference | Android Developers
WALLPAPER_SERVICE
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) WALLPAPER_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
[Link] for accessing wallpapers.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
Constant Value: "wallpaper"
WIFI_AWARE_SERVICE
Added in API level 26 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) WIFI_AWARE_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
WifiAwareManager (/reference/android/net/wifi/aware/WifiAwareManager) for handling
management of Wi-Fi Aware.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
WifiAwareManager (/reference/android/net/wifi/aware/WifiAwareManager)
Constant Value: "wifiaware"
WIFI_P2P_SERVICE Added in API level 14 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 103/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) WIFI_P2P_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
WifiP2pManager (/reference/android/net/wifi/p2p/WifiP2pManager) for handling management
of Wi-Fi peer-to-peer connections.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
WifiP2pManager (/reference/android/net/wifi/p2p/WifiP2pManager)
Constant Value: "wifip2p"
WIFI_RTT_RANGING_SERVICE
Added in API level 28 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) WIFI_RTT_RANGING_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
WifiRttManager (/reference/android/net/wifi/rtt/WifiRttManager) for ranging devices with wifi.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
WifiRttManager (/reference/android/net/wifi/rtt/WifiRttManager)
Constant Value: "wifirtt"
WIFI_SERVICE Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 104/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public static final String (/reference/java/lang/String) WIFI_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
WifiManager (/reference/android/net/wifi/WifiManager) for handling management of Wi-Fi
access.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
WifiManager (/reference/android/net/wifi/WifiManager)
Constant Value: "wifi"
WINDOW_SERVICE Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public static final String (/reference/java/lang/String) WINDOW_SERVICE
Use with getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) to retrieve a
WindowManager (/reference/android/view/WindowManager) for accessing the system's window
manager.
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
WindowManager (/reference/android/view/WindowManager)
Constant Value: "window"
Public constructors
[Link] 105/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Context
public Context ()
Public methods
bindIsolatedServiceAdded in API level 29 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public boolean bindIsolatedService (Intent (/reference/android/content/Intent) service,
int flags,
String (/reference/java/lang/String) instanceName,
Executor (/reference/java/util/concurrent/Executor) executor,
ServiceConnection (/reference/android/content/ServiceConnection) conn)
Variation of bindService(Intent, BindServiceFlags, Executor,
ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
that, in the specific case of isolated services, allows the caller to generate multiple
instances of a service from a single component declaration. In other words, you can use
this to bind to a service that has specified [Link]
(/reference/android/[Link]#isolatedProcess) and, in addition to the existing behavior of running
in an isolated process, you can also through the arguments here have the system bring up
multiple concurrent processes hosting their own instances of that service. The
instanceName you provide here identifies the different instances, and you can use
updateServiceGroup([Link], int, int)
(/reference/android/content/Context#updateServiceGroup([Link],%20int
,%20int))
to tell the system how it should manage each of these instances.
Parameters
[Link] 106/302
2/15/26, 8:49 PM Context | API reference | Android Developers
service Intent : Identifies the service to connect to. The Intent must specify
This value cannot be null .
flags int : Operation options for the binding as per bindService(Inten
(/reference/android/content/Context#bindService([Link]
.
instanceName String : Unique identifier for the service instance. Each unique name
and periods.
This value cannot be null .
executor Executor : Callbacks on ServiceConnection will be called on executo
This value cannot be null .
Callback and listener events are dispatched through this Executor (/
the main thread of your application, you can use [Link]
(/reference/java/util/concurrent/Executor) that dispatches to an appr
conn ServiceConnection : Receives information as the service is started
Returns
boolean Returns success of binding as per bindService(Intent, BindSe
(/reference/android/content/Context#bindService([Link]
.
Throws
IllegalArgumentException If the instanceName is invalid.
(/reference/java/lang/IllegalArgumentException)
SecurityException If the caller does not have permission to access the
(/reference/java/lang/SecurityException) service
[Link] 107/302
2/15/26, 8:49 PM Context | API reference | Android Developers
See also:
bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
updateServiceGroup(ServiceConnection, int, int)
(/reference/android/content/Context#updateServiceGroup([Link],%20int
,%20int))
[Link] (/reference/android/[Link]#isolatedProcess)
bindIsolatedServiceAdded in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public boolean bindIsolatedService (Intent (/reference/android/content/Intent) service,
[Link] (/reference/android/content/[Link]
String (/reference/java/lang/String) instanceName,
Executor (/reference/java/util/concurrent/Executor) executor,
ServiceConnection (/reference/android/content/ServiceConnection) conn)
See bindIsolatedService([Link], int, [Link],
[Link], [Link])
(/reference/android/content/Context#bindIsolatedService([Link],%20int,%[Link]
.String,%[Link],%[Link]))
Call [Link](long)
(/reference/android/content/[Link]#of(long)) to obtain a BindServiceFlags
object.
Parameters
service Intent : This value cannot be null .
flags [Link] : This value cannot be null .
[Link] 108/302
2/15/26, 8:49 PM Context | API reference | Android Developers
instanceName String : This value cannot be null .
executor Executor : This value cannot be null .
Callback and listener events are dispatched through this Executor
(/reference/java/util/concurrent/Executor), providing an easy way to
control which thread is used. To dispatch events through the main
thread of your application, you can use
[Link]()
(/reference/android/content/Context#getMainExecutor()).
Otherwise, provide an Executor
(/reference/java/util/concurrent/Executor) that dispatches to an
appropriate thread.
conn ServiceConnection : This value cannot be null .
Returns
boolean
bindService Added in API level 29 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public boolean bindService (Intent (/reference/android/content/Intent) service,
int flags,
Executor (/reference/java/util/concurrent/Executor) executor,
ServiceConnection (/reference/android/content/ServiceConnection) conn)
Same as bindService(Intent, ServiceConnection, int)
(/reference/android/content/Context#bindService([Link],%[Link]
Connection,%20int))
with executor to control ServiceConnection callbacks.
This method only accepts a 32 bits flag, to pass in a 64 bits flag, call
bindService([Link],
[Link] 109/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link], [Link],
[Link])
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
instead.
Parameters
service Intent : This value cannot be null .
flags int : Value is either 0 or a combination of the following:
BIND_AUTO_CREATE
(/reference/android/content/Context#BIND_AUTO_CREATE)
BIND_DEBUG_UNBIND
(/reference/android/content/Context#BIND_DEBUG_UNBIND)
BIND_NOT_FOREGROUND
(/reference/android/content/Context#BIND_NOT_FOREGROUND)
BIND_ABOVE_CLIENT
(/reference/android/content/Context#BIND_ABOVE_CLIENT)
BIND_ALLOW_OOM_MANAGEMENT
(/reference/android/content/Context#BIND_ALLOW_OOM_MANAG
BIND_WAIVE_PRIORITY
(/reference/android/content/Context#BIND_WAIVE_PRIORITY)
BIND_IMPORTANT (/reference/android/content/Context#BIND_IMP
BIND_ADJUST_WITH_ACTIVITY
(/reference/android/content/Context#BIND_ADJUST_WITH_ACTIVI
BIND_NOT_PERCEPTIBLE
(/reference/android/content/Context#BIND_NOT_PERCEPTIBLE)
BIND_ALLOW_ACTIVITY_STARTS
(/reference/android/content/Context#BIND_ALLOW_ACTIVITY_STA
BIND_INCLUDE_CAPABILITIES
(/reference/android/content/Context#BIND_INCLUDE_CAPABILITIE
BIND_SHARED_ISOLATED_PROCESS
(/reference/android/content/Context#BIND_SHARED_ISOLATED_P
BIND_PACKAGE_ISOLATED_PROCESS
(/reference/android/content/Context#BIND_PACKAGE_ISOLATED_
[Link] 110/302
2/15/26, 8:49 PM Context | API reference | Android Developers
BIND_EXTERNAL_SERVICE
(/reference/android/content/Context#BIND_EXTERNAL_SERVICE)
executor Executor : Callbacks on ServiceConnection will be called on executo
use same instance for the same instance of ServiceConnection.
This value cannot be null .
Callback and listener events are dispatched through this Executor
(/reference/java/util/concurrent/Executor), providing an easy way to c
which thread is used. To dispatch events through the main thread of y
application, you can use [Link]()
(/reference/android/content/Context#getMainExecutor()). Otherwise
an Executor (/reference/java/util/concurrent/Executor) that dispatch
appropriate thread.
conn ServiceConnection : This value cannot be null .
Returns
boolean The result of the binding as described in bindService(Intent, Se
(/reference/android/content/Context#bindService([Link]
.
bindService Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public boolean bindService (Intent (/reference/android/content/Intent) service,
ServiceConnection (/reference/android/content/ServiceConnection) conn,
[Link] (/reference/android/content/[Link]
See bindService([Link], [Link],
int)
(/reference/android/content/Context#bindService([Link],%[Link]
Connection,%20int))
Call [Link](long)
[Link] 111/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/content/[Link]#of(long)) to obtain a BindServiceFlags
object.
Parameters
service Intent : This value cannot be null .
conn ServiceConnection : This value cannot be null .
flags [Link] : This value cannot be null .
Returns
boolean
bindService Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract boolean bindService (Intent (/reference/android/content/Intent) service
ServiceConnection (/reference/android/content/ServiceConnection) conn,
int flags)
Connects to an application service, creating it if needed. This defines a dependency
between your application and the service. The given conn will receive the service object
when it is created and be told if it dies and restarts. The service will be considered
required by the system only for as long as the calling context exists. For example, if this
Context is an Activity that is stopped, the service will not be required to continue running
until the Activity is resumed.
If the service does not support binding, it may return null from its onBind()
(/reference/android/app/Service#onBind([Link])) method. If it does, then the
[Link] 112/302
2/15/26, 8:49 PM Context | API reference | Android Developers
ServiceConnection's onNullBinding()
(/reference/android/content/ServiceConnection#onNullBinding([Link]))
method will be invoked instead of onServiceConnected()
(/reference/android/content/ServiceConnection#onServiceConnected([Link]
me,%[Link]))
.
Note: This method cannot be called from a BroadcastReceiver
(/reference/android/content/BroadcastReceiver) component. A pattern you can use to communicate
from a BroadcastReceiver to a Service is to call startService(Intent)
(/reference/android/content/Context#startService([Link])) with the arguments
containing the command to be sent, with the service calling its [Link](int)
(/reference/android/app/Service#stopSelf(int)) method when done executing that command. See the
API demo App/Service/Service Start Arguments Controller for an illustration of this. It is okay, however,
to use this method from a BroadcastReceiver that has been registered with
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
, since the lifetime of this BroadcastReceiver is tied to another object (the one that registered it).
This method only accepts a int type flag, to pass in a long type flag, call
bindService([Link], [Link],
[Link])
(/reference/android/content/Context#bindService([Link],%[Link]
Connection,%[Link]))
instead.
Parameters
service Intent : Identifies the service to connect to. The Intent must specify
explicit component name.
This value cannot be null .
conn ServiceConnection : Receives information as the service is started
stopped. This must be a valid ServiceConnection object; it must not b
[Link] 113/302
2/15/26, 8:49 PM Context | API reference | Android Developers
flags int : Operation options for the binding. Can be:
0
BIND_AUTO_CREATE
(/reference/android/content/Context#BIND_AUTO_CREATE)
BIND_DEBUG_UNBIND
(/reference/android/content/Context#BIND_DEBUG_UNBIND)
BIND_NOT_FOREGROUND
(/reference/android/content/Context#BIND_NOT_FOREGROUND)
BIND_ABOVE_CLIENT
(/reference/android/content/Context#BIND_ABOVE_CLIENT)
BIND_ALLOW_OOM_MANAGEMENT
(/reference/android/content/Context#BIND_ALLOW_OOM_MANAG
BIND_WAIVE_PRIORITY
(/reference/android/content/Context#BIND_WAIVE_PRIORITY)
BIND_IMPORTANT
(/reference/android/content/Context#BIND_IMPORTANT)
BIND_ADJUST_WITH_ACTIVITY
(/reference/android/content/Context#BIND_ADJUST_WITH_ACTIVI
BIND_NOT_PERCEPTIBLE
(/reference/android/content/Context#BIND_NOT_PERCEPTIBLE)
BIND_INCLUDE_CAPABILITIES
(/reference/android/content/Context#BIND_INCLUDE_CAPABILITIE
Returns
boolean true if the system is in the process of bringing up a service that your
permission to bind to; false if the system couldn't find the service o
doesn't have permission to bind to it. Regardless of the return value, y
unbindService(ServiceConnection)
(/reference/android/content/Context#unbindService([Link]
to release the connection.
[Link] 114/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Throws
SecurityException If the caller does not have permission to access the service or
(/reference/java/lang/SecurityException) found. Call unbindService(ServiceConnection)
(/reference/android/content/Context#unbindService(android.c
to release the connection when this exception is thrown.
See also:
unbindService(ServiceConnection)
(/reference/android/content/Context#unbindService([Link]))
startService(Intent) (/reference/android/content/Context#startService([Link]))
bindService Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public boolean bindService (Intent (/reference/android/content/Intent) service,
[Link] (/reference/android/content/[Link]
Executor (/reference/java/util/concurrent/Executor) executor,
ServiceConnection (/reference/android/content/ServiceConnection) conn)
See bindService([Link], int, [Link],
[Link])
(/reference/android/content/Context#bindService([Link],%20int,%[Link]
[Link],%[Link]))
Call [Link](long)
(/reference/android/content/[Link]#of(long)) to obtain a BindServiceFlags
object.
Parameters
service Intent : This value cannot be null .
[Link] 115/302
2/15/26, 8:49 PM Context | API reference | Android Developers
flags [Link] : This value cannot be null .
executor Executor : This value cannot be null .
Callback and listener events are dispatched through this Executor
(/reference/java/util/concurrent/Executor), providing an easy way to
control which thread is used. To dispatch events through the main
thread of your application, you can use
[Link]()
(/reference/android/content/Context#getMainExecutor()).
Otherwise, provide an Executor
(/reference/java/util/concurrent/Executor) that dispatches to an
appropriate thread.
conn ServiceConnection : This value cannot be null .
Returns
boolean
bindServiceAsUser Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public boolean bindServiceAsUser (Intent (/reference/android/content/Intent) service,
ServiceConnection (/reference/android/content/ServiceConnection) conn,
int flags,
UserHandle (/reference/android/os/UserHandle) user)
Binds to a service in the given user in the same manner as bindService(Intent,
BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
.
Requires that one of the following conditions are met:
[Link] 116/302
2/15/26, 8:49 PM Context | API reference | Android Developers
caller has [Link].INTERACT_ACROSS_USERS_FULL
caller has [Link].INTERACT_ACROSS_USERS and is the
same package as the service (determined by its component's package) and the
Android version is at least Build.VERSION_CODES.TIRAMISU
(/reference/android/os/Build.VERSION_CODES#TIRAMISU)
caller has [Link].INTERACT_ACROSS_USERS and is in same
profile group as the given user
caller has [Link].INTERACT_ACROSS_PROFILES and is in
same profile group as the given user and is the same package as the service
Parameters
service Intent : Identifies the service to connect to. The Intent must specify
explicit component name.
This value cannot be null .
conn ServiceConnection : Receives information as the service is started
stopped. This must be a valid ServiceConnection object; it must not b
null.
flags int : Operation options for the binding. May be 0, BIND_AUTO_CREA
(/reference/android/content/Context#BIND_AUTO_CREATE),
BIND_DEBUG_UNBIND
(/reference/android/content/Context#BIND_DEBUG_UNBIND),
BIND_NOT_FOREGROUND
(/reference/android/content/Context#BIND_NOT_FOREGROUND),
BIND_ABOVE_CLIENT
(/reference/android/content/Context#BIND_ABOVE_CLIENT),
BIND_ALLOW_OOM_MANAGEMENT
(/reference/android/content/Context#BIND_ALLOW_OOM_MANAGEM
, BIND_WAIVE_PRIORITY
(/reference/android/content/Context#BIND_WAIVE_PRIORITY).
BIND_IMPORTANT
(/reference/android/content/Context#BIND_IMPORTANT), or
BIND_ADJUST_WITH_ACTIVITY
(/reference/android/content/Context#BIND_ADJUST_WITH_ACTIVITY)
[Link] 117/302
2/15/26, 8:49 PM Context | API reference | Android Developers
user UserHandle : This value cannot be null .
Returns
boolean true if the system is in the process of bringing up a service that your
permission to bind to; false if the system couldn't find the service. Y
unbindService(ServiceConnection)
(/reference/android/content/Context#unbindService([Link]
to release the connection even if this method returned false .
Throws
SecurityException if the client does not have the required permission to bind.
(/reference/java/lang/SecurityException)
bindServiceAsUser Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public boolean bindServiceAsUser (Intent (/reference/android/content/Intent) service,
ServiceConnection (/reference/android/content/ServiceConnection) conn,
[Link] (/reference/android/content/[Link]
UserHandle (/reference/android/os/UserHandle) user)
See bindServiceAsUser([Link],
[Link], int, [Link])
(/reference/android/content/Context#bindServiceAsUser([Link],%[Link].
ServiceConnection,%20int,%[Link]))
Call [Link](long)
(/reference/android/content/[Link]#of(long)) to obtain a BindServiceFlags
object.
[Link] 118/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Parameters
service Intent : This value cannot be null .
conn ServiceConnection : This value cannot be null .
flags [Link] : This value cannot be null .
user UserHandle : This value cannot be null .
Returns
boolean
checkCallingOrSelfPermission
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract int checkCallingOrSelfPermission (String (/reference/java/lang/String)
Determine whether the calling process of an IPC or you have been granted a particular
permission. This is the same as checkCallingPermission(String)
(/reference/android/content/Context#checkCallingPermission([Link])) , except it grants
your own permissions if you are not currently processing an IPC. Use with care!
Parameters
permission String : The name of the permission being checked.
This value cannot be null .
[Link] 119/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Returns
int PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
the calling pid/uid is allowed that permission, or
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
is not.
Value is one of the following:
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
See also:
[Link](String, String)
(/reference/android/content/pm/PackageManager#checkPermission([Link],%[Link]
ng))
checkPermission(String, int, int)
(/reference/android/content/Context#checkPermission([Link],%20int,%20int))
checkCallingPermission(String)
(/reference/android/content/Context#checkCallingPermission([Link]))
checkCallingOrSelfUriPermission
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract int checkCallingOrSelfUriPermission (Uri (/reference/android/net/Uri)
int modeFlags)
Determine whether the calling process of an IPC or you has been granted permission to
access a specific URI. This is the same as checkCallingUriPermission(Uri, int)
(/reference/android/content/Context#checkCallingUriPermission([Link],%20int)) , except it
grants your own permissions if you are not currently processing an IPC. Use with care!
[Link] 120/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Parameters
uri Uri : The uri that is being checked.
modeFlags int : The access modes to check.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
Returns
int PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
the caller is allowed to access that uri, or
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
is not.
Value is one of the following:
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
See also:
checkCallingUriPermission(Uri, int)
(/reference/android/content/Context#checkCallingUriPermission([Link],%20int))
checkCallingOrSelfUriPermissions
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 121/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public int[] checkCallingOrSelfUriPermissions (List (/reference/java/util/List)<Uri (/ref
int modeFlags)
Determine whether the calling process of an IPC or you has been granted permission to
access a list of URIs. This is the same as checkCallingUriPermission(Uri, int)
(/reference/android/content/Context#checkCallingUriPermission([Link],%20int)) , except it
grants your own permissions if you are not currently processing an IPC. Use with care!
Parameters
uris List : The list of URIs that is being checked.
This value cannot be null .
modeFlags int : The access modes to check.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
Returns
int[] Array of permission grants corresponding to each entry in the list of u
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
the given pid/uid is allowed to access that uri, or
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
is not.
This value cannot be null .
Value is one of the following:
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
[Link] 122/302
2/15/26, 8:49 PM Context | API reference | Android Developers
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
See also:
checkCallingUriPermission(Uri, int)
(/reference/android/content/Context#checkCallingUriPermission([Link],%20int))
checkCallingPermission
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract int checkCallingPermission (String (/reference/java/lang/String) permi
Determine whether the calling process of an IPC you are handling has been granted a
particular permission. This is basically the same as calling
checkPermission([Link], int, int)
(/reference/android/content/Context#checkPermission([Link],%20int,%20int)) with the pid
and uid returned by [Link]() (/reference/android/os/Binder#getCallingPid())
and [Link]() (/reference/android/os/Binder#getCallingUid()) . One important
difference is that if you are not currently processing an IPC, this function will always fail.
This is done to protect against accidentally leaking permissions; you can use
checkCallingOrSelfPermission(String)
(/reference/android/content/Context#checkCallingOrSelfPermission([Link])) to avoid this
protection.
Parameters
permission String : The name of the permission being checked.
This value cannot be null .
Returns
[Link] 123/302
2/15/26, 8:49 PM Context | API reference | Android Developers
int PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
the calling pid/uid is allowed that permission, or
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
is not.
Value is one of the following:
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
See also:
[Link](String, String)
(/reference/android/content/pm/PackageManager#checkPermission([Link],%[Link]
ng))
checkPermission(String, int, int)
(/reference/android/content/Context#checkPermission([Link],%20int,%20int))
checkCallingOrSelfPermission(String)
(/reference/android/content/Context#checkCallingOrSelfPermission([Link]))
checkCallingUriPermission
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract int checkCallingUriPermission (Uri (/reference/android/net/Uri) uri,
int modeFlags)
Determine whether the calling process and uid has been granted permission to access a
specific URI. This is basically the same as calling
checkUriPermission([Link], int, int, int)
(/reference/android/content/Context#checkUriPermission([Link],%20int,%20int,%20int))
with the pid and uid returned by [Link]()
(/reference/android/os/Binder#getCallingPid()) and [Link]()
[Link] 124/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/os/Binder#getCallingUid()) . One important difference is that if you are not
currently processing an IPC, this function will always fail.
Parameters
uri Uri : The uri that is being checked.
modeFlags int : The access modes to check.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
Returns
int PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
the caller is allowed to access that uri, or
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
is not.
Value is one of the following:
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
See also:
checkUriPermission(Uri, int, int, int)
(/reference/android/content/Context#checkUriPermission([Link],%20int,%20int,%20int))
[Link] 125/302
2/15/26, 8:49 PM Context | API reference | Android Developers
checkCallingUriPermissions
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public int[] checkCallingUriPermissions (List (/reference/java/util/List)<Uri (/reference/a
int modeFlags)
Determine whether the calling process and uid has been granted permission to access a
list of URIs. This is basically the same as calling checkUriPermissions([Link],
int, int, int)
(/reference/android/content/Context#checkUriPermissions([Link]<[Link]>,%20int,%20i
nt,%20int))
with the pid and uid returned by [Link]()
(/reference/android/os/Binder#getCallingPid()) and [Link]()
(/reference/android/os/Binder#getCallingUid()) . One important difference is that if you are not
currently processing an IPC, this function will always fail.
Parameters
uris List : The list of URIs that is being checked.
This value cannot be null .
modeFlags int : The access modes to check.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
Returns
int[] Array of permission grants corresponding to each entry in the list of u
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
the given pid/uid is allowed to access that uri, or
[Link] 126/302
2/15/26, 8:49 PM Context | API reference | Android Developers
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
is not.
This value cannot be null .
Value is one of the following:
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
See also:
checkUriPermission(Uri, int, int, int)
(/reference/android/content/Context#checkUriPermission([Link],%20int,%20int,%20int))
checkContentUriPermissionFull
Added in API level 35 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public int checkContentUriPermissionFull (Uri (/reference/android/net/Uri) uri,
int pid,
int uid,
int modeFlags)
Determine whether a particular process and uid has been granted permission to access a
specific content URI.
Unlike checkUriPermission([Link], int, int, int)
(/reference/android/content/Context#checkUriPermission([Link],%20int,%20int,%20int)) ,
this method checks for general access to the URI's content provider, as well as explicitly
granted permissions.
Note, this check will throw an IllegalArgumentException
(/reference/java/lang/IllegalArgumentException) for non-content URIs.
Parameters
[Link] 127/302
2/15/26, 8:49 PM Context | API reference | Android Developers
uri Uri : The content uri that is being checked.
This value cannot be null .
pid int : (Optional) The process ID being checked against. If the pid is un
pass -1.
uid int : The UID being checked against. A uid of 0 is the root user, which
every permission check.
modeFlags int : The access modes to check.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
Returns
int PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
the given pid/uid is allowed to access that uri, or
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
is not.
Value is one of the following:
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
See also:
checkUriPermission(Uri, int, int, int)
(/reference/android/content/Context#checkUriPermission([Link],%20int,%20int,%20int))
[Link] 128/302
2/15/26, 8:49 PM Context | API reference | Android Developers
checkPermission Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract int checkPermission (String (/reference/java/lang/String) permission,
int pid,
int uid)
Determine whether the given permission is allowed for a particular process and user ID
running in the system.
Parameters
permission String : The name of the permission being checked.
This value cannot be null .
pid int : The process ID being checked against. Must be > 0.
uid int : The UID being checked against. A uid of 0 is the root user,
which will pass every permission check.
Returns
[Link] 129/302
2/15/26, 8:49 PM Context | API reference | Android Developers
int PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
the given pid/uid is allowed that permission, or
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
is not.
Value is one of the following:
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
See also:
[Link](String, String)
(/reference/android/content/pm/PackageManager#checkPermission([Link],%[Link]
ng))
checkCallingPermission(String)
(/reference/android/content/Context#checkCallingPermission([Link]))
checkSelfPermissionAdded in API level 23 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract int checkSelfPermission (String (/reference/java/lang/String) permissi
Determine whether you have been granted a particular permission.
Parameters
permission String : The name of the permission being checked.
This value cannot be null .
[Link] 130/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Returns
int PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
you have the permission, or PackageManager.PERMISSION_DENIE
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
not.
Value is one of the following:
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
See also:
[Link](String, String)
(/reference/android/content/pm/PackageManager#checkPermission([Link],%[Link]
ng))
checkCallingPermission(String)
(/reference/android/content/Context#checkCallingPermission([Link]))
checkUriPermission Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract int checkUriPermission (Uri (/reference/android/net/Uri) uri,
String (/reference/java/lang/String) readPermission,
String (/reference/java/lang/String) writePermission,
int pid,
int uid,
int modeFlags)
Check both a Uri and normal permission. This allows you to perform both
checkPermission(String, int, int)
(/reference/android/content/Context#checkPermission([Link],%20int,%20int)) and
checkUriPermission(Uri, int, int, int)
[Link] 131/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/content/Context#checkUriPermission([Link],%20int,%20int,%20int)) in
one call.
Parameters
uri Uri : The Uri whose permission is to be checked, or null to not do this
readPermission String : The permission that provides overall read access, or null to n
this check.
writePermission String : The permission that provides overall write access, or null to
this check.
pid int : The process ID being checked against. Must be > 0.
uid int : The UID being checked against. A uid of 0 is the root user, which
every permission check.
modeFlags int : The access modes to check.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
Returns
int PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
the caller is allowed to access that uri or holds one of the given permi
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
[Link] 132/302
2/15/26, 8:49 PM Context | API reference | Android Developers
is not.
Value is one of the following:
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
checkUriPermission Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract int checkUriPermission (Uri (/reference/android/net/Uri) uri,
int pid,
int uid,
int modeFlags)
Determine whether a particular process and uid has been granted permission to access a
specific URI. This only checks for permissions that have been explicitly granted -- if the
given process/uid has more general access to the URI's content provider then this check
will always fail.
Parameters
uri Uri : The uri that is being checked.
pid int : The process ID being checked against. Must be > 0.
uid int : The UID being checked against. A uid of 0 is the root user, which
every permission check.
modeFlags int : The access modes to check.
Value is either 0 or a combination of the following:
[Link] 133/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
Returns
int PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
the given pid/uid is allowed to access that uri, or
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
is not.
Value is one of the following:
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
See also:
checkCallingUriPermission(Uri, int)
(/reference/android/content/Context#checkCallingUriPermission([Link],%20int))
checkUriPermissionsAdded in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public int[] checkUriPermissions (List (/reference/java/util/List)<Uri (/reference/android/n
int pid,
int uid,
int modeFlags)
Determine whether a particular process and uid has been granted permission to access a
list of URIs. This only checks for permissions that have been explicitly granted -- if the
[Link] 134/302
2/15/26, 8:49 PM Context | API reference | Android Developers
given process/uid has more general access to the URI's content provider then this check
will always fail. Note: On SDK Version Build.VERSION_CODES.S
(/reference/android/os/Build.VERSION_CODES#S) , calling this method from a secondary-user's
context will incorrectly return PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DENIED) for all {code uris}.
Parameters
uris List : The list of URIs that is being checked.
This value cannot be null .
pid int : The process ID being checked against. Must be > 0.
uid int : The UID being checked against. A uid of 0 is the root user, which
every permission check.
modeFlags int : The access modes to check for the list of uris.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
Returns
int[] Array of permission grants corresponding to each entry in the list of u
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_GRA
the given pid/uid is allowed to access that uri, or
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_DEN
is not.
This value cannot be null .
Value is one of the following:
[Link] 135/302
2/15/26, 8:49 PM Context | API reference | Android Developers
PackageManager.PERMISSION_GRANTED
(/reference/android/content/pm/PackageManager#PERMISSION_G
PackageManager.PERMISSION_DENIED
(/reference/android/content/pm/PackageManager#PERMISSION_D
See also:
checkCallingUriPermission(Uri, int)
(/reference/android/content/Context#checkCallingUriPermission([Link],%20int))
clearWallpaper Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 15 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void clearWallpaper ()
This method was deprecated in API level 15.
Use [Link]() (/reference/android/app/WallpaperManager#clear()) instead.
This method requires the caller to hold the permission
[Link].SET_WALLPAPER
(/reference/android/[Link]#SET_WALLPAPER) .
Throws
IOException
(/reference/java/io/IOException)
createAttributionContext
Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 136/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public Context (/reference/android/content/Context) createAttributionContext (String (/r
Return a new Context object for the current Context but attribute to a different tag. In
complex apps attribution tagging can be used to distinguish between separate logical
parts.
Parameters
attributionTag String : The tag or null to create a context for the default.
Returns
Context A Context (/reference/android/content/Context) that is tagged
(/reference/android/content/Context) for the new attribution.
This value cannot be null .
See also:
getAttributionTag() (/reference/android/content/Context#getAttributionTag())
createConfigurationContext
Added in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Context (/reference/android/content/Context) createConfigurationContex
Return a new Context object for the current Context but whose resources are adjusted to
match the given Configuration. Each call to this method returns a new instance of a
Context object; Context objects are not shared, however common state (ClassLoader,
[Link] 137/302
2/15/26, 8:49 PM Context | API reference | Android Developers
other Resources for the same configuration) may be so the Context itself can be fairly
lightweight.
Parameters
overrideConfiguration Configuration : A Configuration
(/reference/android/content/res/Configuration) specifying what
values to modify in the base Configuration of the original Context's
resources. If the base configuration changes (such as due to an
orientation change), the resources of this context will also change
except for those that have been explicitly overridden with a value
here.
This value cannot be null .
Returns
Context A Context (/reference/android/content/Context) with the given
(/reference/android/content/Context) configuration override.
createContext Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public Context (/reference/android/content/Context) createContext (ContextParams (/refere
Creates a context with specific properties and behaviors.
Parameters
contextParams ContextParams : Parameters for how the new context should
behave.
This value cannot be null .
[Link] 138/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Returns
Context A context with the specified behaviors.
(/reference/android/content/Context) This value cannot be null .
See also:
ContextParams (/reference/android/content/ContextParams)
createContextForSplit
Added in API level 26 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Context (/reference/android/content/Context) createContextForSplit (St
Return a new Context object for the given split name. The new Context has a ClassLoader
and Resources object that can access the split's and all of its dependencies'
code/resources. Each call to this method returns a new instance of a Context object;
Context objects are not shared, however common state (ClassLoader, other Resources for
the same split) may be so the Context itself can be fairly lightweight.
Parameters
splitName String : The name of the split to include, as declared in the split's
[Link] .
Returns
Context A Context (/reference/android/content/Context) with the given
(/reference/android/content/Context) split's code and/or resources loaded.
[Link] 139/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Throws
[Link]
(/reference/android/content/pm/[Link])
createDeviceContext
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public Context (/reference/android/content/Context) createDeviceContext (int deviceId)
Returns a new Context object from the current context but with device association given
by the deviceId . Each call to this method returns a new instance of a context object.
Context objects are not shared; however, common state (such as the ClassLoader
(/reference/java/lang/ClassLoader) and other resources for the same configuration) can be
shared, so the Context itself is lightweight.
Applications that run on virtual devices may use this method to access the default device
capabilities and functionality (by passing Context.DEVICE_ID_DEFAULT
(/reference/android/content/Context#DEVICE_ID_DEFAULT) . Similarly, applications running on
the default device may access the functionality of virtual devices.
Note that the newly created instance will be associated with the same display as the
parent Context, regardless of the device ID passed here.
Parameters
deviceId int : The ID of the device to associate with this context.
Returns
[Link] 140/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Context A context associated with the given device ID.
(/reference/android/content/Context) This value cannot be null .
Throws
IllegalArgumentException if the given device ID is not a valid ID of the default
(/reference/java/lang/IllegalArgumentException) device or a virtual device.
See also:
getDeviceId() (/reference/android/content/Context#getDeviceId())
[Link]()
(/reference/android/companion/virtual/VirtualDeviceManager#getVirtualDevices())
createDeviceProtectedStorageContext
Added in API level 24 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Context (/reference/android/content/Context) createDeviceProtectedStor
Return a new Context object for the current Context but whose storage APIs are backed
by device-protected storage.
On devices with direct boot, data stored in this location is encrypted with a key tied to the
physical device, and it can be accessed immediately after the device has booted
successfully, both before and after the user has authenticated with their credentials (such
as a lock pattern or PIN).
Because device-protected data is available without user authentication, you should
carefully limit the data you store using this Context. For example, storing sensitive
authentication tokens or passwords in the device-protected area is strongly discouraged.
If the underlying device does not have the ability to store device-protected and
credential-protected data using different keys, then both storage areas will become
[Link] 141/302
2/15/26, 8:49 PM Context | API reference | Android Developers
available at the same time. They remain as two distinct storage locations on disk, and only
the window of availability changes.
Each call to this method returns a new instance of a Context object; Context objects are
not shared, however common state (ClassLoader, other Resources for the same
configuration) may be so the Context itself can be fairly lightweight.
Returns
Context
(/reference/android/content/Context)
See also:
isDeviceProtectedStorage() (/reference/android/content/Context#isDeviceProtectedStorage())
createDisplayContext
Added in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Context (/reference/android/content/Context) createDisplayContext (Dis
Returns a new Context object from the current context but with resources adjusted to
match the metrics of display . Each call to this method returns a new instance of a
context object. Context objects are not shared; however, common state (such as the
ClassLoader (/reference/java/lang/ClassLoader) and other resources for the same
configuration) can be shared, so the Context itself is lightweight.
Note: This Context is not expected to be updated with new configuration if the
underlying display configuration changes and the cached Resources it returns could be
stale. It is suggested to use [Link]
(/reference/android/hardware/display/[Link]) to listen for changes and
re-create an instance if necessary.
This Context is not a UI context, do not use it to access UI components or obtain a
WindowManager (/reference/android/view/WindowManager) instance.
[Link] 142/302
2/15/26, 8:49 PM Context | API reference | Android Developers
To obtain an instance of WindowManager (/reference/android/view/WindowManager) configured
to show windows on the given display, call createWindowContext(int,
[Link])
(/reference/android/content/Context#createWindowContext(int,%[Link])) on the
returned display context, then call getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link])) or
getSystemService([Link])
(/reference/android/content/Context#getSystemService([Link]<T>)) on the returned
window context.
Parameters
display Display : The display to which the current context's resources are
adjusted.
This value cannot be null .
Returns
Context A context for the display.
(/reference/android/content/Context)
createPackageContext
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Context (/reference/android/content/Context) createPackageContext (Str
int flags)
Return a new Context object for the given application name. This Context is the same as
what the named application gets when it is launched, containing the same resources and
class loader. Each call to this method returns a new instance of a Context object; Context
objects are not shared, however they share common state (Resources, ClassLoader, etc)
so the Context instance itself is fairly lightweight.
[Link] 143/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Throws [Link]
(/reference/android/content/pm/[Link]) if there is no
application with the given package name.
Throws SecurityException (/reference/java/lang/SecurityException) if the Context requested
can not be loaded into the caller's process for security reasons (see
CONTEXT_INCLUDE_CODE (/reference/android/content/Context#CONTEXT_INCLUDE_CODE) for
more information}.
Parameters
packageName String : Name of the application's package.
flags int : Option flags.
Value is either 0 or a combination of the following:
CONTEXT_INCLUDE_CODE
(/reference/android/content/Context#CONTEXT_INCLUDE_CODE)
CONTEXT_IGNORE_SECURITY
(/reference/android/content/Context#CONTEXT_IGNORE_SECURIT
CONTEXT_RESTRICTED
(/reference/android/content/Context#CONTEXT_RESTRICTED)
Returns
Context A Context (/reference/android/content/Context) for the
(/reference/android/content/Context) application.
Throws
[Link] if there is no application w
(/reference/android/content/pm/[Link]) given package name.
[Link] 144/302
2/15/26, 8:49 PM Context | API reference | Android Developers
SecurityException (/reference/java/lang/SecurityException)
createWindowContext
Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public Context (/reference/android/content/Context) createWindowContext (int type,
Bundle (/reference/android/os/Bundle) options)
Creates a Context for a non-activity window.
A window context is a context that can be used to add non-activity windows, such as
[Link].TYPE_APPLICATION_OVERLAY
(/reference/android/view/[Link]#TYPE_APPLICATION_OVERLAY) . A window
context must be created from a context that has an associated Display
Activity (/reference/android/app/Activity) or a
(/reference/android/view/Display) , such as
context created with createDisplayContext([Link])
(/reference/android/content/Context#createDisplayContext([Link])) .
The window context is created with the appropriate Configuration
(/reference/android/content/res/Configuration) for the area of the display that the windows
created with it can occupy; it must be used when inflating
(/reference/android/view/LayoutInflater) views, such that they can be inflated with proper
Resources (/reference/android/content/res/Resources) . Below is a sample code to add an
application overlay window on the primary display:
...
final DisplayManager dm = [Link]([Link]);
final Display primaryDisplay = [Link](DEFAULT_DISPLAY);
final Context windowContext = [Link](primaryDisplay
.createWindowContext(TYPE_APPLICATION_OVERLAY, null);
final View overlayView = [Link](windowContext).inflate(someLayoutXml,
// [Link] initialization
...
// The types used in addView and createWindowContext must match.
[Link] = TYPE_APPLICATION_OVERLAY;
...
[Link] 145/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link]([Link]).addView(overlayView, mPa
This context's configuration and resources are adjusted to an area of the display where
the windows with provided type will be added. Note that all windows associated with
the same context will have an affinity and can only be moved together between
different displays or areas on a display. If there is a need to add different window
types, or non-associated windows, separate Contexts should be used.
Creating a window context is an expensive operation. Misuse of this API may lead to a
huge performance drop. The best practice is to use the same window context when
possible. An approach is to create one window context with specific window type and
display and use it everywhere it's needed.
After Build.VERSION_CODES.S (/reference/android/os/Build.VERSION_CODES#S) , window
context provides the capability to receive configuration changes for existing token by
overriding the token (/reference/android/view/[Link]#token) of the
[Link] (/reference/android/view/[Link]) passed
in [Link](View, LayoutParams)
(/reference/android/view/ViewManager#addView([Link],%[Link]
utParams))
. This is useful when an application needs to attach its window to an existing activity for
window token sharing use-case.
Note that the window context in Build.VERSION_CODES.R
(/reference/android/os/Build.VERSION_CODES#R) didn't have this capability. This is a no-op for
the window context in Build.VERSION_CODES.R
(/reference/android/os/Build.VERSION_CODES#R) .
Below is sample code to attach an existing token to a window context:
final DisplayManager dm = [Link]([Link]);
final Display primaryDisplay = [Link](DEFAULT_DISPLAY);
final Context windowContext = [Link](primaryDisplay,
TYPE_APPLICATION, null);
// Get an existing token.
final IBinder existingToken = [Link]().getAttributes().token;
// The types used in addView() and createWindowContext() must match.
[Link] 146/302
2/15/26, 8:49 PM Context | API reference | Android Developers
final [Link] params = new [Link](TYPE
[Link] = existingToken;
// After WindowManager#addView(), the server side will extract the provided t
// LayoutParams#token (existingToken in the sample code), and switch to propa
// configuration changes from the node associated with the provided token.
[Link]([Link]).addView(overlayView, mPa
After Build.VERSION_CODES.S (/reference/android/os/Build.VERSION_CODES#S) , window
context provides the capability to listen to its Configuration
(/reference/android/content/res/Configuration) changes by calling
registerComponentCallbacks([Link])
(/reference/android/content/Context#registerComponentCallbacks([Link]
cks))
, while other kinds of Context (/reference/android/content/Context) will register the
ComponentCallbacks (/reference/android/content/ComponentCallbacks) to its Application
context (/reference/android/content/Context#getApplicationContext()) . Note that window
context only propagate
[Link](Configuration)
(/reference/android/content/ComponentCallbacks#onConfigurationChanged([Link]
iguration))
callback. [Link]()
(/reference/android/content/ComponentCallbacks#onLowMemory()) or other callbacks in
ComponentCallbacks2 (/reference/android/content/ComponentCallbacks2) won't be invoked.
Note that using Application (/reference/android/app/Application) or Service
(/reference/android/app/Service) context for UI-related queries may result in layout or
continuity issues on devices with variable screen sizes (e.g. foldables) or in multi-window
modes, since these non-UI contexts may not reflect the Configuration
(/reference/android/content/res/Configuration) changes for the visual container.
Parameters
type int : Window type in [Link]
(/reference/android/view/[Link])
Value is one of the following:
[Link].TYPE_BASE_APPLICATION
(/reference/android/view/[Link]#TYPE_B
[Link] 147/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link].TYPE_APPLICATION
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_APPLICATION_STARTI
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_DRAWN_APPLICATION
(/reference/android/view/[Link]#TYPE_D
[Link].TYPE_APPLICATION_PANEL
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_APPLICATION_MEDIA
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_APPLICATION_SUB_PA
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_APPLICATION_ATTACH
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_STATUS_BAR
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_SEARCH_BAR
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_PHONE
(/reference/android/view/[Link]#TYPE_P
[Link].TYPE_SYSTEM_ALERT
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_TOAST
(/reference/android/view/[Link]#TYPE_T
[Link].TYPE_SYSTEM_OVERLAY
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_PRIORITY_PHONE
(/reference/android/view/[Link]#TYPE_P
[Link].TYPE_SYSTEM_DIALOG
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_KEYGUARD_DIALOG
(/reference/android/view/[Link]#TYPE_K
[Link].TYPE_SYSTEM_ERROR
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_INPUT_METHOD
(/reference/android/view/[Link]#TYPE_IN
[Link].TYPE_INPUT_METHOD_DIALO
(/reference/android/view/[Link]#TYPE_IN
[Link] 148/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link].TYPE_WALLPAPER
(/reference/android/view/[Link]#TYPE_W
[Link].TYPE_PRIVATE_PRESENTATI
(/reference/android/view/[Link]#TYPE_P
[Link].TYPE_ACCESSIBILITY_OVER
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_APPLICATION_OVERLA
(/reference/android/view/[Link]#TYPE_A
options Bundle : A bundle used to pass window-related options.
This value may be null .
Returns
Context A Context (/reference/android/content/Context) that can be
(/reference/android/content/Context) used to create non- activity (/reference/android/app/Activity)
windows.
Throws
UnsupportedOperationException if this Context
(/reference/java/lang/UnsupportedOperationException) (/reference/android/content/Context) does
not attach to a display, such as Application
(/reference/android/app/Application) or
Service (/reference/android/app/Service).
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
getSystemService(Class)
(/reference/android/content/Context#getSystemService([Link]<T>))
WINDOW_SERVICE (/reference/android/content/Context#WINDOW_SERVICE)
[Link] 149/302
2/15/26, 8:49 PM Context | API reference | Android Developers
LAYOUT_INFLATER_SERVICE (/reference/android/content/Context#LAYOUT_INFLATER_SERVICE)
WALLPAPER_SERVICE (/reference/android/content/Context#WALLPAPER_SERVICE)
createWindowContext
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public Context (/reference/android/content/Context) createWindowContext (Display (/refere
int type,
Bundle (/reference/android/os/Bundle) options)
Creates a Context for a non- activity (/reference/android/app/Activity) window on the given
Display (/reference/android/view/Display) .
Similar to createWindowContext(int, [Link])
(/reference/android/content/Context#createWindowContext(int,%[Link])) , but the
display is passed in, instead of implicitly using the original Context's Display
(/reference/android/content/Context#getDisplay()) .
Parameters
display Display : The Display (/reference/android/view/Display) to associa
This value cannot be null .
type int : Window type in [Link]
(/reference/android/view/[Link])
Value is one of the following:
[Link].TYPE_BASE_APPLICATION
(/reference/android/view/[Link]#TYPE_B
[Link].TYPE_APPLICATION
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_APPLICATION_STARTI
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_DRAWN_APPLICATION
(/reference/android/view/[Link]#TYPE_D
[Link] 150/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link].TYPE_APPLICATION_PANEL
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_APPLICATION_MEDIA
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_APPLICATION_SUB_PA
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_APPLICATION_ATTACH
(/reference/android/view/[Link]#TYPE_A
[Link].TYPE_STATUS_BAR
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_SEARCH_BAR
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_PHONE
(/reference/android/view/[Link]#TYPE_P
[Link].TYPE_SYSTEM_ALERT
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_TOAST
(/reference/android/view/[Link]#TYPE_T
[Link].TYPE_SYSTEM_OVERLAY
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_PRIORITY_PHONE
(/reference/android/view/[Link]#TYPE_P
[Link].TYPE_SYSTEM_DIALOG
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_KEYGUARD_DIALOG
(/reference/android/view/[Link]#TYPE_K
[Link].TYPE_SYSTEM_ERROR
(/reference/android/view/[Link]#TYPE_S
[Link].TYPE_INPUT_METHOD
(/reference/android/view/[Link]#TYPE_IN
[Link].TYPE_INPUT_METHOD_DIALO
(/reference/android/view/[Link]#TYPE_IN
[Link].TYPE_WALLPAPER
(/reference/android/view/[Link]#TYPE_W
[Link].TYPE_PRIVATE_PRESENTATI
(/reference/android/view/[Link]#TYPE_P
[Link].TYPE_ACCESSIBILITY_OVER
(/reference/android/view/[Link]#TYPE_A
[Link] 151/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link].TYPE_APPLICATION_OVERLA
(/reference/android/view/[Link]#TYPE_A
options Bundle : A bundle used to pass window-related options.
This value may be null .
Returns
Context A Context (/reference/android/content/Context) that can be
(/reference/android/content/Context) used to create non- activity (/reference/android/app/Activity)
windows.
This value cannot be null .
Throws
IllegalArgumentException if the Display (/reference/android/view/Display) is
(/reference/java/lang/IllegalArgumentException) null .
See also:
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
getSystemService(Class)
(/reference/android/content/Context#getSystemService([Link]<T>))
WINDOW_SERVICE (/reference/android/content/Context#WINDOW_SERVICE)
LAYOUT_INFLATER_SERVICE (/reference/android/content/Context#LAYOUT_INFLATER_SERVICE)
WALLPAPER_SERVICE (/reference/android/content/Context#WALLPAPER_SERVICE)
databaseList Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 152/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public abstract String[] (/reference/java/lang/String) databaseList ()
Returns an array of strings naming the private databases associated with this Context's
application package.
Returns
String[] Array of strings naming the private databases.
(/reference/java/lang/String)
See also:
openOrCreateDatabase(String, int, CursorFactory)
(/reference/android/content/Context#openOrCreateDatabase([Link],%20int,%[Link]
[Link]))
deleteDatabase(String) (/reference/android/content/Context#deleteDatabase([Link]))
deleteDatabase Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract boolean deleteDatabase (String (/reference/java/lang/String) name)
Delete an existing private SQLiteDatabase associated with this Context's application
package.
Parameters
name String : The name (unique in the application package) of the
database.
[Link] 153/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Returns
boolean true if the database was successfully deleted; else false .
See also:
openOrCreateDatabase(String, int, CursorFactory)
(/reference/android/content/Context#openOrCreateDatabase([Link],%20int,%[Link]
[Link]))
deleteFile Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract boolean deleteFile (String (/reference/java/lang/String) name)
Delete the given private file associated with this Context's application package.
Parameters
name String : The name of the file to delete; can not contain path
separators.
Returns
boolean true if the file was successfully deleted; else false .
See also:
openFileInput(String) (/reference/android/content/Context#openFileInput([Link]))
[Link] 154/302
2/15/26, 8:49 PM Context | API reference | Android Developers
openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int))
fileList() (/reference/android/content/Context#fileList())
[Link]() (/reference/java/io/File#delete())
deleteSharedPreferences
Added in API level 24 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract boolean deleteSharedPreferences (String (/reference/java/lang/String)
Delete an existing shared preferences file.
Parameters
name String : The name (unique in the application package) of the
shared preferences file.
Returns
boolean true if the shared preferences file was successfully deleted; else
false .
See also:
getSharedPreferences(String, int)
(/reference/android/content/Context#getSharedPreferences([Link],%20int))
enforceCallingOrSelfPermission
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 155/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public abstract void enforceCallingOrSelfPermission (String (/reference/java/lang/Str
String (/reference/java/lang/String) message)
If neither you nor the calling process of an IPC you are handling has been granted a
particular permission, throw a SecurityException (/reference/java/lang/SecurityException) .
This is the same as enforceCallingPermission(String, String)
(/reference/android/content/Context#enforceCallingPermission([Link],%[Link])) ,
except it grants your own permissions if you are not currently processing an IPC. Use with
care!
Parameters
permission String : The name of the permission being checked.
This value cannot be null .
message String : A message to include in the exception if it is thrown.
This value may be null .
See also:
checkCallingOrSelfPermission(String)
(/reference/android/content/Context#checkCallingOrSelfPermission([Link]))
enforceCallingOrSelfUriPermission
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void enforceCallingOrSelfUriPermission (Uri (/reference/android/net/
int modeFlags,
String (/reference/java/lang/String) message)
If the calling process of an IPC or you has not been granted permission to access a
specific URI, throw SecurityException (/reference/java/lang/SecurityException) . This is the
[Link] 156/302
2/15/26, 8:49 PM Context | API reference | Android Developers
same as enforceCallingUriPermission(Uri, int, String)
(/reference/android/content/Context#enforceCallingUriPermission([Link],%20int,%[Link]
[Link]))
, except it grants your own permissions if you are not currently processing an IPC. Use
with care!
Parameters
uri Uri : The uri that is being checked.
modeFlags int : The access modes to enforce.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
message String : A message to include in the exception if it is thrown.
See also:
checkCallingOrSelfUriPermission(Uri, int)
(/reference/android/content/Context#checkCallingOrSelfUriPermission([Link],%20int))
enforceCallingPermission
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void enforceCallingPermission (String (/reference/java/lang/String) pe
String (/reference/java/lang/String) message)
If the calling process of an IPC you are handling has not been granted a particular
permission, throw a SecurityException (/reference/java/lang/SecurityException) . This is
[Link] 157/302
2/15/26, 8:49 PM Context | API reference | Android Developers
basically the same as calling enforcePermission([Link], int, int,
[Link])
(/reference/android/content/Context#enforcePermission([Link],%20int,%20int,%[Link].
String))
with the pid and uid returned by [Link]()
(/reference/android/os/Binder#getCallingPid()) and [Link]()
(/reference/android/os/Binder#getCallingUid()) . One important difference is that if you are not
currently processing an IPC, this function will always throw the SecurityException. This is
done to protect against accidentally leaking permissions; you can use
enforceCallingOrSelfPermission(String, String)
(/reference/android/content/Context#enforceCallingOrSelfPermission([Link],%[Link]
ring))
to avoid this protection.
Parameters
permission String : The name of the permission being checked.
This value cannot be null .
message String : A message to include in the exception if it is thrown.
This value may be null .
See also:
checkCallingPermission(String)
(/reference/android/content/Context#checkCallingPermission([Link]))
enforceCallingUriPermission
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void enforceCallingUriPermission (Uri (/reference/android/net/Uri) ur
int modeFlags,
String (/reference/java/lang/String) message)
[Link] 158/302
2/15/26, 8:49 PM Context | API reference | Android Developers
If the calling process and uid has not been granted permission to access a specific URI,
throw SecurityException (/reference/java/lang/SecurityException) . This is basically the same
as calling enforceUriPermission([Link], int, int, int,
[Link])
(/reference/android/content/Context#enforceUriPermission([Link],%20int,%20int,%20int,%2
[Link]))
with the pid and uid returned by [Link]()
(/reference/android/os/Binder#getCallingPid()) and [Link]()
(/reference/android/os/Binder#getCallingUid()) . One important difference is that if you are not
currently processing an IPC, this function will always throw a SecurityException.
Parameters
uri Uri : The uri that is being checked.
modeFlags int : The access modes to enforce.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
message String : A message to include in the exception if it is thrown.
See also:
checkCallingUriPermission(Uri, int)
(/reference/android/content/Context#checkCallingUriPermission([Link],%20int))
enforcePermission Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void enforcePermission (String (/reference/java/lang/String) permissio
int pid,
[Link] 159/302
2/15/26, 8:49 PM Context | API reference | Android Developers
int uid,
String (/reference/java/lang/String) message)
If the given permission is not allowed for a particular process and user ID running in the
system, throw a SecurityException (/reference/java/lang/SecurityException) .
Parameters
permission String : The name of the permission being checked.
This value cannot be null .
pid int : The process ID being checked against. Must be > 0.
uid int : The UID being checked against. A uid of 0 is the root user,
which will pass every permission check.
message String : A message to include in the exception if it is thrown.
This value may be null .
See also:
checkPermission(String, int, int)
(/reference/android/content/Context#checkPermission([Link],%20int,%20int))
enforceUriPermissionAdded in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void enforceUriPermission (Uri (/reference/android/net/Uri) uri,
String (/reference/java/lang/String) readPermission,
String (/reference/java/lang/String) writePermission,
int pid,
int uid,
[Link] 160/302
2/15/26, 8:49 PM Context | API reference | Android Developers
int modeFlags,
String (/reference/java/lang/String) message)
Enforce both a Uri and normal permission. This allows you to perform both
enforcePermission(String, int, int, String)
(/reference/android/content/Context#enforcePermission([Link],%20int,%20int,%[Link].
String))
and enforceUriPermission(Uri, int, int, int, String)
(/reference/android/content/Context#enforceUriPermission([Link],%20int,%20int,%20int,%2
[Link]))
in one call.
Parameters
uri Uri : The Uri whose permission is to be checked, or null to not do this
readPermission String : The permission that provides overall read access, or null to n
this check.
writePermission String : The permission that provides overall write access, or null to
this check.
pid int : The process ID being checked against. Must be > 0.
uid int : The UID being checked against. A uid of 0 is the root user, which
every permission check.
modeFlags int : The access modes to enforce.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
[Link] 161/302
2/15/26, 8:49 PM Context | API reference | Android Developers
message String : A message to include in the exception if it is thrown.
This value may be null .
See also:
checkUriPermission(Uri, String, String, int, int, int)
(/reference/android/content/Context#checkUriPermission([Link],%[Link],%20jav
[Link],%20int,%20int,%20int))
enforceUriPermissionAdded in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void enforceUriPermission (Uri (/reference/android/net/Uri) uri,
int pid,
int uid,
int modeFlags,
String (/reference/java/lang/String) message)
If a particular process and uid has not been granted permission to access a specific URI,
throw SecurityException (/reference/java/lang/SecurityException) . This only checks for
permissions that have been explicitly granted -- if the given process/uid has more general
access to the URI's content provider then this check will always fail.
Parameters
uri Uri : The uri that is being checked.
pid int : The process ID being checked against. Must be > 0.
uid int : The UID being checked against. A uid of 0 is the root user, which
every permission check.
[Link] 162/302
2/15/26, 8:49 PM Context | API reference | Android Developers
modeFlags int : The access modes to enforce.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
message String : A message to include in the exception if it is thrown.
See also:
checkUriPermission(Uri, int, int, int)
(/reference/android/content/Context#checkUriPermission([Link],%20int,%20int,%20int))
fileList Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract String[] (/reference/java/lang/String) fileList ()
Returns an array of strings naming the private files associated with this Context's
application package.
Returns
String[] Array of strings naming the private files.
(/reference/java/lang/String)
See also:
openFileInput(String) (/reference/android/content/Context#openFileInput([Link]))
openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int))
[Link] 163/302
2/15/26, 8:49 PM Context | API reference | Android Developers
deleteFile(String) (/reference/android/content/Context#deleteFile([Link]))
getApplicationContext
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Context (/reference/android/content/Context) getApplicationContext ()
Return the context of the single, global Application object of the current process. This
generally should only be used if you need a Context whose lifecycle is separate from the
current context, that is tied to the lifetime of the process rather than the current
component.
Consider for example how this interacts with
registerReceiver([Link],
[Link])
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
:
If used from an Activity context, the receiver is being registered within that activity.
This means that you are expected to unregister before the activity is done being
destroyed; in fact if you do not do so, the framework will clean up your leaked
registration as it removes the activity and log an error. Thus, if you use the Activity
context to register a receiver that is static (global to the process, not associated
with an Activity instance) then that registration will be removed on you at whatever
point the activity you used is destroyed.
If used from the Context returned here, the receiver is being registered with the
global state associated with your application. Thus it will never be unregistered for
you. This is necessary if the receiver is associated with static data, not a particular
component. However using the ApplicationContext elsewhere can easily lead to
serious leaks if you forget to unregister, unbind, etc.
Returns
Context
(/reference/android/content/Context)
[Link] 164/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getApplicationInfo Added in API level 4 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract ApplicationInfo (/reference/android/content/pm/ApplicationInfo) getApplic
Return the full application info for this context's package.
Returns
ApplicationInfo
(/reference/android/content/pm/ApplicationInfo)
getAssets Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract AssetManager (/reference/android/content/res/AssetManager) getAssets ()
Returns an AssetManager instance for the application's package.
Note: Implementations of this method should return an AssetManager instance that is
consistent with the Resources instance returned by getResources()
(/reference/android/content/Context#getResources()) . For example, they should share the same
Configuration (/reference/android/content/res/Configuration) object.
Returns
AssetManager an AssetManager instance for the application's
(/reference/android/content/res/AssetManager) package
See also:
getResources() (/reference/android/content/Context#getResources())
[Link] 165/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getAttributionSource
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public AttributionSource (/reference/android/content/AttributionSource) getAttributionSou
Returns
AttributionSource The identity of this context for permission purposes.
(/reference/android/content/AttributionSource) This value cannot be null .
See also:
AttributionSource (/reference/android/content/AttributionSource)
getAttributionTag Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public String (/reference/java/lang/String) getAttributionTag ()
Attribution can be used in complex apps to logically separate parts of the app. E.g. a
blogging app might also have a instant messaging app built in. In this case two separate
tags can for used each sub-feature.
Returns
String the attribution tag this context is for or null if this is the default.
(/reference/java/lang/String)
getCacheDir Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 166/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public abstract File (/reference/java/io/File) getCacheDir ()
Returns the absolute path to the application specific cache directory on the filesystem.
The system will automatically delete files in this directory as disk space is needed
elsewhere on the device. The system will always delete older files first, as reported by
[Link]() (/reference/java/io/File#lastModified()) . If desired, you can exert more
control over how files are deleted using
[Link](File, boolean)
(/reference/android/os/storage/StorageManager#setCacheBehaviorGroup([Link],%20boolean))
and [Link](File, boolean)
(/reference/android/os/storage/StorageManager#setCacheBehaviorTombstone([Link],%20boolea
n))
.
Apps are strongly encouraged to keep their usage of cache space below the quota
returned by [Link]([Link])
(/reference/android/os/storage/StorageManager#getCacheQuotaBytes([Link])) . If your app
goes above this quota, your cached files will be some of the first to be deleted when
additional disk space is needed. Conversely, if your app stays under this quota, your
cached files will be some of the last to be deleted when additional disk space is needed.
Note that your cache quota will change over time depending on how frequently the user
interacts with your app, and depending on how much system-wide disk space is used.
The returned path may change over time if the calling app is moved to an adopted
storage device, so only relative paths should be persisted.
Apps require no extra permissions to read or write to the returned path, since this path
lives in their private storage.
Returns
File (/reference/java/io/File) The path of the directory holding application cache files.
See also:
[Link] 167/302
2/15/26, 8:49 PM Context | API reference | Android Developers
openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int))
getFileStreamPath(String)
(/reference/android/content/Context#getFileStreamPath([Link]))
getDir(String, int) (/reference/android/content/Context#getDir([Link],%20int))
getExternalCacheDir() (/reference/android/content/Context#getExternalCacheDir())
getClassLoader Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract ClassLoader (/reference/java/lang/ClassLoader) getClassLoader ()
Return a class loader you can use to retrieve classes in this package.
Returns
ClassLoader
(/reference/java/lang/ClassLoader)
getCodeCacheDir Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File (/reference/java/io/File) getCodeCacheDir ()
Returns the absolute path to the application specific cache directory on the filesystem
designed for storing cached code.
The system will delete any files stored in this location both when your specific application
is upgraded, and when the entire platform is upgraded.
[Link] 168/302
2/15/26, 8:49 PM Context | API reference | Android Developers
This location is optimal for storing compiled or optimized code generated by your
application at runtime.
The returned path may change over time if the calling app is moved to an adopted
storage device, so only relative paths should be persisted.
Apps require no extra permissions to read or write to the returned path, since this path
lives in their private storage.
Returns
File (/reference/java/io/File) The path of the directory holding application code cache files.
getColor Added in API level 23 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public final int getColor (int id)
Returns a color associated with a particular resource ID and styled for the current theme.
Parameters
id int : The desired resource identifier, as generated by the aapt tool.
This integer encodes the package, type, and resource entry. The
value 0 is an invalid identifier.
Returns
int A single color value in the form 0xAARRGGBB.
[Link] 169/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Throws
[Link] if the given ID does not exist.
(/reference/android/content/res/[Link])
getColorStateList Added in API level 23 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public final ColorStateList (/reference/android/content/res/ColorStateList) getColorStateL
Returns a color state list associated with a particular resource ID and styled for the
current theme.
Parameters
id int : The desired resource identifier, as generated by the aapt tool.
This integer encodes the package, type, and resource entry. The
value 0 is an invalid identifier.
Returns
ColorStateList A color state list.
(/reference/android/content/res/ColorStateList) This value cannot be null .
Throws
[Link] if the given ID does not exist.
(/reference/android/content/res/[Link])
[Link] 170/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getContentResolver Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract ContentResolver (/reference/android/content/ContentResolver) getContentR
Return a ContentResolver instance for your application's package.
Returns
ContentResolver
(/reference/android/content/ContentResolver)
getDataDir Added in API level 24 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File (/reference/java/io/File) getDataDir ()
Returns the absolute path to the directory on the filesystem where all private files
belonging to this app are stored. Apps should not use this path directly; they should
instead use getFilesDir() (/reference/android/content/Context#getFilesDir()) , getCacheDir()
(/reference/android/content/Context#getCacheDir()) , getDir([Link], int)
(/reference/android/content/Context#getDir([Link],%20int)) , or other storage APIs on
this class.
The returned path may change over time if the calling app is moved to an adopted
storage device, so only relative paths should be persisted.
No additional permissions are required for the calling app to read or write files under the
returned path.
Returns
[Link] 171/302
2/15/26, 8:49 PM Context | API reference | Android Developers
File (/reference/java/io/File)
See also:
[Link] (/reference/android/content/pm/ApplicationInfo#dataDir)
getDatabasePath Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File (/reference/java/io/File) getDatabasePath (String (/reference/java/lang
Returns the absolute path on the filesystem where a database created with
openOrCreateDatabase(String, int, CursorFactory)
(/reference/android/content/Context#openOrCreateDatabase([Link],%20int,%[Link]
[Link]))
is stored.
The returned path may change over time if the calling app is moved to an adopted
storage device, so only relative paths should be persisted.
Parameters
name String : The name of the database for which you would like to get
its path.
Returns
File (/reference/java/io/File) An absolute path to the given database.
See also:
[Link] 172/302
2/15/26, 8:49 PM Context | API reference | Android Developers
openOrCreateDatabase(String, int, CursorFactory)
(/reference/android/content/Context#openOrCreateDatabase([Link],%20int,%[Link]
[Link]))
getDeviceId Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public int getDeviceId ()
Gets the device ID this context is associated with. Applications can use this method to
determine whether they are running on a virtual device and identify that device. The
device ID of the host device is Context.DEVICE_ID_DEFAULT
(/reference/android/content/Context#DEVICE_ID_DEFAULT)
If the underlying device ID is changed by the system, for example, when an Activity
(/reference/android/app/Activity) is moved to a different virtual device, applications can
register to listen to changes by calling
[Link](Executor, IntConsumer)
(/reference/android/content/Context#registerDeviceIdChangeListener([Link],%
[Link]))
.
This method will only return a reliable value for this instance if it was created with
[Link](int)
(/reference/android/content/Context#createDeviceContext(int)) , or if this instance is a UI or
Display Context. Contexts created with [Link](int)
(/reference/android/content/Context#createDeviceContext(int)) will have an explicit device
association, which will never change, even if the underlying device is closed or is
removed. UI Contexts and Display Contexts are already associated with a display, so if the
device association is not explicitly given, [Link]()
(/reference/android/content/Context#getDeviceId()) will return the ID of the device associated
with the associated display. The system can assign an arbitrary device id value for
Contexts not logically associated with a device.
Returns
[Link] 173/302
2/15/26, 8:49 PM Context | API reference | Android Developers
int the ID of the device this context is associated with.
See also:
createDeviceContext(int) (/reference/android/content/Context#createDeviceContext(int))
registerDeviceIdChangeListener(Executor, IntConsumer)
(/reference/android/content/Context#registerDeviceIdChangeListener([Link],%
[Link]))
isUiContext() (/reference/android/content/Context#isUiContext())
getDir Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File (/reference/java/io/File) getDir (String (/reference/java/lang/String) na
int mode)
Retrieve, creating if needed, a new directory in which the application can place its own
custom data files. You can use the returned File object to create and access files in this
directory. Note that files created through a File object will only be accessible by your own
application; you can only set the mode of the entire directory, not of individual files.
The returned path may change over time if the calling app is moved to an adopted
storage device, so only relative paths should be persisted.
Apps require no extra permissions to read or write to the returned path, since this path
lives in their private storage.
Parameters
name String : Name of the directory to retrieve. This is a directory that is
created as part of your application data.
mode int : Operating mode.
Value is either 0 or a combination of the following:
[Link] 174/302
2/15/26, 8:49 PM Context | API reference | Android Developers
MODE_PRIVATE
(/reference/android/content/Context#MODE_PRIVATE)
MODE_WORLD_READABLE
(/reference/android/content/Context#MODE_WORLD_READABLE)
MODE_WORLD_WRITEABLE
(/reference/android/content/Context#MODE_WORLD_WRITEABLE)
MODE_APPEND
(/reference/android/content/Context#MODE_APPEND)
Returns
File (/reference/java/io/File) A File (/reference/java/io/File) object for the requested directory.
The directory will have been created if it does not already exist.
See also:
openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int))
getDisplay Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public Display (/reference/android/view/Display) getDisplay ()
Get the display this context is associated with. Applications should use this method with
Activity (/reference/android/app/Activity) or a context associated with a Display
(/reference/android/view/Display) via createDisplayContext([Link])
(/reference/android/content/Context#createDisplayContext([Link])) to get a display
object associated with a Context, or [Link](int)
(/reference/android/hardware/display/DisplayManager#getDisplay(int)) to get a display object by
id.
[Link] 175/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Returns
Display Returns the Display (/reference/android/view/Display) object this
(/reference/android/view/Display) context is associated with.
This value cannot be null .
Throws
UnsupportedOperationException if the method is called on an instance that is
(/reference/java/lang/UnsupportedOperationException) not associated with any display.
getDrawable Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public final Drawable (/reference/android/graphics/drawable/Drawable) getDrawable (int i
Returns a drawable object associated with a particular resource ID and styled for the
current theme.
Parameters
id int : The desired resource identifier, as generated by the aapt tool.
This integer encodes the package, type, and resource entry. The
value 0 is an invalid identifier.
Returns
[Link] 176/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Drawable An object that can be used to draw this resource.
(/reference/android/graphics/drawable/Drawable) This value may be null .
Throws
[Link] if the given ID does not exist.
(/reference/android/content/res/[Link])
getExternalCacheDirAdded in API level 8 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File (/reference/java/io/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. These files are
internal to the application, and not typically visible to the user as media.
This is like getCacheDir() (/reference/android/content/Context#getCacheDir()) in that these
files will be deleted when the application is uninstalled, however there are some important
differences:
The platform does not always monitor the space available in shared storage, and
thus may not automatically delete these files. Apps should always manage the
maximum space used in this location. Currently the only time files here will be
deleted by the platform is when running on Build.VERSION_CODES.JELLY_BEAN_MR1
(/reference/android/os/Build.VERSION_CODES#JELLY_BEAN_MR1) or later and
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link])) returns true.
Shared storage may not always be available, since removable media can be ejected
by the user. Media state can be checked using
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link])) .
[Link] 177/302
2/15/26, 8:49 PM Context | API reference | Android Developers
There is no security enforced with these files. For example, any application holding
[Link].WRITE_EXTERNAL_STORAGE
(/reference/android/[Link]#WRITE_EXTERNAL_STORAGE) can write to these
files.
If a shared storage device is emulated (as determined by
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link])) ), its contents are
backed by a private user data partition, which means there is little benefit to storing data
here instead of the private directory returned by getCacheDir()
(/reference/android/content/Context#getCacheDir()) .
Starting in Build.VERSION_CODES.KITKAT
(/reference/android/os/Build.VERSION_CODES#KITKAT) , no permissions are required to read or
write to the returned path; it's always accessible to the calling app. This only applies to
paths generated for package name of the calling application. To access paths belonging
to other packages, [Link].WRITE_EXTERNAL_STORAGE
(/reference/android/[Link]#WRITE_EXTERNAL_STORAGE) and/or
[Link].READ_EXTERNAL_STORAGE
(/reference/android/[Link]#READ_EXTERNAL_STORAGE) are required.
On devices with multiple users (as described by UserManager
(/reference/android/os/UserManager) ), each user has their own isolated shared storage.
Applications only have access to the shared storage for the user they're running as.
The returned path may change over time if different shared storage media is inserted, so
only relative paths should be persisted.
Returns
File (/reference/java/io/File) the absolute path to application-specific directory. May return null
if shared storage is not currently available.
See also:
getCacheDir() (/reference/android/content/Context#getCacheDir())
getExternalCacheDirs() (/reference/android/content/Context#getExternalCacheDirs())
[Link] 178/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageRemovable([Link]))
getExternalCacheDirs
Added in API level 19 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File[] (/reference/java/io/File) getExternalCacheDirs ()
Returns absolute paths to application-specific directories on all shared/external storage
devices where the application can place cache files it owns. These files are internal to the
application, and not typically visible to the user as media.
This is like getCacheDir() (/reference/android/content/Context#getCacheDir()) in that these
files will be deleted when the application is uninstalled, however there are some important
differences:
The platform does not always monitor the space available in shared storage, and
thus may not automatically delete these files. Apps should always manage the
maximum space used in this location. Currently the only time files here will be
deleted by the platform is when running on Build.VERSION_CODES.JELLY_BEAN_MR1
(/reference/android/os/Build.VERSION_CODES#JELLY_BEAN_MR1) or later and
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link])) returns true.
Shared storage may not always be available, since removable media can be ejected
by the user. Media state can be checked using
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link])) .
There is no security enforced with these files. For example, any application holding
[Link].WRITE_EXTERNAL_STORAGE
(/reference/android/[Link]#WRITE_EXTERNAL_STORAGE) can write to these
files.
[Link] 179/302
2/15/26, 8:49 PM Context | API reference | Android Developers
If a shared storage device is emulated (as determined by
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link])) ), its contents are
backed by a private user data partition, which means there is little benefit to storing data
here instead of the private directory returned by getCacheDir()
(/reference/android/content/Context#getCacheDir()) .
Shared storage devices returned here are considered a stable part of the device,
including physical media slots under a protective cover. The returned paths do not include
transient devices, such as USB flash drives connected to handheld devices.
An application may store data on any or all of the returned devices. For example, an app
may choose to store large files on the device with the most available space, as measured
by StatFs (/reference/android/os/StatFs) .
No additional permissions are required for the calling app to read or write files under the
returned path. Write access outside of these paths on secondary external storage devices
is not available.
The returned paths may change over time if different shared storage media is inserted, so
only relative paths should be persisted.
Returns
File[] (/reference/java/io/File) the absolute paths to application-specific directories. Some
individual paths may be null if that shared storage is not currently
available. The first path returned is the same as
getExternalCacheDir()
(/reference/android/content/Context#getExternalCacheDir()).
See also:
getExternalCacheDir() (/reference/android/content/Context#getExternalCacheDir())
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link]))
[Link] 180/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link](File)
(/reference/android/os/Environment#isExternalStorageRemovable([Link]))
getExternalFilesDir Added in API level 8 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File (/reference/java/io/File) getExternalFilesDir (String (/reference/jav
Returns the absolute path to the directory on the primary shared/external storage device
where the application can place persistent files it owns. These files are internal to the
applications, and not typically visible to the user as media.
This is like getFilesDir() (/reference/android/content/Context#getFilesDir()) in that these files
will be deleted when the application is uninstalled, however there are some important
differences:
Shared storage may not always be available, since removable media can be ejected
by the user. Media state can be checked using
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link])) .
There is no security enforced with these files. For example, any application holding
[Link].WRITE_EXTERNAL_STORAGE
(/reference/android/[Link]#WRITE_EXTERNAL_STORAGE) can write to these
files.
If a shared storage device is emulated (as determined by
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link])) ), its contents are
backed by a private user data partition, which means there is little benefit to storing data
here instead of the private directories returned by getFilesDir()
(/reference/android/content/Context#getFilesDir()) , etc.
Starting in Build.VERSION_CODES.KITKAT
(/reference/android/os/Build.VERSION_CODES#KITKAT) , no permissions are required to read or
write to the returned path; it's always accessible to the calling app. This only applies to
paths generated for package name of the calling application. To access paths belonging
to other packages, [Link].WRITE_EXTERNAL_STORAGE
(/reference/android/[Link]#WRITE_EXTERNAL_STORAGE) and/or
[Link] 181/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link].READ_EXTERNAL_STORAGE
(/reference/android/[Link]#READ_EXTERNAL_STORAGE) are required.
On devices with multiple users (as described by UserManager
(/reference/android/os/UserManager) ), each user has their own isolated shared storage.
Applications only have access to the shared storage for the user they're running as.
The returned path may change over time if different shared storage media is inserted, so
only relative paths should be persisted.
Here is an example of typical code to manipulate a file in an application's shared storage:
void createExternalStoragePrivateFile() {
// Create a path where we will place our private file on external
// storage.
File file = new File(getExternalFilesDir(null), "[Link]");
try {
// Very simple code to copy a picture from the application's
// resource into the external file. Note that this code does
// no error checking, and assumes the picture is small (does not
// try to copy it in chunks). Note that if external storage is
// not currently mounted this will silently fail.
InputStream is = getResources().openRawResource([Link]);
OutputStream os = new FileOutputStream(file);
byte[] data = new byte[[Link]()];
[Link](data);
[Link](data);
[Link]();
[Link]();
} catch (IOException e) {
// Unable to create file, likely because external storage is
// not currently mounted.
Log.w("ExternalStorage", "Error writing " + file, e);
}
}
void deleteExternalStoragePrivateFile() {
// Get path for the file on external storage. If external
// storage is not currently mounted this will fail.
File file = new File(getExternalFilesDir(null), "[Link]");
[Link]();
}
boolean hasExternalStoragePrivateFile() {
// Get path for the file on external storage. If external
[Link] 182/302
2/15/26, 8:49 PM Context | API reference | Android Developers
// storage is not currently mounted this will fail.
File file = new File(getExternalFilesDir(null), "[Link]");
return [Link]();
}
If you supply a non-null type to this function, the returned file will be a path to a sub-
directory of the given type. Though these files are not automatically scanned by the
media scanner, you can explicitly add them to the media database with
[Link]
(/reference/android/media/MediaScannerConnection#scanFile([Link],%[Link].
String[],%[Link][],%[Link]
r))
. Note that this is not the same as
[Link]()
(/reference/android/os/Environment#getExternalStoragePublicDirectory([Link])) , which
provides directories of media shared by all applications. The directories returned here are
owned by the application, and their contents will be removed when the application is
uninstalled. Unlike [Link]()
(/reference/android/os/Environment#getExternalStoragePublicDirectory([Link])) , the
directory returned here will be automatically created for you.
Here is an example of typical code to manipulate a picture in an application's shared
storage and add it to the media database:
void createExternalStoragePrivatePicture() {
// Create a path where we will place our picture in our own private
// pictures directory. Note that we don't really need to place a
// picture in DIRECTORY_PICTURES, since the media scanner will see
// all media in these directories; this may be useful with other
// media types such as DIRECTORY_MUSIC however to help it classify
// your media for display to the user.
File path = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
File file = new File(path, "[Link]");
try {
// Very simple code to copy a picture from the application's
// resource into the external file. Note that this code does
// no error checking, and assumes the picture is small (does not
// try to copy it in chunks). Note that if external storage is
// not currently mounted this will silently fail.
InputStream is = getResources().openRawResource([Link]);
OutputStream os = new FileOutputStream(file);
[Link] 183/302
2/15/26, 8:49 PM Context | API reference | Android Developers
byte[] data = new byte[[Link]()];
[Link](data);
[Link](data);
[Link]();
[Link]();
// Tell the media scanner about the new file so that it is
// immediately available to the user.
[Link](this,
new String[] { [Link]() }, null,
new [Link]() {
public void onScanCompleted(String path, Uri uri) {
Log.i("ExternalStorage", "Scanned " + path + ":");
Log.i("ExternalStorage", "-> uri=" + uri);
}
});
} catch (IOException e) {
// Unable to create file, likely because external storage is
// not currently mounted.
Log.w("ExternalStorage", "Error writing " + file, e);
}
}
void deleteExternalStoragePrivatePicture() {
// Create a path where we will place our picture in the user's
// public pictures directory and delete the file. If external
// storage is not currently mounted this will fail.
File path = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
if (path != null) {
File file = new File(path, "[Link]");
[Link]();
}
}
boolean hasExternalStoragePrivatePicture() {
// Create a path where we will place our picture in the user's
// public pictures directory and check if the file exists. If
// external storage is not currently mounted this will think the
// picture doesn't exist.
File path = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
if (path != null) {
File file = new File(path, "[Link]");
return [Link]();
}
return false;
}
[Link] 184/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Parameters
type String : The type of files directory to return. May be null for the
root of the files directory or one of the following constants for a
subdirectory: Environment.DIRECTORY_MUSIC
(/reference/android/os/Environment#DIRECTORY_MUSIC),
Environment.DIRECTORY_PODCASTS
(/reference/android/os/Environment#DIRECTORY_PODCASTS),
Environment.DIRECTORY_RINGTONES
(/reference/android/os/Environment#DIRECTORY_RINGTONES),
Environment.DIRECTORY_ALARMS
(/reference/android/os/Environment#DIRECTORY_ALARMS),
Environment.DIRECTORY_NOTIFICATIONS
(/reference/android/os/Environment#DIRECTORY_NOTIFICATIONS),
Environment.DIRECTORY_PICTURES
(/reference/android/os/Environment#DIRECTORY_PICTURES), or
Environment.DIRECTORY_MOVIES
(/reference/android/os/Environment#DIRECTORY_MOVIES).
Returns
File (/reference/java/io/File) the absolute path to application-specific directory. May return null
if shared storage is not currently available.
See also:
getFilesDir() (/reference/android/content/Context#getFilesDir())
getExternalFilesDirs(String)
(/reference/android/content/Context#getExternalFilesDirs([Link]))
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageRemovable([Link]))
[Link] 185/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getExternalFilesDirsAdded in API level 19 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File[] (/reference/java/io/File) getExternalFilesDirs (String (/reference
Returns absolute paths to application-specific directories on all shared/external storage
devices where the application can place persistent files it owns. These files are internal to
the application, and not typically visible to the user as media.
This is like getFilesDir() (/reference/android/content/Context#getFilesDir()) in that these files
will be deleted when the application is uninstalled, however there are some important
differences:
Shared storage may not always be available, since removable media can be ejected
by the user. Media state can be checked using
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link])) .
There is no security enforced with these files. For example, any application holding
[Link].WRITE_EXTERNAL_STORAGE
(/reference/android/[Link]#WRITE_EXTERNAL_STORAGE) can write to these
files.
If a shared storage device is emulated (as determined by
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link])) ), its contents are
backed by a private user data partition, which means there is little benefit to storing data
here instead of the private directories returned by getFilesDir()
(/reference/android/content/Context#getFilesDir()) , etc.
Shared storage devices returned here are considered a stable part of the device,
including physical media slots under a protective cover. The returned paths do not include
transient devices, such as USB flash drives connected to handheld devices.
An application may store data on any or all of the returned devices. For example, an app
may choose to store large files on the device with the most available space, as measured
by StatFs (/reference/android/os/StatFs) .
No additional permissions are required for the calling app to read or write files under the
returned path. Write access outside of these paths on secondary external storage devices
is not available.
[Link] 186/302
2/15/26, 8:49 PM Context | API reference | Android Developers
The returned path may change over time if different shared storage media is inserted, so
only relative paths should be persisted.
Parameters
type String : The type of files directory to return. May be null for the
root of the files directory or one of the following constants for a
subdirectory: Environment.DIRECTORY_MUSIC
(/reference/android/os/Environment#DIRECTORY_MUSIC),
Environment.DIRECTORY_PODCASTS
(/reference/android/os/Environment#DIRECTORY_PODCASTS),
Environment.DIRECTORY_RINGTONES
(/reference/android/os/Environment#DIRECTORY_RINGTONES),
Environment.DIRECTORY_ALARMS
(/reference/android/os/Environment#DIRECTORY_ALARMS),
Environment.DIRECTORY_NOTIFICATIONS
(/reference/android/os/Environment#DIRECTORY_NOTIFICATIONS),
Environment.DIRECTORY_PICTURES
(/reference/android/os/Environment#DIRECTORY_PICTURES), or
Environment.DIRECTORY_MOVIES
(/reference/android/os/Environment#DIRECTORY_MOVIES).
Returns
File[] (/reference/java/io/File) the absolute paths to application-specific directories. Some individua
paths may be null if that shared storage is not currently available. T
first path returned is the same as
getExternalFilesDir([Link])
(/reference/android/content/Context#getExternalFilesDir([Link]
.
See also:
getExternalFilesDir(String)
(/reference/android/content/Context#getExternalFilesDir([Link]))
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link]))
[Link] 187/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageRemovable([Link]))
getExternalMediaDirs
Added in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File[] (/reference/java/io/File) getExternalMediaDirs ()
This method was deprecated in API level 30.
These directories still exist and are scanned, but developers are encouraged to migrate to inserting
content into a MediaStore (/reference/android/provider/MediaStore) collection directly, as any app can
contribute new media to MediaStore (/reference/android/provider/MediaStore) with no permissions
required, starting in Build.VERSION_CODES.Q (/reference/android/os/Build.VERSION_CODES#Q).
Returns absolute paths to application-specific directories on all shared/external storage
devices where the application can place media files. These files are scanned and made
available to other apps through MediaStore (/reference/android/provider/MediaStore) .
This is like getExternalFilesDirs(String)
(/reference/android/content/Context#getExternalFilesDirs([Link])) in that these files will
be deleted when the application is uninstalled, however there are some important
differences:
Shared storage may not always be available, since removable media can be ejected
by the user. Media state can be checked using
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link])) .
There is no security enforced with these files. For example, any application holding
[Link].WRITE_EXTERNAL_STORAGE
(/reference/android/[Link]#WRITE_EXTERNAL_STORAGE) can write to these
files.
[Link] 188/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Shared storage devices returned here are considered a stable part of the device,
including physical media slots under a protective cover. The returned paths do not include
transient devices, such as USB flash drives connected to handheld devices.
An application may store data on any or all of the returned devices. For example, an app
may choose to store large files on the device with the most available space, as measured
by StatFs (/reference/android/os/StatFs) .
No additional permissions are required for the calling app to read or write files under the
returned path. Write access outside of these paths on secondary external storage devices
is not available.
The returned paths may change over time if different shared storage media is inserted, so
only relative paths should be persisted.
Returns
File[] (/reference/java/io/File) the absolute paths to application-specific directories. Some
individual paths may be null if that shared storage is not currently
available.
See also:
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageRemovable([Link]))
getFileStreamPath Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File (/reference/java/io/File) getFileStreamPath (String (/reference/java/la
[Link] 189/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Returns the absolute path on the filesystem where a file created with
openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int)) is stored.
The returned path may change over time if the calling app is moved to an adopted
storage device, so only relative paths should be persisted.
Parameters
name String : The name of the file for which you would like to get its path.
Returns
File (/reference/java/io/File) An absolute path to the given file.
See also:
openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int))
getFilesDir() (/reference/android/content/Context#getFilesDir())
getDir(String, int) (/reference/android/content/Context#getDir([Link],%20int))
getFilesDir Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File (/reference/java/io/File) getFilesDir ()
Returns the absolute path to the directory on the filesystem where files created with
openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int)) are stored.
[Link] 190/302
2/15/26, 8:49 PM Context | API reference | Android Developers
The returned path may change over time if the calling app is moved to an adopted
storage device, so only relative paths should be persisted.
No additional permissions are required for the calling app to read or write files under the
returned path.
Returns
File (/reference/java/io/File) The path of the directory holding application files.
See also:
openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int))
getFileStreamPath(String)
(/reference/android/content/Context#getFileStreamPath([Link]))
getDir(String, int) (/reference/android/content/Context#getDir([Link],%20int))
getMainExecutor Added in API level 28 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public Executor (/reference/java/util/concurrent/Executor) getMainExecutor ()
Return an Executor (/reference/java/util/concurrent/Executor) that will run enqueued tasks on
the main thread associated with this context. This is the thread used to dispatch calls to
application components (activities, services, etc).
Returns
Executor
(/reference/java/util/concurrent/Executor)
[Link] 191/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getMainLooper Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Looper (/reference/android/os/Looper) getMainLooper ()
Return the Looper for the main thread of the current process. This is the thread used to
dispatch calls to application components (activities, services, etc).
By definition, this method returns the same result as would be obtained by calling
[Link]() (/reference/android/os/Looper#getMainLooper()) .
Returns
Looper The main looper.
(/reference/android/os/Looper)
getNoBackupFilesDirAdded in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File (/reference/java/io/File) getNoBackupFilesDir ()
Returns the absolute path to the directory on the filesystem similar to getFilesDir()
(/reference/android/content/Context#getFilesDir()) . The difference is that files placed under this
directory will be excluded from automatic backup to remote storage. See BackupAgent
(/reference/android/app/backup/BackupAgent) for a full discussion of the automatic backup
mechanism in Android.
The returned path may change over time if the calling app is moved to an adopted
storage device, so only relative paths should be persisted.
No additional permissions are required for the calling app to read or write files under the
returned path.
[Link] 192/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Returns
File (/reference/java/io/File) The path of the directory holding application files that will not be
automatically backed up to remote storage.
See also:
openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int))
getFileStreamPath(String)
(/reference/android/content/Context#getFileStreamPath([Link]))
getDir(String, int) (/reference/android/content/Context#getDir([Link],%20int))
BackupAgent (/reference/android/app/backup/BackupAgent)
getObbDir Added in API level 11 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File (/reference/java/io/File) getObbDir ()
Return the primary shared/external storage directory where this application's OBB files (if
there are any) can be found. Note if the application does not have any OBB files, this
directory may not exist.
This is like getFilesDir() (/reference/android/content/Context#getFilesDir()) in that these files
will be deleted when the application is uninstalled, however there are some important
differences:
Shared storage may not always be available, since removable media can be ejected
by the user. Media state can be checked using
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link])) .
There is no security enforced with these files. For example, any application holding
[Link].WRITE_EXTERNAL_STORAGE
[Link] 193/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/[Link]#WRITE_EXTERNAL_STORAGE) can write to these
files.
Starting in Build.VERSION_CODES.KITKAT
(/reference/android/os/Build.VERSION_CODES#KITKAT) , no permissions are required to read or
write to the path that this method returns. However, starting from
Build.VERSION_CODES.M (/reference/android/os/Build.VERSION_CODES#M) , to read the OBB
expansion files, you must declare the [Link].READ_EXTERNAL_STORAGE
(/reference/android/[Link]#READ_EXTERNAL_STORAGE) permission in the app
manifest and ask for permission at runtime as follows:
<uses-permission android:name="[Link].READ_EXTERNAL_STORAGE"
android:maxSdkVersion="23" />
Starting from Build.VERSION_CODES.N (/reference/android/os/Build.VERSION_CODES#N) ,
[Link].READ_EXTERNAL_STORAGE
(/reference/android/[Link]#READ_EXTERNAL_STORAGE) permission is not required,
so don\u2019t ask for this permission at runtime. To handle both cases, your app must
first try to read the OBB file, and if it fails, you must request
[Link].READ_EXTERNAL_STORAGE
(/reference/android/[Link]#READ_EXTERNAL_STORAGE) permission at runtime.
The following code snippet shows how to do this:
File obb = new File(obb_filename);
boolean open_failed = false;
try {
BufferedReader br = new BufferedReader(new FileReader(obb));
open_failed = false;
ReadObbFile(br);
} catch (IOException e) {
open_failed = true;
}
if (open_failed) {
// request READ_EXTERNAL_STORAGE permission before reading OBB file
ReadObbFileWithPermission();
}
[Link] 194/302
2/15/26, 8:49 PM Context | API reference | Android Developers
On devices with multiple users (as described by UserManager
(/reference/android/os/UserManager) ), multiple users may share the same OBB storage
location. Applications should ensure that multiple instances running under different users
don't interfere with each other.
Returns
File (/reference/java/io/File) the absolute path to application-specific directory. May return null
if shared storage is not currently available.
See also:
getObbDirs() (/reference/android/content/Context#getObbDirs())
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageRemovable([Link]))
getObbDirs Added in API level 19 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract File[] (/reference/java/io/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. Note if the
application does not have any OBB files, these directories may not exist.
This is like getFilesDir() (/reference/android/content/Context#getFilesDir()) in that these files
will be deleted when the application is uninstalled, however there are some important
differences:
[Link] 195/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Shared storage may not always be available, since removable media can be ejected
by the user. Media state can be checked using
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link])) .
There is no security enforced with these files. For example, any application holding
[Link].WRITE_EXTERNAL_STORAGE
(/reference/android/[Link]#WRITE_EXTERNAL_STORAGE) can write to these
files.
Shared storage devices returned here are considered a stable part of the device,
including physical media slots under a protective cover. The returned paths do not include
transient devices, such as USB flash drives connected to handheld devices.
An application may store data on any or all of the returned devices. For example, an app
may choose to store large files on the device with the most available space, as measured
by StatFs (/reference/android/os/StatFs) .
No additional permissions are required for the calling app to read or write files under the
returned path. Write access outside of these paths on secondary external storage devices
is not available.
Returns
File[] (/reference/java/io/File) the absolute paths to application-specific directories. Some
individual paths may be null if that shared storage is not currently
available. The first path returned is the same as getObbDir()
(/reference/android/content/Context#getObbDir())
See also:
getObbDir() (/reference/android/content/Context#getObbDir())
[Link](File)
(/reference/android/os/Environment#getExternalStorageState([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageEmulated([Link]))
[Link](File)
(/reference/android/os/Environment#isExternalStorageRemovable([Link]))
[Link] 196/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getOpPackageNameAdded in API level 29 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public String (/reference/java/lang/String) getOpPackageName ()
Return the package name that should be used for AppOpsManager
(/reference/android/app/AppOpsManager) calls from this context, so that app ops manager's
uid verification will work with the name.
This is not generally intended for third party application developers.
Returns
String This value cannot be null .
(/reference/java/lang/String)
getPackageCodePath
Added in API level 8 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract String (/reference/java/lang/String) getPackageCodePath ()
Return the full path to this context's primary Android package. The Android package is a
ZIP file which contains application's primary code and assets.
Note: this is not generally useful for applications, since they should not be directly
accessing the file system.
Returns
String String Path to the code and assets.
(/reference/java/lang/String)
[Link] 197/302
2/15/26, 8:49 PM Context | API reference | Android Developers
getPackageManagerAdded in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract PackageManager (/reference/android/content/pm/PackageManager) getPacka
Return PackageManager instance to find global package information.
Returns
PackageManager
(/reference/android/content/pm/PackageManager)
getPackageName Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract String (/reference/java/lang/String) getPackageName ()
Return the name of this application's package.
Returns
String
(/reference/java/lang/String)
getPackageResourcePath
Added in API level 8 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract String (/reference/java/lang/String) getPackageResourcePath ()
[Link] 198/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Return the full path to this context's primary Android package. The Android package is a
ZIP file which contains the application's primary resources.
Note: this is not generally useful for applications, since they should not be directly
accessing the file system.
Returns
String String Path to the resources.
(/reference/java/lang/String)
getParams Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public ContextParams (/reference/android/content/ContextParams) getParams ()
Return the set of parameters which this Context was created with, if it was created via
createContext([Link])
(/reference/android/content/Context#createContext([Link])) .
Returns
ContextParams This value may be null .
(/reference/android/content/ContextParams)
getResources Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Resources (/reference/android/content/res/Resources) getResources ()
Returns a Resources instance for the application's package.
[Link] 199/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Note: Implementations of this method should return a Resources instance that is
consistent with the AssetManager instance returned by getAssets()
(/reference/android/content/Context#getAssets()) . For example, they should share the same
Configuration (/reference/android/content/res/Configuration) object.
Returns
Resources a Resources instance for the application's package
(/reference/android/content/res/Resources)
See also:
getAssets() (/reference/android/content/Context#getAssets())
getSharedPreferences
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract SharedPreferences (/reference/android/content/SharedPreferences) getShar
int mode)
Retrieve and hold the contents of the preferences file 'name', returning a
SharedPreferences through which you can retrieve and modify its values. Only one
instance of the SharedPreferences object is returned to any callers for the same name,
meaning they will see each other's edits as soon as they are made.
This method is thread-safe.
If the preferences directory does not already exist, it will be created when this method is
called.
If a preferences file by this name does not exist, it will be created when you retrieve an
editor ( [Link]() (/reference/android/content/SharedPreferences#edit()) )
and then commit changes ( [Link]()
(/reference/android/content/[Link]#commit()) or
[Link]()
(/reference/android/content/[Link]#apply()) ).
[Link] 200/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Parameters
name String : Desired preferences file.
mode int : Operating mode.
Value is either 0 or a combination of the following:
MODE_PRIVATE
(/reference/android/content/Context#MODE_PRIVATE)
MODE_WORLD_READABLE
(/reference/android/content/Context#MODE_WORLD_READABLE)
MODE_WORLD_WRITEABLE
(/reference/android/content/Context#MODE_WORLD_WRITEABLE)
MODE_MULTI_PROCESS
(/reference/android/content/Context#MODE_MULTI_PROCESS)
Returns
SharedPreferences The single SharedPreferences
(/reference/android/content/SharedPreferences) (/reference/android/content/SharedPreferences)
instance that can be used to retrieve and modify the
preference values.
See also:
MODE_PRIVATE (/reference/android/content/Context#MODE_PRIVATE)
getString Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public final String (/reference/java/lang/String) getString (int resId)
[Link] 201/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Returns a localized string from the application's package's default string table.
Parameters
resId int : Resource id for the string
Returns
String The string data associated with the resource, stripped of styled text
(/reference/java/lang/String) information.
This value cannot be null .
getString Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public final String (/reference/java/lang/String) getString (int resId,
Object... (/reference/java/lang/Object) formatArgs)
Returns a localized formatted string from the application's package's default string table,
substituting the format arguments as defined in Formatter (/reference/java/util/Formatter)
and [Link](String, Object)
(/reference/java/lang/String#format([Link],%[Link][])) .
Parameters
resId int : Resource id for the format string
formatArgs Object : The format arguments that will be used for substitution.
[Link] 202/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Returns
String The string data associated with the resource, formatted and stripped
(/reference/java/lang/String) of styled text information.
This value cannot be null .
getSystemService Added in API level 23 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public final T getSystemService (Class (/reference/java/lang/Class)<T> serviceClass)
Return the handle to a system-level service by class.
Currently available classes are: WindowManager (/reference/android/view/WindowManager) ,
LayoutInflater (/reference/android/view/LayoutInflater) , ActivityManager
(/reference/android/app/ActivityManager) , PowerManager (/reference/android/os/PowerManager) ,
AlarmManager (/reference/android/app/AlarmManager) , NotificationManager
(/reference/android/app/NotificationManager) , KeyguardManager
(/reference/android/app/KeyguardManager) , LocationManager
(/reference/android/location/LocationManager) , SearchManager
(/reference/android/app/SearchManager) , Vibrator (/reference/android/os/Vibrator) ,
ConnectivityManager (/reference/android/net/ConnectivityManager) , WifiManager
(/reference/android/net/wifi/WifiManager) , AudioManager
(/reference/android/media/AudioManager) , MediaRouter (/reference/android/media/MediaRouter) ,
TelephonyManager (/reference/android/telephony/TelephonyManager) , SubscriptionManager
(/reference/android/telephony/SubscriptionManager) , InputMethodManager
(/reference/android/view/inputmethod/InputMethodManager) , UiModeManager
(/reference/android/app/UiModeManager) , DownloadManager
(/reference/android/app/DownloadManager) , BatteryManager
(/reference/android/os/BatteryManager) , JobScheduler (/reference/android/app/job/JobScheduler) ,
NetworkStatsManager (/reference/android/app/usage/NetworkStatsManager) ,
DomainVerificationManager
(/reference/android/content/pm/verify/domain/DomainVerificationManager) , DisplayHashManager
(/reference/android/view/displayhash/DisplayHashManager)
ERROR(/[Link]) (/)
.
[Link] 203/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Note: System services obtained via this API may be closely associated with the Context in
which they are obtained from. In general, do not share the service objects between
various different contexts (Activities, Applications, Services, Providers, etc.)
Note: Instant apps, for which [Link]()
(/reference/android/content/pm/PackageManager#isInstantApp()) returns true, don't have access
to the following system services: DEVICE_POLICY_SERVICE
(/reference/android/content/Context#DEVICE_POLICY_SERVICE) ,
ERROR(/#FINGERPRINT_SERVICE) (/) , KEYGUARD_SERVICE
(/reference/android/content/Context#KEYGUARD_SERVICE) , SHORTCUT_SERVICE
(/reference/android/content/Context#SHORTCUT_SERVICE) , USB_SERVICE
(/reference/android/content/Context#USB_SERVICE) , WALLPAPER_SERVICE
(/reference/android/content/Context#WALLPAPER_SERVICE) , WIFI_P2P_SERVICE
(/reference/android/content/Context#WIFI_P2P_SERVICE) , WIFI_SERVICE
(/reference/android/content/Context#WIFI_SERVICE) , WIFI_AWARE_SERVICE
(/reference/android/content/Context#WIFI_AWARE_SERVICE) . For these services this method will
return null . Generally, if you are running as an instant app you should always check
whether the result of this method is null .
Parameters
serviceClass Class : The class of the desired service.
This value cannot be null .
Returns
T The service or null if the class is not a supported system service.
Note: never throw a RuntimeException
(/reference/java/lang/RuntimeException) if the name is not
supported.
getSystemService Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 204/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public abstract Object (/reference/java/lang/Object) getSystemService (String (/reference
Return the handle to a system-level service by name. The class of the returned object
varies by the requested name. Currently available names are:
WINDOW_SERVICE (/reference/android/content/Context#WINDOW_SERVICE) ("window")
The top-level window manager in which you can place custom windows. The
returned object is a WindowManager (/reference/android/view/WindowManager) . Must
only be obtained from a visual context such as Activity or a Context created with
createWindowContext(int, [Link])
(/reference/android/content/Context#createWindowContext(int,%[Link])) , which
are adjusted to the configuration and visual bounds of an area on screen.
LAYOUT_INFLATER_SERVICE (/reference/android/content/Context#LAYOUT_INFLATER_SERVICE)
("layout_inflater")
A LayoutInflater (/reference/android/view/LayoutInflater) for inflating layout resources
in this context. Must only be obtained from a visual context such as Activity or a
Context created with createWindowContext(int, [Link])
(/reference/android/content/Context#createWindowContext(int,%[Link])) , which
are adjusted to the configuration and visual bounds of an area on screen.
ACTIVITY_SERVICE (/reference/android/content/Context#ACTIVITY_SERVICE) ("activity")
A ActivityManager (/reference/android/app/ActivityManager) for interacting with the
global activity state of the system.
WALLPAPER_SERVICE (/reference/android/content/Context#WALLPAPER_SERVICE) ("wallpaper")
A WallpaperService (/reference/android/service/wallpaper/WallpaperService) for
accessing wallpapers in this context. Must only be obtained from a visual context
such as Activity or a Context created with createWindowContext(int,
[Link])
(/reference/android/content/Context#createWindowContext(int,%[Link])) , which
are adjusted to the configuration and visual bounds of an area on screen.
POWER_SERVICE (/reference/android/content/Context#POWER_SERVICE) ("power")
A PowerManager (/reference/android/os/PowerManager) for controlling power
management.
[Link] 205/302
2/15/26, 8:49 PM Context | API reference | Android Developers
ALARM_SERVICE (/reference/android/content/Context#ALARM_SERVICE) ("alarm")
A AlarmManager (/reference/android/app/AlarmManager) for receiving intents at the time
of your choosing.
NOTIFICATION_SERVICE (/reference/android/content/Context#NOTIFICATION_SERVICE)
("notification")
A NotificationManager (/reference/android/app/NotificationManager) for informing the
user of background events.
KEYGUARD_SERVICE (/reference/android/content/Context#KEYGUARD_SERVICE) ("keyguard")
A KeyguardManager (/reference/android/app/KeyguardManager) for controlling keyguard.
LOCATION_SERVICE (/reference/android/content/Context#LOCATION_SERVICE) ("location")
A LocationManager (/reference/android/location/LocationManager) for controlling
location (e.g., GPS) updates.
SEARCH_SERVICE (/reference/android/content/Context#SEARCH_SERVICE) ("search")
A SearchManager (/reference/android/app/SearchManager) for handling search.
VIBRATOR_MANAGER_SERVICE
(/reference/android/content/Context#VIBRATOR_MANAGER_SERVICE) ("vibrator_manager")
A VibratorManager (/reference/android/os/VibratorManager) for accessing the device
vibrators, interacting with individual ones and playing synchronized effects on
multiple vibrators.
VIBRATOR_SERVICE (/reference/android/content/Context#VIBRATOR_SERVICE) ("vibrator")
A Vibrator (/reference/android/os/Vibrator) for interacting with the vibrator hardware.
CONNECTIVITY_SERVICE (/reference/android/content/Context#CONNECTIVITY_SERVICE)
("connectivity")
A ConnectivityManager (/reference/android/net/ConnectivityManager) for handling
management of network connections.
IPSEC_SERVICE (/reference/android/content/Context#IPSEC_SERVICE) ("ipsec")
A IpSecManager (/reference/android/net/IpSecManager) for managing IPSec on sockets
and networks.
[Link] 206/302
2/15/26, 8:49 PM Context | API reference | Android Developers
WIFI_SERVICE (/reference/android/content/Context#WIFI_SERVICE) ("wifi")
A WifiManager (/reference/android/net/wifi/WifiManager) for management of Wi-Fi
connectivity. On releases before Android 7, it should only be obtained from an
application context, and not from any other derived context to avoid memory leaks
within the calling process.
WIFI_AWARE_SERVICE (/reference/android/content/Context#WIFI_AWARE_SERVICE) ("wifiaware")
A WifiAwareManager (/reference/android/net/wifi/aware/WifiAwareManager) for
management of Wi-Fi Aware discovery and connectivity.
WIFI_P2P_SERVICE (/reference/android/content/Context#WIFI_P2P_SERVICE) ("wifip2p")
A WifiP2pManager (/reference/android/net/wifi/p2p/WifiP2pManager) for management of
Wi-Fi Direct connectivity.
INPUT_METHOD_SERVICE (/reference/android/content/Context#INPUT_METHOD_SERVICE)
("input_method")
An InputMethodManager (/reference/android/view/inputmethod/InputMethodManager) for
management of input methods.
UI_MODE_SERVICE (/reference/android/content/Context#UI_MODE_SERVICE) ("uimode")
An UiModeManager (/reference/android/app/UiModeManager) for controlling UI modes.
DOWNLOAD_SERVICE (/reference/android/content/Context#DOWNLOAD_SERVICE) ("download")
A DownloadManager (/reference/android/app/DownloadManager) for requesting HTTP
downloads
BATTERY_SERVICE (/reference/android/content/Context#BATTERY_SERVICE)
("batterymanager")
A BatteryManager (/reference/android/os/BatteryManager) for managing battery state
JOB_SCHEDULER_SERVICE (/reference/android/content/Context#JOB_SCHEDULER_SERVICE)
("taskmanager")
A JobScheduler (/reference/android/app/job/JobScheduler) for managing scheduled
tasks
NETWORK_STATS_SERVICE (/reference/android/content/Context#NETWORK_STATS_SERVICE)
("netstats")
[Link] 207/302
2/15/26, 8:49 PM Context | API reference | Android Developers
A NetworkStatsManager (/reference/android/app/usage/NetworkStatsManager) for
querying network usage statistics.
HARDWARE_PROPERTIES_SERVICE
(/reference/android/content/Context#HARDWARE_PROPERTIES_SERVICE)
("hardware_properties")
A HardwarePropertiesManager (/reference/android/os/HardwarePropertiesManager) for
accessing hardware properties.
DOMAIN_VERIFICATION_SERVICE
(/reference/android/content/Context#DOMAIN_VERIFICATION_SERVICE) ("domain_verification")
A DomainVerificationManager
(/reference/android/content/pm/verify/domain/DomainVerificationManager) for accessing
web domain approval state.
DISPLAY_HASH_SERVICE (/reference/android/content/Context#DISPLAY_HASH_SERVICE)
("display_hash")
A DisplayHashManager (/reference/android/view/displayhash/DisplayHashManager) for
management of display hashes.
ERROR(/#AUTHENTICATION_POLICY_SERVICE) (/) ("authentication_policy")
A
ERROR(/[Link]
er) (/) for managing authentication related policies on the device.
Note: System services obtained via this API may be closely associated with the Context in
which they are obtained from. In general, do not share the service objects between
various different contexts (Activities, Applications, Services, Providers, etc.)
Note: Instant apps, for which [Link]()
(/reference/android/content/pm/PackageManager#isInstantApp()) returns true, don't have access
to the following system services: DEVICE_POLICY_SERVICE
(/reference/android/content/Context#DEVICE_POLICY_SERVICE) ,
ERROR(/#FINGERPRINT_SERVICE) (/) , KEYGUARD_SERVICE
(/reference/android/content/Context#KEYGUARD_SERVICE) , SHORTCUT_SERVICE
(/reference/android/content/Context#SHORTCUT_SERVICE) , USB_SERVICE
(/reference/android/content/Context#USB_SERVICE) , WALLPAPER_SERVICE
(/reference/android/content/Context#WALLPAPER_SERVICE) , WIFI_P2P_SERVICE
(/reference/android/content/Context#WIFI_P2P_SERVICE) , WIFI_SERVICE
(/reference/android/content/Context#WIFI_SERVICE) , WIFI_AWARE_SERVICE
[Link] 208/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/content/Context#WIFI_AWARE_SERVICE) . For these services this method will
return null . Generally, if you are running as an instant app you should always check
whether the result of this method is null .
Note: When implementing this method, keep in mind that new services can be added on
newer Android releases, so if you're looking for just the explicit names mentioned above,
make sure to return null when you don't recognize the name — if you throw a
RuntimeException (/reference/java/lang/RuntimeException) exception instead, your app might
break on new Android releases.
Parameters
name String : The name of the desired service.
Value is one of the following:
POWER_SERVICE (/reference/android/content/Context#POWER_SE
WINDOW_SERVICE (/reference/android/content/Context#WINDOW
LAYOUT_INFLATER_SERVICE
(/reference/android/content/Context#LAYOUT_INFLATER_SERVICE
ACCOUNT_SERVICE (/reference/android/content/Context#ACCOU
ACTIVITY_SERVICE (/reference/android/content/Context#ACTIVI
ALARM_SERVICE (/reference/android/content/Context#ALARM_SE
NOTIFICATION_SERVICE
(/reference/android/content/Context#NOTIFICATION_SERVICE)
ACCESSIBILITY_SERVICE
(/reference/android/content/Context#ACCESSIBILITY_SERVICE)
CAPTIONING_SERVICE
(/reference/android/content/Context#CAPTIONING_SERVICE)
KEYGUARD_SERVICE
(/reference/android/content/Context#KEYGUARD_SERVICE)
LOCATION_SERVICE
(/reference/android/content/Context#LOCATION_SERVICE)
HEALTHCONNECT_SERVICE
(/reference/android/content/Context#HEALTHCONNECT_SERVICE
SEARCH_SERVICE (/reference/android/content/Context#SEARCH_
SENSOR_SERVICE (/reference/android/content/Context#SENSOR_
STORAGE_SERVICE (/reference/android/content/Context#STORAG
[Link] 209/302
2/15/26, 8:49 PM Context | API reference | Android Developers
STORAGE_STATS_SERVICE
(/reference/android/content/Context#STORAGE_STATS_SERVICE)
WALLPAPER_SERVICE
(/reference/android/content/Context#WALLPAPER_SERVICE)
VIBRATOR_MANAGER_SERVICE
(/reference/android/content/Context#VIBRATOR_MANAGER_SERV
VIBRATOR_SERVICE
(/reference/android/content/Context#VIBRATOR_SERVICE)
CONNECTIVITY_SERVICE
(/reference/android/content/Context#CONNECTIVITY_SERVICE)
TETHERING_SERVICE
(/reference/android/content/Context#TETHERING_SERVICE)
IPSEC_SERVICE (/reference/android/content/Context#IPSEC_SER
VPN_MANAGEMENT_SERVICE
(/reference/android/content/Context#VPN_MANAGEMENT_SERVIC
NETWORK_STATS_SERVICE
(/reference/android/content/Context#NETWORK_STATS_SERVICE)
WIFI_SERVICE (/reference/android/content/Context#WIFI_SERVIC
WIFI_AWARE_SERVICE
(/reference/android/content/Context#WIFI_AWARE_SERVICE)
WIFI_P2P_SERVICE (/reference/android/content/Context#WIFI_P
WIFI_RTT_RANGING_SERVICE
(/reference/android/content/Context#WIFI_RTT_RANGING_SERVIC
NSD_SERVICE (/reference/android/content/Context#NSD_SERVICE
AUDIO_SERVICE (/reference/android/content/Context#AUDIO_SE
BIOMETRIC_SERVICE
(/reference/android/content/Context#BIOMETRIC_SERVICE)
MEDIA_ROUTER_SERVICE
(/reference/android/content/Context#MEDIA_ROUTER_SERVICE)
TELEPHONY_SERVICE
(/reference/android/content/Context#TELEPHONY_SERVICE)
TELEPHONY_SUBSCRIPTION_SERVICE
(/reference/android/content/Context#TELEPHONY_SUBSCRIPTION
TELEPHONY_PHONE_NUMBER_SERVICE
(/reference/android/content/Context#TELEPHONY_PHONE_NUMB
CARRIER_CONFIG_SERVICE
(/reference/android/content/Context#CARRIER_CONFIG_SERVICE)
[Link] 210/302
2/15/26, 8:49 PM Context | API reference | Android Developers
EUICC_SERVICE (/reference/android/content/Context#EUICC_SER
TELECOM_SERVICE (/reference/android/content/Context#TELECO
CLIPBOARD_SERVICE
(/reference/android/content/Context#CLIPBOARD_SERVICE)
INPUT_METHOD_SERVICE
(/reference/android/content/Context#INPUT_METHOD_SERVICE)
TEXT_SERVICES_MANAGER_SERVICE
(/reference/android/content/Context#TEXT_SERVICES_MANAGER_
TEXT_CLASSIFICATION_SERVICE
(/reference/android/content/Context#TEXT_CLASSIFICATION_SER
APPWIDGET_SERVICE
(/reference/android/content/Context#APPWIDGET_SERVICE)
DROPBOX_SERVICE (/reference/android/content/Context#DROPBO
DEVICE_POLICY_SERVICE
(/reference/android/content/Context#DEVICE_POLICY_SERVICE)
UI_MODE_SERVICE (/reference/android/content/Context#UI_MOD
DOWNLOAD_SERVICE
(/reference/android/content/Context#DOWNLOAD_SERVICE)
NFC_SERVICE (/reference/android/content/Context#NFC_SERVICE
BLUETOOTH_SERVICE
(/reference/android/content/Context#BLUETOOTH_SERVICE)
USB_SERVICE (/reference/android/content/Context#USB_SERVICE
LAUNCHER_APPS_SERVICE
(/reference/android/content/Context#LAUNCHER_APPS_SERVICE)
INPUT_SERVICE (/reference/android/content/Context#INPUT_SER
DISPLAY_SERVICE (/reference/android/content/Context#DISPLAY
USER_SERVICE (/reference/android/content/Context#USER_SERV
RESTRICTIONS_SERVICE
(/reference/android/content/Context#RESTRICTIONS_SERVICE)
APP_OPS_SERVICE (/reference/android/content/Context#APP_OP
ROLE_SERVICE (/reference/android/content/Context#ROLE_SERV
CAMERA_SERVICE (/reference/android/content/Context#CAMERA_
PRINT_SERVICE (/reference/android/content/Context#PRINT_SER
CONSUMER_IR_SERVICE
(/reference/android/content/Context#CONSUMER_IR_SERVICE)
[Link] 211/302
2/15/26, 8:49 PM Context | API reference | Android Developers
TV_INTERACTIVE_APP_SERVICE
(/reference/android/content/Context#TV_INTERACTIVE_APP_SERV
TV_INPUT_SERVICE
(/reference/android/content/Context#TV_INPUT_SERVICE)
USAGE_STATS_SERVICE
(/reference/android/content/Context#USAGE_STATS_SERVICE)
MEDIA_SESSION_SERVICE
(/reference/android/content/Context#MEDIA_SESSION_SERVICE)
MEDIA_COMMUNICATION_SERVICE
(/reference/android/content/Context#MEDIA_COMMUNICATION_S
BATTERY_SERVICE (/reference/android/content/Context#BATTER
JOB_SCHEDULER_SERVICE
(/reference/android/content/Context#JOB_SCHEDULER_SERVICE)
PERSISTENT_DATA_BLOCK_SERVICE
(/reference/android/content/Context#PERSISTENT_DATA_BLOCK_
MEDIA_PROJECTION_SERVICE
(/reference/android/content/Context#MEDIA_PROJECTION_SERVI
MIDI_SERVICE (/reference/android/content/Context#MIDI_SERVIC
HARDWARE_PROPERTIES_SERVICE
(/reference/android/content/Context#HARDWARE_PROPERTIES_S
SHORTCUT_SERVICE
(/reference/android/content/Context#SHORTCUT_SERVICE)
SYSTEM_HEALTH_SERVICE
(/reference/android/content/Context#SYSTEM_HEALTH_SERVICE)
COMPANION_DEVICE_SERVICE
(/reference/android/content/Context#COMPANION_DEVICE_SERV
VIRTUAL_DEVICE_SERVICE
(/reference/android/content/Context#VIRTUAL_DEVICE_SERVICE)
CROSS_PROFILE_APPS_SERVICE
(/reference/android/content/Context#CROSS_PROFILE_APPS_SER
LOCALE_SERVICE (/reference/android/content/Context#LOCALE_
MEDIA_METRICS_SERVICE
(/reference/android/content/Context#MEDIA_METRICS_SERVICE)
DISPLAY_HASH_SERVICE
(/reference/android/content/Context#DISPLAY_HASH_SERVICE)
CREDENTIAL_SERVICE
(/reference/android/content/Context#CREDENTIAL_SERVICE)
[Link] 212/302
2/15/26, 8:49 PM Context | API reference | Android Developers
DEVICE_LOCK_SERVICE
(/reference/android/content/Context#DEVICE_LOCK_SERVICE)
GRAMMATICAL_INFLECTION_SERVICE
(/reference/android/content/Context#GRAMMATICAL_INFLECTION
SECURITY_STATE_SERVICE
(/reference/android/content/Context#SECURITY_STATE_SERVICE)
CONTACT_KEYS_SERVICE
(/reference/android/content/Context#CONTACT_KEYS_SERVICE)
MEDIA_QUALITY_SERVICE
(/reference/android/content/Context#MEDIA_QUALITY_SERVICE)
ADVANCED_PROTECTION_SERVICE
(/reference/android/content/Context#ADVANCED_PROTECTION_S
.
This value cannot be null .
Returns
Object The service or null if the name does not exist.
(/reference/java/lang/Object)
See also:
WINDOW_SERVICE (/reference/android/content/Context#WINDOW_SERVICE)
WindowManager (/reference/android/view/WindowManager)
LAYOUT_INFLATER_SERVICE (/reference/android/content/Context#LAYOUT_INFLATER_SERVICE)
LayoutInflater (/reference/android/view/LayoutInflater)
ACTIVITY_SERVICE (/reference/android/content/Context#ACTIVITY_SERVICE)
ActivityManager (/reference/android/app/ActivityManager)
POWER_SERVICE (/reference/android/content/Context#POWER_SERVICE)
PowerManager (/reference/android/os/PowerManager)
ALARM_SERVICE (/reference/android/content/Context#ALARM_SERVICE)
[Link] 213/302
2/15/26, 8:49 PM Context | API reference | Android Developers
AlarmManager (/reference/android/app/AlarmManager)
NOTIFICATION_SERVICE (/reference/android/content/Context#NOTIFICATION_SERVICE)
NotificationManager (/reference/android/app/NotificationManager)
KEYGUARD_SERVICE (/reference/android/content/Context#KEYGUARD_SERVICE)
KeyguardManager (/reference/android/app/KeyguardManager)
LOCATION_SERVICE (/reference/android/content/Context#LOCATION_SERVICE)
LocationManager (/reference/android/location/LocationManager)
SEARCH_SERVICE (/reference/android/content/Context#SEARCH_SERVICE)
SearchManager (/reference/android/app/SearchManager)
SENSOR_SERVICE (/reference/android/content/Context#SENSOR_SERVICE)
SensorManager (/reference/android/hardware/SensorManager)
STORAGE_SERVICE (/reference/android/content/Context#STORAGE_SERVICE)
StorageManager (/reference/android/os/storage/StorageManager)
VIBRATOR_MANAGER_SERVICE
(/reference/android/content/Context#VIBRATOR_MANAGER_SERVICE)
VibratorManager (/reference/android/os/VibratorManager)
VIBRATOR_SERVICE (/reference/android/content/Context#VIBRATOR_SERVICE)
Vibrator (/reference/android/os/Vibrator)
CONNECTIVITY_SERVICE (/reference/android/content/Context#CONNECTIVITY_SERVICE)
ConnectivityManager (/reference/android/net/ConnectivityManager)
WIFI_SERVICE (/reference/android/content/Context#WIFI_SERVICE)
WifiManager (/reference/android/net/wifi/WifiManager)
AUDIO_SERVICE (/reference/android/content/Context#AUDIO_SERVICE)
AudioManager (/reference/android/media/AudioManager)
MEDIA_ROUTER_SERVICE (/reference/android/content/Context#MEDIA_ROUTER_SERVICE)
MediaRouter (/reference/android/media/MediaRouter)
TELEPHONY_SERVICE (/reference/android/content/Context#TELEPHONY_SERVICE)
[Link] 214/302
2/15/26, 8:49 PM Context | API reference | Android Developers
TelephonyManager (/reference/android/telephony/TelephonyManager)
TELEPHONY_SUBSCRIPTION_SERVICE
(/reference/android/content/Context#TELEPHONY_SUBSCRIPTION_SERVICE)
SubscriptionManager (/reference/android/telephony/SubscriptionManager)
CARRIER_CONFIG_SERVICE (/reference/android/content/Context#CARRIER_CONFIG_SERVICE)
CarrierConfigManager (/reference/android/telephony/CarrierConfigManager)
EUICC_SERVICE (/reference/android/content/Context#EUICC_SERVICE)
EuiccManager (/reference/android/telephony/euicc/EuiccManager)
INPUT_METHOD_SERVICE (/reference/android/content/Context#INPUT_METHOD_SERVICE)
InputMethodManager (/reference/android/view/inputmethod/InputMethodManager)
UI_MODE_SERVICE (/reference/android/content/Context#UI_MODE_SERVICE)
UiModeManager (/reference/android/app/UiModeManager)
DOWNLOAD_SERVICE (/reference/android/content/Context#DOWNLOAD_SERVICE)
DownloadManager (/reference/android/app/DownloadManager)
BATTERY_SERVICE (/reference/android/content/Context#BATTERY_SERVICE)
BatteryManager (/reference/android/os/BatteryManager)
JOB_SCHEDULER_SERVICE (/reference/android/content/Context#JOB_SCHEDULER_SERVICE)
JobScheduler (/reference/android/app/job/JobScheduler)
NETWORK_STATS_SERVICE (/reference/android/content/Context#NETWORK_STATS_SERVICE)
NetworkStatsManager (/reference/android/app/usage/NetworkStatsManager)
HardwarePropertiesManager (/reference/android/os/HardwarePropertiesManager)
HARDWARE_PROPERTIES_SERVICE
(/reference/android/content/Context#HARDWARE_PROPERTIES_SERVICE)
DOMAIN_VERIFICATION_SERVICE
(/reference/android/content/Context#DOMAIN_VERIFICATION_SERVICE)
DomainVerificationManager
(/reference/android/content/pm/verify/domain/DomainVerificationManager)
DISPLAY_HASH_SERVICE (/reference/android/content/Context#DISPLAY_HASH_SERVICE)
[Link] 215/302
2/15/26, 8:49 PM Context | API reference | Android Developers
DisplayHashManager (/reference/android/view/displayhash/DisplayHashManager)
ERROR(/#AUTHENTICATION_POLICY_SERVICE) (/)
ERROR(/[Link]) (/)
getSystemServiceName
Added in API level 23 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract String (/reference/java/lang/String) getSystemServiceName (Class (/refere
Gets the name of the system-level service that is represented by the specified class.
Parameters
serviceClass Class : The class of the desired service.
This value cannot be null .
Returns
String The service name or null if the class is not a supported system
(/reference/java/lang/String) service.
getText Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public final CharSequence (/reference/java/lang/CharSequence) getText (int resId)
Return a localized, styled CharSequence from the application's package's default string
table.
[Link] 216/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Parameters
resId int : Resource id for the CharSequence text
Returns
CharSequence This value cannot be null .
(/reference/java/lang/CharSequence)
getTheme Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract [Link] (/reference/android/content/res/[Link]) getThem
Return the Theme object associated with this Context.
Returns
[Link]
(/reference/android/content/res/[Link])
getWallpaper Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 15 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Drawable (/reference/android/graphics/drawable/Drawable) getWallpaper ()
[Link] 217/302
2/15/26, 8:49 PM Context | API reference | Android Developers
This method was deprecated in API level 15.
Use [Link]() (/reference/android/app/WallpaperManager#getDrawable()) instead.
Returns
Drawable
(/reference/android/graphics/drawable/Drawable)
getWallpaperDesiredMinimumHeight
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 15 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract int getWallpaperDesiredMinimumHeight ()
This method was deprecated in API level 15.
Use [Link]()
(/reference/android/app/WallpaperManager#getDesiredMinimumHeight()) instead.
Returns
int
getWallpaperDesiredMinimumWidth
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 15 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract int getWallpaperDesiredMinimumWidth ()
[Link] 218/302
2/15/26, 8:49 PM Context | API reference | Android Developers
This method was deprecated in API level 15.
Use [Link]()
(/reference/android/app/WallpaperManager#getDesiredMinimumWidth()) instead.
Returns
int
grantUriPermission Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void grantUriPermission (String (/reference/java/lang/String) toPackag
Uri (/reference/android/net/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. This can be used to
grant specific, temporary permissions, typically in response to user interaction (such as
the user opening an attachment that you would like someone else to display).
Normally you should use Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERMISSION) or
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PERMISSION) with the Intent being
used to start an activity instead of this function directly. If you use this function directly,
you should be sure to call revokeUriPermission(Uri, int)
(/reference/android/content/Context#revokeUriPermission([Link],%20int)) when the target
should no longer be allowed to access it.
To succeed, the content provider owning the Uri must have set the grantUriPermissions
(/reference/android/[Link]#AndroidManifestProvider_grantUriPermissions) attribute in its
manifest or included the <grant-uri-permissions>
(/reference/android/[Link]#AndroidManifestGrantUriPermission) tag.
[Link] 219/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Parameters
toPackage String : The package you would like to allow to access the Uri.
uri Uri : The Uri you would like to grant access to.
modeFlags int : The desired access modes.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_PERSISTABLE_U
Intent.FLAG_GRANT_PREFIX_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_PREFIX_URI_PE
See also:
revokeUriPermission(Uri, int)
(/reference/android/content/Context#revokeUriPermission([Link],%20int))
isDeviceProtectedStorage
Added in API level 24 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract boolean isDeviceProtectedStorage ()
Indicates if the storage APIs of this Context are backed by device-protected storage.
Returns
[Link] 220/302
2/15/26, 8:49 PM Context | API reference | Android Developers
boolean
See also:
createDeviceProtectedStorageContext()
(/reference/android/content/Context#createDeviceProtectedStorageContext())
isRestricted Added in API level 4 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public boolean isRestricted ()
Indicates whether this Context is restricted.
Returns
boolean true if this Context is restricted, false otherwise.
See also:
CONTEXT_RESTRICTED (/reference/android/content/Context#CONTEXT_RESTRICTED)
isUiContext Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public boolean isUiContext ()
Returns true if the context is a UI context which can access UI components such as
WindowManager (/reference/android/view/WindowManager) , LayoutInflater
(/reference/android/view/LayoutInflater) or WallpaperManager
[Link] 221/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/app/WallpaperManager) . Accessing UI components from non-UI contexts
throws Violation (/reference/android/os/strictmode/Violation) if
[Link]()
(/reference/android/os/[Link]#detectIncorrectContextUse()) is enabled.
Examples of UI contexts are an Activity (/reference/android/app/Activity) , a context created
from createWindowContext(int, [Link])
(/reference/android/content/Context#createWindowContext(int,%[Link])) or
InputMethodService (/reference/android/inputmethodservice/InputMethodService)
Note that even if it is allowed programmatically, it is not suggested to override this
method to bypass IncorrectContextUseViolation
(/reference/android/os/strictmode/IncorrectContextUseViolation) verification.
Returns
boolean
See also:
getDisplay() (/reference/android/content/Context#getDisplay())
getSystemService(String)
(/reference/android/content/Context#getSystemService([Link]))
[Link]()
(/reference/android/os/[Link]#detectIncorrectContextUse())
moveDatabaseFromAdded in API level 24 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract boolean moveDatabaseFrom (Context (/reference/android/content/Context)
String (/reference/java/lang/String) name)
Move an existing database file from the given source storage context to this context. This
is typically used to migrate data between storage locations after an upgrade, such as
migrating to device protected storage.
[Link] 222/302
2/15/26, 8:49 PM Context | API reference | Android Developers
The database must be closed before being moved.
Parameters
sourceContext Context : The source context which contains the existing database
to move.
name String : The name of the database file.
Returns
boolean true if the move was successful or if the database didn't exist in the
source context, otherwise false .
See also:
createDeviceProtectedStorageContext()
(/reference/android/content/Context#createDeviceProtectedStorageContext())
moveSharedPreferencesFrom
Added in API level 24 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract boolean moveSharedPreferencesFrom (Context (/reference/android/conte
String (/reference/java/lang/String) name)
Move an existing shared preferences file from the given source storage context to this
context. This is typically used to migrate data between storage locations after an upgrade,
such as moving to device protected storage.
Parameters
[Link] 223/302
2/15/26, 8:49 PM Context | API reference | Android Developers
sourceContext Context : The source context which contains the existing shared
preferences to move.
name String : The name of the shared preferences file.
Returns
boolean true if the move was successful or if the shared preferences didn't
exist in the source context, otherwise false .
See also:
createDeviceProtectedStorageContext()
(/reference/android/content/Context#createDeviceProtectedStorageContext())
obtainStyledAttributes
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public final TypedArray (/reference/android/content/res/TypedArray) obtainStyledAttribut
int[] attrs)
Retrieve styled attribute information in this Context's theme. See
[Link](AttributeSet, int[], int, int)
(/reference/android/content/res/[Link]#obtainStyledAttributes([Link],%2
0int[],%20int,%20int))
for more information.
Parameters
set AttributeSet : This value may be null .
[Link] 224/302
2/15/26, 8:49 PM Context | API reference | Android Developers
attrs int : This value cannot be null .
Returns
TypedArray This value cannot be null .
(/reference/android/content/res/TypedArray)
See also:
[Link](AttributeSet, int[], int, int)
(/reference/android/content/res/[Link]#obtainStyledAttributes([Link],%2
0int[],%20int,%20int))
obtainStyledAttributes
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public final TypedArray (/reference/android/content/res/TypedArray) obtainStyledAttribut
int[] attrs,
int defStyleAttr,
int defStyleRes)
Retrieve styled attribute information in this Context's theme. See
[Link](AttributeSet, int[], int, int)
(/reference/android/content/res/[Link]#obtainStyledAttributes([Link],%2
0int[],%20int,%20int))
for more information.
Parameters
set AttributeSet : This value may be null .
[Link] 225/302
2/15/26, 8:49 PM Context | API reference | Android Developers
attrs int : This value cannot be null .
defStyleAttr int
defStyleRes int
Returns
TypedArray This value cannot be null .
(/reference/android/content/res/TypedArray)
See also:
[Link](AttributeSet, int[], int, int)
(/reference/android/content/res/[Link]#obtainStyledAttributes([Link],%2
0int[],%20int,%20int))
obtainStyledAttributes
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public final TypedArray (/reference/android/content/res/TypedArray) obtainStyledAttribut
int[] attrs)
Retrieve styled attribute information in this Context's theme. See
[Link](int, int[])
(/reference/android/content/res/[Link]#obtainStyledAttributes(int,%20int[])) for more
information.
Parameters
[Link] 226/302
2/15/26, 8:49 PM Context | API reference | Android Developers
resid int
attrs int : This value cannot be null .
Returns
TypedArray This value cannot be null .
(/reference/android/content/res/TypedArray)
Throws
[Link]
(/reference/android/content/res/[Link])
See also:
[Link](int, int[])
(/reference/android/content/res/[Link]#obtainStyledAttributes(int,%20int[]))
obtainStyledAttributes
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public final TypedArray (/reference/android/content/res/TypedArray) obtainStyledAttribut
Retrieve styled attribute information in this Context's theme. See
[Link](int[])
(/reference/android/content/res/[Link]#obtainStyledAttributes(int[])) for more
information.
[Link] 227/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Parameters
attrs int : This value cannot be null .
Returns
TypedArray This value cannot be null .
(/reference/android/content/res/TypedArray)
See also:
[Link](int[])
(/reference/android/content/res/[Link]#obtainStyledAttributes(int[]))
openFileInput Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract FileInputStream (/reference/java/io/FileInputStream) openFileInput (Str
Open a private file associated with this Context's application package for reading.
Parameters
name String : The name of the file to open; can not contain path
separators.
Returns
[Link] 228/302
2/15/26, 8:49 PM Context | API reference | Android Developers
FileInputStream The resulting FileInputStream
(/reference/java/io/FileInputStream) (/reference/java/io/FileInputStream).
Throws
FileNotFoundException
(/reference/java/io/FileNotFoundException)
See also:
openFileOutput(String, int)
(/reference/android/content/Context#openFileOutput([Link],%20int))
fileList() (/reference/android/content/Context#fileList())
deleteFile(String) (/reference/android/content/Context#deleteFile([Link]))
[Link](String)
(/reference/java/io/FileInputStream#FileInputStream([Link]))
openFileOutput Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract FileOutputStream (/reference/java/io/FileOutputStream) openFileOutput (
int mode)
Open a private file associated with this Context's application package for writing. Creates
the file if it doesn't already exist.
No additional permissions are required for the calling app to read or write the returned
file.
Parameters
[Link] 229/302
2/15/26, 8:49 PM Context | API reference | Android Developers
name String : The name of the file to open; can not contain path
separators.
mode int : Operating mode.
Value is either 0 or a combination of the following:
MODE_PRIVATE
(/reference/android/content/Context#MODE_PRIVATE)
MODE_WORLD_READABLE
(/reference/android/content/Context#MODE_WORLD_READABLE)
MODE_WORLD_WRITEABLE
(/reference/android/content/Context#MODE_WORLD_WRITEABLE)
MODE_APPEND
(/reference/android/content/Context#MODE_APPEND)
Returns
FileOutputStream The resulting FileOutputStream
(/reference/java/io/FileOutputStream) (/reference/java/io/FileOutputStream).
Throws
FileNotFoundException
(/reference/java/io/FileNotFoundException)
See also:
MODE_APPEND (/reference/android/content/Context#MODE_APPEND)
MODE_PRIVATE (/reference/android/content/Context#MODE_PRIVATE)
openFileInput(String) (/reference/android/content/Context#openFileInput([Link]))
fileList() (/reference/android/content/Context#fileList())
deleteFile(String) (/reference/android/content/Context#deleteFile([Link]))
[Link] 230/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link](String)
(/reference/java/io/FileOutputStream#FileOutputStream([Link]))
openOrCreateDatabase
Added in API level 11 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract SQLiteDatabase (/reference/android/database/sqlite/SQLiteDatabase) openOr
int mode,
[Link] (/reference/android/database/sqlite/SQLiteD
DatabaseErrorHandler (/reference/android/database/DatabaseErrorHandler)
Open a new private SQLiteDatabase associated with this Context's application package.
Creates the database file if it doesn't exist.
Accepts input param: a concrete instance of DatabaseErrorHandler
(/reference/android/database/DatabaseErrorHandler) to be used to handle corruption when
sqlite reports database corruption.
Parameters
name String : The name (unique in the application package) of the databa
mode int : Operating mode.
Value is either 0 or a combination of the following:
MODE_PRIVATE (/reference/android/content/Context#MODE_PRIV
MODE_WORLD_READABLE
(/reference/android/content/Context#MODE_WORLD_READABLE)
MODE_WORLD_WRITEABLE
(/reference/android/content/Context#MODE_WORLD_WRITEABLE)
MODE_ENABLE_WRITE_AHEAD_LOGGING
(/reference/android/content/Context#MODE_ENABLE_WRITE_AHE
MODE_NO_LOCALIZED_COLLATORS
(/reference/android/content/Context#MODE_NO_LOCALIZED_COL
[Link] 231/302
2/15/26, 8:49 PM Context | API reference | Android Developers
factory [Link] : An optional factory class that i
instantiate a cursor when query is called.
errorHandler DatabaseErrorHandler : the DatabaseErrorHandler
(/reference/android/database/DatabaseErrorHandler) to be used whe
reports database corruption. if null, DefaultDatabaseErrorHandl
(/reference/android/database/DefaultDatabaseErrorHandler) is assum
Returns
SQLiteDatabase The contents of a newly created database with
(/reference/android/database/sqlite/SQLiteDatabase) the given name.
Throws
SQLiteException if the database file could not be opened.
(/reference/android/database/sqlite/SQLiteException)
See also:
MODE_PRIVATE (/reference/android/content/Context#MODE_PRIVATE)
MODE_ENABLE_WRITE_AHEAD_LOGGING
(/reference/android/content/Context#MODE_ENABLE_WRITE_AHEAD_LOGGING)
MODE_NO_LOCALIZED_COLLATORS
(/reference/android/content/Context#MODE_NO_LOCALIZED_COLLATORS)
deleteDatabase(String) (/reference/android/content/Context#deleteDatabase([Link]))
openOrCreateDatabase
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 232/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public abstract SQLiteDatabase (/reference/android/database/sqlite/SQLiteDatabase) openOr
int mode,
[Link] (/reference/android/database/sqlite/SQLiteD
Open a new private SQLiteDatabase associated with this Context's application package.
Create the database file if it doesn't exist.
Parameters
name String : The name (unique in the application package) of the databa
mode int : Operating mode.
Value is either 0 or a combination of the following:
MODE_PRIVATE (/reference/android/content/Context#MODE_PRIV
MODE_WORLD_READABLE
(/reference/android/content/Context#MODE_WORLD_READABLE)
MODE_WORLD_WRITEABLE
(/reference/android/content/Context#MODE_WORLD_WRITEABLE)
MODE_ENABLE_WRITE_AHEAD_LOGGING
(/reference/android/content/Context#MODE_ENABLE_WRITE_AHE
MODE_NO_LOCALIZED_COLLATORS
(/reference/android/content/Context#MODE_NO_LOCALIZED_COL
factory [Link] : An optional factory class that i
instantiate a cursor when query is called.
Returns
SQLiteDatabase The contents of a newly created database with
(/reference/android/database/sqlite/SQLiteDatabase) the given name.
[Link] 233/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Throws
SQLiteException if the database file could not be opened.
(/reference/android/database/sqlite/SQLiteException)
See also:
MODE_PRIVATE (/reference/android/content/Context#MODE_PRIVATE)
MODE_ENABLE_WRITE_AHEAD_LOGGING
(/reference/android/content/Context#MODE_ENABLE_WRITE_AHEAD_LOGGING)
MODE_NO_LOCALIZED_COLLATORS
(/reference/android/content/Context#MODE_NO_LOCALIZED_COLLATORS)
deleteDatabase(String) (/reference/android/content/Context#deleteDatabase([Link]))
peekWallpaper Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 15 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Drawable (/reference/android/graphics/drawable/Drawable) peekWallpaper (
This method was deprecated in API level 15.
Use [Link]() (/reference/android/app/WallpaperManager#peekDrawable()) instead.
Returns
Drawable
(/reference/android/graphics/drawable/Drawable)
registerComponentCallbacks
Added in API level 14 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 234/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public void registerComponentCallbacks (ComponentCallbacks (/reference/android/conte
Add a new ComponentCallbacks (/reference/android/content/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. Note that
you must be sure to use unregisterComponentCallbacks(ComponentCallbacks)
(/reference/android/content/Context#unregisterComponentCallbacks([Link]
backs))
when appropriate in the future; this will not be removed for you.
After Build.VERSION_CODES.S (/reference/android/os/Build.VERSION_CODES#S) , registering
the ComponentCallbacks to Context created via createWindowContext(int,
[Link])
(/reference/android/content/Context#createWindowContext(int,%[Link])) or
createWindowContext([Link], int, [Link])
(/reference/android/content/Context#createWindowContext([Link],%20int,%20android.
[Link]))
will receive [Link](Configuration)
(/reference/android/content/ComponentCallbacks#onConfigurationChanged([Link]
iguration))
from Window Context rather than its base application. It is helpful if you want to handle UI
components that associated with the Window Context when the Window Context has
configuration changes.
After Build.VERSION_CODES.TIRAMISU
(/reference/android/os/Build.VERSION_CODES#TIRAMISU) , registering the ComponentCallbacks
to Activity (/reference/android/app/Activity) context will receive
[Link](Configuration)
(/reference/android/content/ComponentCallbacks#onConfigurationChanged([Link]
iguration))
from [Link](Configuration)
(/reference/android/app/Activity#onConfigurationChanged([Link]))
rather than its base application.
After Build.VERSION_CODES.UPSIDE_DOWN_CAKE
(/reference/android/os/Build.VERSION_CODES#UPSIDE_DOWN_CAKE) , registering the
ComponentCallbacks to InputMethodService
(/reference/android/inputmethodservice/InputMethodService) will receive
[Link](Configuration)
[Link] 235/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/content/ComponentCallbacks#onConfigurationChanged([Link]
iguration))
from InputmethodService rather than its base application. It is helpful if you want to
handle UI components when the IME has configuration changes.
Parameters
callback ComponentCallbacks : The interface to call. This can be either a
ComponentCallbacks
(/reference/android/content/ComponentCallbacks) or
ComponentCallbacks2
(/reference/android/content/ComponentCallbacks2) interface.
See also:
createWindowContext(int, Bundle)
(/reference/android/content/Context#createWindowContext(int,%[Link]))
registerDeviceIdChangeListener
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public void registerDeviceIdChangeListener (Executor (/reference/java/util/concurrent/E
IntConsumer (/reference/java/util/function/IntConsumer) listener)
Adds a new device ID changed listener to the Context , which will be called when the
device association is changed by the system.
The callback can be called when an app is moved to a different device and the Context is
not explicitly associated with a specific device.
When an application receives a device id update callback, this Context is guaranteed to
also have an updated display ID(if any) and Configuration
(/reference/android/content/res/Configuration) .
[Link] 236/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Parameters
executor Executor : The Executor on whose thread to execute the callbacks
of the listener object.
This value cannot be null .
Callback and listener events are dispatched through this Executor
(/reference/java/util/concurrent/Executor), providing an easy way to
control which thread is used. To dispatch events through the main
thread of your application, you can use
[Link]()
(/reference/android/content/Context#getMainExecutor()).
Otherwise, provide an Executor
(/reference/java/util/concurrent/Executor) that dispatches to an
appropriate thread.
listener IntConsumer : The listener IntConsumer to call which will receive
the updated device ID.
This value cannot be null .
See also:
getDeviceId() (/reference/android/content/Context#getDeviceId())
createDeviceContext(int) (/reference/android/content/Context#createDeviceContext(int))
registerReceiver Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Intent (/reference/android/content/Intent) registerReceiver (BroadcastR
IntentFilter (/reference/android/content/IntentFilter) filter)
Register a BroadcastReceiver to be run in the main activity thread. The receiver will be
called with any broadcast Intent that matches filter, in the main application thread.
The system may broadcast Intents that are "sticky" -- these stay around after the
broadcast has finished, to be sent to any later registrations. If your IntentFilter matches
[Link] 237/302
2/15/26, 8:49 PM Context | API reference | Android Developers
one of these sticky Intents, that Intent will be returned by this function and sent to your
receiver as if it had just been broadcast.
There may be multiple sticky Intents that match filter, in which case each of these will be
sent to receiver. In this case, only one of these can be returned directly by the function;
which of these that is returned is arbitrarily decided by the system.
If you know the Intent you are registering for is sticky, you can supply null for your
receiver. In this case, no receiver is registered -- the function simply returns the sticky
Intent that matches filter. In the case of multiple matches, the same rules as described
above apply.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
As of Build.VERSION_CODES.UPSIDE_DOWN_CAKE
(/reference/android/os/Build.VERSION_CODES#UPSIDE_DOWN_CAKE) , the system can place
context-registered broadcasts in a queue while the app is in the
(/develop/background-work/background-tasks/broadcasts#android-14)cached state
(/guide/components/activities/process-lifecycle). When the app leaves the cached state, such
as returning to the foreground, the system delivers any queued broadcasts. Multiple
instances of certain broadcasts might be merged into one broadcast.
As of Build.VERSION_CODES.ICE_CREAM_SANDWICH
(/reference/android/os/Build.VERSION_CODES#ICE_CREAM_SANDWICH) , receivers registered with
this method will correctly respect the [Link](String)
(/reference/android/content/Intent#setPackage([Link])) specified for an Intent being
broadcast. Prior to that, it would be ignored and delivered to all matching registered
receivers. Be careful if using this for security.
For apps targeting Build.VERSION_CODES.UPSIDE_DOWN_CAKE
(/reference/android/os/Build.VERSION_CODES#UPSIDE_DOWN_CAKE) , either RECEIVER_EXPORTED
(/reference/android/content/Context#RECEIVER_EXPORTED) or RECEIVER_NOT_EXPORTED
(/reference/android/content/Context#RECEIVER_NOT_EXPORTED) must be specified if the
receiver is not being registered for system broadcasts
(/guide/components/broadcasts#system-broadcasts) or a SecurityException
(/reference/java/lang/SecurityException) will be thrown. See
registerReceiver([Link],
[Link], int)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link],%20int))
to register a receiver with flags.
[Link] 238/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Note: this method cannot be called from a BroadcastReceiver
(/reference/android/content/BroadcastReceiver) component; that is, from a BroadcastReceiver that is
declared in an application's manifest. It is okay, however, to call this method from another
BroadcastReceiver that has itself been registered at run time with
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
, since the lifetime of such a registered BroadcastReceiver is tied to the object that registered it.
Parameters
receiver BroadcastReceiver : The BroadcastReceiver to handle the
broadcast.
This value may be null .
filter IntentFilter : Selects the Intent broadcasts to be received.
Returns
Intent The first sticky intent found that matches filter, or null if there are
(/reference/android/content/Intent) none.
See also:
registerReceiver(BroadcastReceiver, IntentFilter, String, Handler)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link],%[Link],%[Link]))
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
unregisterReceiver(BroadcastReceiver)
(/reference/android/content/Context#unregisterReceiver([Link]))
[Link] 239/302
2/15/26, 8:49 PM Context | API reference | Android Developers
registerReceiver Added in API level 26 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Intent (/reference/android/content/Intent) registerReceiver (BroadcastR
IntentFilter (/reference/android/content/IntentFilter) filter,
int flags)
Register to receive intent broadcasts, with the receiver optionally being exposed to
Instant Apps. See registerReceiver([Link],
[Link])
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
for more information. By default Instant Apps cannot interact with receivers in other
applications, this allows you to expose a receiver that Instant Apps can interact with.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
As of Build.VERSION_CODES.UPSIDE_DOWN_CAKE
(/reference/android/os/Build.VERSION_CODES#UPSIDE_DOWN_CAKE) , the system can place
context-registered broadcasts in a queue while the app is in the
(/develop/background-work/background-tasks/broadcasts#android-14)cached state
(/guide/components/activities/process-lifecycle). When the app leaves the cached state, such
as returning to the foreground, the system delivers any queued broadcasts. Multiple
instances of certain broadcasts might be merged into one broadcast.
As of Build.VERSION_CODES.ICE_CREAM_SANDWICH
(/reference/android/os/Build.VERSION_CODES#ICE_CREAM_SANDWICH) , receivers registered with
this method will correctly respect the [Link](String)
(/reference/android/content/Intent#setPackage([Link])) specified for an Intent being
broadcast. Prior to that, it would be ignored and delivered to all matching registered
receivers. Be careful if using this for security.
Parameters
receiver BroadcastReceiver : The BroadcastReceiver to handle the broadca
This value may be null .
[Link] 240/302
2/15/26, 8:49 PM Context | API reference | Android Developers
filter IntentFilter : Selects the Intent broadcasts to be received.
flags int : Additional options for the receiver. For apps targeting
Build.VERSION_CODES.UPSIDE_DOWN_CAKE
(/reference/android/os/Build.VERSION_CODES#UPSIDE_DOWN_CAKE
RECEIVER_EXPORTED
(/reference/android/content/Context#RECEIVER_EXPORTED) or
RECEIVER_NOT_EXPORTED
(/reference/android/content/Context#RECEIVER_NOT_EXPORTED) mu
specified if the receiver isn't being registered for system broadcasts
(/guide/components/broadcasts#system-broadcasts) or a
SecurityException (/reference/java/lang/SecurityException) will b
If RECEIVER_EXPORTED
(/reference/android/content/Context#RECEIVER_EXPORTED) is speci
receiver may additionally specify RECEIVER_VISIBLE_TO_INSTANT
(/reference/android/content/Context#RECEIVER_VISIBLE_TO_INSTANT
For a complete list of system broadcast actions, see the
BROADCAST_ACTIONS.TXT file in the Android SDK. If both
RECEIVER_EXPORTED
(/reference/android/content/Context#RECEIVER_EXPORTED) and
RECEIVER_NOT_EXPORTED
(/reference/android/content/Context#RECEIVER_NOT_EXPORTED) are
specified, an IllegalArgumentException
(/reference/java/lang/IllegalArgumentException) will be thrown.
Value is either 0 or a combination of the following:
RECEIVER_VISIBLE_TO_INSTANT_APPS
(/reference/android/content/Context#RECEIVER_VISIBLE_TO_INSTA
RECEIVER_EXPORTED
(/reference/android/content/Context#RECEIVER_EXPORTED)
RECEIVER_NOT_EXPORTED
(/reference/android/content/Context#RECEIVER_NOT_EXPORTED)
Returns
Intent The first sticky intent found that matches filter, or null if there are
(/reference/android/content/Intent) none.
See also:
[Link] 241/302
2/15/26, 8:49 PM Context | API reference | Android Developers
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
unregisterReceiver(BroadcastReceiver)
(/reference/android/content/Context#unregisterReceiver([Link]))
registerReceiver Added in API level 26 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Intent (/reference/android/content/Intent) registerReceiver (BroadcastR
IntentFilter (/reference/android/content/IntentFilter) filter,
String (/reference/java/lang/String) broadcastPermission,
Handler (/reference/android/os/Handler) scheduler,
int flags)
Register to receive intent broadcasts, to run in the context of scheduler. See
registerReceiver([Link],
[Link], int)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link],%20int))
and registerReceiver([Link],
[Link], [Link], [Link])
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link],%[Link],%[Link]))
for more information.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
As of Build.VERSION_CODES.UPSIDE_DOWN_CAKE
(/reference/android/os/Build.VERSION_CODES#UPSIDE_DOWN_CAKE) , the system can place
context-registered broadcasts in a queue while the app is in the
(/develop/background-work/background-tasks/broadcasts#android-14)cached state
(/guide/components/activities/process-lifecycle). When the app leaves the cached state, such
as returning to the foreground, the system delivers any queued broadcasts. Multiple
instances of certain broadcasts might be merged into one broadcast.
[Link] 242/302
2/15/26, 8:49 PM Context | API reference | Android Developers
As of Build.VERSION_CODES.ICE_CREAM_SANDWICH
(/reference/android/os/Build.VERSION_CODES#ICE_CREAM_SANDWICH) , receivers registered with
this method will correctly respect the [Link](String)
(/reference/android/content/Intent#setPackage([Link])) specified for an Intent being
broadcast. Prior to that, it would be ignored and delivered to all matching registered
receivers. Be careful if using this for security.
Parameters
receiver BroadcastReceiver : The BroadcastReceiver to handle the broadca
filter IntentFilter : Selects the Intent broadcasts to be received.
broadcastPermission String : String naming a permissions that a broadcaster must hold in
send an Intent to you. If null, no permission is required.
scheduler Handler : Handler identifying the thread that will receive the Intent. If
main thread of the process will be used.
flags int : Additional options for the receiver. For apps targeting
Build.VERSION_CODES.UPSIDE_DOWN_CAKE
(/reference/android/os/Build.VERSION_CODES#UPSIDE_DOWN_CAKE
RECEIVER_EXPORTED
(/reference/android/content/Context#RECEIVER_EXPORTED) or
RECEIVER_NOT_EXPORTED
(/reference/android/content/Context#RECEIVER_NOT_EXPORTED) mu
specified if the receiver isn't being registered for system broadcasts
(/guide/components/broadcasts#system-broadcasts) or a
SecurityException (/reference/java/lang/SecurityException) will b
If RECEIVER_EXPORTED
(/reference/android/content/Context#RECEIVER_EXPORTED) is speci
receiver may additionally specify RECEIVER_VISIBLE_TO_INSTANT
(/reference/android/content/Context#RECEIVER_VISIBLE_TO_INSTANT
For a complete list of system broadcast actions, see the
BROADCAST_ACTIONS.TXT file in the Android SDK. If both
RECEIVER_EXPORTED
(/reference/android/content/Context#RECEIVER_EXPORTED) and
RECEIVER_NOT_EXPORTED
(/reference/android/content/Context#RECEIVER_NOT_EXPORTED) are
specified, an IllegalArgumentException
[Link] 243/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/java/lang/IllegalArgumentException) will be thrown.
Value is either 0 or a combination of the following:
RECEIVER_VISIBLE_TO_INSTANT_APPS
(/reference/android/content/Context#RECEIVER_VISIBLE_TO_INSTA
RECEIVER_EXPORTED
(/reference/android/content/Context#RECEIVER_EXPORTED)
RECEIVER_NOT_EXPORTED
(/reference/android/content/Context#RECEIVER_NOT_EXPORTED)
Returns
Intent The first sticky intent found that matches filter, or null if there are
(/reference/android/content/Intent) none.
See also:
registerReceiver(BroadcastReceiver, IntentFilter, int)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link],%20int))
registerReceiver(BroadcastReceiver, IntentFilter, String, Handler)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link],%[Link],%[Link]))
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
unregisterReceiver(BroadcastReceiver)
(/reference/android/content/Context#unregisterReceiver([Link]))
registerReceiver Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract Intent (/reference/android/content/Intent) registerReceiver (BroadcastR
IntentFilter (/reference/android/content/IntentFilter) filter,
[Link] 244/302
2/15/26, 8:49 PM Context | API reference | Android Developers
String (/reference/java/lang/String) broadcastPermission,
Handler (/reference/android/os/Handler) scheduler)
Register to receive intent broadcasts, to run in the context of scheduler. See
registerReceiver([Link],
[Link])
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
for more information. This allows you to enforce permissions on who can broadcast
intents to your receiver, or have the receiver run in a different thread than the main
application thread.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
As of Build.VERSION_CODES.UPSIDE_DOWN_CAKE
(/reference/android/os/Build.VERSION_CODES#UPSIDE_DOWN_CAKE) , the system can place
context-registered broadcasts in a queue while the app is in the
(/develop/background-work/background-tasks/broadcasts#android-14)cached state
(/guide/components/activities/process-lifecycle). When the app leaves the cached state, such
as returning to the foreground, the system delivers any queued broadcasts. Multiple
instances of certain broadcasts might be merged into one broadcast.
As of Build.VERSION_CODES.ICE_CREAM_SANDWICH
(/reference/android/os/Build.VERSION_CODES#ICE_CREAM_SANDWICH) , receivers registered with
this method will correctly respect the [Link](String)
(/reference/android/content/Intent#setPackage([Link])) specified for an Intent being
broadcast. Prior to that, it would be ignored and delivered to all matching registered
receivers. Be careful if using this for security.
For apps targeting Build.VERSION_CODES.UPSIDE_DOWN_CAKE
(/reference/android/os/Build.VERSION_CODES#UPSIDE_DOWN_CAKE) , eitherRECEIVER_EXPORTED
(/reference/android/content/Context#RECEIVER_EXPORTED) or RECEIVER_NOT_EXPORTED
(/reference/android/content/Context#RECEIVER_NOT_EXPORTED) must be specified if the
receiver is not being registered for system broadcasts
(/guide/components/broadcasts#system-broadcasts) or a SecurityException
(/reference/java/lang/SecurityException) will be thrown. See
registerReceiver([Link],
[Link], [Link], [Link], int)
[Link] 245/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link],%[Link],%[Link],%20int))
to register a receiver with flags.
Parameters
receiver BroadcastReceiver : The BroadcastReceiver to handle the
broadcast.
filter IntentFilter : Selects the Intent broadcasts to be received.
broadcastPermission String : String naming a permissions that a broadcaster must hold
in order to send an Intent to you. If null, no permission is required.
scheduler Handler : Handler identifying the thread that will receive the Intent.
If null, the main thread of the process will be used.
Returns
Intent The first sticky intent found that matches filter, or null if there are
(/reference/android/content/Intent) none.
See also:
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
unregisterReceiver(BroadcastReceiver)
(/reference/android/content/Context#unregisterReceiver([Link]))
[Link] 246/302
2/15/26, 8:49 PM Context | API reference | Android Developers
removeStickyBroadcast
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void removeStickyBroadcast (Intent (/reference/android/content/Intent)
This method was deprecated in API level 21.
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.
Remove the data previously sent with sendStickyBroadcast(Intent)
(/reference/android/content/Context#sendStickyBroadcast([Link])) , so that it is as
if the sticky broadcast had never happened.
Requires [Link].BROADCAST_STICKY
(/reference/android/[Link]#BROADCAST_STICKY)
Parameters
intent Intent : The Intent that was previously broadcast.
See also:
sendStickyBroadcast(Intent)
(/reference/android/content/Context#sendStickyBroadcast([Link]))
removeStickyBroadcastAsUser
Added in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void removeStickyBroadcastAsUser (Intent (/reference/android/content/
UserHandle (/reference/android/os/UserHandle) user)
[Link] 247/302
2/15/26, 8:49 PM Context | API reference | Android Developers
This method was deprecated in API level 21.
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.
Version of removeStickyBroadcast([Link])
(/reference/android/content/Context#removeStickyBroadcast([Link])) that allows
you to specify the user the broadcast will be sent to. This is not available to applications
that are not pre-installed on the system image.
You must hold the [Link].BROADCAST_STICKY
(/reference/android/[Link]#BROADCAST_STICKY) permission in order to use this
API. If you do not hold that permission, SecurityException
(/reference/java/lang/SecurityException) will be thrown.
Requires [Link].INTERACT_ACROSS_USERS and
[Link].BROADCAST_STICKY
(/reference/android/[Link]#BROADCAST_STICKY)
Parameters
intent Intent : The Intent that was previously broadcast.
user UserHandle : UserHandle to remove the sticky broadcast from.
See also:
sendStickyBroadcastAsUser(Intent, UserHandle)
(/reference/android/content/Context#sendStickyBroadcastAsUser([Link],%20android.
[Link]))
revokeSelfPermissionOnKill
Added in API level 33 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 248/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public void revokeSelfPermissionOnKill (String (/reference/java/lang/String) permName)
Triggers the asynchronous revocation of a runtime permission. If the permission is not
currently granted, nothing happens (even if later granted by the user).
Parameters
permName String : The name of the permission to be revoked.
This value cannot be null .
Throws
IllegalArgumentException if the permission is not a runtime permission
(/reference/java/lang/IllegalArgumentException)
See also:
revokeSelfPermissionsOnKill(Collection)
(/reference/android/content/Context#revokeSelfPermissionsOnKill([Link]<[Link]>
))
revokeSelfPermissionsOnKill
Added in API level 33 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public void revokeSelfPermissionsOnKill (Collection (/reference/java/util/Collection)<St
Triggers the revocation of one or more permissions for the calling package. A package is
only able to revoke runtime permissions. If a permission is not currently granted, it is
ignored and will not get revoked (even if later granted by the user). Ultimately, you should
[Link] 249/302
2/15/26, 8:49 PM Context | API reference | Android Developers
never make assumptions about a permission status as users may grant or revoke them at
any time.
Background permissions which have no corresponding foreground permission still
granted once the revocation is effective will also be revoked.
The revocation happens asynchronously and kills all processes running in the calling UID.
It will be triggered once it is safe to do so. In particular, it will not be triggered as long as
the package remains in the foreground, or has any active manifest components (e.g.
when another app is accessing a content provider in the package).
If you want to revoke the permissions right away, you could call [Link]() in
[Link] with a delay to allow completion of async IPC, But [Link]()
could affect other apps that are accessing your app at the moment. For example, apps
accessing a content provider in your app will all crash.
Note that the settings UI shows a permission group as granted as long as at least one
permission in the group is granted. If you want the user to observe the revocation in the
settings, you should revoke every permission in the target group. To learn the current list
of permissions in a group, you may use
[Link](String, Executor, Consumer)
(/reference/android/content/pm/PackageManager#getGroupOfPlatformPermission([Link],%2
[Link],%[Link]<[Link]>))
and [Link](String, Executor,
Consumer)
(/reference/android/content/pm/PackageManager#getPlatformPermissionsForGroup([Link],
%[Link],%[Link]<[Link]<[Link]>>))
. This list of permissions may evolve over time, so it is recommended to check whether it
contains any permission you wish to retain before trying to revoke an entire group.
Parameters
permissions Collection : Collection of permissions to be revoked.
This value cannot be null .
Throws
[Link] 250/302
2/15/26, 8:49 PM Context | API reference | Android Developers
IllegalArgumentException if any of the permissions is not a runtime permission
(/reference/java/lang/IllegalArgumentException)
See also:
[Link](String, Executor, Consumer)
(/reference/android/content/pm/PackageManager#getGroupOfPlatformPermission([Link],%2
[Link],%[Link]<[Link]>))
[Link](String, Executor, Consumer)
(/reference/android/content/pm/PackageManager#getPlatformPermissionsForGroup([Link],
%[Link],%[Link]<[Link]<[Link]>>))
revokeUriPermissionAdded in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void revokeUriPermission (Uri (/reference/android/net/Uri) uri,
int modeFlags)
Remove all permissions to access a particular content provider Uri that were previously
added with grantUriPermission(String, Uri, int)
(/reference/android/content/Context#grantUriPermission([Link],%[Link],%20int))
or any other mechanism. The given Uri will match all previously granted Uris that are the
same or a sub-path of the given Uri. That is, revoking "content://foo/target" will revoke
both "content://foo/target" and "content://foo/target/sub", but not "content://foo". It will
not remove any prefix grants that exist at a higher level.
Prior to Build.VERSION_CODES.LOLLIPOP
(/reference/android/os/Build.VERSION_CODES#LOLLIPOP) , if you did not have regular
permission access to a Uri, but had received access to it through a specific Uri permission
grant, you could not revoke that grant with this function and a SecurityException
(/reference/java/lang/SecurityException) would be thrown. As of
Build.VERSION_CODES.LOLLIPOP (/reference/android/os/Build.VERSION_CODES#LOLLIPOP) , this
function will not throw a security exception, but will remove whatever permission grants to
the Uri had been given to the app (or none).
[Link] 251/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Unlike revokeUriPermission([Link], [Link], int)
(/reference/android/content/Context#revokeUriPermission([Link],%[Link],%20int
))
, this method impacts all permission grants matching the given Uri, for any package they
had been granted to, through any mechanism this had happened (such as indirectly
through the clipboard, activity launch, service start, etc). That means this can be
potentially dangerous to use, as it can revoke grants that another app could be strongly
expecting to stick around.
Parameters
uri Uri : The Uri you would like to revoke access to.
modeFlags int : The access modes to revoke.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
See also:
grantUriPermission(String, Uri, int)
(/reference/android/content/Context#grantUriPermission([Link],%[Link],%20int))
revokeUriPermissionAdded in API level 26 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void revokeUriPermission (String (/reference/java/lang/String) toPacka
Uri (/reference/android/net/Uri) uri,
int modeFlags)
[Link] 252/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Remove permissions to access a particular content provider Uri that were previously
added with grantUriPermission(String, Uri, int)
(/reference/android/content/Context#grantUriPermission([Link],%[Link],%20int))
for a specific target package. The given Uri will match all previously granted Uris that are
the same or a sub-path of the given Uri. That is, revoking "content://foo/target" will revoke
both "content://foo/target" and "content://foo/target/sub", but not "content://foo". It will
not remove any prefix grants that exist at a higher level.
Unlike revokeUriPermission([Link], int)
(/reference/android/content/Context#revokeUriPermission([Link],%20int)) , this method will
only revoke permissions that had been explicitly granted through
grantUriPermission(String, Uri, int)
(/reference/android/content/Context#grantUriPermission([Link],%[Link],%20int))
and only for the package specified. Any matching grants that have happened through
other mechanisms (clipboard, activity launching, service starting, etc) will not be
removed.
Parameters
toPackage String : The package you had previously granted access to.
uri Uri : The Uri you would like to revoke access to.
modeFlags int : The access modes to revoke.
Value is either 0 or a combination of the following:
Intent.FLAG_GRANT_READ_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_READ_URI_PERM
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
(/reference/android/content/Intent#FLAG_GRANT_WRITE_URI_PER
See also:
grantUriPermission(String, Uri, int)
(/reference/android/content/Context#grantUriPermission([Link],%[Link],%20int))
[Link] 253/302
2/15/26, 8:49 PM Context | API reference | Android Developers
sendBroadcast Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public void sendBroadcast (Intent (/reference/android/content/Intent) intent,
String (/reference/java/lang/String) receiverPermission,
Bundle (/reference/android/os/Bundle) options)
Broadcast the given intent to all interested BroadcastReceivers, allowing an optional
required permission to be enforced. This call is asynchronous; it returns immediately, and
you will continue executing while the receivers are run. No results are propagated from
receivers and receivers can not abort the broadcast. If you want to allow receivers to
propagate results or abort the broadcast, you must send an ordered broadcast using
sendOrderedBroadcast([Link], [Link])
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
This value cannot be null .
receiverPermission String : (optional) String naming a permission that a receiver must
hold in order to receive your broadcast. If null, no permission is
required.
options Bundle : (optional) Additional sending options, generated from a
BroadcastOptions (/reference/android/app/BroadcastOptions).
This value may be null .
See also:
[Link] 254/302
2/15/26, 8:49 PM Context | API reference | Android Developers
BroadcastReceiver (/reference/android/content/BroadcastReceiver)
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
sendOrderedBroadcast(Intent, String)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int,
String, Bundle)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng,%[Link],%[Link],%20int,%[Link],%20an
[Link]))
sendBroadcast Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void sendBroadcast (Intent (/reference/android/content/Intent) intent,
String (/reference/java/lang/String) receiverPermission)
Broadcast the given intent to all interested BroadcastReceivers, allowing an optional
required permission to be enforced. This call is asynchronous; it returns immediately, and
you will continue executing while the receivers are run. No results are propagated from
receivers and receivers can not abort the broadcast. If you want to allow receivers to
propagate results or abort the broadcast, you must send an ordered broadcast using
sendOrderedBroadcast([Link], [Link])
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
Parameters
[Link] 255/302
2/15/26, 8:49 PM Context | API reference | Android Developers
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
receiverPermission String : (optional) String naming a permission that a receiver must
hold in order to receive your broadcast. If null, no permission is
required.
See also:
BroadcastReceiver (/reference/android/content/BroadcastReceiver)
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
sendOrderedBroadcast(Intent, String)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int,
String, Bundle)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng,%[Link],%[Link],%20int,%[Link],%20an
[Link]))
sendBroadcast Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void sendBroadcast (Intent (/reference/android/content/Intent) intent)
Broadcast the given intent to all interested BroadcastReceivers. This call is asynchronous;
it returns immediately, and you will continue executing while the receivers are run. No
results are propagated from receivers and receivers can not abort the broadcast. If you
want to allow receivers to propagate results or abort the broadcast, you must send an
ordered broadcast using sendOrderedBroadcast([Link],
[Link] 256/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link])
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
See also:
BroadcastReceiver (/reference/android/content/BroadcastReceiver)
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
sendBroadcast(Intent, String)
(/reference/android/content/Context#sendBroadcast([Link],%[Link]))
sendOrderedBroadcast(Intent, String)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int,
String, Bundle)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng,%[Link],%[Link],%20int,%[Link],%20an
[Link]))
sendBroadcastAsUser
Added in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void sendBroadcastAsUser (Intent (/reference/android/content/Intent) in
[Link] 257/302
2/15/26, 8:49 PM Context | API reference | Android Developers
UserHandle (/reference/android/os/UserHandle) user)
Version of sendBroadcast([Link])
(/reference/android/content/Context#sendBroadcast([Link])) that allows you to
specify the user the broadcast will be sent to. This is not available to applications that are
not pre-installed on the system image.
Requires [Link].INTERACT_ACROSS_USERS
Parameters
intent Intent : The intent to broadcast
user UserHandle : UserHandle to send the intent to.
See also:
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
sendBroadcastAsUser
Added in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void sendBroadcastAsUser (Intent (/reference/android/content/Intent) in
UserHandle (/reference/android/os/UserHandle) user,
String (/reference/java/lang/String) receiverPermission)
Version of sendBroadcast([Link], [Link])
(/reference/android/content/Context#sendBroadcast([Link],%[Link]))
that allows you to specify the user the broadcast will be sent to. This is not available to
applications that are not pre-installed on the system image.
Requires [Link].INTERACT_ACROSS_USERS
[Link] 258/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
user UserHandle : UserHandle to send the intent to.
receiverPermission String : (optional) String naming a permission that a receiver must
hold in order to receive your broadcast. If null, no permission is
required.
See also:
sendBroadcast(Intent, String)
(/reference/android/content/Context#sendBroadcast([Link],%[Link]))
sendBroadcastWithMultiplePermissions
Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public void sendBroadcastWithMultiplePermissions (Intent (/reference/android/content/
String[] (/reference/java/lang/String) receiverPermissions)
Broadcast the given intent to all interested BroadcastReceivers, allowing an array of
required permissions to be enforced. This call is asynchronous; it returns immediately, and
you will continue executing while the receivers are run. No results are propagated from
receivers and receivers can not abort the broadcast. If you want to allow receivers to
propagate results or abort the broadcast, you must send an ordered broadcast using
sendOrderedBroadcast([Link], [Link])
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
[Link] 259/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
This value cannot be null .
receiverPermissions String : Array of names of permissions that a receiver must hold in
order to receive your broadcast. If empty, no permissions are
required.
This value cannot be null .
See also:
BroadcastReceiver (/reference/android/content/BroadcastReceiver)
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
sendOrderedBroadcast(Intent, String)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int,
String, Bundle)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng,%[Link],%[Link],%20int,%[Link],%20an
[Link]))
sendOrderedBroadcast
Added in API level 30 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public void sendOrderedBroadcast (Intent (/reference/android/content/Intent) intent,
String (/reference/java/lang/String) receiverPermission,
String (/reference/java/lang/String) receiverAppOp,
BroadcastReceiver (/reference/android/content/BroadcastReceiver) resultR
Handler (/reference/android/os/Handler) scheduler,
[Link] 260/302
2/15/26, 8:49 PM Context | API reference | Android Developers
int initialCode,
String (/reference/java/lang/String) initialData,
Bundle (/reference/android/os/Bundle) initialExtras)
Version of sendOrderedBroadcast([Link], [Link],
[Link], [Link], int,
[Link], [Link])
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng,%[Link],%[Link],%20int,%[Link],%20an
[Link]))
that allows you to specify the App Op to enforce restrictions on which receivers the
broadcast will be sent to.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
This value cannot be null .
receiverPermission String : String naming a permissions that a receiver must hold in
order to receive your broadcast. If null, no permission is required.
receiverAppOp String : The app op associated with the broadcast. If null, no
appOp is required. If both receiverAppOp and receiverPermission are
non-null, a receiver must have both of them to receive the broadcast
resultReceiver BroadcastReceiver : Your own BroadcastReceiver to treat as the
final receiver of the broadcast.
This value may be null .
scheduler Handler : A custom Handler with which to schedule the
resultReceiver callback; if null it will be scheduled in the Context's
main thread.
[Link] 261/302
2/15/26, 8:49 PM Context | API reference | Android Developers
initialCode int : An initial value for the result code. Often Activity.RESULT_OK.
initialData String : An initial value for the result data. Often null.
initialExtras Bundle : An initial value for the result extras. Often null.
See also:
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int,
String, Bundle)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng,%[Link],%[Link],%20int,%[Link],%20an
[Link]))
sendOrderedBroadcast
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void sendOrderedBroadcast (Intent (/reference/android/content/Intent) i
String (/reference/java/lang/String) receiverPermission,
BroadcastReceiver (/reference/android/content/BroadcastReceiver) resultR
Handler (/reference/android/os/Handler) scheduler,
int initialCode,
String (/reference/java/lang/String) initialData,
Bundle (/reference/android/os/Bundle) initialExtras)
Version of sendBroadcast([Link])
(/reference/android/content/Context#sendBroadcast([Link])) that allows you to
receive data back from the broadcast. This is accomplished by supplying your own
BroadcastReceiver when calling, which will be treated as a final receiver at the end of the
broadcast -- its [Link]
(/reference/android/content/BroadcastReceiver#onReceive([Link],%[Link]
[Link]))
method will be called with the result values collected from the other receivers. The
broadcast will be serialized in the same way as calling
sendOrderedBroadcast([Link], [Link])
[Link] 262/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
.
Like sendBroadcast([Link])
(/reference/android/content/Context#sendBroadcast([Link])) , this method is
asynchronous; it will return before [Link]() is called.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
This value cannot be null .
receiverPermission String : String naming a permissions that a receiver must hold in
order to receive your broadcast. If null, no permission is required.
resultReceiver BroadcastReceiver : Your own BroadcastReceiver to treat as the
final receiver of the broadcast.
This value may be null .
scheduler Handler : A custom Handler with which to schedule the
resultReceiver callback; if null it will be scheduled in the Context's
main thread.
initialCode int : An initial value for the result code. Often Activity.RESULT_OK.
initialData String : An initial value for the result data. Often null.
initialExtras Bundle : An initial value for the result extras. Often null.
See also:
[Link] 263/302
2/15/26, 8:49 PM Context | API reference | Android Developers
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
sendBroadcast(Intent, String)
(/reference/android/content/Context#sendBroadcast([Link],%[Link]))
sendOrderedBroadcast(Intent, String)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
BroadcastReceiver (/reference/android/content/BroadcastReceiver)
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
Activity.RESULT_OK (/reference/android/app/Activity#RESULT_OK)
sendOrderedBroadcast
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public void sendOrderedBroadcast (Intent (/reference/android/content/Intent) intent,
String (/reference/java/lang/String) receiverPermission,
Bundle (/reference/android/os/Bundle) options)
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. This call is asynchronous; it returns immediately, and you will
continue executing while the receivers are run.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
This value cannot be null .
[Link] 264/302
2/15/26, 8:49 PM Context | API reference | Android Developers
receiverPermission String : (optional) String naming a permissions that a receiver must
hold in order to receive your broadcast. If null, no permission is
required.
options Bundle : (optional) Additional sending options, generated from a
BroadcastOptions (/reference/android/app/BroadcastOptions).
This value may be null .
See also:
BroadcastReceiver (/reference/android/content/BroadcastReceiver)
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int,
String, Bundle)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng,%[Link],%[Link],%20int,%[Link],%20an
[Link]))
sendOrderedBroadcast
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public void sendOrderedBroadcast (Intent (/reference/android/content/Intent) intent,
String (/reference/java/lang/String) receiverPermission,
Bundle (/reference/android/os/Bundle) options,
BroadcastReceiver (/reference/android/content/BroadcastReceiver) resultR
Handler (/reference/android/os/Handler) scheduler,
int initialCode,
String (/reference/java/lang/String) initialData,
Bundle (/reference/android/os/Bundle) initialExtras)
[Link] 265/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Version of sendBroadcast([Link])
(/reference/android/content/Context#sendBroadcast([Link])) that allows you to
receive data back from the broadcast. This is accomplished by supplying your own
BroadcastReceiver when calling, which will be treated as a final receiver at the end of the
broadcast -- its [Link]
(/reference/android/content/BroadcastReceiver#onReceive([Link],%[Link]
[Link]))
method will be called with the result values collected from the other receivers. The
broadcast will be serialized in the same way as calling
sendOrderedBroadcast([Link], [Link])
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
.
Like sendBroadcast([Link])
(/reference/android/content/Context#sendBroadcast([Link])) , this method is
asynchronous; it will return before [Link]() is called.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
This value cannot be null .
receiverPermission String : String naming a permissions that a receiver must hold in
order to receive your broadcast. If null, no permission is required.
options Bundle : (optional) Additional sending options, generated from a
BroadcastOptions (/reference/android/app/BroadcastOptions).
This value may be null .
resultReceiver BroadcastReceiver : Your own BroadcastReceiver to treat as the
final receiver of the broadcast.
This value may be null .
[Link] 266/302
2/15/26, 8:49 PM Context | API reference | Android Developers
scheduler Handler : A custom Handler with which to schedule the
resultReceiver callback; if null it will be scheduled in the Context's
main thread.
initialCode int : An initial value for the result code. Often Activity.RESULT_OK.
initialData String : An initial value for the result data. Often null.
initialExtras Bundle : An initial value for the result extras. Often null.
See also:
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
sendBroadcast(Intent, String)
(/reference/android/content/Context#sendBroadcast([Link],%[Link]))
sendOrderedBroadcast(Intent, String)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
BroadcastReceiver (/reference/android/content/BroadcastReceiver)
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
Activity.RESULT_OK (/reference/android/app/Activity#RESULT_OK)
sendOrderedBroadcast
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void sendOrderedBroadcast (Intent (/reference/android/content/Intent) i
String (/reference/java/lang/String) receiverPermission)
[Link] 267/302
2/15/26, 8:49 PM Context | API reference | Android Developers
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. This call is asynchronous; it returns immediately, and you will
continue executing while the receivers are run.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
receiverPermission String : (optional) String naming a permissions that a receiver must
hold in order to receive your broadcast. If null, no permission is
required.
See also:
BroadcastReceiver (/reference/android/content/BroadcastReceiver)
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int,
String, Bundle)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng,%[Link],%[Link],%20int,%[Link],%20an
[Link]))
sendOrderedBroadcastAsUser
Added in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 268/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public abstract void sendOrderedBroadcastAsUser (Intent (/reference/android/content/In
UserHandle (/reference/android/os/UserHandle) user,
String (/reference/java/lang/String) receiverPermission,
BroadcastReceiver (/reference/android/content/BroadcastReceiver) resultR
Handler (/reference/android/os/Handler) scheduler,
int initialCode,
String (/reference/java/lang/String) initialData,
Bundle (/reference/android/os/Bundle) initialExtras)
Version of sendOrderedBroadcast([Link], [Link],
[Link], [Link], int,
[Link], [Link])
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng,%[Link],%[Link],%20int,%[Link],%20an
[Link]))
that allows you to specify the user the broadcast will be sent to. This is not available to
applications that are not pre-installed on the system image.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
Requires [Link].INTERACT_ACROSS_USERS
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
user UserHandle : UserHandle to send the intent to.
receiverPermission String : String naming a permissions that a receiver must hold in
order to receive your broadcast. If null, no permission is required.
resultReceiver BroadcastReceiver : Your own BroadcastReceiver to treat as the
final receiver of the broadcast.
[Link] 269/302
2/15/26, 8:49 PM Context | API reference | Android Developers
scheduler Handler : A custom Handler with which to schedule the
resultReceiver callback; if null it will be scheduled in the Context's
main thread.
initialCode int : An initial value for the result code. Often Activity.RESULT_OK.
initialData String : An initial value for the result data. Often null.
initialExtras Bundle : An initial value for the result extras. Often null.
See also:
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int,
String, Bundle)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng,%[Link],%[Link],%20int,%[Link],%20an
[Link]))
sendStickyBroadcast
Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void sendStickyBroadcast (Intent (/reference/android/content/Intent) in
This method was deprecated in API level 21.
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.
Perform a sendBroadcast([Link])
(/reference/android/content/Context#sendBroadcast([Link])) that is "sticky,"
meaning the Intent you are sending stays around after the broadcast is complete, so that
[Link] 270/302
2/15/26, 8:49 PM Context | API reference | Android Developers
others can quickly retrieve that data through the return value of
registerReceiver([Link],
[Link])
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
. In all other ways, this behaves the same as sendBroadcast([Link])
(/reference/android/content/Context#sendBroadcast([Link])) .
Requires [Link].BROADCAST_STICKY
(/reference/android/[Link]#BROADCAST_STICKY)
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast, and the Intent will be held to be re-
broadcast to future receivers.
See also:
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
sendStickyOrderedBroadcast(Intent, BroadcastReceiver, Handler, int, String,
Bundle)
(/reference/android/content/Context#sendStickyOrderedBroadcast([Link],%20androi
[Link],%[Link],%20int,%[Link],%[Link]
e))
sendStickyBroadcast
Added in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 31 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public void sendStickyBroadcast (Intent (/reference/android/content/Intent) intent,
Bundle (/reference/android/os/Bundle) options)
This method was deprecated in API level 31.
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
[Link] 271/302
2/15/26, 8:49 PM Context | API reference | Android Developers
non-sticky broadcast to report that something has changed, with another mechanism for apps to
retrieve the current value whenever desired.
Perform a sendBroadcast([Link])
(/reference/android/content/Context#sendBroadcast([Link])) that is "sticky,"
meaning the Intent you are sending stays around after the broadcast is complete, so that
others can quickly retrieve that data through the return value of
registerReceiver([Link],
[Link])
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
. In all other ways, this behaves the same as sendBroadcast([Link])
(/reference/android/content/Context#sendBroadcast([Link])) .
Requires [Link].BROADCAST_STICKY
(/reference/android/[Link]#BROADCAST_STICKY)
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast, and the Intent will be held to be re-
broadcast to future receivers.
This value cannot be null .
options Bundle : (optional) Additional sending options, generated from a
BroadcastOptions (/reference/android/app/BroadcastOptions).
This value may be null .
See also:
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
sendStickyOrderedBroadcast(Intent, BroadcastReceiver, Handler, int, String,
Bundle)
(/reference/android/content/Context#sendStickyOrderedBroadcast([Link],%20androi
[Link],%[Link],%20int,%[Link],%[Link]
e))
[Link] 272/302
2/15/26, 8:49 PM Context | API reference | Android Developers
sendStickyBroadcastAsUser
Added in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void sendStickyBroadcastAsUser (Intent (/reference/android/content/Int
UserHandle (/reference/android/os/UserHandle) user)
This method was deprecated in API level 21.
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.
Version of sendStickyBroadcast([Link])
(/reference/android/content/Context#sendStickyBroadcast([Link])) that allows you
to specify the user the broadcast will be sent to. This is not available to applications that
are not pre-installed on the system image.
Requires [Link].INTERACT_ACROSS_USERS and
[Link].BROADCAST_STICKY
(/reference/android/[Link]#BROADCAST_STICKY)
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast, and the Intent will be held to be re-
broadcast to future receivers.
user UserHandle : UserHandle to send the intent to.
See also:
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
[Link] 273/302
2/15/26, 8:49 PM Context | API reference | Android Developers
sendStickyOrderedBroadcast
Added in API level 5 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void sendStickyOrderedBroadcast (Intent (/reference/android/content/In
BroadcastReceiver (/reference/android/content/BroadcastReceiver) resultR
Handler (/reference/android/os/Handler) scheduler,
int initialCode,
String (/reference/java/lang/String) initialData,
Bundle (/reference/android/os/Bundle) initialExtras)
This method was deprecated in API level 21.
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.
Version of sendStickyBroadcast(Intent)
(/reference/android/content/Context#sendStickyBroadcast([Link])) that allows you
to receive data back from the broadcast. This is accomplished by supplying your own
BroadcastReceiver when calling, which will be treated as a final receiver at the end of the
broadcast -- its [Link]
(/reference/android/content/BroadcastReceiver#onReceive([Link],%[Link]
[Link]))
method will be called with the result values collected from the other receivers. The
broadcast will be serialized in the same way as calling
sendOrderedBroadcast([Link], [Link])
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
.
Like sendBroadcast([Link])
(/reference/android/content/Context#sendBroadcast([Link])) , this method is
asynchronous; it will return before [Link]() is called. Note that the
sticky data stored is only the data you initially supply to the broadcast, not the result of
any changes made by the receivers.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
[Link] 274/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Requires [Link].BROADCAST_STICKY
(/reference/android/[Link]#BROADCAST_STICKY)
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
resultReceiver BroadcastReceiver : Your own BroadcastReceiver to treat as the
final receiver of the broadcast.
scheduler Handler : A custom Handler with which to schedule the
resultReceiver callback; if null it will be scheduled in the Context's
main thread.
initialCode int : An initial value for the result code. Often Activity.RESULT_OK.
initialData String : An initial value for the result data. Often null.
initialExtras Bundle : An initial value for the result extras. Often null.
See also:
sendBroadcast(Intent)
(/reference/android/content/Context#sendBroadcast([Link]))
sendBroadcast(Intent, String)
(/reference/android/content/Context#sendBroadcast([Link],%[Link]))
sendOrderedBroadcast(Intent, String)
(/reference/android/content/Context#sendOrderedBroadcast([Link],%[Link]
ng))
sendStickyBroadcast(Intent)
(/reference/android/content/Context#sendStickyBroadcast([Link]))
BroadcastReceiver (/reference/android/content/BroadcastReceiver)
[Link] 275/302
2/15/26, 8:49 PM Context | API reference | Android Developers
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
Activity.RESULT_OK (/reference/android/app/Activity#RESULT_OK)
sendStickyOrderedBroadcastAsUser
Added in API level 17 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 21 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void sendStickyOrderedBroadcastAsUser (Intent (/reference/android/c
UserHandle (/reference/android/os/UserHandle) user,
BroadcastReceiver (/reference/android/content/BroadcastReceiver) resultR
Handler (/reference/android/os/Handler) scheduler,
int initialCode,
String (/reference/java/lang/String) initialData,
Bundle (/reference/android/os/Bundle) initialExtras)
This method was deprecated in API level 21.
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.
Version of sendStickyOrderedBroadcast([Link],
[Link], [Link], int,
[Link], [Link])
(/reference/android/content/Context#sendStickyOrderedBroadcast([Link],%20androi
[Link],%[Link],%20int,%[Link],%[Link]
e))
that allows you to specify the user the broadcast will be sent to. This is not available to
applications that are not pre-installed on the system image.
See BroadcastReceiver (/reference/android/content/BroadcastReceiver) for more information
on Intent broadcasts.
Requires [Link].INTERACT_ACROSS_USERS and
[Link].BROADCAST_STICKY
(/reference/android/[Link]#BROADCAST_STICKY)
[Link] 276/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Parameters
intent Intent : The Intent to broadcast; all receivers matching this Intent
will receive the broadcast.
user UserHandle : UserHandle to send the intent to.
resultReceiver BroadcastReceiver : Your own BroadcastReceiver to treat as the
final receiver of the broadcast.
scheduler Handler : A custom Handler with which to schedule the
resultReceiver callback; if null it will be scheduled in the Context's
main thread.
initialCode int : An initial value for the result code. Often Activity.RESULT_OK.
initialData String : An initial value for the result data. Often null.
initialExtras Bundle : An initial value for the result extras. Often null.
See also:
sendStickyOrderedBroadcast(Intent, BroadcastReceiver, Handler, int, String,
Bundle)
(/reference/android/content/Context#sendStickyOrderedBroadcast([Link],%20androi
[Link],%[Link],%20int,%[Link],%[Link]
e))
setTheme Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 277/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public abstract void setTheme (int resid)
Set the base theme for this context. Note that this should be called before any views are
instantiated in the Context (for example before calling [Link](View)
(/reference/android/app/Activity#setContentView([Link])) or
[Link](int, ViewGroup)
(/reference/android/view/LayoutInflater#inflate(int,%[Link])) ).
Parameters
resid int : The style resource describing the theme.
setWallpaper Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 15 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void setWallpaper (Bitmap (/reference/android/graphics/Bitmap) bitmap)
This method was deprecated in API level 15.
Use [Link]()
(/reference/android/app/WallpaperManager#setBitmap([Link])) instead.
This method requires the caller to hold the permission
[Link].SET_WALLPAPER
(/reference/android/[Link]#SET_WALLPAPER) .
Parameters
bitmap Bitmap
[Link] 278/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Throws
IOException
(/reference/java/io/IOException)
setWallpaper Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in API level 15 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void setWallpaper (InputStream (/reference/java/io/InputStream) data)
This method was deprecated in API level 15.
Use [Link]()
(/reference/android/app/WallpaperManager#setStream([Link])) instead.
This method requires the caller to hold the permission
[Link].SET_WALLPAPER
(/reference/android/[Link]#SET_WALLPAPER) .
Parameters
data InputStream
Throws
IOException
(/reference/java/io/IOException)
startActivities Added in API level 16 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 279/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public abstract void startActivities (Intent[] (/reference/android/content/Intent) inte
Bundle (/reference/android/os/Bundle) options)
Launch multiple new activities. This is generally the same as calling
startActivity([Link])
(/reference/android/content/Context#startActivity([Link])) for the first Intent in the
array, that activity during its creation calling startActivity([Link])
(/reference/android/content/Context#startActivity([Link])) for the second entry,
etc. Note that unlike that approach, generally none of the activities except the last in the
array will be created at this point, but rather will be created when the user first visits them
(due to pressing back from the activity on top).
This method throws ActivityNotFoundException
(/reference/android/content/ActivityNotFoundException) if there was no Activity found for any
given Intent. In this case the state of the activity stack is undefined (some Intents in the
list may be on it, some not), so you probably want to avoid such situations.
Parameters
intents Intent : An array of Intents to be started.
options Bundle : Additional options for how the Activity should be started. Se
startActivity(Intent, Bundle)
(/reference/android/content/Context#startActivity([Link]
[Link](Intent, Bundle)} for more details.
Throws
ActivityNotFoundException
(/reference/android/content/ActivityNotFoundException)
See also:
[Link] 280/302
2/15/26, 8:49 PM Context | API reference | Android Developers
startActivities(Intent[])
(/reference/android/content/Context#startActivities([Link][]))
[Link](Intent, ResolveInfoFlags)
(/reference/android/content/pm/PackageManager#resolveActivity([Link],%20android.
[Link]))
startActivities Added in API level 11 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void startActivities (Intent[] (/reference/android/content/Intent) inte
Same as startActivities([Link][], [Link])
(/reference/android/content/Context#startActivities([Link][],%[Link]))
with no options specified.
Parameters
intents Intent : An array of Intents to be started.
Throws
ActivityNotFoundException
(/reference/android/content/ActivityNotFoundException)
See also:
startActivities(Intent[], Bundle)
(/reference/android/content/Context#startActivities([Link][],%[Link]))
[Link](Intent, ResolveInfoFlags)
(/reference/android/content/pm/PackageManager#resolveActivity([Link],%20android.
[Link]))
[Link] 281/302
2/15/26, 8:49 PM Context | API reference | Android Developers
startActivity Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void startActivity (Intent (/reference/android/content/Intent) intent)
Same as startActivity([Link], [Link])
(/reference/android/content/Context#startActivity([Link],%[Link]))
with no options specified.
Parameters
intent Intent : The description of the activity to start.
Throws
ActivityNotFoundException `
(/reference/android/content/ActivityNotFoundException)
See also:
startActivity(Intent, Bundle)
(/reference/android/content/Context#startActivity([Link],%[Link]))
[Link](Intent, ResolveInfoFlags)
(/reference/android/content/pm/PackageManager#resolveActivity([Link],%20android.
[Link]))
startActivity Added in API level 16 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void startActivity (Intent (/reference/android/content/Intent) intent,
Bundle (/reference/android/os/Bundle) options)
[Link] 282/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Launch a new activity. You will not receive any information about when the activity exits.
Note that if this method is being called from outside of an Activity
(/reference/android/app/Activity) Context, then the Intent must include the
Intent.FLAG_ACTIVITY_NEW_TASK
(/reference/android/content/Intent#FLAG_ACTIVITY_NEW_TASK) launch flag. This is because,
without being started from an existing Activity, there is no existing task in which to place
the new activity and thus it needs to be placed in its own separate task.
This method throws ActivityNotFoundException
(/reference/android/content/ActivityNotFoundException) if there was no Activity found to run the
given Intent.
Parameters
intent Intent : The description of the activity to start.
options Bundle : Additional options for how the Activity should be started.
May be null if there are no options. See ActivityOptions
(/reference/android/app/ActivityOptions) for how to build the Bundle
supplied here; there are no supported definitions for building it
manually.
Throws
ActivityNotFoundException
(/reference/android/content/ActivityNotFoundException)
See also:
startActivity(Intent)
(/reference/android/content/Context#startActivity([Link]))
[Link](Intent, ResolveInfoFlags)
(/reference/android/content/pm/PackageManager#resolveActivity([Link],%20android.
[Link]))
[Link] 283/302
2/15/26, 8:49 PM Context | API reference | Android Developers
startForegroundService
Added in API level 26 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract ComponentName (/reference/android/content/ComponentName) startForegro
Similar to startService([Link])
(/reference/android/content/Context#startService([Link])) , but with an implicit
promise that the Service will call startForeground(int, [Link])
(/reference/android/app/Service#startForeground(int,%[Link])) once it begins
running. The service is given an amount of time comparable to the ANR interval to do this,
otherwise the system will automatically crash the process, in which case an internal
exception ForegroundServiceDidNotStartInTimeException is logged on logcat on
devices running SDK Version Build.VERSION_CODES.S
(/reference/android/os/Build.VERSION_CODES#S) or later. On older Android versions, an internal
exception RemoteServiceException is logged instead, with a corresponding message.
Unlike the ordinary startService([Link])
(/reference/android/content/Context#startService([Link])) , this method can be
used at any time, regardless of whether the app hosting the service is in a foreground
state.
Note: Beginning with SDK Version Build.VERSION_CODES.S
(/reference/android/os/Build.VERSION_CODES#S), apps targeting SDK Version
Build.VERSION_CODES.S (/reference/android/os/Build.VERSION_CODES#S) or higher are not allowed
to start foreground services from the background. See Behavior changes: Apps targeting Android 12
(/about/versions/12/behavior-changes-12) for more details.
Parameters
service Intent : Identifies the service to be started. The Intent must be fully
explicit (supplying a component name). Additional values may be
included in the Intent extras to supply arguments along with this
specific start call.
[Link] 284/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Returns
ComponentName If the service is being started or is already running, the
(/reference/android/content/ComponentName) ComponentName
(/reference/android/content/ComponentName) of the
actual service that was started is returned; else if the
service does not exist null is returned.
Throws
ForegroundServiceStartNotAllowedException If the caller app's targeting API i
(/reference/android/app/ForegroundServiceStartNotAllowedException) Build.VERSION_CODES.S
(/reference/android/os/[Link]
or later, and the foreground serv
from start due to background re
SecurityException (/reference/java/lang/SecurityException) If the caller does not have perm
the service or the service can no
See also:
stopService(Intent) (/reference/android/content/Context#stopService([Link]))
[Link](int, [Link])
(/reference/android/app/Service#startForeground(int,%[Link]))
startInstrumentationAdded in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract boolean startInstrumentation (ComponentName (/reference/android/cont
String (/reference/java/lang/String) profileFile,
Bundle (/reference/android/os/Bundle) arguments)
[Link] 285/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Start executing an Instrumentation (/reference/android/app/Instrumentation) class. The given
Instrumentation component will be run by killing its target application (if currently
running), starting the target process, instantiating the instrumentation component, and
then letting it drive the application.
This function is not synchronous -- it returns as soon as the instrumentation has started
and while it is running.
Instrumentation is normally only allowed to run against a package that is either unsigned
or signed with a signature that the the instrumentation package is also signed with
(ensuring the target trusts the instrumentation).
Parameters
className ComponentName : Name of the Instrumentation component to be
run.
This value cannot be null .
profileFile String : Optional path to write profiling data as the instrumentation
runs, or null for no profiling.
arguments Bundle : Additional optional arguments to pass to the
instrumentation, or null.
Returns
boolean true if the instrumentation was successfully started, else false if
it could not be found.
startIntentSender Added in API level 5 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 286/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public abstract void startIntentSender (IntentSender (/reference/android/content/Inten
Intent (/reference/android/content/Intent) fillInIntent,
int flagsMask,
int flagsValues,
int extraFlags)
Same as startIntentSender([Link],
[Link], int, int, int, [Link])
(/reference/android/content/Context#startIntentSender([Link],%[Link]
[Link],%20int,%20int,%20int,%[Link]))
with no options specified.
Parameters
intent IntentSender : The IntentSender to launch.
fillInIntent Intent : If non-null, this will be provided as the intent parameter to I
(/reference/android/content/IntentSender#sendIntent([Link]
.
flagsMask int : Intent flags in the original IntentSender that you would like to ch
Value is either 0 or a combination of the following:
Intent.FLAG_FROM_BACKGROUND (/reference/android/content/In
Intent.FLAG_DEBUG_LOG_RESOLUTION (/reference/android/con
Intent.FLAG_EXCLUDE_STOPPED_PACKAGES (/reference/andro
Intent.FLAG_INCLUDE_STOPPED_PACKAGES (/reference/andro
Intent.FLAG_ACTIVITY_MATCH_EXTERNAL (/reference/android
Intent.FLAG_ACTIVITY_NO_HISTORY (/reference/android/cont
Intent.FLAG_ACTIVITY_SINGLE_TOP (/reference/android/cont
Intent.FLAG_ACTIVITY_NEW_TASK (/reference/android/conten
Intent.FLAG_ACTIVITY_MULTIPLE_TASK (/reference/android/c
Intent.FLAG_ACTIVITY_CLEAR_TOP (/reference/android/conte
Intent.FLAG_ACTIVITY_FORWARD_RESULT (/reference/android
[Link] 287/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Intent.FLAG_ACTIVITY_PREVIOUS_IS_TOP (/reference/andro
Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS (/reference
Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT (/reference/andr
Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED (/reference
Intent.FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY (/referenc
Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET (/referenc
Intent.FLAG_ACTIVITY_NEW_DOCUMENT (/reference/android/co
Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET (/referenc
Intent.FLAG_ACTIVITY_NO_USER_ACTION (/reference/android
Intent.FLAG_ACTIVITY_REORDER_TO_FRONT (/reference/andr
Intent.FLAG_ACTIVITY_NO_ANIMATION (/reference/android/co
Intent.FLAG_ACTIVITY_CLEAR_TASK (/reference/android/cont
Intent.FLAG_ACTIVITY_TASK_ON_HOME (/reference/android/co
Intent.FLAG_ACTIVITY_RETAIN_IN_RECENTS (/reference/and
Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT (/reference/andro
Intent.FLAG_RECEIVER_REGISTERED_ONLY (/reference/andro
Intent.FLAG_RECEIVER_REPLACE_PENDING (/reference/andro
Intent.FLAG_RECEIVER_FOREGROUND (/reference/android/cont
Intent.FLAG_RECEIVER_NO_ABORT (/reference/android/conten
Intent.FLAG_RECEIVER_VISIBLE_TO_INSTANT_APPS (/refere
flagsValues int : Desired values for any bits set in flagsMask.
Value is either 0 or a combination of the following:
Intent.FLAG_FROM_BACKGROUND (/reference/android/content/In
Intent.FLAG_DEBUG_LOG_RESOLUTION (/reference/android/con
Intent.FLAG_EXCLUDE_STOPPED_PACKAGES (/reference/andro
Intent.FLAG_INCLUDE_STOPPED_PACKAGES (/reference/andro
Intent.FLAG_ACTIVITY_MATCH_EXTERNAL (/reference/android
Intent.FLAG_ACTIVITY_NO_HISTORY (/reference/android/cont
Intent.FLAG_ACTIVITY_SINGLE_TOP (/reference/android/cont
Intent.FLAG_ACTIVITY_NEW_TASK (/reference/android/conten
[Link] 288/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Intent.FLAG_ACTIVITY_MULTIPLE_TASK (/reference/android/c
Intent.FLAG_ACTIVITY_CLEAR_TOP (/reference/android/conte
Intent.FLAG_ACTIVITY_FORWARD_RESULT (/reference/android
Intent.FLAG_ACTIVITY_PREVIOUS_IS_TOP (/reference/andro
Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS (/reference
Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT (/reference/andr
Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED (/reference
Intent.FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY (/referenc
Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET (/referenc
Intent.FLAG_ACTIVITY_NEW_DOCUMENT (/reference/android/co
Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET (/referenc
Intent.FLAG_ACTIVITY_NO_USER_ACTION (/reference/android
Intent.FLAG_ACTIVITY_REORDER_TO_FRONT (/reference/andr
Intent.FLAG_ACTIVITY_NO_ANIMATION (/reference/android/co
Intent.FLAG_ACTIVITY_CLEAR_TASK (/reference/android/cont
Intent.FLAG_ACTIVITY_TASK_ON_HOME (/reference/android/co
Intent.FLAG_ACTIVITY_RETAIN_IN_RECENTS (/reference/and
Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT (/reference/andro
Intent.FLAG_RECEIVER_REGISTERED_ONLY (/reference/andro
Intent.FLAG_RECEIVER_REPLACE_PENDING (/reference/andro
Intent.FLAG_RECEIVER_FOREGROUND (/reference/android/cont
Intent.FLAG_RECEIVER_NO_ABORT (/reference/android/conten
Intent.FLAG_RECEIVER_VISIBLE_TO_INSTANT_APPS (/refere
extraFlags int : Always set to 0.
Throws
[Link] 289/302
2/15/26, 8:49 PM Context | API reference | Android Developers
[Link]
(/reference/android/content/[Link])
See also:
startActivity(Intent)
(/reference/android/content/Context#startActivity([Link]))
startIntentSender(IntentSender, Intent, int, int, int, Bundle)
(/reference/android/content/Context#startIntentSender([Link],%[Link]
[Link],%20int,%20int,%20int,%[Link]))
startIntentSender Added in API level 16 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void startIntentSender (IntentSender (/reference/android/content/Inten
Intent (/reference/android/content/Intent) fillInIntent,
int flagsMask,
int flagsValues,
int extraFlags,
Bundle (/reference/android/os/Bundle) options)
Like startActivity([Link], [Link])
(/reference/android/content/Context#startActivity([Link],%[Link])) ,
but taking a IntentSender to start. If the IntentSender is for an activity, that activity will be
started as if you had called the regular startActivity([Link])
(/reference/android/content/Context#startActivity([Link])) here; otherwise, its
associated action will be executed (such as sending a broadcast) as if you had called
[Link]
(/reference/android/content/IntentSender#sendIntent([Link],%20int,%[Link]
[Link],%[Link],%[Link]))
on it.
Parameters
[Link] 290/302
2/15/26, 8:49 PM Context | API reference | Android Developers
intent IntentSender : The IntentSender to launch.
fillInIntent Intent : If non-null, this will be provided as the intent parameter to I
(/reference/android/content/IntentSender#sendIntent([Link]
.
flagsMask int : Intent flags in the original IntentSender that you would like to ch
Value is either 0 or a combination of the following:
Intent.FLAG_FROM_BACKGROUND (/reference/android/content/In
Intent.FLAG_DEBUG_LOG_RESOLUTION (/reference/android/con
Intent.FLAG_EXCLUDE_STOPPED_PACKAGES (/reference/andro
Intent.FLAG_INCLUDE_STOPPED_PACKAGES (/reference/andro
Intent.FLAG_ACTIVITY_MATCH_EXTERNAL (/reference/android
Intent.FLAG_ACTIVITY_NO_HISTORY (/reference/android/cont
Intent.FLAG_ACTIVITY_SINGLE_TOP (/reference/android/cont
Intent.FLAG_ACTIVITY_NEW_TASK (/reference/android/conten
Intent.FLAG_ACTIVITY_MULTIPLE_TASK (/reference/android/c
Intent.FLAG_ACTIVITY_CLEAR_TOP (/reference/android/conte
Intent.FLAG_ACTIVITY_FORWARD_RESULT (/reference/android
Intent.FLAG_ACTIVITY_PREVIOUS_IS_TOP (/reference/andro
Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS (/reference
Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT (/reference/andr
Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED (/reference
Intent.FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY (/referenc
Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET (/referenc
Intent.FLAG_ACTIVITY_NEW_DOCUMENT (/reference/android/co
Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET (/referenc
Intent.FLAG_ACTIVITY_NO_USER_ACTION (/reference/android
Intent.FLAG_ACTIVITY_REORDER_TO_FRONT (/reference/andr
Intent.FLAG_ACTIVITY_NO_ANIMATION (/reference/android/co
Intent.FLAG_ACTIVITY_CLEAR_TASK (/reference/android/cont
[Link] 291/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Intent.FLAG_ACTIVITY_TASK_ON_HOME (/reference/android/co
Intent.FLAG_ACTIVITY_RETAIN_IN_RECENTS (/reference/and
Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT (/reference/andro
Intent.FLAG_RECEIVER_REGISTERED_ONLY (/reference/andro
Intent.FLAG_RECEIVER_REPLACE_PENDING (/reference/andro
Intent.FLAG_RECEIVER_FOREGROUND (/reference/android/cont
Intent.FLAG_RECEIVER_NO_ABORT (/reference/android/conten
Intent.FLAG_RECEIVER_VISIBLE_TO_INSTANT_APPS (/refere
flagsValues int : Desired values for any bits set in flagsMask.
Value is either 0 or a combination of the following:
Intent.FLAG_FROM_BACKGROUND (/reference/android/content/In
Intent.FLAG_DEBUG_LOG_RESOLUTION (/reference/android/con
Intent.FLAG_EXCLUDE_STOPPED_PACKAGES (/reference/andro
Intent.FLAG_INCLUDE_STOPPED_PACKAGES (/reference/andro
Intent.FLAG_ACTIVITY_MATCH_EXTERNAL (/reference/android
Intent.FLAG_ACTIVITY_NO_HISTORY (/reference/android/cont
Intent.FLAG_ACTIVITY_SINGLE_TOP (/reference/android/cont
Intent.FLAG_ACTIVITY_NEW_TASK (/reference/android/conten
Intent.FLAG_ACTIVITY_MULTIPLE_TASK (/reference/android/c
Intent.FLAG_ACTIVITY_CLEAR_TOP (/reference/android/conte
Intent.FLAG_ACTIVITY_FORWARD_RESULT (/reference/android
Intent.FLAG_ACTIVITY_PREVIOUS_IS_TOP (/reference/andro
Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS (/reference
Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT (/reference/andr
Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED (/reference
Intent.FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY (/referenc
Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET (/referenc
Intent.FLAG_ACTIVITY_NEW_DOCUMENT (/reference/android/co
Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET (/referenc
Intent.FLAG_ACTIVITY_NO_USER_ACTION (/reference/android
[Link] 292/302
2/15/26, 8:49 PM Context | API reference | Android Developers
Intent.FLAG_ACTIVITY_REORDER_TO_FRONT (/reference/andr
Intent.FLAG_ACTIVITY_NO_ANIMATION (/reference/android/co
Intent.FLAG_ACTIVITY_CLEAR_TASK (/reference/android/cont
Intent.FLAG_ACTIVITY_TASK_ON_HOME (/reference/android/co
Intent.FLAG_ACTIVITY_RETAIN_IN_RECENTS (/reference/and
Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT (/reference/andro
Intent.FLAG_RECEIVER_REGISTERED_ONLY (/reference/andro
Intent.FLAG_RECEIVER_REPLACE_PENDING (/reference/andro
Intent.FLAG_RECEIVER_FOREGROUND (/reference/android/cont
Intent.FLAG_RECEIVER_NO_ABORT (/reference/android/conten
Intent.FLAG_RECEIVER_VISIBLE_TO_INSTANT_APPS (/refere
extraFlags int : Always set to 0.
options Bundle : Additional options for how the Activity should be started. Se
(/reference/android/content/Context#startActivity([Link]
supplied by the IntentSender, options given here will override any that
This value may be null .
Throws
[Link]
(/reference/android/content/[Link])
See also:
startActivity(Intent, Bundle)
(/reference/android/content/Context#startActivity([Link],%[Link]))
startIntentSender(IntentSender, Intent, int, int, int)
(/reference/android/content/Context#startIntentSender([Link],%[Link]
[Link],%20int,%20int,%20int))
[Link] 293/302
2/15/26, 8:49 PM Context | API reference | Android Developers
startService Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract ComponentName (/reference/android/content/ComponentName) startService
Request that a given application service be started. The Intent should either contain the
complete class name of a specific service implementation to start, or a specific package
name to target. If the Intent is less specified, it logs a warning about this. In this case any
of the multiple matching services may be used. If this service is not already running, it will
be instantiated and started (creating a process for it if needed); if it is running then it
remains running.
Every call to this method will result in a corresponding call to the target service's
[Link](Intent, int, int)
(/reference/android/app/Service#onStartCommand([Link],%20int,%20int)) method,
with the intent given here. This provides a convenient way to submit jobs to a service
without having to bind and call on to its interface.
Using startService() overrides the default service lifetime that is managed by
bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
: it requires the service to remain running until stopService(Intent)
(/reference/android/content/Context#stopService([Link])) is called, regardless of
whether any clients are connected to it. Note that calls to startService() do not nest: no
matter how many times you call startService(), a single call to stopService(Intent)
(/reference/android/content/Context#stopService([Link])) will stop it.
The system attempts to keep running services around as much as possible. The only time
they should be stopped is if the current foreground application is using so many
resources that the service needs to be killed. If any errors happen in the service's
process, it will automatically be restarted.
This function will throw SecurityException (/reference/java/lang/SecurityException) if you do
not have permission to start the given service.
Note: Each call to startService() results in significant work done by the system to manage service
lifecycle surrounding the processing of the intent, which can take multiple milliseconds of CPU time.
Due to this cost, startService() should not be used for frequent intent delivery to a service, and only for
[Link] 294/302
2/15/26, 8:49 PM Context | API reference | Android Developers
scheduling significant work. Use bound services
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
for high frequency calls.
Beginning with SDK Version Build.VERSION_CODES.O
(/reference/android/os/Build.VERSION_CODES#O), apps targeting SDK Version
Build.VERSION_CODES.O (/reference/android/os/Build.VERSION_CODES#O) or higher are not allowed
to start background services from the background. See Background Execution Limits
(/about/versions/oreo/background) for more details.
Note: Beginning with SDK Version Build.VERSION_CODES.S
(/reference/android/os/Build.VERSION_CODES#S), apps targeting SDK Version
Build.VERSION_CODES.S (/reference/android/os/Build.VERSION_CODES#S) or higher are not allowed
to start foreground services from the background. See Behavior changes: Apps targeting Android 12
(/about/versions/12/behavior-changes-12) for more details.
Parameters
service Intent : Identifies the service to be started. The Intent must be fully
explicit (supplying a component name). Additional values may be
included in the Intent extras to supply arguments along with this
specific start call.
Returns
ComponentName If the service is being started or is already running, the
(/reference/android/content/ComponentName) ComponentName
(/reference/android/content/ComponentName) of the
actual service that was started is returned; else if the
service does not exist null is returned.
Throws
[Link] 295/302
2/15/26, 8:49 PM Context | API reference | Android Developers
BackgroundServiceStartNotAllowedException On Android Build.VERSION_C
(/reference/android/app/BackgroundServiceStartNotAllowedException) (/reference/android/os/[Link]
application is in a state where th
not in the foreground in a state
BackgroundServiceStartNo
(/reference/android/app/Backg
is thrown. This exception extend
(/reference/java/lang/IllegalStat
(IllegalStateException)
IllegalStateException Before Android [Link]
(/reference/java/lang/IllegalStateException) (/reference/android/os/[Link]
in a state where the service can
foreground in a state when serv
IllegalStateException
(/reference/java/lang/IllegalStat
SecurityException (/reference/java/lang/SecurityException) If the caller does not have perm
service can not be found.
See also:
startForegroundService(Intent)
(/reference/android/content/Context#startForegroundService([Link]))
stopService(Intent) (/reference/android/content/Context#stopService([Link]))
bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
stopService Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract boolean stopService (Intent (/reference/android/content/Intent) service
Request that a given application service be stopped. If the service is not running, nothing
happens. Otherwise it is stopped. Note that calls to startService() are not counted -- this
stops the service no matter how many times it was started.
[Link] 296/302
2/15/26, 8:49 PM Context | API reference | Android Developers
If the service is running as a foreground service when it is stopped, its associated
notification will be removed. To avoid this, apps can use
stopForeground(STOP_FOREGROUND_DETACH)
(/reference/android/app/Service#stopForeground(int)) to decouple the notification from the
service's lifecycle before stopping it.
Note that if a stopped service still has ServiceConnection
(/reference/android/content/ServiceConnection) objects bound to it with the
BIND_AUTO_CREATE (/reference/android/content/Context#BIND_AUTO_CREATE) set, it will not be
destroyed until all of these bindings are removed. See the Service
(/reference/android/app/Service) documentation for more details on a service's lifecycle.
This function will throw SecurityException (/reference/java/lang/SecurityException) if you do
not have permission to stop the given service.
Parameters
service Intent : Description of the service to be stopped. The Intent must
be either fully explicit (supplying a component name) or specify a
specific package name it is targeted to.
Returns
boolean If there is a service matching the given Intent that is already running,
then it is stopped and true is returned; else false is returned.
Throws
IllegalStateException If the application is in a state where the service can not be
(/reference/java/lang/IllegalStateException) started (such as not in the foreground in a state when
services are allowed).
SecurityException If the caller does not have permission to access the
(/reference/java/lang/SecurityException) service or the service can not be found.
[Link] 297/302
2/15/26, 8:49 PM Context | API reference | Android Developers
See also:
startService(Intent) (/reference/android/content/Context#startService([Link]))
unbindService Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public abstract void unbindService (ServiceConnection (/reference/android/content/Ser
Disconnect from an application service. You will no longer receive calls as the service is
restarted, and the service is now allowed to stop at any time.
Parameters
conn ServiceConnection : The connection interface previously supplied
to bindService(). This parameter must not be null.
See also:
bindService(Intent, BindServiceFlags, Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
unregisterComponentCallbacks
Added in API level 14 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public void unregisterComponentCallbacks (ComponentCallbacks (/reference/android/co
Remove a ComponentCallbacks (/reference/android/content/ComponentCallbacks) object that
was previously registered with
registerComponentCallbacks([Link])
[Link] 298/302
2/15/26, 8:49 PM Context | API reference | Android Developers
(/reference/android/content/Context#registerComponentCallbacks([Link]
cks))
.
Parameters
callback ComponentCallbacks
unregisterDeviceIdChangeListener
Added in API level 34 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public void unregisterDeviceIdChangeListener (IntConsumer (/reference/java/util/functio
Removes a device ID changed listener from the Context. It's a no-op if the listener is not
already registered.
Parameters
listener IntConsumer : The Consumer to remove.
This value cannot be null .
See also:
getDeviceId() (/reference/android/content/Context#getDeviceId())
registerDeviceIdChangeListener(Executor, IntConsumer)
(/reference/android/content/Context#registerDeviceIdChangeListener([Link],%
[Link]))
unregisterReceiver Added in API level 1 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
[Link] 299/302
2/15/26, 8:49 PM Context | API reference | Android Developers
public abstract void unregisterReceiver (BroadcastReceiver (/reference/android/conte
Unregister a previously registered BroadcastReceiver. All filters that have been registered
for this BroadcastReceiver will be removed.
Parameters
receiver BroadcastReceiver : The BroadcastReceiver to unregister.
Throws
IllegalArgumentException if the receiver was not previously registered or
(/reference/java/lang/IllegalArgumentException) already unregistered.
See also:
registerReceiver(BroadcastReceiver, IntentFilter)
(/reference/android/content/Context#registerReceiver([Link],%20androi
[Link]))
updateServiceGroup
Added in API level 29 (/guide/topics/manifest/uses-sdk-element#ApiLevels)
public void updateServiceGroup (ServiceConnection (/reference/android/content/ServiceC
int group,
int importance)
For a service previously bound with bindService(Intent, BindServiceFlags,
Executor, ServiceConnection)
(/reference/android/content/Context#bindService([Link],%[Link].
BindServiceFlags,%[Link],%[Link]))
[Link] 300/302
2/15/26, 8:49 PM Context | API reference | Android Developers
or a related method, change how the system manages that service's process in relation to
other processes. This doesn't modify the original bind flags that were passed in when
binding, but adjusts how the process will be managed in some cases based on those
flags. Currently only works on isolated processes (will be ignored for non-isolated
processes).
Note that this call does not take immediate effect, but will be applied the next time the
impacted process is adjusted for some other reason. Typically you would call this before
then calling a new bindIsolatedService(Intent, BindServiceFlags, String,
Executor, ServiceConnection)
(/reference/android/content/Context#bindIsolatedService([Link],%[Link].
[Link],%[Link],%[Link],%[Link].S
erviceConnection))
on the service of interest, with that binding causing the process to be shuffled
accordingly.
Parameters
conn ServiceConnection : The connection interface previously supplied
to bindService(). This parameter must not be null.
group int : A group to put this connection's process in. Upon calling here,
this will override any previous group that was set for that process.
The group tells the system about processes that are logically
grouped together, so should be managed as one unit of importance
(such as when being considered a recently used app). All processes
in the same app with the same group are considered to be related.
Supplying 0 reverts to the default behavior of not grouping.
importance int : Additional importance of the processes within a group. Upon
calling here, this will override any previous importance that was set
for that process. The most important process is 0, and higher values
are successively less important. You can view this as describing how
to order the processes in an array, with the processes at the end of
the array being the least important. This value has no meaning
besides indicating how processes should be ordered in that array
one after the other. This provides a way to fine-tune the system's
process killing, guiding it to kill processes at the end of the array
first.
[Link] 301/302
2/15/26, 8:49 PM Context | API reference | Android Developers
See also:
bindIsolatedService(Intent, BindServiceFlags, String, Executor,
ServiceConnection)
(/reference/android/content/Context#bindIsolatedService([Link],%[Link].
[Link],%[Link],%[Link],%[Link].S
erviceConnection))
Content and code samples on this page are subject to the licenses described in the Content License
(/license). Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2026-02-13 UTC.
[Link] 302/302
You might also like
- Android IntentService Overview and UsageNo ratings yetAndroid IntentService Overview and Usage122 pages
- Notes Module2 Mobile Application DevelopmentNo ratings yetNotes Module2 Mobile Application Development21 pages
- JVM vs DVM and Android Components ExplainedNo ratings yetJVM vs DVM and Android Components Explained40 pages
- Android SDK Overview and Key ComponentsNo ratings yetAndroid SDK Overview and Key Components33 pages
- Android Manifest and Activity Lifecycle ExplainedNo ratings yetAndroid Manifest and Activity Lifecycle Explained1 page
- GCS Human Interface Components OverviewNo ratings yetGCS Human Interface Components Overview88 pages
- Introduction to Android App DevelopmentNo ratings yetIntroduction to Android App Development42 pages
- Android UI Components and Services OverviewNo ratings yetAndroid UI Components and Services Overview7 pages
- Android UI Components and Activities GuideNo ratings yetAndroid UI Components and Activities Guide20 pages
- Android Development: UI Components & ServicesNo ratings yetAndroid Development: UI Components & Services10 pages
- Android Development Key Concepts and ExamplesNo ratings yetAndroid Development Key Concepts and Examples11 pages
- Android MCQ (Multiple Choice Questions) - JavatpointNo ratings yetAndroid MCQ (Multiple Choice Questions) - Javatpoint1 page
- Mobile App Development with Android StudioNo ratings yetMobile App Development with Android Studio28 pages
- Mobile and Web Software Course OverviewNo ratings yetMobile and Web Software Course Overview41 pages
- Common Android System Services ExplainedNo ratings yetCommon Android System Services Explained2 pages
- Android Development Overview and ConceptsNo ratings yetAndroid Development Overview and Concepts13 pages
- Java Programming Basics and Control FlowNo ratings yetJava Programming Basics and Control Flow47 pages
- 21st Century Skills in Job AdvertisementsNo ratings yet21st Century Skills in Job Advertisements37 pages
- Audit Committee Impact on Reporting TimelinessNo ratings yetAudit Committee Impact on Reporting Timeliness21 pages
- 61 Opinion Writing Prompts for 5th GradeNo ratings yet61 Opinion Writing Prompts for 5th Grade1 page
- Difference Between Vacuum Circuit Breaker & Vacuum Contactor67% (3)Difference Between Vacuum Circuit Breaker & Vacuum Contactor2 pages
- B01-FC-ADDA-03 - High Precision ADDA Module Basic Installation Instructions - ENGNo ratings yetB01-FC-ADDA-03 - High Precision ADDA Module Basic Installation Instructions - ENG2 pages
- Impact of Globalization on Assam's Indigenous CultureNo ratings yetImpact of Globalization on Assam's Indigenous Culture2 pages