debug构建配置applicationIdSuffix后如何运行connectedCheck测试

配置applicationIdSuffix ".debug"后，debug构建产出的APK实际安装包名会变为[基础包名].debug，但Instrumentation测试框架的目标包配置未同步更新，仍指向不带.debug后缀的原始基础包名。测试执行时系统找不到匹配包名的被测应用，就会出现设备上无测试可运行的问题。
常见触发场景：

• 手动在配置中硬编码了testInstrumentationRunnerArguments的targetPackage参数，写死了原始包名，没有跟随applicationId动态变化
• AGP（Android Gradle插件）7.0以前的部分旧版本存在兼容问题，不会自动同步applicationId后缀到测试配置
• 设备上残留了旧版本（未加后缀）的同包名应用，安装测试包时出现签名/包名冲突

保留你原有debug构建配置的基础上，按以下规则调整即可：

1. 删除所有硬编码的targetPackage配置，让AGP自动匹配当前构建变体的applicationId
2. 如有需要可以给测试包单独配置后缀，避免和其他变体测试包冲突
   参考配置代码如下：

android {
    namespace "com.your.base.package" // 替换成你自己的命名空间
    compileSdk 34 // 按你项目实际版本填写

    defaultConfig {
        applicationId "com.your.base.package" // 替换成你自己的基础包名
        minSdk 21
        targetSdk 34
        versionCode 1
        versionName "1.0"
        // 只配置测试Runner即可，不要硬编码targetPackage
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        debug {
            applicationIdSuffix ".debug"
            versionNameSuffix '.debug'
            minifyEnabled false
            shrinkResources false
            debuggable true
            // 可选：给测试APK也加独立后缀，避免冲突
            testApplicationIdSuffix ".test"
        }
        release {
            // 你的release配置
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

配置完成后先执行卸载命令清理设备上的残留安装包：

• 卸载原基础包名应用：adb uninstall com.your.base.package
• 卸载加了debug后缀的应用：adb uninstall com.your.base.package.debug

connectedCheck是所有变体测试任务的聚合任务，针对特定构建变体可以直接调用对应单任务提升执行效率，任务命名遵循固定规则：

• 全量执行所有构建类型、所有风味的测试：直接运行./gradlew connectedCheck即可，会自动遍历所有变体逐个执行测试
• 无自定义产品风味时，仅执行debug构建的测试：运行./gradlew connectedDebugAndroidTest，该任务只会构建debug变体和对应的测试APK，执行速度远快于全量connectedCheck
• 配置了产品风味时，对应任务名格式为connected[风味名首字母大写][构建类型名首字母大写]AndroidTest，举例：
  • 假设配置了dev、prod两个产品风味，要跑dev风味的debug测试：./gradlew connectedDevDebugAndroidTest
  • 要跑prod风味的release测试：./gradlew connectedProdReleaseAndroidTest
• 如果不确定当前项目有哪些可用的测试任务，可以运行./gradlew tasks --group=verification，输出列表中所有以connected开头、AndroidTest结尾的任务就是对应变体的测试执行任务。

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