深入理解JobScheduler与JobService的使用

JobScheduler和JobService是安卓在api 21中增加的接口,用于在某些指定条件下执行后台任务。

JobScheduler

JobScheduler是用于计划基于应用进程的多种类型任务的api接口。

  • 对象获取方法:[Context.getSystemService(Context.JOB_SCHEDULER_SERVICE)]
  • 使用JobInfo.Builder.JobInfo.Builder(int, android.content.ComponentName)构造JobInfo对象,并作为参数传给JobSechduler的schedule(JobInfo)方法。
  • 当JobInfo中声明的执行条件满足时,系统会在应用的JobService中启动执行这个任务。
    当任务执行时,系统会为你的应用持有WakeLock,所以应用不需要做多余的确保设备唤醒的工作。

JobService

public abstract class JobService
extends Service
JobService继承自Service,是用于处理JobScheduler中规划的异步请求的特殊Service

  • 使用JobService必须先在AndroidManifest.xml中声明service和权限
    <service android:name="MyJobService" android:permission="android.permission.BIND_JOB_SERVICE"/ >
  • 应用需要实现onStartJob(JobParameters)接口,在其中执行任务逻辑。
  • 这个Service会在一个运行在主线程的Handler中执行规划的任务,所以应用需要在另外的thread/handler/AsyncTask中执行业务逻辑,如果不这么做的话可能会引起主线程的阻塞。
  • onStopJob(android.app.job.JobParameters)接口是当计划的执行条件“不再”满足时被执行的(例如网络中断)。

设置周期性任务

    private static final int JOB_INFO_ID = 10001;
    private static final long JOB_PERIODIC = 5 * 1000L;
    private void onJobStartClick() {
        JobScheduler jobScheduler = (JobScheduler) getSystemService(JOB_SCHEDULER_SERVICE);
        ComponentName componentName = new ComponentName(this, MyJobService.class);
        JobInfo jobinfo = new JobInfo.Builder(JOB_INFO_ID, componentName)
                .setPeriodic(JOB_PERIODIC)
                .build();
    }

周期periodic设置为5秒->运行,会发现JobService没有被启动,为什么?

setPeriodic的最小执行间隔

源码里来找答案:android/frameworks/base/core/java/android/app/job/JobInfo.java

      /* Minimum interval for a periodic job, in milliseconds. */
      private static final long MIN_PERIOD_MILLIS = 15 * 60 * 1000L;   // 15 minutes
      /* Minimum flex for a periodic job, in milliseconds. */
      private static final long MIN_FLEX_MILLIS = 5 * 60 * 1000L; // 5 minutes

      /**
       * Specify that this job should recur with the provided interval, not more than once per
       * period. You have no control over when within this interval this job will be executed,
       * only the guarantee that it will be executed at most once within this interval.
       * Setting this function on the builder with {@link #setMinimumLatency(long)} or
       * {@link #setOverrideDeadline(long)} will result in an error.
       * @param intervalMillis Millisecond interval for which this job will repeat.
       */
      public Builder setPeriodic(long intervalMillis) {
          return setPeriodic(intervalMillis, intervalMillis);
      }
      /**
       * Specify that this job should recur with the provided interval and flex. The job can
       * execute at any time in a window of flex length at the end of the period.
       * @param intervalMillis Millisecond interval for which this job will repeat. A minimum
       *                       value of {@link #getMinPeriodMillis()} is enforced.
       * @param flexMillis Millisecond flex for this job. Flex is clamped to be at least
       *                   {@link #getMinFlexMillis()} or 5 percent of the period, whichever is
       *                   higher.
       */
      public Builder setPeriodic(long intervalMillis, long flexMillis) {
          mIsPeriodic = true;
          mIntervalMillis = intervalMillis;
          mFlexMillis = flexMillis;
          mHasEarlyConstraint = mHasLateConstraint = true;
          return this;
      }

      /**
       * Query the minimum interval allowed for periodic scheduled jobs.  Attempting
       * to declare a smaller period that this when scheduling a job will result in a
       * job that is still periodic, but will run with this effective period.
       *
       * @return The minimum available interval for scheduling periodic jobs, in milliseconds.
       */
      public static final long getMinPeriodMillis() {
          return MIN_PERIOD_MILLIS;
      }
      /**
       * Set to the interval between occurrences of this job. This value is <b>not</b> set if the
       * job does not recur periodically.
       */
      public long getIntervalMillis() {
          final long minInterval = getMinPeriodMillis();
          return intervalMillis >= minInterval ? intervalMillis : minInterval;
      }

