public abstract class Context extends Object
Modifier and Type | Field and Description |
---|---|
static String |
ACCESSIBILITY_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
AccessibilityManager for giving the user
feedback for UI events through the registered event listeners. |
static String |
ACCOUNT_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
AccountManager for receiving intents at a
time of your choosing. |
static String |
ACTIVITY_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
ActivityManager for interacting with the global
system state. |
static String |
ALARM_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
AlarmManager for receiving intents at a
time of your choosing. |
static String |
APPWIDGET_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
AppWidgetManager for accessing AppWidgets. |
static String |
AUDIO_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
AudioManager for handling management of volume,
ringer modes and audio routing. |
static String |
BACKUP_SERVICE
Use with
getSystemService(java.lang.String) to retrieve an
IBackupManager for communicating
with the backup mechanism. |
static int |
BIND_ABOVE_CLIENT
Flag for
bindService(android.content.Intent, android.content.ServiceConnection, int) : indicates that the client application
binding to this service considers the service to be more important than
the app itself. |
static int |
BIND_ADJUST_WITH_ACTIVITY
Flag for
bindService(android.content.Intent, android.content.ServiceConnection, int) : If binding from an activity, allow the
target service's process importance to be raised based on whether the
activity is visible to the user, regardless whether another flag is
used to reduce the amount that the client process's overall importance
is used to impact it. |
static int |
BIND_ALLOW_OOM_MANAGEMENT
Flag for
bindService(android.content.Intent, android.content.ServiceConnection, int) : allow the process hosting the bound
service to go through its normal memory management. |
static int |
BIND_AUTO_CREATE
Flag for
bindService(android.content.Intent, android.content.ServiceConnection, int) : automatically create the service as long
as the binding exists. |
static int |
BIND_DEBUG_UNBIND
Flag for
bindService(android.content.Intent, android.content.ServiceConnection, int) : include debugging help for mismatched
calls to unbind. |
static int |
BIND_IMPORTANT
Flag for
bindService(android.content.Intent, android.content.ServiceConnection, int) : this service is very important to
the client, so should be brought to the foreground process level
when the client is. |
static int |
BIND_NOT_FOREGROUND
Flag for
bindService(android.content.Intent, android.content.ServiceConnection, int) : don't allow this binding to raise
the target service's process to the foreground scheduling priority. |
static int |
BIND_NOT_VISIBLE
Flag for
bindService(android.content.Intent, android.content.ServiceConnection, int) : Don't consider the bound service to be
visible, even if the caller is visible. |
static int |
BIND_VISIBLE |
static int |
BIND_WAIVE_PRIORITY
Flag for
bindService(android.content.Intent, android.content.ServiceConnection, int) : don't impact the scheduling or
memory management priority of the target service's hosting process. |
static String |
BLUETOOTH_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
BluetoothAdapter for using Bluetooth. |
static String |
CLIPBOARD_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
ClipboardManager for accessing and modifying
the contents of the global clipboard. |
static String |
CONNECTIVITY_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a ConnectivityManager for handling management of
network connections. |
static int |
CONTEXT_IGNORE_SECURITY
Flag for use with
createPackageContext(java.lang.String, int) : ignore any security
restrictions on the Context being requested, allowing it to always
be loaded. |
static int |
CONTEXT_INCLUDE_CODE
Flag for use with
createPackageContext(java.lang.String, int) : include the application
code with the context. |
static int |
CONTEXT_RESTRICTED
Flag for use with
createPackageContext(java.lang.String, int) : a restricted context may
disable specific features. |
static String |
COUNTRY_DETECTOR
Use with
getSystemService(java.lang.String) to retrieve a
CountryDetector for detecting the country that
the user is in. |
static String |
DEVICE_POLICY_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
DevicePolicyManager for working with global
device policy management. |
static String |
DISPLAY_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
DisplayManager for interacting with display devices. |
static String |
DOWNLOAD_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
DownloadManager for requesting HTTP downloads. |
static String |
DROPBOX_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
DropBoxManager instance for recording
diagnostic logs. |
static String |
INPUT_METHOD_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
InputMethodManager for accessing input
methods. |
static String |
INPUT_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
InputManager for interacting with input devices. |
static String |
KEYGUARD_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
NotificationManager for controlling keyguard. |
static String |
LAYOUT_INFLATER_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
LayoutInflater for inflating layout resources in this
context. |
static String |
LOCATION_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a LocationManager for controlling location
updates. |
static String |
MEDIA_ROUTER_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
MediaRouter for controlling and managing
routing of media. |
static int |
MODE_APPEND
File creation mode: for use with
openFileOutput(java.lang.String, int) , if the file
already exists then write data to the end of the existing file
instead of erasing it. |
static int |
MODE_ENABLE_WRITE_AHEAD_LOGGING
Database open flag: when set, the database is opened with write-ahead
logging enabled by default.
|
static int |
MODE_MULTI_PROCESS
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.
|
static 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).
|
static int |
MODE_WORLD_READABLE
Deprecated.
Creating world-readable files is very dangerous, and likely
to cause security holes in applications. It is strongly discouraged;
instead, applications should use more formal mechanism for interactions
such as
ContentProvider , BroadcastReceiver , and
Service . There are no guarantees that this
access mode will remain on a file, such as when it goes through a
backup and restore.
File creation mode: allow all other applications to have read access
to the created file. |
static int |
MODE_WORLD_WRITEABLE
Deprecated.
Creating world-writable files is very dangerous, and likely
to cause security holes in applications. It is strongly discouraged;
instead, applications should use more formal mechanism for interactions
such as
ContentProvider , BroadcastReceiver , and
Service . There are no guarantees that this
access mode will remain on a file, such as when it goes through a
backup and restore.
File creation mode: allow all other applications to have write access
to the created file. |
static String |
NETWORK_POLICY_SERVICE |
static String |
NETWORK_STATS_SERVICE |
static String |
NETWORKMANAGEMENT_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a android.net.NetworkManagementService for handling management of
system network services |
static String |
NFC_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
NfcManager for using NFC. |
static String |
NOTIFICATION_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
NotificationManager for informing the user of
background events. |
static String |
NSD_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a NsdManager for handling management of network service
discovery |
static String |
POWER_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
PowerManager for controlling power management,
including "wake locks," which let you keep the device on while
you're running long tasks. |
static String |
SCHEDULING_POLICY_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
SchedulingPolicyService for managing scheduling policy. |
static String |
SEARCH_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a SearchManager for handling searches. |
static String |
SENSOR_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a SensorManager for accessing sensors. |
static String |
SERIAL_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a SerialManager for access to serial ports. |
static String |
SIP_SERVICE |
static String |
STATUS_BAR_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a StatusBarManager for interacting with the status bar. |
static String |
STORAGE_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a StorageManager for accessing system storage
functions. |
static String |
TELEPHONY_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
TelephonyManager for handling management the
telephony features of the device. |
static String |
TEXT_SERVICES_MANAGER_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
TextServicesManager for accessing
text services. |
static String |
THROTTLE_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a ThrottleManager for handling management of
throttling. |
static String |
UI_MODE_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
UiModeManager for controlling UI modes. |
static String |
UPDATE_LOCK_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a android.os.IUpdateLock for managing runtime sequences that
must not be interrupted by headless OTA application or similar. |
static String |
USB_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a UsbManager for access to USB devices (as a USB host)
and for controlling this device's behavior as a USB device. |
static String |
USER_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
UserManager for managing users on devices that support multiple users. |
static String |
VIBRATOR_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a Vibrator for interacting with the vibration hardware. |
static String |
WALLPAPER_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
com.android.server.WallpaperService for accessing wallpapers. |
static String |
WIFI_P2P_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a WifiP2pManager for handling management of
Wi-Fi peer-to-peer connections. |
static String |
WIFI_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a WifiManager for handling management of
Wi-Fi access. |
static String |
WINDOW_SERVICE
Use with
getSystemService(java.lang.String) to retrieve a
WindowManager for accessing the system's window
manager. |
Constructor and Description |
---|
Context() |
Modifier and Type | Method and Description |
---|---|
abstract boolean |
bindService(Intent service,
ServiceConnection conn,
int flags)
Connect to an application service, creating it if needed.
|
boolean |
bindService(Intent service,
ServiceConnection conn,
int flags,
int userHandle)
Same as
bindService(Intent, ServiceConnection, int) , but with an explicit userHandle
argument for use by system server and other multi-user aware code. |
abstract int |
checkCallingOrSelfPermission(String permission)
Determine whether the calling process of an IPC or you have been
granted a particular permission.
|
abstract int |
checkCallingOrSelfUriPermission(Uri uri,
int modeFlags)
Determine whether the calling process of an IPC or you has been granted
permission to access a specific URI.
|
abstract int |
checkCallingPermission(String permission)
Determine whether the calling process of an IPC you are handling has been
granted a particular permission.
|
abstract int |
checkCallingUriPermission(Uri uri,
int modeFlags)
Determine whether the calling process and user ID has been
granted permission to access a specific URI.
|
abstract int |
checkPermission(String permission,
int pid,
int uid)
Determine whether the given permission is allowed for a particular
process and user ID running in the system.
|
abstract int |
checkUriPermission(Uri uri,
int pid,
int uid,
int modeFlags)
Determine whether a particular process and user ID has been granted
permission to access a specific URI.
|
abstract int |
checkUriPermission(Uri uri,
String readPermission,
String writePermission,
int pid,
int uid,
int modeFlags)
Check both a Uri and normal permission.
|
abstract void |
clearWallpaper()
Deprecated.
Use
WallpaperManager.clear() instead.
This method requires the caller to hold the permission
|
abstract Context |
createConfigurationContext(Configuration overrideConfiguration)
Return a new Context object for the current Context but whose resources
are adjusted to match the given Configuration.
|
abstract Context |
createDisplayContext(Display display)
Return a new Context object for the current Context but whose resources
are adjusted to match the metrics of the given Display.
|
abstract Context |
createPackageContext(String packageName,
int flags)
Return a new Context object for the given application name.
|
abstract Context |
createPackageContextAsUser(String packageName,
int flags,
UserHandle user)
Similar to
createPackageContext(String, int) , but with a
different UserHandle . |
abstract String[] |
databaseList()
Returns an array of strings naming the private databases associated with
this Context's application package.
|
abstract boolean |
deleteDatabase(String name)
Delete an existing private SQLiteDatabase associated with this Context's
application package.
|
abstract boolean |
deleteFile(String name)
Delete the given private file associated with this Context's
application package.
|
abstract void |
enforceCallingOrSelfPermission(String permission,
String message)
If neither you nor the calling process of an IPC you are
handling has been granted a particular permission, throw a
SecurityException . |
abstract void |
enforceCallingOrSelfUriPermission(Uri uri,
int modeFlags,
String message)
If the calling process of an IPC or you has not been
granted permission to access a specific URI, throw
SecurityException . |
abstract void |
enforceCallingPermission(String permission,
String message)
If the calling process of an IPC you are handling has not been
granted a particular permission, throw a
SecurityException . |
abstract void |
enforceCallingUriPermission(Uri uri,
int modeFlags,
String message)
If the calling process and user ID has not been granted
permission to access a specific URI, throw
SecurityException . |
abstract void |
enforcePermission(String permission,
int pid,
int uid,
String message)
If the given permission is not allowed for a particular process
and user ID running in the system, throw a
SecurityException . |
abstract void |
enforceUriPermission(Uri uri,
int pid,
int uid,
int modeFlags,
String message)
If a particular process and user ID has not been granted
permission to access a specific URI, throw
SecurityException . |
abstract void |
enforceUriPermission(Uri uri,
String readPermission,
String writePermission,
int pid,
int uid,
int modeFlags,
String message)
Enforce both a Uri and normal permission.
|
abstract String[] |
fileList()
Returns an array of strings naming the private files associated with
this Context's application package.
|
abstract Context |
getApplicationContext()
Return the context of the single, global Application object of the
current process.
|
abstract ApplicationInfo |
getApplicationInfo()
Return the full application info for this context's package.
|
abstract AssetManager |
getAssets()
Return an AssetManager instance for your application's package.
|
abstract File |
getCacheDir()
Returns the absolute path to the application specific cache directory
on the filesystem.
|
abstract ClassLoader |
getClassLoader()
Return a class loader you can use to retrieve classes in this package.
|
abstract CompatibilityInfoHolder |
getCompatibilityInfo(int displayId)
Gets the compatibility info holder for this context.
|
abstract ContentResolver |
getContentResolver()
Return a ContentResolver instance for your application's package.
|
abstract File |
getDatabasePath(String name)
Returns the absolute path on the filesystem where a database created with
openOrCreateDatabase(java.lang.String, int, android.database.sqlite.SQLiteDatabase.CursorFactory) is stored. |
abstract File |
getDir(String name,
int mode)
Retrieve, creating if needed, a new directory in which the application
can place its own custom data files.
|
abstract File |
getExternalCacheDir()
Returns the absolute path to the directory on the external filesystem
(that is somewhere on
Environment.getExternalStorageDirectory() where the application can
place cache files it owns. |
abstract File |
getExternalFilesDir(String type)
Returns the absolute path to the directory on the external filesystem
(that is somewhere on
Environment.getExternalStorageDirectory() ) where the application can
place persistent files it owns. |
abstract File |
getFilesDir()
Returns the absolute path to the directory on the filesystem where
files created with
openFileOutput(java.lang.String, int) are stored. |
abstract File |
getFileStreamPath(String name)
Returns the absolute path on the filesystem where a file created with
openFileOutput(java.lang.String, int) is stored. |
abstract Looper |
getMainLooper()
Return the Looper for the main thread of the current process.
|
abstract File |
getObbDir()
Return the directory where this application's OBB files (if there
are any) can be found.
|
abstract String |
getPackageCodePath()
Return the full path to this context's primary Android package.
|
abstract PackageManager |
getPackageManager()
Return PackageManager instance to find global package information.
|
abstract String |
getPackageName()
Return the name of this application's package.
|
abstract String |
getPackageResourcePath()
Return the full path to this context's primary Android package.
|
abstract Resources |
getResources()
Return a Resources instance for your application's package.
|
abstract SharedPreferences |
getSharedPreferences(String name,
int mode)
Retrieve and hold the contents of the preferences file 'name', returning
a SharedPreferences through which you can retrieve and modify its
values.
|
abstract File |
getSharedPrefsFile(String name)
Return the full path to the shared prefs file for the given prefs group name.
|
String |
getString(int resId)
Return a localized string from the application's package's
default string table.
|
String |
getString(int resId,
Object... formatArgs)
Return a localized formatted string from the application's package's
default string table, substituting the format arguments as defined in
Formatter and String.format(java.lang.String, java.lang.Object...) . |
abstract Object |
getSystemService(String name)
Return the handle to a system-level service by name.
|
CharSequence |
getText(int resId)
Return a localized, styled CharSequence from the application's package's
default string table.
|
abstract Resources.Theme |
getTheme()
Return the Theme object associated with this Context.
|
int |
getThemeResId() |
abstract Drawable |
getWallpaper()
Deprecated.
Use
WallpaperManager.get() instead. |
abstract int |
getWallpaperDesiredMinimumHeight()
Deprecated.
Use
WallpaperManager.getDesiredMinimumHeight() instead. |
abstract int |
getWallpaperDesiredMinimumWidth()
Deprecated.
Use
WallpaperManager.getDesiredMinimumWidth() instead. |
abstract void |
grantUriPermission(String toPackage,
Uri uri,
int modeFlags)
Grant permission to access a specific Uri to another package, regardless
of whether that package has general permission to access the Uri's
content provider.
|
boolean |
isRestricted()
Indicates whether this Context is restricted.
|
TypedArray |
obtainStyledAttributes(AttributeSet set,
int[] attrs)
Retrieve styled attribute information in this Context's theme.
|
TypedArray |
obtainStyledAttributes(AttributeSet set,
int[] attrs,
int defStyleAttr,
int defStyleRes)
Retrieve styled attribute information in this Context's theme.
|
TypedArray |
obtainStyledAttributes(int[] attrs)
Retrieve styled attribute information in this Context's theme.
|
TypedArray |
obtainStyledAttributes(int resid,
int[] attrs)
Retrieve styled attribute information in this Context's theme.
|
abstract FileInputStream |
openFileInput(String name)
Open a private file associated with this Context's application package
for reading.
|
abstract FileOutputStream |
openFileOutput(String name,
int mode)
Open a private file associated with this Context's application package
for writing.
|
abstract SQLiteDatabase |
openOrCreateDatabase(String name,
int mode,
SQLiteDatabase.CursorFactory factory)
Open a new private SQLiteDatabase associated with this Context's
application package.
|
abstract SQLiteDatabase |
openOrCreateDatabase(String name,
int mode,
SQLiteDatabase.CursorFactory factory,
DatabaseErrorHandler errorHandler)
Open a new private SQLiteDatabase associated with this Context's
application package.
|
abstract Drawable |
peekWallpaper()
Deprecated.
Use
WallpaperManager.peek() instead. |
void |
registerComponentCallbacks(ComponentCallbacks callback)
Add a new
ComponentCallbacks to the base application of the
Context, which will be called at the same times as the ComponentCallbacks
methods of activities and other components are called. |
abstract Intent |
registerReceiver(BroadcastReceiver receiver,
IntentFilter filter)
Register a BroadcastReceiver to be run in the main activity thread.
|
abstract Intent |
registerReceiver(BroadcastReceiver receiver,
IntentFilter filter,
String broadcastPermission,
Handler scheduler)
Register to receive intent broadcasts, to run in the context of
scheduler.
|
abstract Intent |
registerReceiverAsUser(BroadcastReceiver receiver,
UserHandle user,
IntentFilter filter,
String broadcastPermission,
Handler scheduler) |
abstract void |
removeStickyBroadcast(Intent intent)
Remove the data previously sent with
sendStickyBroadcast(android.content.Intent) ,
so that it is as if the sticky broadcast had never happened. |
abstract void |
removeStickyBroadcastAsUser(Intent intent,
UserHandle user)
Version of
removeStickyBroadcast(Intent) that allows you to specify the
user the broadcast will be sent to. |
abstract void |
revokeUriPermission(Uri uri,
int modeFlags)
Remove all permissions to access a particular content provider Uri
that were previously added with
grantUriPermission(java.lang.String, android.net.Uri, int) . |
abstract void |
sendBroadcast(Intent intent)
Broadcast the given intent to all interested BroadcastReceivers.
|
abstract void |
sendBroadcast(Intent intent,
String receiverPermission)
Broadcast the given intent to all interested BroadcastReceivers, allowing
an optional required permission to be enforced.
|
abstract void |
sendBroadcastAsUser(Intent intent,
UserHandle user)
Version of
sendBroadcast(Intent) that allows you to specify the
user the broadcast will be sent to. |
abstract void |
sendBroadcastAsUser(Intent intent,
UserHandle user,
String receiverPermission)
Version of
sendBroadcast(Intent, String) that allows you to specify the
user the broadcast will be sent to. |
abstract void |
sendOrderedBroadcast(Intent intent,
String receiverPermission)
Broadcast the given intent to all interested BroadcastReceivers, delivering
them one at a time to allow more preferred receivers to consume the
broadcast before it is delivered to less preferred receivers.
|
abstract void |
sendOrderedBroadcast(Intent intent,
String receiverPermission,
BroadcastReceiver resultReceiver,
Handler scheduler,
int initialCode,
String initialData,
Bundle initialExtras)
Version of
sendBroadcast(Intent) that allows you to
receive data back from the broadcast. |
abstract void |
sendOrderedBroadcastAsUser(Intent intent,
UserHandle user,
String receiverPermission,
BroadcastReceiver resultReceiver,
Handler scheduler,
int initialCode,
String initialData,
Bundle initialExtras)
Version of
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)
that allows you to specify the
user the broadcast will be sent to. |
abstract void |
sendStickyBroadcast(Intent intent)
Perform a
sendBroadcast(Intent) 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(BroadcastReceiver, IntentFilter) . |
abstract void |
sendStickyBroadcastAsUser(Intent intent,
UserHandle user)
Version of
sendStickyBroadcast(Intent) that allows you to specify the
user the broadcast will be sent to. |
abstract void |
sendStickyOrderedBroadcast(Intent intent,
BroadcastReceiver resultReceiver,
Handler scheduler,
int initialCode,
String initialData,
Bundle initialExtras)
Version of
sendStickyBroadcast(android.content.Intent) that allows you to
receive data back from the broadcast. |
abstract void |
sendStickyOrderedBroadcastAsUser(Intent intent,
UserHandle user,
BroadcastReceiver resultReceiver,
Handler scheduler,
int initialCode,
String initialData,
Bundle initialExtras)
Version of
sendStickyOrderedBroadcast(Intent, BroadcastReceiver, Handler, int, String, Bundle)
that allows you to specify the
user the broadcast will be sent to. |
abstract void |
setTheme(int resid)
Set the base theme for this context.
|
abstract void |
setWallpaper(Bitmap bitmap)
Deprecated.
Use
WallpaperManager.set() instead.
This method requires the caller to hold the permission
|
abstract void |
setWallpaper(InputStream data)
Deprecated.
Use
WallpaperManager.set() instead.
This method requires the caller to hold the permission
|
abstract void |
startActivities(Intent[] intents)
Same as
startActivities(Intent[], Bundle) with no options
specified. |
abstract void |
startActivities(Intent[] intents,
Bundle options)
Launch multiple new activities.
|
void |
startActivitiesAsUser(Intent[] intents,
Bundle options,
UserHandle userHandle) |
abstract void |
startActivity(Intent intent)
Same as
startActivity(Intent, Bundle) with no options
specified. |
abstract void |
startActivity(Intent intent,
Bundle options)
Launch a new activity.
|
void |
startActivityAsUser(Intent intent,
Bundle options,
UserHandle userId)
Version of
startActivity(Intent, Bundle) that allows you to specify the
user the activity will be started for. |
void |
startActivityAsUser(Intent intent,
UserHandle user)
Version of
startActivity(Intent) that allows you to specify the
user the activity will be started for. |
abstract boolean |
startInstrumentation(ComponentName className,
String profileFile,
Bundle arguments)
Start executing an
Instrumentation class. |
abstract void |
startIntentSender(IntentSender intent,
Intent fillInIntent,
int flagsMask,
int flagsValues,
int extraFlags)
Same as
startIntentSender(IntentSender, Intent, int, int, int, Bundle)
with no options specified. |
abstract void |
startIntentSender(IntentSender intent,
Intent fillInIntent,
int flagsMask,
int flagsValues,
int extraFlags,
Bundle options)
Like
startActivity(Intent, Bundle) , but taking a IntentSender
to start. |
abstract ComponentName |
startService(Intent service)
Request that a given application service be started.
|
abstract ComponentName |
startServiceAsUser(Intent service,
UserHandle user) |
abstract boolean |
stopService(Intent service)
Request that a given application service be stopped.
|
abstract boolean |
stopServiceAsUser(Intent service,
UserHandle user) |
abstract void |
unbindService(ServiceConnection conn)
Disconnect from an application service.
|
void |
unregisterComponentCallbacks(ComponentCallbacks callback)
Remove a
ComponentCallbacks objec that was previously registered
with registerComponentCallbacks(ComponentCallbacks) . |
abstract void |
unregisterReceiver(BroadcastReceiver receiver)
Unregister a previously registered BroadcastReceiver.
|
public static final int MODE_PRIVATE
@Deprecated public static final int MODE_WORLD_READABLE
ContentProvider
, BroadcastReceiver
, and
Service
. There are no guarantees that this
access mode will remain on a file, such as when it goes through a
backup and restore.
File creation mode: allow all other applications to have read access
to the created file.@Deprecated public static final int MODE_WORLD_WRITEABLE
ContentProvider
, BroadcastReceiver
, and
Service
. There are no guarantees that this
access mode will remain on a file, such as when it goes through a
backup and restore.
File creation mode: allow all other applications to have write access
to the created file.MODE_PRIVATE
,
MODE_WORLD_READABLE
,
Constant Field Valuespublic static final int MODE_APPEND
openFileOutput(java.lang.String, int)
, if the file
already exists then write data to the end of the existing file
instead of erasing it.public static final int MODE_MULTI_PROCESS
This was the legacy (but undocumented) behavior in and before Gingerbread (Android 2.3) and this flag is implied when targetting such releases. For applications targetting SDK versions greater than Android 2.3, this flag must be explicitly set if desired.
public static final int MODE_ENABLE_WRITE_AHEAD_LOGGING
#openOrCreateDatabase(String, int, CursorFactory)
,
#openOrCreateDatabase(String, int, CursorFactory, DatabaseErrorHandler)
,
SQLiteDatabase.enableWriteAheadLogging()
,
Constant Field Valuespublic static final int BIND_AUTO_CREATE
bindService(android.content.Intent, android.content.ServiceConnection, int)
: automatically create the service as long
as the binding exists. Note that while this will create the service,
its Service.onStartCommand(android.content.Intent, int, int)
method will still only be called due to an
explicit call to startService(android.content.Intent)
. 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
,
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
. For compatibility, old applications
that don't specify BIND_AUTO_CREATE
will automatically have
the flags BIND_WAIVE_PRIORITY
and
BIND_ADJUST_WITH_ACTIVITY
set for them in order to achieve
the same result.
public static final int BIND_DEBUG_UNBIND
bindService(android.content.Intent, android.content.ServiceConnection, int)
: include debugging help for mismatched
calls to unbind. When this flag is set, the callstack of the following
unbindService(android.content.ServiceConnection)
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.public static final int BIND_NOT_FOREGROUND
bindService(android.content.Intent, android.content.ServiceConnection, int)
: 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.public static final int BIND_ABOVE_CLIENT
bindService(android.content.Intent, android.content.ServiceConnection, int)
: 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.public static final int BIND_ALLOW_OOM_MANAGEMENT
bindService(android.content.Intent, android.content.ServiceConnection, int)
: 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.public static final int BIND_WAIVE_PRIORITY
bindService(android.content.Intent, android.content.ServiceConnection, int)
: 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.public static final int BIND_IMPORTANT
bindService(android.content.Intent, android.content.ServiceConnection, int)
: 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.public static final int BIND_ADJUST_WITH_ACTIVITY
bindService(android.content.Intent, android.content.ServiceConnection, int)
: If binding from an activity, allow the
target service's process importance to be raised based on whether the
activity is visible to the user, regardless whether another flag is
used to reduce the amount that the client process's overall importance
is used to impact it.public static final int BIND_VISIBLE
public static final int BIND_NOT_VISIBLE
bindService(android.content.Intent, android.content.ServiceConnection, int)
: Don't consider the bound service to be
visible, even if the caller is visible.public static final String POWER_SERVICE
getSystemService(java.lang.String)
to retrieve a
PowerManager
for controlling power management,
including "wake locks," which let you keep the device on while
you're running long tasks.public static final String WINDOW_SERVICE
getSystemService(java.lang.String)
to retrieve a
WindowManager
for accessing the system's window
manager.public static final String LAYOUT_INFLATER_SERVICE
getSystemService(java.lang.String)
to retrieve a
LayoutInflater
for inflating layout resources in this
context.public static final String ACCOUNT_SERVICE
getSystemService(java.lang.String)
to retrieve a
AccountManager
for receiving intents at a
time of your choosing.public static final String ACTIVITY_SERVICE
getSystemService(java.lang.String)
to retrieve a
ActivityManager
for interacting with the global
system state.public static final String ALARM_SERVICE
getSystemService(java.lang.String)
to retrieve a
AlarmManager
for receiving intents at a
time of your choosing.public static final String NOTIFICATION_SERVICE
getSystemService(java.lang.String)
to retrieve a
NotificationManager
for informing the user of
background events.public static final String ACCESSIBILITY_SERVICE
getSystemService(java.lang.String)
to retrieve a
AccessibilityManager
for giving the user
feedback for UI events through the registered event listeners.public static final String KEYGUARD_SERVICE
getSystemService(java.lang.String)
to retrieve a
NotificationManager
for controlling keyguard.public static final String LOCATION_SERVICE
getSystemService(java.lang.String)
to retrieve a LocationManager
for controlling location
updates.public static final String COUNTRY_DETECTOR
getSystemService(java.lang.String)
to retrieve a
CountryDetector
for detecting the country that
the user is in.public static final String SEARCH_SERVICE
getSystemService(java.lang.String)
to retrieve a SearchManager
for handling searches.public static final String SENSOR_SERVICE
getSystemService(java.lang.String)
to retrieve a SensorManager
for accessing sensors.public static final String STORAGE_SERVICE
getSystemService(java.lang.String)
to retrieve a StorageManager
for accessing system storage
functions.public static final String WALLPAPER_SERVICE
getSystemService(java.lang.String)
to retrieve a
com.android.server.WallpaperService for accessing wallpapers.public static final String VIBRATOR_SERVICE
getSystemService(java.lang.String)
to retrieve a Vibrator
for interacting with the vibration hardware.public static final String STATUS_BAR_SERVICE
getSystemService(java.lang.String)
to retrieve a StatusBarManager
for interacting with the status bar.public static final String CONNECTIVITY_SERVICE
getSystemService(java.lang.String)
to retrieve a ConnectivityManager
for handling management of
network connections.public static final String THROTTLE_SERVICE
getSystemService(java.lang.String)
to retrieve a ThrottleManager
for handling management of
throttling.public static final String UPDATE_LOCK_SERVICE
getSystemService(java.lang.String)
to retrieve a android.os.IUpdateLock
for managing runtime sequences that
must not be interrupted by headless OTA application or similar.public static final String NETWORKMANAGEMENT_SERVICE
getSystemService(java.lang.String)
to retrieve a android.net.NetworkManagementService
for handling management of
system network servicesgetSystemService(java.lang.String)
,
android.net.NetworkManagementService
,
Constant Field Valuespublic static final String NETWORK_STATS_SERVICE
public static final String NETWORK_POLICY_SERVICE
public static final String WIFI_SERVICE
getSystemService(java.lang.String)
to retrieve a WifiManager
for handling management of
Wi-Fi access.public static final String WIFI_P2P_SERVICE
getSystemService(java.lang.String)
to retrieve a WifiP2pManager
for handling management of
Wi-Fi peer-to-peer connections.public static final String NSD_SERVICE
getSystemService(java.lang.String)
to retrieve a NsdManager
for handling management of network service
discoverypublic static final String AUDIO_SERVICE
getSystemService(java.lang.String)
to retrieve a
AudioManager
for handling management of volume,
ringer modes and audio routing.public static final String MEDIA_ROUTER_SERVICE
getSystemService(java.lang.String)
to retrieve a
MediaRouter
for controlling and managing
routing of media.public static final String TELEPHONY_SERVICE
getSystemService(java.lang.String)
to retrieve a
TelephonyManager
for handling management the
telephony features of the device.public static final String CLIPBOARD_SERVICE
getSystemService(java.lang.String)
to retrieve a
ClipboardManager
for accessing and modifying
the contents of the global clipboard.public static final String INPUT_METHOD_SERVICE
getSystemService(java.lang.String)
to retrieve a
InputMethodManager
for accessing input
methods.public static final String TEXT_SERVICES_MANAGER_SERVICE
getSystemService(java.lang.String)
to retrieve a
TextServicesManager
for accessing
text services.public static final String APPWIDGET_SERVICE
getSystemService(java.lang.String)
to retrieve a
AppWidgetManager
for accessing AppWidgets.public static final String BACKUP_SERVICE
getSystemService(java.lang.String)
to retrieve an
IBackupManager
for communicating
with the backup mechanism.public static final String DROPBOX_SERVICE
getSystemService(java.lang.String)
to retrieve a
DropBoxManager
instance for recording
diagnostic logs.public static final String DEVICE_POLICY_SERVICE
getSystemService(java.lang.String)
to retrieve a
DevicePolicyManager
for working with global
device policy management.public static final String UI_MODE_SERVICE
getSystemService(java.lang.String)
to retrieve a
UiModeManager
for controlling UI modes.public static final String DOWNLOAD_SERVICE
getSystemService(java.lang.String)
to retrieve a
DownloadManager
for requesting HTTP downloads.public static final String NFC_SERVICE
getSystemService(java.lang.String)
to retrieve a
NfcManager
for using NFC.public static final String BLUETOOTH_SERVICE
getSystemService(java.lang.String)
to retrieve a
BluetoothAdapter
for using Bluetooth.public static final String SIP_SERVICE
public static final String USB_SERVICE
getSystemService(java.lang.String)
to retrieve a UsbManager
for access to USB devices (as a USB host)
and for controlling this device's behavior as a USB device.getSystemService(java.lang.String)
,
android.harware.usb.UsbManager
,
Constant Field Valuespublic static final String SERIAL_SERVICE
getSystemService(java.lang.String)
to retrieve a SerialManager
for access to serial ports.getSystemService(java.lang.String)
,
android.harware.SerialManager
,
Constant Field Valuespublic static final String INPUT_SERVICE
getSystemService(java.lang.String)
to retrieve a
InputManager
for interacting with input devices.public static final String DISPLAY_SERVICE
getSystemService(java.lang.String)
to retrieve a
DisplayManager
for interacting with display devices.public static final String SCHEDULING_POLICY_SERVICE
getSystemService(java.lang.String)
to retrieve a
SchedulingPolicyService
for managing scheduling policy.public static final String USER_SERVICE
getSystemService(java.lang.String)
to retrieve a
UserManager
for managing users on devices that support multiple users.public static final int CONTEXT_INCLUDE_CODE
createPackageContext(java.lang.String, int)
: include the application
code with the context. This means loading code into the caller's
process, so that 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,
java.lang.SecurityException will be thrown. If this flag is not set,
there will be no restrictions on the packages that can be loaded,
but getClassLoader()
will always return the default system
class loader.public static final int CONTEXT_IGNORE_SECURITY
createPackageContext(java.lang.String, int)
: ignore any security
restrictions on the Context being requested, allowing it to always
be loaded. For use with 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!public static final int CONTEXT_RESTRICTED
createPackageContext(java.lang.String, int)
: a restricted context may
disable specific features. For instance, a View associated with a restricted
context would ignore particular XML attributes.public abstract AssetManager getAssets()
public abstract Resources getResources()
public abstract PackageManager getPackageManager()
public abstract ContentResolver getContentResolver()
public abstract Looper getMainLooper()
public abstract Context getApplicationContext()
Consider for example how this interacts with
registerReceiver(BroadcastReceiver, IntentFilter)
:
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.
public void registerComponentCallbacks(ComponentCallbacks callback)
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(android.content.ComponentCallbacks)
when
appropriate in the future; this will not be removed for you.callback
- The interface to call. This can be either a
ComponentCallbacks
or ComponentCallbacks2
interface.public void unregisterComponentCallbacks(ComponentCallbacks callback)
ComponentCallbacks
objec that was previously registered
with registerComponentCallbacks(ComponentCallbacks)
.public final CharSequence getText(int resId)
resId
- Resource id for the CharSequence textpublic final String getString(int resId)
resId
- Resource id for the stringpublic final String getString(int resId, Object... formatArgs)
Formatter
and String.format(java.lang.String, java.lang.Object...)
.resId
- Resource id for the format stringformatArgs
- The format arguments that will be used for substitution.public abstract void setTheme(int resid)
Activity.setContentView(int)
or
LayoutInflater.inflate(int, android.view.ViewGroup)
).resid
- The style resource describing the theme.public int getThemeResId()
public abstract Resources.Theme getTheme()
public final TypedArray obtainStyledAttributes(int[] attrs)
Resources.Theme#obtainStyledAttributes(int[])
for more information.Resources.Theme#obtainStyledAttributes(int[])
public final TypedArray obtainStyledAttributes(int resid, int[] attrs) throws Resources.NotFoundException
Resources.Theme#obtainStyledAttributes(int, int[])
for more information.Resources.NotFoundException
Resources.Theme#obtainStyledAttributes(int, int[])
public final TypedArray obtainStyledAttributes(AttributeSet set, int[] attrs)
Resources.Theme#obtainStyledAttributes(AttributeSet, int[], int, int)
for more information.Resources.Theme#obtainStyledAttributes(AttributeSet, int[], int, int)
public final TypedArray obtainStyledAttributes(AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)
Resources.Theme#obtainStyledAttributes(AttributeSet, int[], int, int)
for more information.Resources.Theme#obtainStyledAttributes(AttributeSet, int[], int, int)
public abstract ClassLoader getClassLoader()
public abstract String getPackageName()
public abstract ApplicationInfo getApplicationInfo()
public abstract String getPackageResourcePath()
Note: this is not generally useful for applications, since they should not be directly accessing the file system.
public abstract String getPackageCodePath()
Note: this is not generally useful for applications, since they should not be directly accessing the file system.
public abstract File getSharedPrefsFile(String name)
Note: this is not generally useful for applications, since they should not be directly accessing the file system.
public abstract SharedPreferences getSharedPreferences(String name, int mode)
name
- Desired preferences file. If a preferences file by this name
does not exist, it will be created when you retrieve an
editor (SharedPreferences.edit()) and then commit changes (Editor.commit()).mode
- Operating mode. Use 0 or MODE_PRIVATE
for the
default operation, MODE_WORLD_READABLE
and MODE_WORLD_WRITEABLE
to control permissions. The bit
MODE_MULTI_PROCESS
can also be used if multiple processes
are mutating the same SharedPreferences file. MODE_MULTI_PROCESS
is always on in apps targetting Gingerbread (Android 2.3) and below, and
off by default in later versions.MODE_PRIVATE
,
MODE_WORLD_READABLE
,
MODE_WORLD_WRITEABLE
,
MODE_MULTI_PROCESS
public abstract FileInputStream openFileInput(String name) throws FileNotFoundException
name
- The name of the file to open; can not contain path
separators.FileNotFoundException
openFileOutput(java.lang.String, int)
,
fileList()
,
deleteFile(java.lang.String)
,
FileInputStream.FileInputStream(String)
public abstract FileOutputStream openFileOutput(String name, int mode) throws FileNotFoundException
name
- The name of the file to open; can not contain path
separators.mode
- Operating mode. Use 0 or MODE_PRIVATE
for the
default operation, MODE_APPEND
to append to an existing file,
MODE_WORLD_READABLE
and MODE_WORLD_WRITEABLE
to control
permissions.FileNotFoundException
MODE_APPEND
,
MODE_PRIVATE
,
MODE_WORLD_READABLE
,
MODE_WORLD_WRITEABLE
,
openFileInput(java.lang.String)
,
fileList()
,
deleteFile(java.lang.String)
,
FileOutputStream.FileOutputStream(String)
public abstract boolean deleteFile(String name)
name
- The name of the file to delete; can not contain path
separators.openFileInput(java.lang.String)
,
openFileOutput(java.lang.String, int)
,
fileList()
,
File.delete()
public abstract File getFileStreamPath(String name)
openFileOutput(java.lang.String, int)
is stored.name
- The name of the file for which you would like to get
its path.openFileOutput(java.lang.String, int)
,
getFilesDir()
,
getDir(java.lang.String, int)
public abstract File getFilesDir()
openFileOutput(java.lang.String, int)
are stored.openFileOutput(java.lang.String, int)
,
getFileStreamPath(java.lang.String)
,
getDir(java.lang.String, int)
public abstract File getExternalFilesDir(String type)
Environment.getExternalStorageDirectory()
) where the application can
place persistent files it owns. These files are private to the
applications, and not typically visible to the user as media.
This is like getFilesDir()
in that these
files will be deleted when the application is uninstalled, however there
are some important differences:
Environment
for information in the storage state.
On devices with multiple users (as described by UserManager
),
each user has their own isolated external storage. Applications only
have access to the external storage for the user they're running as.
Here is an example of typical code to manipulate a file in an application's private storage:
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
MediaScannerConnection.scanFile
.
Note that this is not the same as
Environment.getExternalStoragePublicDirectory()
, 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
Environment.getExternalStoragePublicDirectory()
, 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 private storage and add it to the media database:
Writing to this path requires the
android.Manifest.permission#WRITE_EXTERNAL_STORAGE
permission.
type
- The type of files directory to return. May be null for
the root of the files directory or one of
the following Environment constants for a subdirectory:
Environment.DIRECTORY_MUSIC
,
Environment.DIRECTORY_PODCASTS
,
Environment.DIRECTORY_RINGTONES
,
Environment.DIRECTORY_ALARMS
,
Environment.DIRECTORY_NOTIFICATIONS
,
Environment.DIRECTORY_PICTURES
, or
Environment.DIRECTORY_MOVIES
.getFilesDir()
,
Environment.getExternalStoragePublicDirectory(java.lang.String)
public abstract File getObbDir()
On devices with multiple users (as described by 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.
public abstract File getCacheDir()
openFileOutput(java.lang.String, int)
,
getFileStreamPath(java.lang.String)
,
getDir(java.lang.String, int)
public abstract File getExternalCacheDir()
Environment.getExternalStorageDirectory()
where the application can
place cache files it owns.
This is like getCacheDir()
in that these
files will be deleted when the application is uninstalled, however there
are some important differences:
Build.VERSION_CODES.JELLY_BEAN_MR1
or later and
Environment.isExternalStorageEmulated()
returns true. Note that you should
be managing the maximum space you will use for these anyway, just like
with getCacheDir()
.
Environment
for information in the storage state.
On devices with multiple users (as described by UserManager
),
each user has their own isolated external storage. Applications only
have access to the external storage for the user they're running as.
Writing to this path requires the
android.Manifest.permission#WRITE_EXTERNAL_STORAGE
permission.
getCacheDir()
public abstract String[] fileList()
openFileInput(java.lang.String)
,
openFileOutput(java.lang.String, int)
,
deleteFile(java.lang.String)
public abstract File getDir(String name, int mode)
name
- Name of the directory to retrieve. This is a directory
that is created as part of your application data.mode
- Operating mode. Use 0 or MODE_PRIVATE
for the
default operation, MODE_WORLD_READABLE
and
MODE_WORLD_WRITEABLE
to control permissions.openFileOutput(String, int)
public abstract SQLiteDatabase openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)
name
- The name (unique in the application package) of the database.mode
- Operating mode. Use 0 or MODE_PRIVATE
for the
default operation, MODE_WORLD_READABLE
and MODE_WORLD_WRITEABLE
to control permissions.
Use MODE_ENABLE_WRITE_AHEAD_LOGGING
to enable write-ahead logging by default.factory
- An optional factory class that is called to instantiate a
cursor when query is called.SQLiteException
- if the database file could not be opened.MODE_PRIVATE
,
MODE_WORLD_READABLE
,
MODE_WORLD_WRITEABLE
,
MODE_ENABLE_WRITE_AHEAD_LOGGING
,
deleteDatabase(java.lang.String)
public abstract SQLiteDatabase openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)
Accepts input param: a concrete instance of DatabaseErrorHandler
to be
used to handle corruption when sqlite reports database corruption.
name
- The name (unique in the application package) of the database.mode
- Operating mode. Use 0 or MODE_PRIVATE
for the
default operation, MODE_WORLD_READABLE
and MODE_WORLD_WRITEABLE
to control permissions.
Use MODE_ENABLE_WRITE_AHEAD_LOGGING
to enable write-ahead logging by default.factory
- An optional factory class that is called to instantiate a
cursor when query is called.errorHandler
- the DatabaseErrorHandler
to be used when sqlite reports database
corruption. if null, DefaultDatabaseErrorHandler
is assumed.SQLiteException
- if the database file could not be opened.MODE_PRIVATE
,
MODE_WORLD_READABLE
,
MODE_WORLD_WRITEABLE
,
MODE_ENABLE_WRITE_AHEAD_LOGGING
,
deleteDatabase(java.lang.String)
public abstract boolean deleteDatabase(String name)
name
- The name (unique in the application package) of the
database.openOrCreateDatabase(java.lang.String, int, android.database.sqlite.SQLiteDatabase.CursorFactory)
public abstract File getDatabasePath(String name)
openOrCreateDatabase(java.lang.String, int, android.database.sqlite.SQLiteDatabase.CursorFactory)
is stored.name
- The name of the database for which you would like to get
its path.openOrCreateDatabase(java.lang.String, int, android.database.sqlite.SQLiteDatabase.CursorFactory)
public abstract String[] databaseList()
openOrCreateDatabase(java.lang.String, int, android.database.sqlite.SQLiteDatabase.CursorFactory)
,
deleteDatabase(java.lang.String)
@Deprecated public abstract Drawable getWallpaper()
WallpaperManager.get()
instead.@Deprecated public abstract Drawable peekWallpaper()
WallpaperManager.peek()
instead.@Deprecated public abstract int getWallpaperDesiredMinimumWidth()
WallpaperManager.getDesiredMinimumWidth()
instead.@Deprecated public abstract int getWallpaperDesiredMinimumHeight()
WallpaperManager.getDesiredMinimumHeight()
instead.@Deprecated public abstract void setWallpaper(Bitmap bitmap) throws IOException
WallpaperManager.set()
instead.
This method requires the caller to hold the permission
android.Manifest.permission#SET_WALLPAPER
.
IOException
@Deprecated public abstract void setWallpaper(InputStream data) throws IOException
WallpaperManager.set()
instead.
This method requires the caller to hold the permission
android.Manifest.permission#SET_WALLPAPER
.
IOException
@Deprecated public abstract void clearWallpaper() throws IOException
WallpaperManager.clear()
instead.
This method requires the caller to hold the permission
android.Manifest.permission#SET_WALLPAPER
.
IOException
public abstract void startActivity(Intent intent)
startActivity(Intent, Bundle)
with no options
specified.intent
- The description of the activity to start.ActivityNotFoundException
#startActivity(Intent, Bundle)}
,
PackageManager.resolveActivity(android.content.Intent, int)
public void startActivityAsUser(Intent intent, UserHandle user)
startActivity(Intent)
that allows you to specify the
user the activity will be started for. This is not available to applications
that are not pre-installed on the system image. Using it requires holding
the INTERACT_ACROSS_USERS_FULL permission.intent
- The description of the activity to start.user
- The UserHandle of the user to start this activity for.ActivityNotFoundException
public abstract void startActivity(Intent intent, Bundle options)
Note that if this method is being called from outside of an
Activity
Context, then the Intent must include
the 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
if there was no Activity found to run the given Intent.
intent
- The description of the activity to start.options
- Additional options for how the Activity should be started.
May be null if there are no options. See ActivityOptions
for how to build the Bundle supplied here; there are no supported definitions
for building it manually.ActivityNotFoundException
startActivity(Intent)
,
PackageManager.resolveActivity(android.content.Intent, int)
public void startActivityAsUser(Intent intent, Bundle options, UserHandle userId)
startActivity(Intent, Bundle)
that allows you to specify the
user the activity will be started for. This is not available to applications
that are not pre-installed on the system image. Using it requires holding
the INTERACT_ACROSS_USERS_FULL permission.intent
- The description of the activity to start.options
- Additional options for how the Activity should be started.
May be null if there are no options. See ActivityOptions
for how to build the Bundle supplied here; there are no supported definitions
for building it manually.user
- The UserHandle of the user to start this activity for.ActivityNotFoundException
public abstract void startActivities(Intent[] intents)
startActivities(Intent[], Bundle)
with no options
specified.intents
- An array of Intents to be started.ActivityNotFoundException
#startActivities(Intent[], Bundle)}
,
PackageManager.resolveActivity(android.content.Intent, int)
public abstract void startActivities(Intent[] intents, Bundle options)
startActivity(Intent)
for the first Intent in the array,
that activity during its creation calling startActivity(Intent)
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
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.
intents
- An array of Intents to be started.options
- Additional options for how the Activity should be started.
See Context.startActivity(Intent, Bundle)
for more details.ActivityNotFoundException
#startActivities(Intent[])}
,
PackageManager.resolveActivity(android.content.Intent, int)
public void startActivitiesAsUser(Intent[] intents, Bundle options, UserHandle userHandle)
intents
- An array of Intents to be started.options
- Additional options for how the Activity should be started.userHandle
- The user for whom to launch the activities
See Context.startActivity(Intent, Bundle)
for more details.ActivityNotFoundException
#startActivities(Intent[])}
,
PackageManager.resolveActivity(android.content.Intent, int)
public abstract void startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags) throws IntentSender.SendIntentException
startIntentSender(IntentSender, Intent, int, int, int, Bundle)
with no options specified.intent
- The IntentSender to launch.fillInIntent
- If non-null, this will be provided as the
intent parameter to IntentSender.sendIntent(android.content.Context, int, android.content.Intent, android.content.IntentSender.OnFinished, android.os.Handler)
.flagsMask
- Intent flags in the original IntentSender that you
would like to change.flagsValues
- Desired values for any bits set in
flagsMaskextraFlags
- Always set to 0.IntentSender.SendIntentException
startActivity(Intent)
,
startIntentSender(IntentSender, Intent, int, int, int, Bundle)
public abstract void startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options) throws IntentSender.SendIntentException
startActivity(Intent, Bundle)
, 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(Intent)
here; otherwise, its associated action will be executed (such as
sending a broadcast) as if you had called
IntentSender.sendIntent
on it.intent
- The IntentSender to launch.fillInIntent
- If non-null, this will be provided as the
intent parameter to IntentSender.sendIntent(android.content.Context, int, android.content.Intent, android.content.IntentSender.OnFinished, android.os.Handler)
.flagsMask
- Intent flags in the original IntentSender that you
would like to change.flagsValues
- Desired values for any bits set in
flagsMaskextraFlags
- Always set to 0.options
- Additional options for how the Activity should be started.
See Context.startActivity(Intent, Bundle)
for more details. If options
have also been supplied by the IntentSender, options given here will
override any that conflict with those given by the IntentSender.IntentSender.SendIntentException
startActivity(Intent, Bundle)
,
startIntentSender(IntentSender, Intent, int, int, int)
public abstract void sendBroadcast(Intent intent)
sendOrderedBroadcast(Intent, String)
.
See BroadcastReceiver
for more information on Intent broadcasts.
intent
- The Intent to broadcast; all receivers matching this
Intent will receive the broadcast.BroadcastReceiver
,
registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter)
,
sendBroadcast(Intent, String)
,
sendOrderedBroadcast(Intent, String)
,
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)
public abstract void sendBroadcast(Intent intent, String receiverPermission)
sendOrderedBroadcast(Intent, String)
.
See BroadcastReceiver
for more information on Intent broadcasts.
intent
- The Intent to broadcast; all receivers matching this
Intent will receive the broadcast.receiverPermission
- (optional) String naming a permission that
a receiver must hold in order to receive your broadcast.
If null, no permission is required.BroadcastReceiver
,
registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter)
,
sendBroadcast(Intent)
,
sendOrderedBroadcast(Intent, String)
,
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)
public abstract void sendOrderedBroadcast(Intent intent, String receiverPermission)
See BroadcastReceiver
for more information on Intent broadcasts.
intent
- The Intent to broadcast; all receivers matching this
Intent will receive the broadcast.receiverPermission
- (optional) String naming a permissions that
a receiver must hold in order to receive your broadcast.
If null, no permission is required.BroadcastReceiver
,
registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter)
,
sendBroadcast(Intent)
,
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)
public abstract void sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)
sendBroadcast(Intent)
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
BroadcastReceiver.onReceive(android.content.Context, android.content.Intent)
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(Intent, String)
.
Like sendBroadcast(Intent)
, this method is
asynchronous; it will return before
resultReceiver.onReceive() is called.
See BroadcastReceiver
for more information on Intent broadcasts.
intent
- The Intent to broadcast; all receivers matching this
Intent will receive the broadcast.receiverPermission
- String naming a permissions that
a receiver must hold in order to receive your broadcast.
If null, no permission is required.resultReceiver
- Your own BroadcastReceiver to treat as the final
receiver of the broadcast.scheduler
- A custom Handler with which to schedule the
resultReceiver callback; if null it will be
scheduled in the Context's main thread.initialCode
- An initial value for the result code. Often
Activity.RESULT_OK.initialData
- An initial value for the result data. Often
null.initialExtras
- An initial value for the result extras. Often
null.sendBroadcast(Intent)
,
sendBroadcast(Intent, String)
,
sendOrderedBroadcast(Intent, String)
,
sendStickyBroadcast(Intent)
,
sendStickyOrderedBroadcast(Intent, BroadcastReceiver, Handler, int, String, Bundle)
,
BroadcastReceiver
,
registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter)
,
Activity.RESULT_OK
public abstract void sendBroadcastAsUser(Intent intent, UserHandle user)
sendBroadcast(Intent)
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. Using it requires holding
the INTERACT_ACROSS_USERS permission.intent
- The intent to broadcastuser
- UserHandle to send the intent to.sendBroadcast(Intent)
public abstract void sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)
sendBroadcast(Intent, String)
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. Using it requires holding
the INTERACT_ACROSS_USERS permission.intent
- The Intent to broadcast; all receivers matching this
Intent will receive the broadcast.user
- UserHandle to send the intent to.receiverPermission
- (optional) String naming a permission that
a receiver must hold in order to receive your broadcast.
If null, no permission is required.sendBroadcast(Intent, String)
public abstract void sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)
sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)
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. Using it requires holding
the INTERACT_ACROSS_USERS permission.
See BroadcastReceiver
for more information on Intent broadcasts.
intent
- The Intent to broadcast; all receivers matching this
Intent will receive the broadcast.user
- UserHandle to send the intent to.receiverPermission
- String naming a permissions that
a receiver must hold in order to receive your broadcast.
If null, no permission is required.resultReceiver
- Your own BroadcastReceiver to treat as the final
receiver of the broadcast.scheduler
- A custom Handler with which to schedule the
resultReceiver callback; if null it will be
scheduled in the Context's main thread.initialCode
- An initial value for the result code. Often
Activity.RESULT_OK.initialData
- An initial value for the result data. Often
null.initialExtras
- An initial value for the result extras. Often
null.sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)
public abstract void sendStickyBroadcast(Intent intent)
sendBroadcast(Intent)
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(BroadcastReceiver, IntentFilter)
. In
all other ways, this behaves the same as
sendBroadcast(Intent)
.
You must hold the android.Manifest.permission#BROADCAST_STICKY
permission in order to use this API. If you do not hold that
permission, SecurityException
will be thrown.
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.sendBroadcast(Intent)
,
sendStickyOrderedBroadcast(Intent, BroadcastReceiver, Handler, int, String, Bundle)
public abstract void sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)
sendStickyBroadcast(android.content.Intent)
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
BroadcastReceiver.onReceive(android.content.Context, android.content.Intent)
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(Intent, String)
.
Like sendBroadcast(Intent)
, this method is
asynchronous; it will return before
resultReceiver.onReceive() 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
for more information on Intent broadcasts.
intent
- The Intent to broadcast; all receivers matching this
Intent will receive the broadcast.resultReceiver
- Your own BroadcastReceiver to treat as the final
receiver of the broadcast.scheduler
- A custom Handler with which to schedule the
resultReceiver callback; if null it will be
scheduled in the Context's main thread.initialCode
- An initial value for the result code. Often
Activity.RESULT_OK.initialData
- An initial value for the result data. Often
null.initialExtras
- An initial value for the result extras. Often
null.sendBroadcast(Intent)
,
sendBroadcast(Intent, String)
,
sendOrderedBroadcast(Intent, String)
,
sendStickyBroadcast(Intent)
,
BroadcastReceiver
,
registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter)
,
Activity.RESULT_OK
public abstract void removeStickyBroadcast(Intent intent)
sendStickyBroadcast(android.content.Intent)
,
so that it is as if the sticky broadcast had never happened.
You must hold the android.Manifest.permission#BROADCAST_STICKY
permission in order to use this API. If you do not hold that
permission, SecurityException
will be thrown.
intent
- The Intent that was previously broadcast.sendStickyBroadcast(android.content.Intent)
public abstract void sendStickyBroadcastAsUser(Intent intent, UserHandle user)
sendStickyBroadcast(Intent)
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. Using it requires holding
the INTERACT_ACROSS_USERS permission.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 to send the intent to.sendBroadcast(Intent)
public abstract void sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)
sendStickyOrderedBroadcast(Intent, BroadcastReceiver, Handler, int, String, Bundle)
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. Using it requires holding
the INTERACT_ACROSS_USERS permission.
See BroadcastReceiver
for more information on Intent broadcasts.
intent
- The Intent to broadcast; all receivers matching this
Intent will receive the broadcast.user
- UserHandle to send the intent to.resultReceiver
- Your own BroadcastReceiver to treat as the final
receiver of the broadcast.scheduler
- A custom Handler with which to schedule the
resultReceiver callback; if null it will be
scheduled in the Context's main thread.initialCode
- An initial value for the result code. Often
Activity.RESULT_OK.initialData
- An initial value for the result data. Often
null.initialExtras
- An initial value for the result extras. Often
null.sendStickyOrderedBroadcast(Intent, BroadcastReceiver, Handler, int, String, Bundle)
public abstract void removeStickyBroadcastAsUser(Intent intent, UserHandle user)
removeStickyBroadcast(Intent)
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. Using it requires holding
the INTERACT_ACROSS_USERS permission.
You must hold the android.Manifest.permission#BROADCAST_STICKY
permission in order to use this API. If you do not hold that
permission, SecurityException
will be thrown.
intent
- The Intent that was previously broadcast.user
- UserHandle to remove the sticky broadcast from.sendStickyBroadcastAsUser(android.content.Intent, android.os.UserHandle)
public abstract Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter)
The system may broadcast Intents that are "sticky" -- these stay around after the broadcast as finished, to be sent to any later registrations. If your IntentFilter matches 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 your 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
for more information on Intent broadcasts.
As of Build.VERSION_CODES.ICE_CREAM_SANDWICH
, receivers
registered with this method will correctly respect the
Intent.setPackage(String)
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.
Note: this method cannot be called from a
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(android.content.BroadcastReceiver, android.content.IntentFilter)
, since the lifetime of such a
registered BroadcastReceiver is tied to the object that registered it.
receiver
- The BroadcastReceiver to handle the broadcast.filter
- Selects the Intent broadcasts to be received.registerReceiver(BroadcastReceiver, IntentFilter, String, Handler)
,
sendBroadcast(android.content.Intent)
,
unregisterReceiver(android.content.BroadcastReceiver)
public abstract Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)
registerReceiver(BroadcastReceiver, IntentFilter)
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
for more information on Intent broadcasts.
As of Build.VERSION_CODES.ICE_CREAM_SANDWICH
, receivers
registered with this method will correctly respect the
Intent.setPackage(String)
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.
receiver
- The BroadcastReceiver to handle the broadcast.filter
- Selects the Intent broadcasts to be received.broadcastPermission
- 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 identifying the thread that will receive
the Intent. If null, the main thread of the process will be used.registerReceiver(BroadcastReceiver, IntentFilter)
,
sendBroadcast(android.content.Intent)
,
unregisterReceiver(android.content.BroadcastReceiver)
public abstract Intent registerReceiverAsUser(BroadcastReceiver receiver, UserHandle user, IntentFilter filter, String broadcastPermission, Handler scheduler)
receiver
- The BroadcastReceiver to handle the broadcast.user
- UserHandle to send the intent to.filter
- Selects the Intent broadcasts to be received.broadcastPermission
- 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 identifying the thread that will receive
the Intent. If null, the main thread of the process will be used.#registerReceiver(BroadcastReceiver, IntentFilter, String, Handler
,
sendBroadcast(android.content.Intent)
,
unregisterReceiver(android.content.BroadcastReceiver)
public abstract void unregisterReceiver(BroadcastReceiver receiver)
receiver
- The BroadcastReceiver to unregister.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter)
public abstract ComponentName startService(Intent service)
Every call to this method will result in a corresponding call to
the target service's Service.onStartCommand(android.content.Intent, int, int)
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(android.content.Intent, android.content.ServiceConnection, int)
: it requires the service to remain
running until stopService(android.content.Intent)
is called, regardless of whether
any clients are connected to it. Note that calls to startService()
are not nesting: no matter how many times you call startService(),
a single call to stopService(android.content.Intent)
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
if you do not
have permission to start the given service.
service
- Identifies the service to be started. The Intent may
specify either an explicit component name to start, or a logical
description (action, category, etc) to match an
IntentFilter
published by a service. Additional values
may be included in the Intent extras to supply arguments along with
this specific start call.ComponentName
of the actual service that was started is
returned; else if the service does not exist null is returned.SecurityException
stopService(android.content.Intent)
,
bindService(android.content.Intent, android.content.ServiceConnection, int)
public abstract boolean stopService(Intent service)
Note that if a stopped service still has ServiceConnection
objects bound to it with the BIND_AUTO_CREATE
set, it will
not be destroyed until all of these bindings are removed. See
the Service
documentation for more details on a
service's lifecycle.
This function will throw SecurityException
if you do not
have permission to stop the given service.
service
- Description of the service to be stopped. The Intent may
specify either an explicit component name to start, or a logical
description (action, category, etc) to match an
IntentFilter
published by a service.SecurityException
startService(android.content.Intent)
public abstract ComponentName startServiceAsUser(Intent service, UserHandle user)
public abstract boolean stopServiceAsUser(Intent service, UserHandle user)
public abstract boolean bindService(Intent service, ServiceConnection conn, int flags)
This function will throw SecurityException
if you do not
have permission to bind to the given service.
Note: this method can not be called from a
BroadcastReceiver
component. A pattern you can use to
communicate from a BroadcastReceiver to a Service is to call
startService(android.content.Intent)
with the arguments containing the command to be
sent, with the service calling its
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(android.content.BroadcastReceiver, android.content.IntentFilter)
, since the lifetime of this BroadcastReceiver
is tied to another object (the one that registered it).
service
- Identifies the service to connect to. The Intent may
specify either an explicit component name, or a logical
description (action, category, etc) to match an
IntentFilter
published by a service.conn
- Receives information as the service is started and stopped.
This must be a valid ServiceConnection object; it must not be null.flags
- Operation options for the binding. May be 0,
BIND_AUTO_CREATE
, BIND_DEBUG_UNBIND
,
BIND_NOT_FOREGROUND
, BIND_ABOVE_CLIENT
,
BIND_ALLOW_OOM_MANAGEMENT
, or
BIND_WAIVE_PRIORITY
.SecurityException
unbindService(android.content.ServiceConnection)
,
startService(android.content.Intent)
,
BIND_AUTO_CREATE
,
BIND_DEBUG_UNBIND
,
BIND_NOT_FOREGROUND
public boolean bindService(Intent service, ServiceConnection conn, int flags, int userHandle)
bindService(Intent, ServiceConnection, int)
, but with an explicit userHandle
argument for use by system server and other multi-user aware code.public abstract void unbindService(ServiceConnection conn)
conn
- The connection interface previously supplied to
bindService(). This parameter must not be null.bindService(android.content.Intent, android.content.ServiceConnection, int)
public abstract boolean startInstrumentation(ComponentName className, String profileFile, Bundle arguments)
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).
className
- Name of the Instrumentation component to be run.profileFile
- Optional path to write profiling data as the
instrumentation runs, or null for no profiling.arguments
- Additional optional arguments to pass to the
instrumentation, or null.public abstract Object getSystemService(String name)
WINDOW_SERVICE
("window")
WindowManager
.
LAYOUT_INFLATER_SERVICE
("layout_inflater")
LayoutInflater
for inflating layout resources
in this context.
ACTIVITY_SERVICE
("activity")
ActivityManager
for interacting with the
global activity state of the system.
POWER_SERVICE
("power")
PowerManager
for controlling power
management.
ALARM_SERVICE
("alarm")
AlarmManager
for receiving intents at the
time of your choosing.
NOTIFICATION_SERVICE
("notification")
NotificationManager
for informing the user
of background events.
KEYGUARD_SERVICE
("keyguard")
KeyguardManager
for controlling keyguard.
LOCATION_SERVICE
("location")
LocationManager
for controlling location
(e.g., GPS) updates.
SEARCH_SERVICE
("search")
SearchManager
for handling search.
VIBRATOR_SERVICE
("vibrator")
Vibrator
for interacting with the vibrator
hardware.
CONNECTIVITY_SERVICE
("connection")
ConnectivityManager
for
handling management of network connections.
WIFI_SERVICE
("wifi")
WifiManager
for management of
Wi-Fi connectivity.
INPUT_METHOD_SERVICE
("input_method")
InputMethodManager
for management of input methods.
UI_MODE_SERVICE
("uimode")
UiModeManager
for controlling UI modes.
DOWNLOAD_SERVICE
("download")
DownloadManager
for requesting HTTP downloads
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.)
name
- The name of the desired service.WINDOW_SERVICE
,
WindowManager
,
LAYOUT_INFLATER_SERVICE
,
LayoutInflater
,
ACTIVITY_SERVICE
,
ActivityManager
,
POWER_SERVICE
,
PowerManager
,
ALARM_SERVICE
,
AlarmManager
,
NOTIFICATION_SERVICE
,
NotificationManager
,
KEYGUARD_SERVICE
,
KeyguardManager
,
LOCATION_SERVICE
,
LocationManager
,
SEARCH_SERVICE
,
SearchManager
,
SENSOR_SERVICE
,
SensorManager
,
STORAGE_SERVICE
,
StorageManager
,
VIBRATOR_SERVICE
,
Vibrator
,
CONNECTIVITY_SERVICE
,
ConnectivityManager
,
WIFI_SERVICE
,
WifiManager
,
AUDIO_SERVICE
,
AudioManager
,
MEDIA_ROUTER_SERVICE
,
MediaRouter
,
TELEPHONY_SERVICE
,
TelephonyManager
,
INPUT_METHOD_SERVICE
,
InputMethodManager
,
UI_MODE_SERVICE
,
UiModeManager
,
DOWNLOAD_SERVICE
,
DownloadManager
public abstract int checkPermission(String permission, int pid, int uid)
permission
- The name of the permission being checked.pid
- The process ID being checked against. Must be > 0.uid
- The user ID being checked against. A uid of 0 is the root
user, which will pass every permission check.PackageManager.PERMISSION_GRANTED
if the given
pid/uid is allowed that permission, or
PackageManager.PERMISSION_DENIED
if it is not.PackageManager.checkPermission(String, String)
,
checkCallingPermission(java.lang.String)
public abstract int checkCallingPermission(String permission)
checkPermission(String, int, int)
with the pid and uid returned
by Binder.getCallingPid()
and
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(java.lang.String)
to avoid this protection.permission
- The name of the permission being checked.PackageManager.PERMISSION_GRANTED
if the calling
pid/uid is allowed that permission, or
PackageManager.PERMISSION_DENIED
if it is not.PackageManager.checkPermission(String, String)
,
checkPermission(java.lang.String, int, int)
,
checkCallingOrSelfPermission(java.lang.String)
public abstract int checkCallingOrSelfPermission(String permission)
checkCallingPermission(java.lang.String)
, except it grants your own permissions
if you are not currently processing an IPC. Use with care!permission
- The name of the permission being checked.PackageManager.PERMISSION_GRANTED
if the calling
pid/uid is allowed that permission, or
PackageManager.PERMISSION_DENIED
if it is not.PackageManager.checkPermission(String, String)
,
checkPermission(java.lang.String, int, int)
,
checkCallingPermission(java.lang.String)
public abstract void enforcePermission(String permission, int pid, int uid, String message)
SecurityException
.permission
- The name of the permission being checked.pid
- The process ID being checked against. Must be > 0.uid
- The user ID being checked against. A uid of 0 is the root
user, which will pass every permission check.message
- A message to include in the exception if it is thrown.checkPermission(String, int, int)
public abstract void enforceCallingPermission(String permission, String message)
SecurityException
. This is basically the same as calling
enforcePermission(String, int, int, String)
with the
pid and uid returned by Binder.getCallingPid()
and 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(java.lang.String, java.lang.String)
to avoid this
protection.permission
- The name of the permission being checked.message
- A message to include in the exception if it is thrown.checkCallingPermission(String)
public abstract void enforceCallingOrSelfPermission(String permission, String message)
SecurityException
. This is the same as enforceCallingPermission(java.lang.String, java.lang.String)
, except it grants your own
permissions if you are not currently processing an IPC. Use
with care!permission
- The name of the permission being checked.message
- A message to include in the exception if it is thrown.checkCallingOrSelfPermission(String)
public abstract void grantUriPermission(String toPackage, Uri uri, int modeFlags)
Normally you should use Intent.FLAG_GRANT_READ_URI_PERMISSION
or
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(android.net.Uri, int)
when the target should no longer be allowed
to access it.
To succeed, the content provider owning the Uri must have set the
grantUriPermissions
attribute in its manifest or included the
<grant-uri-permissions>
tag.
toPackage
- The package you would like to allow to access the Uri.uri
- The Uri you would like to grant access to.modeFlags
- The desired access modes. Any combination of
Intent.FLAG_GRANT_READ_URI_PERMISSION
or
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
.revokeUriPermission(android.net.Uri, int)
public abstract void revokeUriPermission(Uri uri, int modeFlags)
grantUriPermission(java.lang.String, android.net.Uri, int)
. 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/one" will
revoke both "content://foo/target" and "content://foo/target/sub", but not
"content://foo".uri
- The Uri you would like to revoke access to.modeFlags
- The desired access modes. Any combination of
Intent.FLAG_GRANT_READ_URI_PERMISSION
or
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
.grantUriPermission(java.lang.String, android.net.Uri, int)
public abstract int checkUriPermission(Uri uri, int pid, int uid, int modeFlags)
uri
- The uri that is being checked.pid
- The process ID being checked against. Must be > 0.uid
- The user ID being checked against. A uid of 0 is the root
user, which will pass every permission check.modeFlags
- The type of access to grant. May be one or both of
Intent.FLAG_GRANT_READ_URI_PERMISSION
or
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
.PackageManager.PERMISSION_GRANTED
if the given
pid/uid is allowed to access that uri, or
PackageManager.PERMISSION_DENIED
if it is not.checkCallingUriPermission(android.net.Uri, int)
public abstract int checkCallingUriPermission(Uri uri, int modeFlags)
checkUriPermission(Uri, int, int,
int)
with the pid and uid returned by Binder.getCallingPid()
and Binder.getCallingUid()
. One important difference is
that if you are not currently processing an IPC, this function
will always fail.uri
- The uri that is being checked.modeFlags
- The type of access to grant. May be one or both of
Intent.FLAG_GRANT_READ_URI_PERMISSION
or
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
.PackageManager.PERMISSION_GRANTED
if the caller
is allowed to access that uri, or
PackageManager.PERMISSION_DENIED
if it is not.checkUriPermission(Uri, int, int, int)
public abstract int checkCallingOrSelfUriPermission(Uri uri, int modeFlags)
checkCallingUriPermission(android.net.Uri, int)
, except it grants your own permissions
if you are not currently processing an IPC. Use with care!uri
- The uri that is being checked.modeFlags
- The type of access to grant. May be one or both of
Intent.FLAG_GRANT_READ_URI_PERMISSION
or
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
.PackageManager.PERMISSION_GRANTED
if the caller
is allowed to access that uri, or
PackageManager.PERMISSION_DENIED
if it is not.checkCallingUriPermission(android.net.Uri, int)
public abstract int checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)
checkPermission(java.lang.String, int, int)
and checkUriPermission(android.net.Uri, int, int, int)
in one
call.uri
- The Uri whose permission is to be checked, or null to not
do this check.readPermission
- The permission that provides overall read access,
or null to not do this check.writePermission
- The permission that provides overall write
acess, or null to not do this check.pid
- The process ID being checked against. Must be > 0.uid
- The user ID being checked against. A uid of 0 is the root
user, which will pass every permission check.modeFlags
- The type of access to grant. May be one or both of
Intent.FLAG_GRANT_READ_URI_PERMISSION
or
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
.PackageManager.PERMISSION_GRANTED
if the caller
is allowed to access that uri or holds one of the given permissions, or
PackageManager.PERMISSION_DENIED
if it is not.public abstract void enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)
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.uri
- The uri that is being checked.pid
- The process ID being checked against. Must be > 0.uid
- The user ID being checked against. A uid of 0 is the root
user, which will pass every permission check.modeFlags
- The type of access to grant. May be one or both of
Intent.FLAG_GRANT_READ_URI_PERMISSION
or
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
.message
- A message to include in the exception if it is thrown.checkUriPermission(Uri, int, int, int)
public abstract void enforceCallingUriPermission(Uri uri, int modeFlags, String message)
SecurityException
. This is basically the same as calling
enforceUriPermission(Uri, int, int, int, String)
with
the pid and uid returned by Binder.getCallingPid()
and Binder.getCallingUid()
. One important difference is
that if you are not currently processing an IPC, this function
will always throw a SecurityException.uri
- The uri that is being checked.modeFlags
- The type of access to grant. May be one or both of
Intent.FLAG_GRANT_READ_URI_PERMISSION
or
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
.message
- A message to include in the exception if it is thrown.checkCallingUriPermission(Uri, int)
public abstract void enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)
SecurityException
. This is the same as enforceCallingUriPermission(android.net.Uri, int, java.lang.String)
, except it grants your own
permissions if you are not currently processing an IPC. Use
with care!uri
- The uri that is being checked.modeFlags
- The type of access to grant. May be one or both of
Intent.FLAG_GRANT_READ_URI_PERMISSION
or
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
.message
- A message to include in the exception if it is thrown.checkCallingOrSelfUriPermission(Uri, int)
public abstract void enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)
enforcePermission(java.lang.String, int, int, java.lang.String)
and enforceUriPermission(android.net.Uri, int, int, int, java.lang.String)
in one
call.uri
- The Uri whose permission is to be checked, or null to not
do this check.readPermission
- The permission that provides overall read access,
or null to not do this check.writePermission
- The permission that provides overall write
acess, or null to not do this check.pid
- The process ID being checked against. Must be > 0.uid
- The user ID being checked against. A uid of 0 is the root
user, which will pass every permission check.modeFlags
- The type of access to grant. May be one or both of
Intent.FLAG_GRANT_READ_URI_PERMISSION
or
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
.message
- A message to include in the exception if it is thrown.checkUriPermission(Uri, String, String, int, int, int)
public abstract Context createPackageContext(String packageName, int flags) throws PackageManager.NameNotFoundException
Throws PackageManager.NameNotFoundException
if there is no
application with the given package name.
Throws SecurityException
if the Context requested
can not be loaded into the caller's process for security reasons (see
CONTEXT_INCLUDE_CODE
for more information}.
packageName
- Name of the application's package.flags
- Option flags, one of CONTEXT_INCLUDE_CODE
or CONTEXT_IGNORE_SECURITY
.SecurityException
PackageManager.NameNotFoundException
- if there is no application with
the given package namepublic abstract Context createPackageContextAsUser(String packageName, int flags, UserHandle user) throws PackageManager.NameNotFoundException
createPackageContext(String, int)
, but with a
different UserHandle
. For example, getContentResolver()
will open any Uri
as the given user.public abstract Context createConfigurationContext(Configuration overrideConfiguration)
overrideConfiguration
- A 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.public abstract Context createDisplayContext(Display display)
WindowManager
(see getSystemService(String)
) that is configured to show windows
on the given display. The WindowManager's WindowManager.getDefaultDisplay()
method can be used to retrieve the Display from the returned Context.display
- A Display
object specifying the display
for whose metrics the Context's resources should be tailored and upon which
new windows should be shown.public abstract CompatibilityInfoHolder getCompatibilityInfo(int displayId)
displayId
- The display id for which to get compatibility info.public boolean isRestricted()
CONTEXT_RESTRICTED