13 }
14 TASK_NAME_THREE -> {
15 return AnchorTaskThree()
16 }
17 TASK_NAME_FOUR -> {
18 return AnchorTaskFour()
19 }
20 TASK_NAME_FIVE -> {
21 return AnchorTaskFive()
22 }
23 }
24 return null
25 }
26
27}
Demo 跑起来,可以看到预期的效果。
基本使用
第一步:在 moulde build.gradle 配置远程依赖
1implementation ‘com.xj.android:anchortask:1.0.0’
最新的版本号可以看这里 lastedt version
第二步:自定义 AnchorTaskZero
,继承 AnchorTask
,并指定 taskName
,注意 taskName
必须是唯一的,因为我们会根据 taskName
找到相应的 AnchorTask
重写相应的方法
1class AnchorTaskZero() : AnchorTask(TASK_NAME_ZERO) {
2 override fun isRunOnMainThread(): Boolean {
3 return false
4 }
5
6 override fun run() {
7 val start = System.currentTimeMillis()
8 try {
9 Thread.sleep(300)
10 } catch (e: Exception) {
11 }
12 LogUtils.i(
13 TAG, "AnchorTaskOne: " + (System.currentTimeMillis() - start)
14 )
15 }
16}
如果任务 三 依赖任务 二,任务 一,可以这样写
1addTask(TASK_NAME_THREE).afterTask(TASK_NAME_ZERO, TASK_NAME_ONE)
最后,通过 project.start()
方法启动, 如果需要阻塞等待,调用 await() 方法
1AnchorProject.Builder().setContext(context).setLogLevel(LogUtils.LogLevel.DEBUG)
2 .setAnchorTaskCreator(ApplicationAnchorTaskCreator())
3 .addTask(TASK_NAME_ZERO)
4 .addTask(TASK_NAME_ONE)
5 .addTask(TASK_NAME_TWO)
6 .addTask(TASK_NAME_THREE).afterTask(TASK_NAME_ZERO, TASK_NAME_ONE)
7 .addTask(TASK_NAME_FOUR).afterTask(TASK_NAME_ONE, TASK_NAME_TWO)
8 .addTask(TASK_NAME_FIVE).afterTask(TASK_NAME_THREE, TASK_NAME_FOUR)
9 .build()
10project.start().await()
监听任务回调
1project.addListener(object : OnProjectExecuteListener {
2
3 // project 开始执行的时候
4 override fun onProjectStart() {
5 com.xj.anchortask.LogUtils.i(MyApplication.TAG, "onProjectStart ")
6 }
7
8 // project 执行一个 task 完成的时候
9 override fun onTaskFinish(taskName: String) {
10 com.xj.anchortask.LogUtils.i(
11 MyApplication.TAG,
12 “onTaskFinish, taskName is $taskName”
13 )
14 }
15
16 // project 执行完成的时候
17 override fun onProjectFinish() {
18 com.xj.anchortask.LogUtils.i(MyApplication.TAG, "onProjectFinish ")
19 }
20
21 })
添加每个任务执行耗时回调
1project.onGetMonitorRecordCallback = object : OnGetMonitorRecordCallback {
2
3 // 所有 task 执行完毕会调用这个方法,Map 存储了 task 的执行时间, key 是 taskName,value 是时间,单位毫秒
4 override fun onGetTaskExecuteRecord(result: Map<String?, Long?>?) {
5 onGetMonitorRecordCallback?.onGetTaskExecuteRecord(result)
6 }
7
8 // 所有 task 执行完毕会调用这个方法,costTime 执行时间
9 override fun onGetProjectExecuteTime(costTime: Long) {
10 onGetMonitorRecordCallback?.onGetProjectExecuteTime(costTime)
11 }
12
13 }
AnchorProject 介绍
-------
-
AnchorTaskDispatcher start
方法必须在主线程调用,子线程调用会抛出异常。 -
await
阻塞当前线程,等待所有任务执行完毕之后,会自动往下走,await 方法携带一个参数,timeOutMillion 表示超时等待的时间 -
await()
方法必须在 start 方法之后调用 -
添加任务是通过
AnchorProject.Builder().addTask
添加的,典型的构造模式 -
设置执行的线程池,可以通过
AnchorProject.Builder().setThreadPoolExecutor(TaskExecutorManager.instance.cpuThreadPoolExecutor)
AnchorTask 介绍
AnchorTask 实现了 IAnchorTask 接口,主要有几个方法
-
isRunOnMainThread(): Boolean
表示是否在主线程运行,默认值是 false -
priority(): Int
方法 表示线程的优先级别,默认值是 Process.THREAD_PRIORITY_FOREGROUND -
needWait()
表示当我们调用AnchorTaskDispatcher await
时,是否需要等待,return true,表示需要等待改任务执行结束,AnchorTaskDispatcher await
方法才能继续往下执行。 -
fun run()
方法,表示任务执行的时候
1interface IAnchorTask : IAnchorCallBack {
2
3 /**
4 * 是否在主线程执行
5 */
6 fun isRunOnMainThread(): Boolean
7
8 /**
9 * 任务优先级别
10 */
11 @IntRange(
12 from = Process.THREAD_PRIORITY_FOREGROUND.toLong(),
13 to = Process.THREAD_PRIORITY_LOWEST.toLong()
14 )
15 fun priority(): Int
16
17 /**
18 * 调用 await 方法,是否需要等待改任务执行完成
19 * true 不需要
20 * false 需要
21 */
22 fun needWait(): Boolean
23
24 /**
25 * 任务被执行的时候回调
26 */
27 fun run()
28
29}
1class AnchorTaskOne : AnchorTask() {
2 override fun isRunOnMainThread(): Boolean {
14 )
15 fun priority(): Int
16
17 /**
18 * 调用 await 方法,是否需要等待改任务执行完成
19 * true 不需要
20 * false 需要
21 */
22 fun needWait(): Boolean
23
24 /**
25 * 任务被执行的时候回调
26 */
27 fun run()
28
29}
1class AnchorTaskOne : AnchorTask() {
2 override fun isRunOnMainThread(): Boolean {