Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Document startService cost" into nyc-dev

Browse Source
This commit is contained in:
Chris Craik
2016-04-19 21:08:12 +00:00
committed by Android (Google) Code Review
parent 6bf86d5e5c 1e35352763
commit 6ed4e35e49
1 changed files with 9 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
core/java/android/content/Context.java
View File

@@ -2446,6 +2446,15 @@ public abstract class Context {
* <p>This function will throw {@link SecurityException} if you do not * <p>This function will throw {@link SecurityException} if you do not
* have permission to start the given service. * have permission to start the given service.
* *
* <p class="note"><strong>Note:</strong> Each call to startService()
* results in significant work done by the system to manage service
* lifecycle surrounding the processing of the intent, which can take
* multiple milliseconds of CPU time. Due to this cost, startService()
* should not be used for frequent intent delivery to a service, and only
* for scheduling significant work. Use {@link #bindService bound services}
* for high frequency calls.
* </p>
*
* @param service Identifies the service to be started. The Intent must be either * @param service Identifies the service to be started. The Intent must be either
* fully explicit (supplying a component name) or specify a specific package * fully explicit (supplying a component name) or specify a specific package
* name it is targetted to. Additional values * name it is targetted to. Additional values