求助：Jetpack Compose Dialog打开时Talkback总是读取应用名称

核心原因 #

Talkback读取的是你应用在AndroidManifest.xml中<application>标签的label属性，而非单个Activity的标签，所以修改Activity标签不会生效。要控制Dialog打开时的读取内容，可通过以下几种方式实现：

方法1：强制聚焦Dialog标题，跳过应用标签读取 #

通过FocusRequester让Dialog打开时直接聚焦到标题控件，Talkback会优先读取焦点内容，而非默认的应用标签。

@Composable
fun CustomDialog(showDialog: Boolean, onDismiss: () -> Unit) {
    if (showDialog) {
        val focusRequester = remember { FocusRequester() }

        Dialog(onDismissRequest = onDismiss) {
            Surface(shape = MaterialTheme.shapes.medium) {
                Column(modifier = Modifier.padding(16.dp)) {
                    // 给标题设置焦点请求器
                    Text(
                        text = "自定义对话框标题",
                        style = MaterialTheme.typography.titleLarge,
                        modifier = Modifier
                            .focusRequester(focusRequester)
                            .focusable() // 确保控件可被聚焦
                    )
                    // 对话框其他内容
                    Text(text = "对话框内容示例", modifier = Modifier.padding(top = 8.dp))
                }
            }

            // Dialog显示时请求聚焦标题
            LaunchedEffect(Unit) {
                focusRequester.requestFocus()
            }
        }
    }
}

方法2：自定义语义属性，覆盖默认读取行为 #

通过semantics修饰符给Dialog根容器设置自定义语义描述，或者清空默认描述，阻止Talkback读取应用标签。

@Composable
fun CustomDialog(showDialog: Boolean, onDismiss: () -> Unit) {
    if (showDialog) {
        Dialog(onDismissRequest = onDismiss) {
            Surface(
                modifier = Modifier
                    .semantics {
                        // 清空语义描述，阻止读取应用标签
                        contentDescription = ""
                        // 也可设置自定义初始读取内容
                        // contentDescription = "自定义初始提示内容"
                    },
                shape = MaterialTheme.shapes.medium
            ) {
                Column(modifier = Modifier.padding(16.dp)) {
                    Text(text = "自定义对话框标题", style = MaterialTheme.typography.titleLarge)
                    Text(text = "对话框内容示例", modifier = Modifier.padding(top = 8.dp))
                }
            }
        }
    }
}

方法3：调整Dialog窗口的辅助属性 #

通过修改Dialog窗口的importantForAccessibility属性，让辅助功能仅关注Dialog内部内容，忽略外部应用标签的读取。

@Composable
fun CustomDialog(showDialog: Boolean, onDismiss: () -> Unit) {
    if (showDialog) {
        Dialog(onDismissRequest = onDismiss) {
            val view = LocalView.current
            DisposableEffect(Unit) {
                val window = view.context.getWindow()
                // 保存原始属性值，避免影响其他场景
                val originalValue = window.decorView.importantForAccessibility
                // 设置窗口仅自身内容参与辅助功能
                window.decorView.importantForAccessibility = View.IMPORTANT_FOR_ACCESSIBILITY_YES

                // Dialog关闭时恢复原始属性
                onDispose {
                    window.decorView.importantForAccessibility = originalValue
                }
            }

            Surface(shape = MaterialTheme.shapes.medium) {
                Column(modifier = Modifier.padding(16.dp)) {
                    Text(text = "自定义对话框标题", style = MaterialTheme.typography.titleLarge)
                    Text(text = "对话框内容示例", modifier = Modifier.padding(top = 8.dp))
                }
            }
        }
    }
}

注意事项 #

• 方法1是最推荐的方案，符合辅助功能的最佳实践：让焦点落在用户最需要关注的内容上。
• 不要直接修改<application>的label来解决问题，这会影响应用在Launcher等场景的显示名称。

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