Flutter多环境主文件命令行运行时Android Manifest及Gradle异常排查

1. 路径解析偏差：命令行执行时，-t指定的test_app/lib/main.dart可能让Flutter CLI误将test_app目录识别为项目根目录，导致无法找到上层目录中的android/app/src/main/AndroidManifest.xml。而IDE基于预设的项目根目录运行，不会出现该问题。
2. Gradle未适配多入口配置：默认Flutter Gradle配置仅适配根目录lib/main.dart的入口，当指定子目录中的入口文件时，CLI无法匹配到对应的构建规则，因此提示“不支持的Gradle项目”。
3. 项目结构不符合CLI预期：Flutter CLI对自定义入口文件的位置有默认解析逻辑，将入口放在test_app这类独立子目录中，超出了CLI的默认识别范围。

1. 修正命令路径 #

确保在项目根目录下执行命令，并明确指定入口文件的相对路径：

flutter run -t ./test_app/lib/main.dart
flutter build apk -t ./test_app/lib/main.dart

（添加./可明确告诉CLI路径基于当前项目根目录，避免解析偏差）

2. 配置Flavor支持（推荐） #

通过Android Gradle的Flavor功能适配多环境，让CLI正确识别不同环境的配置：

• 打开android/app/build.gradle，在android代码块内添加Flavor配置：

flavorDimensions "environment"
productFlavors {
    dev {
        dimension "environment"
        applicationIdSuffix ".dev"
    }
    test {
        dimension "environment"
        applicationIdSuffix ".test"
    }
}

• 运行命令时配合--flavor参数：

flutter run --flavor test -t test_app/lib/main.dart
flutter build apk --flavor test -t test_app/lib/main.dart

3. 调整入口文件位置 #

将测试环境的main.dart移动到lib目录下的子文件夹（如lib/test/main.dart），符合Flutter CLI的默认结构预期：

flutter run -t lib/test/main.dart
flutter build apk -t lib/test/main.dart

4. 重新生成Gradle配置 #

如果现有Gradle配置存在损坏，在项目根目录执行以下命令（先备份代码），让Flutter重新生成标准Android配置：

flutter create --platforms android .

5. 参考IDE的运行参数 #

查看IDE的运行日志（比如Android Studio的Run控制台），找到IDE实际执行的Flutter命令，直接复制到终端执行，确保参数和路径完全一致。

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