/* * Copyright (C) 2016 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.dialer.shortcuts; import android.annotation.TargetApi; import android.app.job.JobInfo; import android.app.job.JobParameters; import android.app.job.JobScheduler; import android.app.job.JobService; import android.content.ComponentName; import android.content.Context; import android.os.Build.VERSION; import android.os.Build.VERSION_CODES; import android.support.annotation.MainThread; import android.support.annotation.NonNull; import android.support.v4.os.UserManagerCompat; import com.android.dialer.common.Assert; import com.android.dialer.common.LogUtil; import com.android.dialer.constants.ScheduledJobIds; import java.util.concurrent.TimeUnit; /** * {@link JobService} which starts the periodic job to refresh dynamic and pinned shortcuts. * *
Only {@link #schedulePeriodicJob(Context)} should be used by callers. */ @TargetApi(VERSION_CODES.N_MR1) // Shortcuts introduced in N MR1 public final class PeriodicJobService extends JobService { private static final long REFRESH_PERIOD_MILLIS = TimeUnit.HOURS.toMillis(24); private RefreshShortcutsTask refreshShortcutsTask; /** * Schedules the periodic job to refresh shortcuts. If called repeatedly, the job will just be * rescheduled. * *
The job will not be scheduled if the build version is not at least N MR1 or if the user is * locked. */ @MainThread public static void schedulePeriodicJob(@NonNull Context context) { Assert.isMainThread(); LogUtil.enterBlock("PeriodicJobService.schedulePeriodicJob"); if (VERSION.SDK_INT >= VERSION_CODES.N_MR1 && UserManagerCompat.isUserUnlocked(context)) { JobScheduler jobScheduler = context.getSystemService(JobScheduler.class); if (jobScheduler.getPendingJob(ScheduledJobIds.SHORTCUT_PERIODIC_JOB) != null) { LogUtil.i("PeriodicJobService.schedulePeriodicJob", "job already scheduled."); return; } JobInfo jobInfo = new JobInfo.Builder( ScheduledJobIds.SHORTCUT_PERIODIC_JOB, new ComponentName(context, PeriodicJobService.class)) .setPeriodic(REFRESH_PERIOD_MILLIS) .setPersisted(true) .setRequiresCharging(true) .setRequiresDeviceIdle(true) .build(); jobScheduler.schedule(jobInfo); } } /** Cancels the periodic job. */ @MainThread public static void cancelJob(@NonNull Context context) { Assert.isMainThread(); LogUtil.enterBlock("PeriodicJobService.cancelJob"); context.getSystemService(JobScheduler.class).cancel(ScheduledJobIds.SHORTCUT_PERIODIC_JOB); } @Override @MainThread public boolean onStartJob(@NonNull JobParameters params) { Assert.isMainThread(); LogUtil.enterBlock("PeriodicJobService.onStartJob"); if (VERSION.SDK_INT >= VERSION_CODES.N_MR1) { (refreshShortcutsTask = new RefreshShortcutsTask(this)).execute(params); } else { // It is possible for the job to have been scheduled on NMR1+ and then the system was // downgraded to < NMR1. In this case, shortcuts are no longer supported so we cancel the job // which creates them. LogUtil.i("PeriodicJobService.onStartJob", "not running on NMR1, cancelling job"); cancelJob(this); return false; } return true; } @Override @MainThread public boolean onStopJob(@NonNull JobParameters params) { Assert.isMainThread(); LogUtil.enterBlock("PeriodicJobService.onStopJob"); if (refreshShortcutsTask != null) { refreshShortcutsTask.cancel(false /* mayInterruptIfRunning */); } return false; } }