当前位置:主页 > 移动开发 > Android代码 >

Kotlin + Flow 实现Android 应用初始化任务启动库

时间:2023-03-10 10:46:18 | 栏目:Android代码 | 点击:

特性

Kotlin + Flow 实现的 Android 应用初始化任务启动库。

引入依赖

项目地址:github.com/czy1121/ini…

repositories { 
  maven { url "https://gitee.com/ezy/repo/raw/android_public/"}
} 
dependencies {
  implementation "me.reezy.init:init:0.9.0" 
  kapt "me.reezy.init:init-compiler:0.9.0" 

  // 使用 init-startup 代替 init 可以利用 Jetpack Startup 库自动初始化
  // 无需在 Application.onCreate 调用 InitManager.init()
  implementation "me.reezy.init:init-startup:0.9.0" 
}

使用

在 AndroidManifest.xml 的 <application> 里添加模块

<meta-data android:name="modules" android:value="app" />

通过注解 @Init 和 InitTask 接口定义一个任务

@Init
class OneInit : InitTask {
  override fun execute(app: Application) {
    Log.e(TAG, "this is ${javaClass.simpleName} in ${Thread.currentThread().name}")
  }
}

通过注解 @Init 的参数配置任务信息

@Target(AnnotationTarget.CLASS)
@Retention(AnnotationRetention.SOURCE)
annotation class Init(
  val process: String = "all",    // 指定工作进程名称,main 表示仅在主进程运行,all 表示在所有进程运行
  val background: Boolean = false,  // 是否在工作线程执行任务
  val debugOnly: Boolean = false,   // 是否仅在 DEBUG 模式执行任务
  val compliance: Boolean = false,  // 是否需要合规执行
  val depends: Array<String> = [],  // 依赖的任务列表
  val priority: Short = 0       // 
)

APT会按模块收集任务信息并生成任务加载器(InitLoader_$moduleName),任务加载器用于添加任务到TaskList

class Task(
  val name: String,          // APT收集的任务名称格式为 "$moduleName:${clazz.simpleName}"
  val background: Boolean = false,  // 是否在工作线程执行任务
  val priority: Int = 0,       // 进程运行的优先级,值小的先执行
  val depends: Set<String> = setOf(), // 依赖的任务列表,同模块只需指定"${clazz.simpleName}",跨模块需要指定 "$moduleName:${clazz.simpleName}"
  val block: () -> Unit = {},     // 待执行的任务
) {
  val children: MutableSet<Task> = mutableSetOf() // 子任务列表
}

核心类

无依赖的异步任务,在子线程并行执行
无依赖的同步任务,在主线程顺序执行
有依赖的任务,确保无循环依赖,且被依赖的任务先执行

可以不使用 InitManager 收集任务

val taskList = TaskList(app).apply {
  add("task1") { 
  }  
  add("task2", depends = setOf("t1")) { 
  }  
  add("task3", depends = setOf("task1")) { 
  }  
}

val manager = TaskManager(taskList, setOf("t1"))
manager.start()

// ...

// 完成开关任务t1
manager.trigger("t1")

您可能感兴趣的文章:

相关文章