Home How it Works Android APIMiner IDE Version More Info

to top

fullscreen Use Tree Navigation

Summary: Constants | Methods | Inherited Methods | [Expand All]

Added in API level 14

public interface

ComponentCallbacks2

implements ComponentCallbacks

android.content.ComponentCallbacks2

Known Indirect Subclasses

AbstractInputMethodService, AccessibilityService, AccountAuthenticatorActivity, Activity, ActivityGroup, AliasActivity, Application, ContentProvider, DialogFragment, DreamService, ExpandableListActivity, Fragment, and 18 others.

AbstractInputMethodService	AbstractInputMethodService provides a abstract base class for input methods.
AccessibilityService	An accessibility service runs in the background and receives callbacks by the system when `AccessibilityEvent`s are fired.
AccountAuthenticatorActivity	Base class for implementing an Activity that is used to help implement an AbstractAccountAuthenticator.
Activity	An activity is a single, focused thing that the user can do.
ActivityGroup	This class was deprecated in API level 13. Use the new `Fragment` and `FragmentManager` APIs instead; these are also available on older platforms through the Android compatibility package.
AliasActivity	Stub activity that launches another activity (and then finishes itself) based on information in its component's manifest meta-data.
Application	Base class for those who need to maintain global application state.
ContentProvider	Content providers are one of the primary building blocks of Android applications, providing content to applications.
DialogFragment	A fragment that displays a dialog window, floating on top of its activity's window.
DreamService	Extend this class to implement a custom dream (available to the user as a "Daydream").
ExpandableListActivity	An activity that displays an expandable list of items by binding to a data source implementing the ExpandableListAdapter, and exposes event handlers when the user selects an item.
Fragment	A Fragment is a piece of an application's user interface or behavior that can be placed in an `Activity`.
FragmentActivity	Base class for activities that want to use the support-based `Fragment` and `Loader` APIs.
InputMethodService	InputMethodService provides a standard implementation of an InputMethod, which final implementations can derive from and customize.
IntentService	IntentService is a base class for `Service`s that handle asynchronous requests (expressed as `Intent`s) on demand.
LauncherActivity	Displays a list of all activities which can be performed for a given intent.
ListActivity	An activity that displays a list of items by binding to a data source such as an array or Cursor, and exposes event handlers when the user selects an item.
ListFragment	A fragment that displays a list of items by binding to a data source such as an array or Cursor, and exposes event handlers when the user selects an item.
MockApplication	A mock `Application` class.
MockContentProvider	Mock implementation of ContentProvider.
NativeActivity	Convenience for implementing an activity that will be implemented purely in native code.
PreferenceActivity	This is the base class for an activity to show a hierarchy of preferences to the user.
PreferenceFragment	Shows a hierarchy of `Preference` objects as lists.
RecognitionService	This class provides a base class for recognition service implementations.
RemoteViewsService	The service to be connected to for a remote adapter to request RemoteViews.
SearchRecentSuggestionsProvider	This superclass can be used to create a simple search suggestions provider for your application.
Service	A Service is an application component representing either an application's desire to perform a longer-running operation while not interacting with the user or to supply functionality for other applications to use.
SpellCheckerService	SpellCheckerService provides an abstract base class for a spell checker.
TabActivity	This class was deprecated in API level 13. New applications should use Fragments instead of this class; to continue to run on older devices, you can use the v4 support library which provides a version of the Fragment API that is compatible down to `DONUT`.
TextToSpeechService	Abstract base class for TTS engine implementations.
VpnService	VpnService is a base class for applications to extend and build their own VPN solutions.
WallpaperService	A wallpaper service is responsible for showing a live wallpaper behind applications that would like to sit on top of it.
WebViewFragment	A fragment that displays a WebView.

Class Overview

Extended ComponentCallbacks interface with a new callback for finer-grained memory management.

Summary

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

Public Methods
? Examples	abstract void	onTrimMemory(int level) Called when the operating system has determined that it is a good time for a process to trim unneeded memory from its process.

