SuperAPI AI 工具集

android-coroutines

编程与开发

查看项目

更新于 10-17 16:16

技能介绍

用途

该技能面向在 Android 平台上编写生产级 Kotlin Coroutines 代码的场景,提供一套权威规则与模式,强制结构化并发、生命周期安全以及符合 2025 标准的现代最佳实践。

主要能力

技能覆盖以下职责范围:

  • 异步逻辑:实现 suspend 函数、Dispatcher 管理与并行执行。
  • 响应式流:实现 Flow、StateFlow、SharedFlow 与 callbackFlow。
  • 生命周期集成:管理作用域(viewModelScope、lifecycleScope)与安全收集(repeatOnLifecycle)。
  • 错误处理:实现 CoroutineExceptionHandler、SupervisorJob 与正确的 try-catch 层级。
  • 可取消性:通过 ensureActive() 确保长时间运行操作具备协作性。
  • 测试:配置 TestDispatcher 与 runTest。

使用方式

当用户提出以下请求时激活该技能:从 API/数据库获取数据、执行后台处理、修复与线程/任务相关的内存泄漏、将监听器/回调转换为 Coroutines、实现 ViewModel、处理 UI 状态更新。

关键规则与约束

  1. 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) { ... }
}
  1. 主线程安全:Data 或 Domain 层定义的所有 suspend 函数必须主线程安全;一次性调用应暴露为 suspend 函数;数据变更应暴露为 Flow;调用方(ViewModel)应能在 Dispatchers.Main 上调用而不阻塞 UI;在仓库实现内部使用 withContext(dispatcher) 将执行移至后台。

  2. 生命周期感知收集:绝不在 lifecycleScope.launch 或 launchWhenStarted(已弃用/不安全)中直接收集 flow;在 Activity 或 Fragment 中收集 flow 时始终使用 repeatOnLifecycle(Lifecycle.State.STARTED)。

// CORRECT
viewLifecycleOwner.lifecycleScope.launch {
    viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.STARTED) {
        viewModel.uiState.collect { ... }
    }
}
  1. ViewModel 作用域使用:在 ViewModel 中使用 viewModelScope 启动协程;不要从 ViewModel 向 View 暴露 suspend 函数,ViewModel 应暴露 View 观察的 StateFlow 或 SharedFlow。

  2. 可变状态封装:绝不公开暴露 MutableStateFlow 或 MutableSharedFlow;使用 .asStateFlow() 或向上转型将其暴露为只读 StateFlow 或 Flow。

  3. 禁止 GlobalScope:绝不使用 GlobalScope,它会破坏结构化并发并导致泄漏;如果任务必须存活于当前作用域,使用注入的 applicationScope(绑定到 Application 生命周期的自定义作用域)。

  4. 异常处理:绝不在泛型 catch (e: Exception) 块中捕获 CancellationException 而不重新抛出;仅在显式重新抛出 CancellationException 时使用 runCatching;CoroutineExceptionHandler 仅用于顶层协程(launch 内部),在 async 或子协程中无效。

  5. 可取消性:协程采用协作式取消,除非检查取消否则不会立即停止;在紧凑循环(如处理大列表、读取文件)中始终调用 ensureActive() 或 yield() 以检查取消;delay() 与 withContext() 等标准函数本身已可取消。

  6. 回调转换:使用 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 状态管理、回调转协程、内存泄漏修复以及协程测试等任务。

限制

资料未提供该技能的具体安装方式、支持的平台版本范围、收费模式或价格信息,暂未提供。