📚 课程目录第3章创建持久化JobService

3. 创建持久化 JobService：代码实现、参数配置、系统广播触发

3.1 技术原理解析

持久化 JobService 是利用 Android JobScheduler 框架实现后台任务韧性的核心手段。其持久化机制依赖于系统级守护进程 SystemServer 中的 JobSchedulerService，该服务将满足 setPersisted(true) 的 JobInfo 写入 /data/system/job/jobs.xml 文件。即使应用进程被 lmkd 杀死或设备重启，任务记录在系统重启扫描持久化目录后仍然存在，一旦触发条件满足，系统会立即尝试重建应用进程并回调 onStartJob。

核心优势：相比普通 Service 依赖进程存活，持久化 JobService 通过系统存储和调度实现了对进程死亡和重启的完全免疫，是后台保活和绕过系统限制的重要基础。

3.2 代码实现与配置

3.2.1 AndroidManifest.xml 配置

必须声明服务和绑定权限，同时申请持久化所需的开机广播权限。

重要权限提醒： 缺少 android.permission.BIND_JOB_SERVICE 权限声明会导致 JobScheduler 无法调度该服务。缺少 RECEIVE_BOOT_COMPLETED 权限会导致 setPersisted(true) 在重启后失效。

3.2.2 JobService 实现类

实现 JobService 核心在于正确管理 onStartJob 和 onStopJob 的生命周期，确保后台任务的持久执行。

package com.example.jobbypass.persistent;

import android.app.job.JobParameters;
import android.app.job.JobService;
import android.os.AsyncTask;
import android.util.Log;

public class PersistentJobService extends JobService {

    private static final String TAG = "PersistentJob";
    private AsyncTask runningTask;

    @Override
    public boolean onStartJob(final JobParameters params) {
        Log.d(TAG, "Job started. Persistence flag: " + params.isPersisted());

        // 模拟后台长耗时任务
        runningTask = new AsyncTask() {
            @Override
            protected Void doInBackground(Void... voids) {
                // 在此处放置绕过逻辑或心跳代码
                Log.d(TAG, "Executing persistent background task...");
                // 注意：Android 8+ 对后台执行限制严格，此处仅为框架示例
                try {
                    Thread.sleep(10000); // 模拟10秒任务
                } catch (InterruptedException e) {
                    Thread.currentThread().interrupt();
                }
                return null;
            }

            @Override
            protected void onPostExecute(Void aVoid) {
                // 任务执行完毕，通知系统释放工作锁
                jobFinished(params, false);
                Log.d(TAG, "Job finished, calling jobFinished().");
            }
        }.execute();

        // 返回 true 表示任务仍在进行中，系统会持有唤醒锁
        return true;
    }

    @Override
    public boolean onStopJob(JobParameters params) {
        Log.w(TAG, "Job stopped by system. Reason: " + params.getStopReason());
        // 取消正在执行的任务，释放资源
        if (runningTask != null && !runningTask.isCancelled()) {
            runningTask.cancel(true);
        }
        // 返回 true 表示希望系统在条件允许时重新调度此作业
        return true;
    }
}

3.3 JobInfo 参数配置与绕过作用

通过 JobInfo.Builder 配置关键参数，特别是 setPersisted 和 setOverrideDeadline 是实现绕过系统限制的关键。

参数方法	描述	对绕过的具体作用
`setPersisted(true)`	将任务信息写入系统持久化存储，重启后仍保留。	绕过进程死亡和设备重启导致的保活失效。
`setOverrideDeadline(long time)`	即使约束条件未满足，在截止时间到达时也必须执行任务。	绕过系统因电量或网络状态不佳而对任务执行时间的延迟限制。
`setMinimumLatency(long time)`	设置任务首次执行的最小延迟时间。	用于避开系统密集任务调度窗口，降低被检测到的概率。
`setRequiredNetworkType(int type)`	指定任务执行的网络环境（如 NETWORK_TYPE_UNMETERED）。	确保任务只在特定网络环境下触发，减少耗电量引起的用户察觉。
`setRequiresCharging(true)`	设备处于充电状态时才能执行。	利用充电状态作为掩护，规避系统对高耗电后台行为的审查。

