Android Compose中如何测试TextField的输入键盘类型？

Compose默认的语义测试API并没有直接暴露KeyboardOptions的检查方法，不过可以通过自定义语义属性的方式来实现键盘类型的验证，步骤如下：

• 1. 定义自定义语义属性键
  先创建一个用于传递键盘类型的语义属性键，用来关联TextField的键盘配置：

  val KeyboardTypeKey = SemanticsPropertyKey<KeyboardType>("KeyboardType")
  var SemanticsPropertyReceiver.keyboardType by KeyboardTypeKey
  

• 2. 给TextField附加语义属性
  在设置keyboardOptions的同时，把对应的KeyboardType值添加到TextField的语义节点上：

  TextField(
      value = text,
      onValueChange = { text = it },
      keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Number),
      modifier = Modifier.semantics {
          // 同步键盘类型到语义属性
          keyboardType = KeyboardType.Number
      }
  )
  

• 3. 在测试中验证键盘类型
  通过Compose测试规则找到目标TextField的语义节点，然后检查自定义的语义属性值是否符合预期：

  @Test
  fun testTextFieldUsesNumberKeyboard() {
      composeTestRule.setContent {
          var text by remember { mutableStateOf("") }
          TextField(
              value = text,
              onValueChange = { text = it },
              keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Number),
              modifier = Modifier.semantics {
                  keyboardType = KeyboardType.Number
              }
          )
      }
  
      // 找到具有输入功能的TextField节点
      composeTestRule.onNode(hasSetTextAction())
          // 验证自定义属性已定义
          .assert(SemanticsMatcher.keyIsDefined(KeyboardTypeKey))
          // 验证键盘类型为数字键盘
          .assert { node ->
              node.config[KeyboardTypeKey] == KeyboardType.Number
          }
  }
  

另外，也可以通过间接方式验证：比如尝试输入非数字字符，看TextField是否会过滤这些输入。但这种方法依赖系统键盘的行为，不同设备可能有差异，不如自定义语义属性的方式直接可靠。

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