求助：Flutter中使用Maestro无法识别CheckboxListTile组件

Maestro依赖Flutter语义树识别UI组件，默认的CheckboxListTile可能因语义信息不足无法被精准定位，可通过以下几种方式解决：

1. 添加语义标签 #

给CheckboxListTile直接添加语义属性，明确组件的语义信息：

CheckboxListTile(
  title: Text('localizations.welcomeDisclaimerChoice'),
  value: checkedValue,
  onChanged: (newValue) {
    setState(() {
      checkedValue = newValue!;
    });
  },
  semanticsLabel: '欢迎声明选择', // 自定义语义标签
  semanticsValue: checkedValue ? '已选中' : '未选中', // 反馈选中状态
);

也可以用Semantics组件包裹CheckboxListTile，更灵活地定义语义信息：

Semantics(
  label: '欢迎声明选择',
  value: checkedValue ? '已选中' : '未选中',
  child: CheckboxListTile(
    title: Text('localizations.welcomeDisclaimerChoice'),
    value: checkedValue,
    onChanged: (newValue) {
      setState(() {
        checkedValue = newValue!;
      });
    },
  ),
);

2. 给组件添加唯一Key #

通过Key定位是最直接的方式，给CheckboxListTile设置全局唯一的Key：

CheckboxListTile(
  key: const Key('welcome_disclaimer_checkbox'),
  title: Text('localizations.welcomeDisclaimerChoice'),
  value: checkedValue,
  onChanged: (newValue) {
    setState(() {
      checkedValue = newValue!;
    });
  },
);

之后在Maestro脚本中通过Key定位并操作：

- tapOn:
    key: welcome_disclaimer_checkbox

3. 通过显示文本定位 #

如果CheckboxListTile的标题文本能被Maestro识别（确保是实际渲染的本地化文本），可直接用文本定位：

- tapOn: "欢迎声明选择"

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