如何解决Appium Flutter Driver无法获取Flutter文本组件值的问题？

使用Python结合Appium Flutter Driver测试Flutter应用时，部分功能正常运行，但处理文本组件时遇到问题：可通过semanticsLabel定位到文本元素，但无法从FlutterElement中读取文本值，询问是操作有误还是该方式本身不可行。

Flutter代码 #

const Text("Text with semanticsLable", semanticsLabel: "text_semantic_lable"),

Python代码 #

driver = Remote('http://127.0.0.1:4723',
                {'platformName': 'android',
                 'automationName': 'flutter',
                 'platformVersion': '',
                 'deviceName': 'emulator-5554',
                 'app': '/Users/xxxx/AndroidStudioProjects/hello_world_appium/build/app/outputs/flutter-apk/app-debug.apk'
                 })

finder = FlutterFinder()
text_finder = finder.by_semantics_label("text_semantic_lable")
text_element = FlutterElement(driver, text_finder)
print(text_element.text)

错误日志 #

Traceback (most recent call last):
  File "/Users/xxx/git/xxx/tests/xxx/solutions/IC/flutter_test.py", line 90, in <module>
    print(text_element.text)
          ^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.11/site-packages/selenium/webdriver/remote/webelement.py", line 89, in text
    return self._execute(Command.GET_ELEMENT_TEXT)["value"]
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.11/site-packages/selenium/webdriver/remote/webelement.py", line 403, in _execute
    return self._parent.execute(command, params)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.11/site-packages/selenium/webdriver/remote/webdriver.py", line 440, in execute
    self.error_handler.check_response(response)
  File "/usr/local/lib/python3.11/site-packages/appium/webdriver/errorhandler.py", line 30, in check_response
    raise wde
  File "/usr/local/lib/python3.11/site-packages/appium/webdriver/errorhandler.py", line 26, in check_response
    super().check_response(response)
  File "/usr/local/lib/python3.11/site-packages/selenium/webdriver/remote/errorhandler.py", line 245, in check_response
    raise exception_class(message, screen, stacktrace)
selenium.common.exceptions.WebDriverException: Message: An unknown server-side error occurred while processing the command. Original error: Cannot execute command get_text, server reponse {
  "isError": true,
  "response": "Uncaught extension error while executing get_text: Unsupported operation: Type Semantics is currently not supported by getText\n#0      CommandHandlerFactory._getText (package:flutter_driver/src/common/handler_factory.dart:430:7)\n<asynchronous suspension>\n#1      FlutterDriverExtension.call (package:flutter_driver/src/extension/extension.dart:372:31)\n<asynchronous suspension>\n#2      BindingBase.registerServiceExtension.<anonymous closure> (package:flutter/src/foundation/binding.dart:856:18)\n<asynchronous suspension>\n",
  "type": "_extensionType",
  "method": "ext.flutter.driver"
}
Stacktrace:
UnknownError: An unknown server-side error occurred while processing the command. Original error: Cannot execute command get_text, server reponse {
  "isError": true,
  "response": "Uncaught extension error while executing get_text: Unsupported operation: Type Semantics is currently not supported by getText\n#0      CommandHandlerFactory._getText (package:flutter_driver/src/common/handler_factory.dart:430:7)\n<asynchronous suspension>\n#1      FlutterDriverExtension.call (package:flutter_driver/src/extension/extension.dart:372:31)\n<asynchronous suspension>\n#2      BindingBase.registerServiceExtension.<anonymous closure> (package:flutter/src/foundation/binding.dart:856:18)\n<asynchronous suspension>\n",
  "type": "_extensionType",
  "method": "ext.flutter.driver"
}
    at getResponseForW3CError (/usr/local/lib/node_modules/appium/node_modules/@appium/base-driver/lib/protocol/errors.js:1067:9)
    at asyncHandler (/usr/local/lib/node_modules/appium/node_modules/@appium/base-driver/lib/protocol/protocol.js:476:57)

从错误日志中Unsupported operation: Type Semantics is currently not supported by getText的提示可知，通过semanticsLabel定位的元素无法直接调用get_text（即text_element.text）获取文本，这是Flutter Driver的原生限制，它的getText方法不支持Semantics类型元素。可通过以下三种方式解决：

• 方法一：通过文本内容直接定位
  若文本内容固定，直接使用by_text定位元素，即可正常读取文本：

  finder = FlutterFinder()
  text_finder = finder.by_text("Text with semanticsLable")
  text_element = FlutterElement(driver, text_finder)
  print(text_element.text)
  

• 方法二：从semantics属性中提取文本
  既然通过semanticsLabel定位，可直接获取元素的semantics属性，从中提取目标文本：

  # 获取元素的semantics属性字典
  semantics_data = text_element.get_attribute("semantics")
  # 根据实际返回结构提取文本，示例取label字段
  print(semantics_data.get("label"))
  

• 方法三：给Text组件添加测试Key
  修改Flutter代码，给目标Text添加测试专用Key，再通过by_value_key定位，即可正常读取文本：
  Flutter代码：

  const Text("Text with semanticsLable", 
            semanticsLabel: "text_semantic_lable",
            key: Key("text_test_key")),
  

  Python代码：

  finder = FlutterFinder()
  text_finder = finder.by_value_key("text_test_key")
  text_element = FlutterElement(driver, text_finder)
  print(text_element.text)
  

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