JobSchedulerCompat 使用指南

JobSchedulerCompat 使用指南

JobSchedulerCompat[Deprecated] A backport of Android Lollipop's JobScheduler to api 10+项目地址:https://gitcode.com/gh_mirrors/jo/JobSchedulerCompat

1. 项目目录结构及介绍

JobSchedulerCompat 是一个用于在API级别10及以上版本的Android设备上兼容JobScheduler的库。尽管该项目被标记为已弃用，它展示了如何支持在不同API级别使用后台作业调度的关键概念。以下是一个典型的开源项目目录结构概述，尽管实际的目录可能有所差异：

• src/main/java: 这是主要的Java源代码存放地，包含核心类如JobService的实现以及JobSchedulerCompat的核心逻辑。
  • me/tatarka/support/job: 包含了所有与作业调度相关的类，比如模拟JobScheduler接口的类。
• src/main/res: 资源文件夹，虽然对于此类库项目，资源通常是辅助性的，比如字符串或布局文件，但不直接参与作业调度逻辑。
• README.md: 重要的文档，包含了项目简介、依赖引入方法、快速使用示例等。
• build.gradle: 构建脚本，定义了项目的构建配置，依赖关系等。

2. 项目的启动文件介绍

在使用JobSchedulerCompat时，关键的“启动”并不直接体现在某个特定的启动文件中，而是通过代码来触发作业的调度。通常，这会在应用的某个业务逻辑中发生，例如数据同步、清理任务等。下面是如何调度一个作业的基本步骤：

// 创建PersistableBundle来存储作业参数
PersistableBundle extras = new PersistableBundle();
extras.putString("key", "value");

// 定义作业信息
JobInfo.Builder builder = new JobInfo.Builder(
    0, new ComponentName(context, MyJobService.class))
    .setMinimumLatency(TimeUnit.MINUTES.toMillis(15)) // 最小延迟时间
    .setOverrideDeadline(TimeUnit.HOURS.toMillis(2))   // 截止期限
    .setRequiredNetworkType(JobInfo.NETWORK_TYPE_ANY)  // 网络要求
    .setExtras(extras);

// 调度作业
JobScheduler scheduler = (JobScheduler) context.getSystemService(Context.JOB_SCHEDULER_SERVICE);
scheduler.schedule(builder.build());

其中，MyJobService是你自定义继承自JobService的服务类，负责处理作业执行的逻辑。

3. 项目的配置文件介绍

对于JobSchedulerCompat这类依赖，在Android项目中的主要配置是在app/build.gradle文件里添加依赖项：

dependencies {
    // 注意：以下是示例性的依赖声明，实际版本号可能需要更新或查找最新版本
    implementation 'me.tatarka.support:jobscheduler:0.1.1'
}

此外，若涉及到服务和接收器的自动添加到清单文件，旧版库可能需要手动管理或确保manifest合并策略正确。但在现代的Android开发环境中，这一部分通常是自动处理的，除非有特殊需求，不需要额外的手动XML配置。

---

请注意，由于项目已经标记为【Deprecated】，推荐考虑使用Android Jetpack组件中的WorkManager作为替代方案，以确保更好的兼容性和维护性。以上示例主要用于理解如何传统地使用类似库。

JobSchedulerCompat[Deprecated] A backport of Android Lollipop's JobScheduler to api 10+项目地址:https://gitcode.com/gh_mirrors/jo/JobSchedulerCompat