从 GCM 迁移到 FCM 后的 PeriodicTask 和 OneoffTask



问题

从 GCM 迁移到 FCM 时,我应该使用什么来代替 PeriodicTask 和 OneOffTask?FCM 包装中是否有等效项?

背景

最近Google已经弃用了GCM,他们提供了迁移指南,但我找不到任何关于迁移PeriodicTasks和OneOffTasks的信息。

教程说用firebase-messaging替换play-services-gcm,但我找不到与此包中的任务类似的任何内容,所以我想知道他们是否完全放弃了它们,或者我们是否可以继续使用 PeriodicTask/OneOffTasks?

PeriodicTask 和 OneoffTask 类(GcmNetworkManager 组件的一部分(可以替换为 Firebase Job Dispatcher,Firebase Job Dispatcher 是一个开源库,用于调度将在应用进程中执行的工作单元。它公开的服务端API反映了框架的JobScheduler API,它与GcmNetworkManager略有不同。升级应该是一个相当容易的机械更改。

升级步骤

将以下内容添加到build.gradle的依赖项部分:

implementation 'com.firebase:firebase-jobdispatcher:0.8.5'

改为使GcmTaskService实现扩展JobService。由此:

public class MyTaskService extends GcmTaskService {
  @Override
  public int onRunTask(TaskParams params) {
    // Runs in its own thread
    // ...
    return RESULT_SUCCESS;
  }
}

对此:

public class MyJobService extends JobService {
  @Override
  public boolean onStartJob(JobParameters job) {
    // Runs on the main thread!
    // ...
    return false; // "Did we start any background work?"
  }
  @Override
  public boolean onStopJob(JobParameters job) {
    // Runs on the main thread!
    // ...
    return false; // "Should this job be retried?"
  }
}

如果您不想管理自己的线程,则可以利用库附带的SimpleJobService

public class MyJobService extends SimpleJobService {
  @Override
  public int onRunJob(JobParameters job) {
    // Runs on its own thread!
    // ...
    return JobService.RESULT_SUCCESS;
  }
}

请务必调整清单。将您之前的GcmTaskService条目替换为以下内容:

<service
    android:exported="false"
    android:name=".MyJobService">
    <intent-filter>
        <action android:name="com.firebase.jobdispatcher.ACTION_EXECUTE"/>
    </intent-filter>
</service>

调度很简单:

// Create a new dispatcher using the Google Play driver.
FirebaseJobDispatcher dispatcher =
  new FirebaseJobDispatcher(new GooglePlayDriver(context));
Job myJob = dispatcher.newJobBuilder()
    // the JobService that will be called
    .setService(MyJobService.class)
    // uniquely identifies the job
    .setTag("my-unique-tag")
    // one-off job (only runs once unless a retry is requested)
    .setRecurring(false)
    // don't persist past a device reboot (requires RECEIVE_BOOT_COMPLETE)
    .setLifetime(Lifetime.UNTIL_NEXT_BOOT)
    // start between 0 and 60 seconds from now
    .setTrigger(Trigger.executionWindow(0, 60))
    // don't overwrite an existing job with the same tag
    .setReplaceCurrent(false)
    // retry with exponential backoff
    .setRetryStrategy(RetryStrategy.DEFAULT_EXPONENTIAL)
    // constraints that need to be satisfied for the job to run
    .setConstraints(
        // only run on an unmetered network
        Constraint.ON_UNMETERED_NETWORK,
        // only run when the device is charging
        Constraint.DEVICE_CHARGING
    )
    .setExtras(myExtrasBundle)
    .build();
dispatcher.mustSchedule(myJob);

有关详细信息,请查看存储库。

最新更新