如何在Android测试中访问应用悬浮窗（Application Overlay）？

核心原因 #

悬浮窗属于系统层级窗口（TYPE_SYSTEM_ALERT/TYPE_APPLICATION_OVERLAY），Espresso默认仅检测当前应用的主Activity窗口，UiAutomator默认也不会自动遍历系统层级窗口，因此导致控件查找失败。

解决方案1：使用UiAutomator指定窗口类型查找 #

修改Instrumented Test代码，先定位到悬浮窗所在的系统层级窗口，再在该窗口内查找目标按钮：

val device = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation())
// 匹配悬浮窗的窗口类型
val windowType = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY
} else {
    WindowManager.LayoutParams.TYPE_SYSTEM_ALERT
}
// 找到悬浮窗窗口
val overlayWindow = device.findObject(UiSelector().windowType(windowType))
// 在窗口内查找目标按钮
val floatingButton = overlayWindow.findObject(UiSelector().resourceId("com.example.myappname:id/someButton"))

// 等待控件加载完成后执行点击
if (floatingButton.waitForExists(5000)) {
    floatingButton.click()
}

解决方案2：确保权限已授予 #

Android 6.0+版本需要保证目标应用（或测试应用）已获得SYSTEM_ALERT_WINDOW权限：

• 手动授予：前往设备「设置」→「应用」→「目标应用」→「权限」→开启「显示在其他应用上层」
• 代码自动引导（可选）：在测试初始化阶段跳转权限设置页面，引导用户授予权限（需处理页面返回逻辑）

关于Espresso的说明 #

Espresso本身设计用于测试应用内的Activity/Fragment视图，对系统层级窗口的支持有限，不推荐用它测试悬浮窗控件，优先选择UiAutomator方案。

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