3.3.1 调度配置示例

import android.app.job.JobInfo;
import android.app.job.JobScheduler;
import android.content.ComponentName;
import android.content.Context;

public class JobSchedulerHelper {

    public static void schedulePersistentJob(Context context) {
        JobScheduler jobScheduler =
                (JobScheduler) context.getSystemService(Context.JOB_SCHEDULER_SERVICE);

        ComponentName componentName =
                new ComponentName(context, PersistentJobService.class);

        JobInfo jobInfo = new JobInfo.Builder(101, componentName)
                .setPersisted(true)                          // 关键：持久化，重启后存活
                .setMinimumLatency(5000)                     // 延迟5秒执行
                .setOverrideDeadline(120000)                 // 最长等待120秒，强制触发
                .setRequiredNetworkType(JobInfo.NETWORK_TYPE_ANY) // 有网即可
                .setRequiresCharging(false)                  // 不强制充电，灵活触发
                .build();

        int result = jobScheduler.schedule(jobInfo);
        if (result == JobScheduler.RESULT_SUCCESS) {
            Log.d("JobScheduler", "Persistent job scheduled successfully.");
        } else {
            Log.e("JobScheduler", "Job scheduling failed.");
        }
    }
}

3.4 系统广播触发机制

JobScheduler 本身是一个被动系统服务，它的唤醒依赖于系统内部广播。常见的触发广播包括：

ACTION_BOOT_COMPLETED：开机完成后，系统会扫描持久化 Job 列表并重新评估。
CONNECTIVITY_ACTION：网络状态发生变化时触发作业重评估。
ACTION_POWER_CONNECTED/DISCONNECTED：充电状态变化。
ACTION_TIMEZONE_CHANGED：时区变化等时间相关广播。

进阶技巧： 我们可以注册一个高优先级的 BroadcastReceiver，监听上述系统广播，并在收到广播后主动调用 jobScheduler.schedule(jobInfo) 进行一次“刷新”。这一步可以重置系统内部的作业定时器，巧妙地利用系统机制绕过部分厂商对 JobScheduler 调用的频率限制。

3.5 调试与常见错误

3.5.1 调试命令

# 查看所有已调度的 Job（包含持久化 Job）
adb shell dumpsys jobscheduler

# 过滤特定包名下的 Job 信息
adb shell dumpsys jobscheduler | grep -A 20 com.example.jobbypass

# 强制触发指定 Job ID 的运行（需要 root 权限，或通过 shell 调用）
adb shell cmd jobscheduler run -f com.example.jobbypass 101

# 查看系统持久化 Job 存储文件
adb shell cat /data/system/job/jobs.xml

3.5.2 常见错误与避坑

错误现象	原因	解决方案
重启后 Job 消失	未调用 `setPersisted(true)` 或未声明 `RECEIVE_BOOT_COMPLETED` 权限。	补全代码和清单文件配置。
`onStartJob` 未被调用	服务未绑定 `BIND_JOB_SERVICE`。	在清单文件中配置 `android:permission="android.permission.BIND_JOB_SERVICE"`。
任务执行短暂，日志一闪而过	`onStartJob` 返回了 `false`，系统认为任务已结束。	修改为返回 `true` 以保持唤醒锁。
应用被 kill 后 Job 不重建进程	系统内嵌的电力节省策略（Scudo）拦截。	添加 `setOverrideDeadline()` 参数，绕过部分限制。

3.6 性能与稳定性优化

唤醒锁管理： 在 onStartJob 返回 true 后，系统会代理一个部分唤醒锁（Wake Lock）。务必在任务结束后调用 jobFinished()，否则会持续消耗电量。
任务超时保护： 系统为 onStartJob 执行提供了默认超时时间（通常为 10 分钟）。建议通过 jobFinished() 的分段执行模式，避免单次执行时间过长被强行杀死。
稳定退出： 在 onStopJob 中必须返回 true，这样当系统因为资源紧张或约束变化而中断任务后，一旦条件恢复，系统会立即重新调度任务，而不是彻底丢弃。