测试 Uiautomator

适用于跨应用功能界面测试的框架

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
2023 年 1 月 11 日	-	-	-	2.3.0-alpha02

声明依赖项

如需添加 Test 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 制品库。

在应用或模块的 build.gradle 文件中添加所需制品的依赖项：

dependencies {
    // Use to implement UIAutomator tests
    androidTestImplementation "androidx.test.uiautomator:uiautomator:2.3.0-alpha02"
}

dependencies {
    // Use to implement UIAutomator tests
    androidTestImplementation("androidx.test.uiautomator:uiautomator:2.3.0-alpha02")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

如需了解详情，请参阅问题跟踪器文档。

2023 年 1 月 11 日

发布了 androidx.test.uiautomator:uiautomator:2.3.0-alpha02。版本 2.3.0-alpha02 中包含以下提交内容。

API 变更

重新设计了整个库的日志记录功能，以提供更多信息、就潜在问题发出警告并提高一致性。
添加了 UiDevice#pressKeyCodes 以支持同时按下多个按键，例如同时按 POWER 和 VOLUME_DOWN 可截屏 (22e525)。
添加了 UiDevice#setCompressedLayoutHierarchy 并废弃了 UiDevice#setCompressedLayoutHeirarchy，以修复方法名称中的拼写错误 (4e2f65)。
将 UiAutomatorInstrumentationTestRunner 标记为已废弃，因为它是用于处理已废弃的 UiAutomatorTestCase，不再需要了 (be6c85)。
将 UiObject2 MotionEvent 之间的延迟时间更新为显示刷新率的 2 倍，以更好地模拟用户手势 (454450)。
添加了对多行文本和说明匹配的支持（1625e6、b/255787130）。

bug 修复

修复了在查询或等待对象时偶尔抛出 StaleObjectException 的问题 (4cbcc0)。
修复了 UiScrollable#scrollToBeginning、scrollToEnd、flingToBeginning 和 flingToEnd 的返回值不表明是否已到达开头/末尾的问题 (d33e06)。
修复了 UiScrollable#scrollForward 和 scrollBackward 方法忽略所配置的超时时限的问题 (29e4f3)。
修复了 BySelector 复制构造函数不处理深度选择器的问题 (6c7b91)。
修复了对 UiObject#pinchIn 和 pinchOut 中无效百分比值的处理方式 (01b973)。
修复了重置底层 UiAutomation 连接后多窗口支持会丢失的罕见问题 (1bb956)。

2022 年 9 月 7 日

发布了 androidx.test.uiautomator:uiautomator:2.3.0-alpha01。版本 2.3.0-alpha01 中包含这些提交内容。

API 变更

为所有公共方法添加了 null 性注解。
MotionEvent 注入改为了异步，并有短暂的延迟，使 UiObject2 手势更流畅。
减小了轮询时间间隔，同时将等待时间从 1000 毫秒缩短为 100 毫秒。
更新了 UiDevice#wakeUp 和 UiDevice#sleep，以使用 KEYCODE_WAKEUP 和 KEYCODE_SLEEP 来支持替换电源按钮的设备。
添加了 UiObject2#getDisplayId，并且支持在多个显示屏中查找和管理对象。
添加了 UiObject#click 和 UiObject2#clickAndWait 方法，以完成基于坐标的点击操作。

bug 修复