flutter_driver library

提供API以测试在真实设备和仿真器上运行的Flutter应用程序.

该应用程序与测试本身在单独的过程中运行.

这是Flutter的Selenium WebDriver(通用网络),Protractor(角度),Espresso(Android)或Earl Gray(iOS)的版本.

Classes

Ancestor
扑驱动取景器,用于查找的祖先匹配的匹配 . [...]
BySemanticsLabel
Flutter Driver查找器,通过语义标签查找小部件. [...]
ByText
Flutter Driver查找器,可通过TextEditableText小部件中的文本查找小部件.
ByTooltipMessage
Flutter Driver查找器,可通过工具提示文本查找小部件.
ByType
Flutter Driver查找器,通过它们的runtimeType查找小部件.
ByValueKey
Flutter Driver查找器,通过ValueKey查找小部件.
CombinedCondition
等待直到满足所有给定条件的组合条件.
Command
从Flutter驱动程序发送到Flutter应用程序的对象,指示该应用程序执行任务.
CommandWithTarget
Flutter Driver命令针对查找器要定位的对象. [...]
CommonFinders
为经常使用的查找器提供方便的访问器.
Descendant
一扑驱动程序搜索器,找到的后裔匹配匹配 . [...]
DiagnosticsTreeResult
GetDiagnosticsTree命令的结果.
DriverOffset
Flutter驱动程序使用的一个不变的2D浮点偏移量.
EnterText
Flutter Driver命令,可将文本输入当前聚焦的窗口小部件.
EnterTextResult
EnterText命令的结果.
EnumIndex<E>
通过简单名称索引enum值列表. [...]
FirstFrameRasterized
等待条件,直到Flutter引擎已光栅化第一帧.
FlutterDriver
驱动在另一个进程中运行的Flutter应用程序.
FlutterWebConnection
将连接信息封装到Flutter Web应用程序的实例.
FuchsiaCompat
用于创建与紫红色设备的连接的实用程序类. [...]
GetDiagnosticsTree
Flutter Driver命令,用于检索finder标识的对象的JSON序列化DiagnosticsNode树. [...]
GetHealth
Flutter Driver命令,请求应用程序运行状况检查.
GetOffset
一扑驱动命令返回offsetType从查明的渲染对象取景 . [...]
GetOffsetResult
GetRect命令的结果. [...]
GetRenderTree
Flutter Driver命令,请求渲染树的字符串表示形式.
GetSemanticsId
Flutter驱动程序命令,该命令使用指定的查找器检索语义ID. [...]
GetSemanticsIdResult
GetSemanticsId命令的结果.
GetText
Flutter Driver命令,可从给定元素读取文本.
GetTextResult
GetText命令的结果.
Health
响应FlutterDriver.checkHealth测试而提供的应用程序状态的描述.
NoPendingFrame
等待直到没有计划任何待定帧的条件.
NoPendingPlatformMessages
等待直到没有待处理的平台消息的条件.
NoTransientCallbacks
等待直到没有安排任何临时回调的条件.
PageBack
Flutter Driver查找器,可在页面的Material或Cupertino支架上找到后退按钮. [...]
RenderTree
渲染树的字符串表示形式,它是FlutterDriver.getRenderTree方法的结果.
RequestData
Flutter Driver命令,该命令将字符串发送到应用程序并期望字符串响应.
RequestDataResult
RequestData命令的结果.
Result
响应命令,将对象从Flutter应用程序发送回Flutter驱动程序.
Scroll
Flutter Driver命令,该命令命令驱动程序执行滚动操作.
ScrollIntoView
Flutter Driver命令,该命令命令驱动程序确保finder代表的元素已完全滚动到视图中.
ScrollResult
滚动命令的结果.
SerializableFinder
Flutter驱动程序查找器的基类,这些对象描述驱动程序应如何搜索元素.
SerializableWaitCondition
Flutter驱动程序等待条件的基类,这些对象描述了驱动程序可以等待的条件. [...]
SetFrameSync
Flutter Driver命令,用于启用或禁用FrameSync机制.
SetFrameSyncResult
SetFrameSync命令的结果.
SetSemantics
Flutter Driver命令,用于启用或禁用语义.
SetSemanticsResult
SetSemantics命令的结果.
SetTextEntryEmulation
Flutter Driver命令,用于启用和禁用文本输入仿真.
SetTextEntryEmulationResult
SetTextEntryEmulation命令的结果.
Tap
A Flutter Driver command that taps on a target widget located by finder.
TapResult
Tap命令的结果.
Timeline
Flutter运行时记录的时间轴数据.
TimelineEvent
单个时间轴事件.
TimelineSummary
时间轴中提取统计信息.
VMServiceClientConnection
将连接信息封装到Flutter应用程序的实例.
VMServiceFlutterDriver
Flutter驱动程序通过vmservice协议的实现.
WaitFor
Flutter Driver命令,等待发现者找到目标.
WaitForAbsent
一扑驱动命令等待,直到取景器不再能够找到目标.
WaitForAbsentResult
WaitForAbsent命令的结果.
WaitForCondition
Flutter Driver命令,等待直到满足给定条件 .
WaitForResult
WaitFor命令的结果.
WaitUntilFirstFrameRasterized
Flutter驱动程序命令,它等待直到Flutter引擎光栅化第一帧. [...]
WaitUntilNoPendingFrame
Flutter Driver命令,等待直到帧同步. [...]
WaitUntilNoTransientCallbacks
Flutter Driver命令,等待直到队列中没有更多的瞬态回调. [...]
WebFlutterDriver
使用WebDriver的Flutter驱动程序的实现. [...]

Constants

find → const CommonFinders
常用查找器的便捷访问器. [...]
CommonFinders._()
kBuildBudget → const Duration
被认为可安全用于框架构建阶段的最长时间. 过去有可能丢失60FPS帧的危险.
Duration (milliseconds: 16)
kUnusuallyLongTimeout → const Duration
显示消息似乎需要很长时间之前,需要等待多长时间.
@visibleForTesting
Duration (seconds: 5)

Properties

driverLog DriverLogCallback
将给定的消息打印到控制台. [...]
读/写
fs FileSystem
该库使用的文件系统实现. [...]
读/写
testOutputsDirectory String
Flutter驱动程序测试输出目录. [...]
只读
vmServiceConnectFunction VMServiceConnectFunction
FlutterDriver.connect使用的连接函数. [...]
读/写

Functions

restoreFileSystem() → void
将文件系统恢复为默认的本地文件系统实现.
restoreVmServiceConnectFunction() → void
vmServiceConnectFunction恢复为默认值.
useMemoryFileSystemForTesting() → void
覆盖文件系统,以便可以在不损坏硬盘驱动器的情况下对其进行测试.
waitUntilExtensionInstalled(WebDriver driver, Duration timeout) Future<void>
等待直到安装了扩展程序.

Enums

DiagnosticsType
GetDiagnosticsTree可以请求的DiagnosticsNode树类型.
HealthStatus
应用程序状态的描述.
OffsetType
GetOffset可以请求的偏移量类型.
TimelineStream
时间轴流标识符.

Typedefs

DriverLogCallback(String source, String message) → void
driverLog的签名. [...]
EvaluatorFunction() → dynamic
计算一个值. [...]
VMServiceConnectFunction(String url) Future<VMServiceClientConnection>
给定url连接到Dart VM服务的功能.

Exceptions / Errors

DriverError
Flutter驱动程序API引发的标准错误.
SerializationException
抛出以指示序列化错误.