总结几个要点:

  • 可以看到系统默认设置了一个最小间隔时间15分钟,在获取执行间隔时,会先比较最小间隔时间和设置的间隔时间,取其中大的那个。所以setPeriodic设置时间小于15分钟是不会生效的。
  • flexMillis参数是用来设置周期任务执行的活动时间的,这意味着JobScheduler规划的任务不是在精确的时间执行的。并且这个时间也是有最小值的,系统默认5分钟。
  • setMinimumLatency和setOverrideDeadline不能同setPeriodic一起使用,会引起报错,另外还有一些其他规则,看源码:
        /**
         * @return The job object to hand to the JobScheduler. This object is immutable.
         */
        public JobInfo build() {
            // Allow jobs with no constraints - What am I, a database?
            if (!mHasEarlyConstraint && !mHasLateConstraint && mConstraintFlags == 0 &&
                    mNetworkType == NETWORK_TYPE_NONE &&
                    mTriggerContentUris == null) {
                throw new IllegalArgumentException("You're trying to build a job with no " +
                        "constraints, this is not allowed.");
            }
            // Check that a deadline was not set on a periodic job.
            if (mIsPeriodic) {
                if (mMaxExecutionDelayMillis != 0L) {
                    throw new IllegalArgumentException("Can't call setOverrideDeadline() on a " +
                            "periodic job.");
                }
                if (mMinLatencyMillis != 0L) {
                    throw new IllegalArgumentException("Can't call setMinimumLatency() on a " +
                            "periodic job");
                }
                if (mTriggerContentUris != null) {
                    throw new IllegalArgumentException("Can't call addTriggerContentUri() on a " +
                            "periodic job");
                }
            }
            if (mIsPersisted) {
                if (mTriggerContentUris != null) {
                    throw new IllegalArgumentException("Can't call addTriggerContentUri() on a " +
                            "persisted job");
                }
                if (!mTransientExtras.isEmpty()) {
                    throw new IllegalArgumentException("Can't call setTransientExtras() on a " +
                            "persisted job");
                }
                if (mClipData != null) {
                    throw new IllegalArgumentException("Can't call setClipData() on a " +
                            "persisted job");
                }
            }
            if (mBackoffPolicySet && (mConstraintFlags & CONSTRAINT_FLAG_DEVICE_IDLE) != 0) {
                throw new IllegalArgumentException("An idle mode job will not respect any" +
                        " back-off policy, so calling setBackoffCriteria with" +
                        " setRequiresDeviceIdle is an error.");
            }
            JobInfo job = new JobInfo(this);
            ....
            return job;
        }

如何查看自己的JobService的运行?

adb给我们提供了dumpsys工具:
adb shell dumpsys jobscheduler

  JOB #u0a122/10001: 945a633 com.fantasy.android.demo/.android.job.MyJobService
    u0a122 tag=*job*/com.fantasy.android.demo/.android.job.MyJobService
    Source: uid=u0a122 user=0 pkg=com.fantasy.android.demo
    JobInfo:
      Service: com.fantasy.android.demo/.android.job.MyJobService
      PERIODIC: interval=+1h0m0s0ms flex=+1h0m0s0ms
      Requires: charging=false batteryNotLow=false deviceIdle=false
      Backoff: policy=1 initial=+30s0ms
      Has early constraint
      Has late constraint
    Required constraints: TIMING_DELAY DEADLINE
    Satisfied constraints: APP_NOT_IDLE DEVICE_NOT_DOZING
    Unsatisfied constraints: TIMING_DELAY DEADLINE
    Tracking: TIME
    Enqueue time: -5m38s906ms
    Run time: earliest=+54m21s65ms, latest=+1h54m21s65ms
    Last successful run: 2018-01-02 13:07:16
    Ready: false (job=false user=true !pending=true !active=true !backingup=true comp=true)

JobService的使用:

继承JobService实现他的两个接口

