Flutter构建APK报错：需将入口文件从main.dart改为main_dev.dart

直接命令行指定入口 #

构建APK时，通过--target参数明确指定入口文件路径：

flutter build apk --target lib/main_dev.dart

如果要构建release版本，加上--release参数：

flutter build apk --release --target lib/main_dev.dart

编辑器配置默认入口 #

VS Code #

修改.vscode/launch.json中的program字段，将默认入口改为lib/main_dev.dart：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Flutter",
      "request": "launch",
      "type": "dart",
      "program": "lib/main_dev.dart"
    }
  ]
}

Android Studio #

1. 点击顶部工具栏的Run > Edit Configurations
2. 在左侧列表选择你的Flutter运行配置
3. 在右侧Dart entrypoint输入框中，修改为lib/main_dev.dart
4. 点击Apply保存配置

多环境Flavor管理（推荐） #

如果需要频繁切换dev/staging环境，可通过Flutter的Flavor功能统一配置：

1. 在pubspec.yaml中添加Flavor配置：

flutter:
  flavors:
    dev:
      target: lib/main_dev.dart
    staging:
      target: lib/main_staging.dart

2. 构建对应环境的APK：

# 构建dev环境
flutter build apk --flavor dev
# 构建staging环境
flutter build apk --flavor staging

兼容默认入口的折中方案 #

如果不想修改构建配置，可以给main.dart添加一个main方法，根据环境变量跳转到对应环境的入口：

import 'main_dev.dart' as dev;
import 'main_staging.dart' as staging;

void main() {
  const env = String.fromEnvironment('ENV');
  switch (env) {
    case 'dev':
      dev.main();
      break;
    case 'staging':
      staging.main();
      break;
    default:
      dev.main(); // 默认走dev环境
  }
}

构建时通过--dart-define指定环境：

flutter build apk --dart-define=ENV=dev

内容的提问来源于stack exchange，提问作者ABHINAV G NAMBIAR