summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
author Andrew Solovay <asolovay@google.com> 2017-08-01 21:07:18 +0000
committer Android (Google) Code Review <android-gerrit@google.com> 2017-08-01 21:07:18 +0000
commitd71cc3b72eadc8ad0f07651c63764edb6a96f0e2 (patch)
tree2dc2a73d1d2072bc57c6384b3173918c13def939
parentd88f4b723d3d26020d3cfa811203f9183aa5e1b0 (diff)
parent494f1a4dfa8abba5b468349a5375ec7a0194a91f (diff)
Merge "docs: Noted that JobIntentService is usually a better choice" into oc-dev
-rw-r--r--core/java/android/app/IntentService.java8
1 files changed, 8 insertions, 0 deletions
diff --git a/core/java/android/app/IntentService.java b/core/java/android/app/IntentService.java
index e4a22c42d9bc..95ec24cdb9c5 100644
--- a/core/java/android/app/IntentService.java
+++ b/core/java/android/app/IntentService.java
@@ -43,6 +43,13 @@ import android.os.Message;
* long as necessary (and will not block the application's main loop), but
* only one request will be processed at a time.
*
+ * <p class="note"><b>Note:</b> IntentService is subject to all the
+ * <a href="/preview/features/background.html">background execution limits</a>
+ * imposed with Android 8.0 (API level 26). In most cases, you are better off
+ * using {@link android.support.v4.app.JobIntentService}, which uses jobs
+ * instead of services when running on Android 8.0 or higher.
+ * </p>
+ *
* <div class="special reference">
* <h3>Developer Guides</h3>
* <p>For a detailed discussion about how to create services, read the
@@ -50,6 +57,7 @@ import android.os.Message;
* guide.</p>
* </div>
*
+ * @see android.support.v4.app.JobIntentService
* @see android.os.AsyncTask
*/
public abstract class IntentService extends Service {