public class MyJobService extends JobService{
    private static final String TAG = "MyJobService";
    @Override
    public boolean onStartJob(JobParameters jobParameters) {
        Log.d(TAG, "onStartJob-->");
        return false;
    }

    @Override
    public boolean onStopJob(JobParameters jobParameters) {
        Log.d(TAG, "onStopJob-->");
        return false;
    }
}
  • Android准备好执行任务时,服务就会启动,此时会在主线程上收到onStartJob()方法调用。
    该方法返回false结果表示该任务已经全部做完,此时系统会解绑该JobService,最终会调用JobService的onDestroy()方法,效果就如同自己调用了jobFinished()方法一样。
    返回 true 结果则表示任务已经启动成功,但还没有全部做完,此时可以在任务完成后,应用自行调用jobFinished方法。

  • onStopJob(JobParameters)方法是在中断任务时调用,例如用户需要服务在有充电时才运行,如果在调用JobFinished()之前(任务完成之前)充电器拔掉,onStopJob(...) 方法就会被调用,也就是说,一切任务就立即停止了。
    调用 onStopJob(...) 方法就是表明,服务马上就要被停掉,这里返回 true 表示:“任务应该计划在下次继续。”返回 false 表示:“不管怎样,事情就到此结束吧,不要计划下次了。”

  • 关于jobFinished()
    public final void jobFinished (JobParameters params, boolean wantsReschedule)
    Job的任务执行完毕后,APP端自己调用,用以通知JobScheduler已经完成了任务。
    注意:该方法执行完后不会回调onStopJob(),但是会回调onDestroy()
    当wantsReschedule参数设置为true时,表示任务需要另外规划时间进行执行。
    而这个执行的时间受限与JobInfo的退避规则。

设置退避规则

setBackoffCriteria
public [JobInfo.Builder] setBackoffCriteria (long initialBackoffMillis, int backoffPolicy)

  • initialBackoffMillis是第一次尝试重试的等待间隔,单位为毫秒,预设的参数有:
    DEFAULT_INITIAL_BACKOFF_MILLIS
    30000
    MAX_BACKOFF_DELAY_MILLIS
    18000000
  • backoffPolicy是对应的退避策略,预设的参数有:
    BACKOFF_POLICY_EXPONENTIAL
    二进制退避,等待间隔呈指数增长
    retry_time(current_time, num_failures) = current_time + initial_backoff_millis * 2 ^ (num_failures - 1), num_failures >= 1
    BACKOFF_POLICY_LINEAR
    线性退避,等待间隔呈线性增长
    retry_time(current_time, num_failures) = current_time + initial_backoff_millis * num_failures, num_failures >= 1

如何查看JobScheduler为应用持有的WakeLock

adb shell dumpsys power com.fantasy.android.demo | grep Wake

参考文章:
https://blog.csdn.net/allisonchen/article/details/79240163
https://blog.csdn.net/allisonchen/article/details/79218713
https://www.cnblogs.com/chase1/p/7221916.html

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,117评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,328评论 1 293
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,839评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,007评论 0 206
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,384评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,629评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,880评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,593评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,313评论 1 243
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,575评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,066评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,392评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,052评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,082评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,844评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,662评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,575评论 2 270

推荐阅读更多精彩内容

  • Android Jobscheduler使用 Until android API 25 一、Jobschedule...
    芥末末的沫阅读 49,923评论 11 89
  • 在一篇关于网络优化的博文中发现了这个词。我们的项目中并没有使用到这个东西,但看了一下还是非常好用的,mark一下以...
    MinuitZ阅读 32,477评论 0 26
  • JobScheduler JobScheduler是Android L(API21)新增的特性,用于定义满足某些条...
    Skywalker_Yang阅读 9,212评论 0 4
  • 此文献给我的御用模特正能量小公主大狗琼 1 大琼是一个温州姑娘。 我和大琼的缘分始于军训时,她刚好排在我的旁边。因...
    斯费阅读 537评论 6 1
  • 莫名地很火大。 很烦躁。 一堆的事情。 一堆啊。 搞得我一件都不想做。 (つಥ㉨ಥ)つ (>﹏<) 神啊⊙﹏⊙ 快...
    白藜芦醇阅读 187评论 1 0