文章目录
- 一、 JobScheduler 用法简介
- 二、 JobScheduler 拉活完整代码
- 1、 JobService
- 2、清单文件
- 3、启动 JobScheduler 任务
- 4、运行效果
- 三、 源码资源
一、 JobScheduler 用法简介
JobScheduler 机制可以规定在特定状态 , 特定时间 , 执行周期性任务 ;
JobScheduler 是系统服务 , 由系统负责调度第三方应用注册的 JobScheduler , 定时完成指定任务 ;
部分设备 , 版本 , 无法达到拉活效果 ;
这种拉活方式 , 需要在 API Level 21 以上才可以使用 ;
在应用中 , 创建一个 JobService 服务 , JobService 需要 API Level 21 ;
该服务注册时必须声明 android.permission.BIND_JOB_SERVICE 权限 ;
代码语言:javascript复制 <!-- JobScheduler 拉活 -->
<service
android:name=".jobscheduler.KeepAliveJobService"
android:enabled="true"
android:exported="true"
android:permission="android.permission.BIND_JOB_SERVICE"></service>
JobScheduler 用法 :
① 获取 JobScheduler 对象 : 通过 Binder 机制获取该 JobScheduler 系统服务 ;
代码语言:javascript复制// 创建 JobScheduler
JobScheduler jobScheduler =
(JobScheduler) context.getSystemService(Context.JOB_SCHEDULER_SERVICE);
② 指定 JobScheduler 任务信息 JobInfo : 绑定任务 ID , 指定任务的运行组件 , 也就是之前创建并注册的 JobService , 最后要设置该任务在重启后也要执行 ;
代码语言:javascript复制// 第一个参数指定任务 ID
// 第二个参数指定任务在哪个组件中执行
// setPersisted 方法需要 android.permission.RECEIVE_BOOT_COMPLETED 权限
// setPersisted 方法作用是设备重启后 , 依然执行 JobScheduler 定时任务
JobInfo.Builder jobInfoBuilder = new JobInfo.Builder(10,
new ComponentName(context.getPackageName(), KeepAliveJobService.class.getName()))
.setPersisted(true);
③ 设置时间信息 :
7.0 以下的系统可以设置间隔 ,
7.0 以上设置不了 ;
7.0 以上的版本需要设置延迟执行 , 否则无法启动 ;
代码语言:javascript复制// 7.0 以下的版本, 可以每隔 5000 毫秒执行一次任务
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N){
jobInfoBuilder.setPeriodic(5_000);
}else{
// 7.0 以上的版本 , 设置延迟 5 秒执行
// 该时间不能小于 JobInfo.getMinLatencyMillis 方法获取的最小值
jobInfoBuilder.setMinimumLatency(5_000);
}
④ 开启定时任务 :
代码语言:javascript复制// 开启定时任务
jobScheduler.schedule(jobInfoBuilder.build());
⑤
7.0 以上的特殊处理 : 由于在
7.0 以上的系统中设置了延迟执行 , 需要在 JobService 的 onStartJob 方法中 , 再次开启一次 JobScheduler 任务执行 , 也就是重复上述 ① ~ ④ 执行 , 这样就实现了周期性执行的目的 ;
代码语言:javascript复制public class KeepAliveJobService extends JobService {
@Override
public boolean onStartJob(JobParameters params) {
Log.i("KeepAliveJobService", "JobService onStartJob 开启");
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N){
// 如果当前设备大于 7.0 , 延迟 5 秒 , 再次执行一次
startJob(this);
}
return false;
}
}
二、 JobScheduler 拉活完整代码
1、 JobService
代码语言:javascript复制package kim.hsl.keep_progress_alive.jobscheduler;
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;
import android.util.Log;
import androidx.annotation.RequiresApi;
@RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
public class KeepAliveJobService extends JobService {
@Override
public boolean onStartJob(JobParameters params) {
Log.i("KeepAliveJobService", "JobService onStartJob 开启");
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N){
// 如果当前设备大于 7.0 , 延迟 5 秒 , 再次执行一次
startJob(this);
}
return false;
}
@Override
public boolean onStopJob(JobParameters params) {
Log.i("KeepAliveJobService", "JobService onStopJob 关闭");
return false;
}
public static void startJob(Context context){
// 创建 JobScheduler
JobScheduler jobScheduler =
(JobScheduler) context.getSystemService(Context.JOB_SCHEDULER_SERVICE);
// 第一个参数指定任务 ID
// 第二个参数指定任务在哪个组件中执行
// setPersisted 方法需要 android.permission.RECEIVE_BOOT_COMPLETED 权限
// setPersisted 方法作用是设备重启后 , 依然执行 JobScheduler 定时任务
JobInfo.Builder jobInfoBuilder = new JobInfo.Builder(10,
new ComponentName(context.getPackageName(), KeepAliveJobService.class.getName()))
.setPersisted(true);
// 7.0 以下的版本, 可以每隔 5000 毫秒执行一次任务
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N){
jobInfoBuilder.setPeriodic(5_000);
}else{
// 7.0 以上的版本 , 设置延迟 5 秒执行
// 该时间不能小于 JobInfo.getMinLatencyMillis 方法获取的最小值
jobInfoBuilder.setMinimumLatency(5_000);
}
// 开启定时任务
jobScheduler.schedule(jobInfoBuilder.build());
}
}
2、清单文件
核心配置 :
代码语言:javascript复制 <!-- JobScheduler 拉活 -->
<service
android:name=".jobscheduler.KeepAliveJobService"
android:enabled="true"
android:exported="true"
android:permission="android.permission.BIND_JOB_SERVICE"></service>
完整配置 :
代码语言:javascript复制<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="kim.hsl.keep_progress_alive">
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission
android:name="android.permission.GET_ACCOUNTS"
android:maxSdkVersion="22" />
<uses-permission
android:name="android.permission.AUTHENTICATE_ACCOUNTS"
android:maxSdkVersion="22" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission
android:name="android.permission.WRITE_SYNC_SETTINGS"/>
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/Theme.Keep_Progress_Alive">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<!--
设置最近任务列表中不显示该 Activity 组件 ( 不要被用户察觉 )
android:excludeFromRecents="true"
设置 Activity 亲和性
让该界面在一个独立的任务栈中 , 不要与本应用的其它任务栈放在一起
避免解除锁屏后 , 关闭 1 像素界面 , 将整个任务栈都唤醒
android:taskAffinity="kim.hsl.keep_progress_alive.alive"
-->
<activity
android:name=".one_pixel_activity.OnePixelActivity"
android:excludeFromRecents="true"
android:taskAffinity="kim.hsl.keep_progress_alive.onepixel"
android:theme="@style/OnePixelActivityTheme" />
<!-- 用于提权的前台进程 -->
<service
android:name=".foreground_service.ForegroundService"
android:enabled="true"
android:exported="true" />
<!-- 用于提权的前台进程, 关闭通知操作 -->
<service
android:name=".foreground_service.CancelNotificationService"
android:enabled="true"
android:exported="true" />
<!-- 系统 Service 机制拉活 -->
<service
android:name=".stick_service.StickService"
android:enabled="true"
android:exported="true" />
<!-- 用于账户同步拉活 -->
<service
android:name=".account_service.AuthenticationService"
android:enabled="true"
android:exported="true">
<intent-filter>
<action android:name="android.accounts.AccountAuthenticator" />
</intent-filter>
<meta-data
android:name="android.accounts.AccountAuthenticator"
android:resource="@xml/account_authenticator" />
</service>
<!-- 账户同步服务 -->
<service
android:name=".account_service.AccountSyncService"
android:enabled="true"
android:exported="true">
<intent-filter>
<action android:name="android.content.SyncAdapter" />
</intent-filter>
<meta-data
android:name="android.content.SyncAdapter"
android:resource="@xml/sync_adapter" />
</service>
<!-- 账户同步 ContentProvider -->
<provider
android:authorities="kim.hsl.keep_progress_alive.provider"
android:name=".account_service.AccountSyncContentProvider" />
<!-- JobScheduler 拉活 -->
<service
android:name=".jobscheduler.KeepAliveJobService"
android:enabled="true"
android:exported="true"
android:permission="android.permission.BIND_JOB_SERVICE"></service>
</application>
</manifest>
3、启动 JobScheduler 任务
代码语言:javascript复制package kim.hsl.keep_progress_alive;
import androidx.appcompat.app.AppCompatActivity;
import android.content.Intent;
import android.os.Build;
import android.os.Bundle;
import kim.hsl.keep_progress_alive.account_service.AccountUtils;
import kim.hsl.keep_progress_alive.foreground_service.ForegroundService;
import kim.hsl.keep_progress_alive.jobscheduler.KeepAliveJobService;
import kim.hsl.keep_progress_alive.one_pixel_activity.KeepProgressAliveManager;
import kim.hsl.keep_progress_alive.stick_service.StickService;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 1. 1 像素 Activity 提升应用权限
// 注册广播接收者 , 1 像素 Activity 启动的 广播接收者
//KeepProgressAliveManager.getmInstance().registerReceiver(this);
// 2. 通过前台 Service 提升应用权限
// 启动普通 Service , 但是在该 Service 的 onCreate 方法中执行了 startForeground
// 变成了前台 Service 服务
//startService(new Intent(this, ForegroundService.class));
// 3. 使用 Service 机制拉活
//startService(new Intent(this, StickService.class));
// 4. 账户同步拉活
//AccountUtils.addAccount(this);
// 开始同步
//AccountUtils.autoSyncStart();
// 5. JobScheduler 拉活
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
KeepAliveJobService.startJob(this);
}
}
@Override
protected void onDestroy() {
super.onDestroy();
// 1. 取消注册广播接收者, 也可以不取消注册
//KeepProgressAliveManager.getmInstance().registerReceiver(this);
}
}
4、运行效果
每隔 5 秒调用一次 ;
三、 源码资源
源码资源 :
- GitHub 地址 : https://github.com/han1202012/Keep_Progress_Alive
- CSDN 源码快照 : https://download.csdn.net/download/han1202012/16619430