本文介绍如何利用 kotlin 华程的 `suspendcancellablecoroutine` 将异步回调（如 `areallthesettingsgranted`）安全转为挂起函数，从而在不阻塞主线程的前提下实现“等待结果再执行后续逻辑”的同步式编码体验。
在 Android 或 Kotlin 开发中，许多系统 API（如 LocationSettingsClient）仅提供基于回调的异步接口，例如：
settings.areAllTheSettingsGranted { isGranted ->
// 回调中才能拿到结果 —— 但此时已脱离原始调用栈
}
// 此处 result 还未被赋值，无法直接使用！这种设计导致逻辑分散、难以组合，也违背了现代 Kotlin 推崇的结构化并发理念。你不能也不应“强制阻塞线程”来等待回调（如使用 CountDownLatch 或 Thread.sleep()），这会破坏响应性，甚至引发 ANR。
✅ 正确解法：使用协程封装回调为挂起函数。
✅ 推荐方案：用 suspendCancellableCoroutine 封装
该函数允许你在协程上下文中挂起执行，并在回调触发时恢复——既保持非阻塞，又获得同步编码的直观性：
import kotlinx.coroutines.suspendCancellableCoroutine
import kotlin.coroutines.resume
suspend fun areAllSettingsGranted(): Boolean {
return suspendCancellableCoroutine { cont ->
settings.areAllTheSettingsGranted { isGranted ->
cont.resume(isGranted)
}
// 可选：处理取消（如用户退出页面）
cont.invokeOnCancellation {
// 如需清理资源，可在此添加逻辑
}
}
}调用时即可像同步函数一样使用：
scope.launch {
try {
val result = areAllSettingsGranted() // 挂起，直到回调返回
if (result) {
// ✅ 安全使用 result —— 此处它已确定为 Boolean
startLocationUpdates()
} else {
showSettingsDialog()
}
} catch (e: CancellationException) {
// 协程被取消（如界面销毁），无需额外处理
}
}? 进阶：嵌套回调链的统一处理（如 checkIfLocationServicesAreEnabled）
你提到内部还有另一层回调（checkLocationSettings）。同样可封装为挂起函数，并复用上述模式：
suspend fun checkLocationServicesEnabled(): Boolean {
return suspendCancellableCoroutine { cont ->
settingsClient.checkLocationSettings(locationSettingsRequestBuilder.build())
.addOnSuccessListener { cont.resume(true) }
.addOnFailureListener { cont.resume(false) }
cont.invokeOnCancellation {
// 可选择调用 cancel()（若 API 支持）
}
}
}这样，整个权限与定位检查流程可清晰串联：
suspend fun ensureLocationReady(): Boolean {
if (!areAllSettingsGranted()) return false
return checkLocationServicesEnabled()
}
// 使用
scope.launch {
val ready = ensureLocationReady()
if (ready) launchLocationFlow() else handleSetupNeeded()
}⚠️ 注意事项
- 必须在协程作用域内调用：如 lifecycleScope、viewModelScope 或自定义 CoroutineScope；
- 避免在非协程上下文（如普通函数、onClick 直接调用）中使用 suspend 函数，否则编译不通过；
- suspendCancellableCoroutine 自动处理协程取消，建议在 invokeOnCancellation 中释放相关资源（如注销监听器）；
- 不要尝试用 runBlocking 包裹此类调用——它会阻塞线程，绝对禁止在主线程使用。
✅ 总结
将回调转为挂起函数不是“强行同步”，而是借助协程的挂起/恢复机制，在逻辑上达成顺序表达，同时物理上保持异步非阻塞。这是 Kotlin 协程最核心的价值之一。坚持此模式，你的异步代码将更简洁、可读、可测试，也更符合现代 Android 架构最佳实践。
