1. 添加二进制
build.gradle 中添加
compile 'com.xdandroid:hellodaemon:+'
2. 继承 AbsWorkService, 实现 6 个抽象方法
/**
* 是否 任务完成, 不再需要服务运行?
* @return 应当停止服务, true; 应当启动服务, false; 无法判断, null.
*/
Boolean shouldStopService();
/**
* 任务是否正在运行?
* @return 任务正在运行, true; 任务当前不在运行, false; 无法判断, null.
*/
Boolean isWorkRunning();
void startWork();
void stopWork();
//Service.onBind(Intent intent)
@Nullable IBinder onBind(Intent intent, Void unused);
//服务被杀时调用, 可以在这里面保存数据.
void onServiceKilled();
别忘了在 Manifest 中注册这个 Service.
3. 自定义 Application
在 Application 的 onCreate() 中, 调用
DaemonEnv.initialize(this, MonitoringService::class.java, 10 * 1000)
DaemonEnv.startServiceMayBind(MonitoringService::class.java)
别忘了在 Manifest 中通过 android:name 使用这个自定义的 Application.
4. API 说明
启动 Service:
Context.startService(new Intent(Context c, Class<? extends AbsWorkService> serviceClass))
停止 Service:
在 ? extends AbsWorkService 中, 添加 stopService() 方法:
1.操作自己维护的 flag, 使 shouldStopService() 返回 true;
2.调用自己的方法或第三方 SDK 提供的 API, 停止任务;
3.调用 AbsWorkService.cancelJobAlarmSub() 取消 Job / Alarm / Subscription.
需要停止服务时, 调用 ? extends AbsWorkService 上的 stopService() 即可.
处理白名单:
以下 API 全部位于 IntentWrapper 中:
List<IntentWrapper> getIntentWrapperList();
//弹出 android.support.v7.AlertDialog, 引导用户将 App 加入白名单.
void whiteListMatters(Activity a, String reason);
//防止华为机型未加入白名单时按返回键回到桌面再锁屏后几秒钟进程被杀.
//重写 MainActivity.onBackPressed(), 只保留对以下 API 的调用.
void onBackPressed(Activity a);