[Expand]

Inherited Methods

From interface android.content.ComponentCallbacks

Constants

public static final int TRIM_MEMORY_BACKGROUND

Added in API level 14

Level for onTrimMemory(int): the process has gone on to the LRU list. This is a good opportunity to clean up resources that can efficiently and quickly be re-built if the user returns to the app.

Constant Value: 40 (0x00000028)

public static final int TRIM_MEMORY_COMPLETE

Added in API level 14

Level for onTrimMemory(int): the process is nearing the end of the background LRU list, and if more memory isn't found soon it will be killed.

Constant Value: 80 (0x00000050)

public static final int TRIM_MEMORY_MODERATE

Added in API level 14

Level for onTrimMemory(int): the process is around the middle of the background LRU list; freeing memory can help the system keep other processes running later in the list for better overall performance.

Constant Value: 60 (0x0000003c)

public static final int TRIM_MEMORY_RUNNING_CRITICAL

Added in API level 16

Level for onTrimMemory(int): the process is not an expendable background process, but the device is running extremely low on memory and is about to not be able to keep any background processes running. Your running process should free up as many non-critical resources as it can to allow that memory to be used elsewhere. The next thing that will happen after this is onLowMemory() called to report that nothing at all can be kept in the background, a situation that can start to notably impact the user.

Constant Value: 15 (0x0000000f)

public static final int TRIM_MEMORY_RUNNING_LOW

Added in API level 16

Level for onTrimMemory(int): the process is not an expendable background process, but the device is running low on memory. Your running process should free up unneeded resources to allow that memory to be used elsewhere.

Constant Value: 10 (0x0000000a)

public static final int TRIM_MEMORY_RUNNING_MODERATE

Added in API level 16

Level for onTrimMemory(int): the process is not an expendable background process, but the device is running moderately low on memory. Your running process may want to release some unneeded resources for use elsewhere.

Constant Value: 5 (0x00000005)

public static final int TRIM_MEMORY_UI_HIDDEN

Added in API level 14

Level for onTrimMemory(int): the process had been showing a user interface, and is no longer doing so. Large allocations with the UI should be released at this point to allow memory to be better managed.

Constant Value: 20 (0x00000014)

Public Methods

public abstract void onTrimMemory (int level)

Added in API level 14

Called when the operating system has determined that it is a good time for a process to trim unneeded memory from its process. This will happen for example when it goes in the background and there is not enough memory to keep as many background processes running as desired. You should never compare to exact values of the level, since new intermediate values may be added -- you will typically want to compare if the value is greater or equal to a level you are interested in.

To retrieve the processes current trim level at any point, you can use ActivityManager.getMyMemoryState(RunningAppProcessInfo).

Parameters

level	The context of the trim, giving a hint of the amount of trimming the application may like to perform. May be `TRIM_MEMORY_COMPLETE`, `TRIM_MEMORY_MODERATE`, `TRIM_MEMORY_BACKGROUND`, `TRIM_MEMORY_UI_HIDDEN`, `TRIM_MEMORY_RUNNING_CRITICAL`, `TRIM_MEMORY_RUNNING_LOW`, or `TRIM_MEMORY_RUNNING_MODERATE`.

information

No examples for this method.

Frequently called with: [Clear]

This example was provided by APIMiner.

Portions of this page are reproduced from work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. The original page is available here.

Results

Interfaces

Classes

Exceptions

ComponentCallbacks2

Class Overview

Summary

Constants

public static final int TRIM_MEMORY_BACKGROUND

public static final int TRIM_MEMORY_COMPLETE

public static final int TRIM_MEMORY_MODERATE

public static final int TRIM_MEMORY_RUNNING_CRITICAL

public static final int TRIM_MEMORY_RUNNING_LOW

public static final int TRIM_MEMORY_RUNNING_MODERATE

public static final int TRIM_MEMORY_UI_HIDDEN

Public Methods

public abstract void onTrimMemory (int level)

Parameters