TaskManager - GitLite

KO | EN

gitlite — search

#javascript #python #ai #typescript #go #golang #android #deep-learning #linux #docker #nodejs #java #vue #mcp

TaskManager

(★ 483)

一种支持依赖关系、任务兜底策略的任务调度管理工具。API灵活易用，稳定可靠。轻松提交主线程任务、异步任务。支持周期性任务，顺序执行任务，并行任务等。

File Explorer

Download Latest Version (.zip)

- .gitignore
- build.gradle
- proguard-rules.pro
- event_data_dispatcher.png
- need_task_sync.png
- parallel_task.png
- task_dispatcher.png
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- .gitignore
- build.gradle
- proguard-rules.pro
.gitignore
build.gradle
gradle.properties
gradlew
gradlew.bat
LICENSE.txt
README-CN.md
README.md
settings.gradle

# Installation Guide

1. Get the code

git clone https://github.com/iqiyi/TaskManager

Downloads the entire project code from GitHub to your computer.

cd TaskManager

Moves into the project folder you just downloaded.

2. Gradle (Java/Kotlin)

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
JDK (Java) Required to build and run Java/Kotlin projects.
Gradle If the repo includes gradlew (Gradle Wrapper), you don't need to install Gradle separately.

cd TaskManager

This project's files live in a subfolder, so move into it first.

./gradlew build

Builds the project using Gradle.

✅ A BUILD SUCCESSFUL message means it worked. The output is created under build/.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

* [中文文档](README-CN.md)
* [Release Note](https://github.com/iqiyi/TaskManager/wiki/ReleaseNote-EN)

##### Task manager is an Android task management tool. It is capable of handling complex task work flow. It's low-coupling, flexible & stable. It supports relation-based tasks. All tasks will be executed in a well-managed order. It can submit tasks with complex relations such as “Or Dependency” or “And Dependency”. Meanwhile, parallel tasks and serial tasks are also supported.

### Supported Features

```Java
   TM.postAsync(Runnable); // run on background thread
   TM.postAsyncDelay(Runnable);
   TM.postUI(Runnable); // run on UI thread
   TM.postUIDelay(Runnable, int delay);
   TM.postSerial(Runnable  , String groupName);//tasks with same group name , runs in FIFO order.
   TM.cancelTaskByToken(Object);// cancel tasks with same token.

```

#### 1. Task dispatcher: 
* Dispatch task to UI thread or background thread
* Dispatch task to run on background thread in FIFO order (behaves like background thread Handler ).
* Submit a group of tasks, to run in parallell. (ParallellTask)
* To run a task periodically. (TickTask)
* Run task while idle. (Task.enableIdleRun)

![img](https://raw.githubusercontent.com/iqiyi/TaskManager/master/art/task_dispatcher.png)

#### 2. Event & Data Dispatcher:

![img](https://raw.githubusercontent.com/iqiyi/TaskManager/master/art/event_data_dispatcher.png)

#### 3. Advantages：

a)  Change serial tasks into parallel tasks by adding task dependencies, so that we can run several tasks in the same time.

![img](https://raw.githubusercontent.com/iqiyi/TaskManager/master/art/parallel_task.png)

b)  Task execute guarantee: Call “TM.needTaskSync” before your business running. In order to make sure your tasks prerequisites are proper loaded.

![img](https://raw.githubusercontent.com/iqiyi/TaskManager/master/art/need_task_sync.png)

c) Task recursive dependency testing: In debug mode , task recursive test will be executed in order to avoid some wrong relationship been set to tasks.

###  Getting Started

add dependencies in your "build.gradle" file

``` Java
dependencies {
    implementation 'com.iqiyi.taskmanager:taskmanager:1.3.7'
}
```

###  Developer Guide

* [API document wiki](https://github.com/iqiyi/TaskManager/wiki)

### TaskAnalyze
+ TaskAnalyze: Please refer to Task Analyze(任务分析) function in Lens.
+ TaskRecode:  See iqiyi/Lens  DataDump Function to check TM task status; You can find running tasks ,finished tasks & task bloking time on DataDump panel.
```Java
 LensUtil.setDumper(MyDumpFactory.class);
```
```Java
@Override
    public ILogDumper create() {
        return AnnotationLogDumper.create(this)
        // Dump.class：注解类；
        //LensApp.getInstance()： 查询注解的单例对象
        //StaticDump.class:查询带注静态方法的类
                .add(Dump.class, LensApp.getInstance(), StaticDump.class)
        //"TM" : 别名
        //TMDump.class：注解类；
        // TaskManager.getInstance()：查询注解的单例对象
                .add("TM",TMDump.class, TaskManager.getInstance(), TaskRecorder.class);
    }
```

###  License

TaskManager is [Apache v2.0 Licensed](https://github.com/iqiyi/Neptune/blob/master/LICENSE).