Android测试构建报错：<instrumentation>标签android:name需为合法Java类名

嘿，我帮你梳理下这个问题，你遇到的android:name在<instrumentation>标签里不是有效Java类名的错误，本质是测试相关的Manifest配置出了问题，我一步步给你说怎么解决：

先明确你的问题背景 #

你写了这段Espresso测试代码来验证Activity跳转：

@Test
public void checkNewActivity() {
    onView(withId(R.id.button_open_new_activity)).perform(click());
    onView(withText("SecondActivity")).check(matches(isDisplayed()));
}

主Manifest里也正确声明了两个Activity：

<activity android:name=".SecondActivity" android:label="@string/title_activity_second" android:theme="@style/AppTheme.NoActionBar">
</activity>
<activity android:name=".MainActivity" android:label="@string/app_name" android:theme="@style/AppTheme.NoActionBar">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

但构建时遇到了这个报错：

Android resource linking failed /Users/shihab/StudioProjects/AndroidTesting/app/build/intermediates/merged_manifests/debugAndroidTest/AndroidManifest.xml:9: error: attribute 'android:name' in tag must be a valid Java class name。

错误原因 #

这个错误说明测试环境合并后的AndroidManifest.xml里，<instrumentation>标签的android:name属性值要么拼写错了，要么对应的类不存在，或者包名不匹配。通常是测试Manifest配置错误，或者build.gradle里的测试运行器配置不一致导致的。

具体解决方案 #

1. 检查/创建测试目录的AndroidManifest.xml #

打开app/src/androidTest/AndroidManifest.xml（如果没有就新建一个），确保配置是正确的：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.your.app.package"> <!-- 替换成你自己的应用包名 -->

    <instrumentation
        android:name="androidx.test.runner.AndroidJUnitRunner"
        android:targetPackage="com.your.app.package" /> <!-- 必须和应用包名完全一致 -->

    <application>
        <uses-library android:name="android.test.runner" />
    </application>
</manifest>

注意：如果你还在用旧的Support库，把androidx.test.runner.AndroidJUnitRunner换成android.support.test.runner.AndroidJUnitRunner，但更推荐迁移到AndroidX。

2. 确认build.gradle的测试依赖配置 #

打开模块级别的build.gradle（也就是app/build.gradle），确保测试相关的依赖和运行器配置正确：

dependencies {
    // Espresso核心依赖
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
    // JUnit扩展
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    // 测试运行器
    androidTestImplementation 'androidx.test:runner:1.5.2'
}

android {
    defaultConfig {
        // 这里的运行器要和测试Manifest里的name完全一致
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
}

3. 清理缓存并重新构建 #

有时候IDE的缓存会导致Manifest合并异常，执行以下步骤：

• 点击Android Studio顶部菜单栏的Build -> Clean Project
• 然后点击Build -> Rebuild Project
• 最后尝试重新运行你的测试

如果还是不行，可以手动删除app/build目录，再重新构建项目，这样能彻底清除旧的缓存文件。

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