如何用Jetpack Compose+WindowManager实现Truecaller式全局悬浮窗？

问题原因 #

你的代码存在三个核心问题：

• 重复将overlayView绑定到两个不同容器：既通过AndroidView关联到Activity的Composable树，又通过WindowManager.addView添加到系统窗口，导致Compose的LayoutNode无法确定正确的所属Owner。
• 在onAttachedToWindow回调中重复调用window.addView，同一个View被多次添加到WindowManager，触发生命周期冲突。
• 全局悬浮窗属于系统级窗口，不应依赖Activity的Composable生命周期管理，需要独立于Activity的View树创建和维护。

解决方案 #

步骤1：申请必要权限 #

首先在AndroidManifest.xml中添加悬浮窗权限：

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

Android 6.0及以上版本需要动态引导用户开启权限：

fun requestOverlayPermission(context: Context) {
    if (!Settings.canDrawOverlays(context)) {
        val intent = Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION, Uri.parse("package:${context.packageName}"))
        context.startActivity(intent)
    }
}

步骤2：重构悬浮窗管理逻辑 #

创建独立的悬浮窗管理类，负责初始化Compose内容、添加/移除系统窗口，彻底与Activity的Composable生命周期解耦：

@RequiresApi(Build.VERSION_CODES.O)
class OverlayWindowManager(private val context: Context) {
    private val windowManager = context.getSystemService(WINDOW_SERVICE) as WindowManager
    private var overlayView: ComposeView? = null

    private val layoutParams = WindowManager.LayoutParams().apply {
        type = WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY
        format = PixelFormat.TRANSLUCENT
        flags = WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE or WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS
        gravity = Gravity.CENTER
        width = 400
        height = 300
    }

    fun showOverlay() {
        if (overlayView != null || !Settings.canDrawOverlays(context)) return

        overlayView = ComposeView(context).apply {
            setContent {
                ComposeOverlay()
            }
        }

        windowManager.addView(overlayView, layoutParams)
    }

    fun hideOverlay() {
        overlayView?.let {
            windowManager.removeView(it)
            overlayView = null
        }
    }
}

@Composable
fun ComposeOverlay() {
    Column(
        modifier = Modifier
            .padding(16.dp)
            .background(Color.White, RoundedCornerShape(8.dp))
            .padding(16.dp)
    ) {
        Text(text = "Hello from Compose!", color = Color.Black)
    }
}

步骤3：在Compose中调用管理类 #

主Composable仅处理权限检查和悬浮窗的显示/隐藏触发：

@RequiresApi(Build.VERSION_CODES.O)
@Composable
fun MyApp() {
    val context = LocalContext.current
    val overlayManager = remember { OverlayWindowManager(context) }

    Column(
        modifier = Modifier.fillMaxSize(),
        horizontalAlignment = Alignment.CenterHorizontally,
        verticalArrangement = Arrangement.Center
    ) {
        Button(onClick = {
            if (Settings.canDrawOverlays(context)) {
                overlayManager.showOverlay()
            } else {
                requestOverlayPermission(context)
            }
        }) {
            Text("显示悬浮窗")
        }

        Button(onClick = { overlayManager.hideOverlay() }) {
            Text("隐藏悬浮窗")
        }
    }
}

关键说明 #

• 使用ComposeView直接承载Compose内容，无需自定义FrameLayout，它本身就是官方提供的支持Compose的原生View容器。
• 悬浮窗的生命周期完全由OverlayWindowManager管理，与Activity的Composable树彻底解耦，避免Owner冲突。
• 移除了所有重复添加View的逻辑，确保每个悬浮窗View只被添加一次到WindowManager。

内容的提问来源于stack exchange，提问作者Slimane