React Native Android多渠道下Task 'installDebug'歧义报错求助

安全阿岳

2026-8-24

解决React Native配置Product Flavors后installDebug歧义报错

问题原因

当你在build.gradle中配置了flavorDimensions和productFlavors后，Gradle会将渠道（flavor）与构建类型（Debug/Release）组合生成全新的构建变体，比如devDebug、prodDebug。此时原有的installDebug任务会被拆分，React Native默认尝试调用的installDebug任务不存在，就会抛出歧义错误。

解决方案

1. 命令行明确指定变体

直接在运行命令中指定完整的变体名称，注意使用英文双横杠（不要用中文破折号）：

react-native run-android --variant=devDebug

如果要运行prod版本则用：

react-native run-android --variant=prodDebug

2. 配置Gradle默认变体

如果不想每次命令行都加参数，可以在android/app/build.gradle中设置默认的发布变体，让RN自动使用指定的变体：

android {
    // 你的现有渠道配置
    flavorDimensions "environment"
    productFlavors {
        dev {
            dimension "environment"
            applicationIdSuffix ".dev"
            // 其他dev渠道相关配置
        }
        prod {
            dimension "environment"
            // 其他prod渠道相关配置
        }
    }

    // 添加默认变体配置
    defaultPublishConfig "devDebug"
    // 让assemble任务默认执行devDebug构建
    tasks.whenTaskAdded { task ->
        if (task.name == "assemble") {
            task.dependsOn "assembleDevDebug"
        }
    }
}

配置完成后，直接运行react-native run-android就会自动使用devDebug变体。