用途
该技能面向在 Android 平台上编写生产级 Kotlin Coroutines 代码的场景,提供一套权威规则与模式,强制结构化并发、生命周期安全以及符合 2025 标准的现代最佳实践。
主要能力
技能覆盖以下职责范围:
- 异步逻辑:实现 suspend 函数、Dispatcher 管理与并行执行。
- 响应式流:实现 Flow、StateFlow、SharedFlow 与 callbackFlow。
- 生命周期集成:管理作用域(viewModelScope、lifecycleScope)与安全收集(repeatOnLifecycle)。
- 错误处理:实现 CoroutineExceptionHandler、SupervisorJob 与正确的 try-catch 层级。
- 可取消性:通过 ensureActive() 确保长时间运行操作具备协作性。
- 测试:配置 TestDispatcher 与 runTest。
使用方式
当用户提出以下请求时激活该技能:从 API/数据库获取数据、执行后台处理、修复与线程/任务相关的内存泄漏、将监听器/回调转换为 Coroutines、实现 ViewModel、处理 UI 状态更新。
关键规则与约束
- Dispatcher 注入(可测试性):绝不在类内硬编码 Dispatchers(如 Dispatchers.IO、Dispatchers.Default);始终通过构造器注入 CoroutineDispatcher;为方便起见在构造器参数中默认使用 Dispatchers.IO,但允许覆盖。
// CORRECT
class UserRepository(
private val ioDispatcher: CoroutineDispatcher = Dispatchers.IO
) { ... }
// INCORRECT
class UserRepository {
fun getData() = withContext(Dispatchers.IO) { ... }
}
-
主线程安全:Data 或 Domain 层定义的所有 suspend 函数必须主线程安全;一次性调用应暴露为 suspend 函数;数据变更应暴露为 Flow;调用方(ViewModel)应能在 Dispatchers.Main 上调用而不阻塞 UI;在仓库实现内部使用 withContext(dispatcher) 将执行移至后台。
-
生命周期感知收集:绝不在 lifecycleScope.launch 或 launchWhenStarted(已弃用/不安全)中直接收集 flow;在 Activity 或 Fragment 中收集 flow 时始终使用 repeatOnLifecycle(Lifecycle.State.STARTED)。
// CORRECT
viewLifecycleOwner.lifecycleScope.launch {
viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.STARTED) {
viewModel.uiState.collect { ... }
}
}
-
ViewModel 作用域使用:在 ViewModel 中使用 viewModelScope 启动协程;不要从 ViewModel 向 View 暴露 suspend 函数,ViewModel 应暴露 View 观察的 StateFlow 或 SharedFlow。
-
可变状态封装:绝不公开暴露 MutableStateFlow 或 MutableSharedFlow;使用 .asStateFlow() 或向上转型将其暴露为只读 StateFlow 或 Flow。
-
禁止 GlobalScope:绝不使用 GlobalScope,它会破坏结构化并发并导致泄漏;如果任务必须存活于当前作用域,使用注入的 applicationScope(绑定到 Application 生命周期的自定义作用域)。
-
异常处理:绝不在泛型 catch (e: Exception) 块中捕获 CancellationException 而不重新抛出;仅在显式重新抛出 CancellationException 时使用 runCatching;CoroutineExceptionHandler 仅用于顶层协程(launch 内部),在 async 或子协程中无效。
-
可取消性:协程采用协作式取消,除非检查取消否则不会立即停止;在紧凑循环(如处理大列表、读取文件)中始终调用 ensureActive() 或 yield() 以检查取消;delay() 与 withContext() 等标准函数本身已可取消。
-
回调转换:使用 callbackFlow 将基于回调的 API 转换为 Flow;始终在 callbackFlow 块末尾使用 awaitClose 注销监听器。
代码模式
带 Flow 的仓库模式:
class NewsRepository(
private val remoteDataSource: NewsRemoteDataSource,
private val externalScope: CoroutineScope, // For app-wide events
private val ioDispatcher: CoroutineDispatcher = Dispatchers.IO
) {
val newsUpdates: Flow<List<News>> = flow {
val news = remoteDataSource.fetchLatestNews()
emit(news)
}.flowOn(ioDispatcher) // Upstream executes on IO
}
并行执行:
suspend fun loadDashboardData() = coroutineScope {
val userDeferred = async { userRepo.getUser() }
val feedDeferred = async { feedRepo.getFeed() }
// Wait for both
DashboardData(
user = userDeferred.await(),
feed = feedDeferred.await()
)
}
使用 runTest 测试:
@Test
fun testViewModel() = runTest {
val testDispatcher = StandardTestDispatcher(testScheduler)
val viewModel = MyViewModel(testDispatcher)
viewModel.loadData()
advanceUntilIdle() // Process coroutines
assertEquals(expectedState, viewModel.uiState.value)
}
适用场景
适用于 Android 应用开发中涉及协程的异步数据获取、后台处理、响应式流实现、生命周期安全收集、ViewModel 状态管理、回调转协程、内存泄漏修复以及协程测试等任务。
限制
资料未提供该技能的具体安装方式、支持的平台版本范围、收费模式或价格信息,暂未提供。