Compose UI运行时（非测试场景）如何查询语义树获取可组合项属性

你可以直接通过Compose官方公开的运行时API访问语义树，不需要依赖测试组件，也不需要给每个目标节点加onGloballyPositioned回调。具体实现步骤如下：

1. 先定义全局唯一的自定义语义属性 #

// 定义语义属性Key
val CustomSemanticKey = SemanticsPropertyKey<String>("CustomSemanticKey")
// 扩展语义属性接收器，方便设置属性
var SemanticsPropertyReceiver.customValue by CustomSemanticKey

你给目标节点设置属性的代码可以简化为：

Text(
    text = text, 
    modifier = Modifier.semantics {
        customValue = "CustomValue"
    }
)

2. 获取当前Compose树的SemanticsOwner实例 #

SemanticsOwner是语义树的持有者，你可以通过两种方式获取：

• 如果你在Activity/Fragment中持有ComposeView实例：

val semanticsOwner = composeView.semanticsOwner

• 如果你在Composable函数内部执行查询：

val localView = LocalView.current
val semanticsOwner = localView.findViewTreeSemanticsOwner() ?: return

3. 遍历语义树匹配目标节点 #

递归遍历所有语义节点，匹配自定义属性值即可拿到目标节点：

fun findTargetSemanticNode(
    semanticsOwner: SemanticsOwner,
    targetValue: String
): SemanticsNode? {
    fun traverseNode(node: SemanticsNode): SemanticsNode? {
        // 匹配当前节点属性
        if (node.config.getOrNull(CustomSemanticKey) == targetValue) {
            return node
        }
        // 递归遍历子节点
        node.children.forEach { childNode ->
            val matched = traverseNode(childNode)
            if (matched != null) return matched
        }
        return null
    }
    return traverseNode(semanticsOwner.rootSemanticsNode)
}

4. 读取目标节点的位置和尺寸信息 #

匹配到的SemanticsNode直接提供了布局相关的公开属性：

val targetNode = findTargetSemanticNode(semanticsOwner, "CustomValue")
targetNode?.let { node ->
    // 节点尺寸
    val width = node.size.width
    val height = node.size.height
    // 节点在Compose根布局中的左上角坐标
    val positionInRoot = node.positionInRoot
    val rootX = positionInRoot.x
    val rootY = positionInRoot.y
    // 节点在手机屏幕全局的左上角坐标
    val positionInScreen = node.positionInWindow
    val screenX = positionInScreen.x
    val screenY = positionInScreen.y
}

注意事项：

1. 只有设置了semantics modifier的节点才会出现在语义树中，确保你的目标节点都配置了自定义语义属性
2. 建议在布局完全渲染完成后再执行查询逻辑，比如在Composable中配合LaunchedEffect(Unit)触发查询，避免拿到未完成布局的无效值

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