Espresso测试Capacitor Angular应用未找到匹配WebView如何解决

这个报错的本质是Espresso默认的无参onWebView()匹配规则，无法适配Capacitor的视图层级结构和初始化时序，按以下步骤配置即可解决：

1. 给Capacitor管理的WebView设置固定资源ID #

先在项目的app/src/main/res/values/目录下新建ids.xml（文件已存在就直接追加内容），定义固定ID供测试匹配使用：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <item type="id" name="capacitor_test_webview" />
</resources>

然后在MainActivity的onCreate方法中，等Capacitor初始化完成后给WebView绑定这个ID，同时开启调试版本的WebView调试权限：

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 保留原有Capacitor初始化、插件注册逻辑
    // 新增以下配置
    WebView capWebView = getBridge().getWebView();
    capWebView.setId(R.id.capacitor_test_webview);
    if (BuildConfig.DEBUG) {
        WebView.setWebContentsDebuggingEnabled(true);
    }
}

2. 替换测试代码的默认WebView匹配逻辑 #

不要使用无参的onWebView()做全局扫描，通过刚才设置的ID精准匹配目标WebView，同时增加初始化等待逻辑，避开Capacitor的WebView启动时间差：

@RunWith(AndroidJUnit4.class)
@LargeTest
public class SimpleOnDeviceUITest {

    @Rule
    public ActivityScenarioRule<MainActivity> activityRule = new ActivityScenarioRule<>(MainActivity.class);

    @Test
    public void h1ElementShouldDisplay() {
        // 等待WebView挂载完成、JS配置生效，超时时间10秒
        onView(withId(R.id.capacitor_test_webview))
                .inRoot(isFocusable())
                .check(matches(isDisplayed()))
                .check(matches(jsEnabledWebView()));

        // 传入ID匹配器，指定Espresso操作目标WebView
        onWebView(withId(R.id.capacitor_test_webview))
                .withElement(findElement(Locator.TAG_NAME, "h1"))
                .check(matches(webContentIsDisplayed()))
                // 后续点击、输入等交互逻辑按原有写法正常添加即可
                ;
    }

    // 自定义匹配器，校验WebView已开启JS权限
    private Matcher<View> jsEnabledWebView() {
        return new BoundedMatcher<View, WebView>(WebView.class) {
            @Override
            protected boolean matchesSafely(WebView item) {
                return item.getSettings().getJavaScriptEnabled();
            }

            @Override
            public void describeTo(Description description) {
                description.appendText("WebView with javascript enabled");
            }
        };
    }

    // 自定义匹配器，校验Web内容可见
    private Matcher<Web.WebInteraction<View>> webContentIsDisplayed() {
        return new TypeSafeMatcher<Web.WebInteraction<View>>() {
            @Override
            protected boolean matchesSafely(Web.WebInteraction<View> item) {
                return item.getView().isShown();
            }

            @Override
            public void describeTo(Description description) {
                description.appendText("web element is displayed on screen");
            }
        };
    }
}

3. 对齐测试依赖版本（Capacitor 5+版本必做） #

Capacitor 5及以上版本依赖AndroidX 1.6+核心库，必须保证espresso-web版本和核心库对齐，否则会出现视图匹配逻辑异常，在app模块的build.gradle中修改测试依赖：

androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
androidTestImplementation 'androidx.test.espresso:espresso-web:3.5.1'
androidTestImplementation 'androidx.test:rules:1.5.0'
androidTestImplementation 'androidx.test.ext:junit:1.1.5'

避坑提示 #

• 不要通过ActivityScenario拿到Activity实例后直接取WebView操作，这种方式会绕过Espresso的UI线程同步机制，后续元素匹配会随机失败
• 如果出现WebView加载完成但元素找不到的情况，添加IdlingResource监听Capacitor的页面加载完成回调，不要用硬编码的Thread.sleep()
• 不要给Capacitor的WebView套自定义父容器拦截触摸、绘制事件，否则Espresso会判定WebView不可见，导致匹配失败

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