Flutter 工程实践：多环境配置与打包发布优化方案

一、多环境配置的必要性

在开发过程中，通常需要区分不同环境（如开发、测试、生产），每个环境可能有独立的：

• API 端点（如 dev.api.com vs prod.api.com）
• 第三方服务密钥（如 Firebase、Analytics）
• 功能开关（如调试工具、日志级别）
• 应用标识（Bundle ID/Package Name）

---

二、多环境配置实现方案

1. 环境变量管理

使用 .env 文件管理环境变量，通过 flutter_dotenv 包加载：

# pubspec.yaml
dependencies:
  flutter_dotenv: ^5.1.0

// lib/main.dart
import 'package:flutter_dotenv/flutter_dotenv.dart';

Future<void> main() async {
  await dotenv.load(fileName: ".env"); // 加载对应环境的文件
  runApp(MyApp());
}

// 获取环境变量
final apiUrl = dotenv.get('API_URL');

2. 多环境文件结构

/config
  ├── dev.env
  ├── staging.env
  └── prod.env
/lib
  └── main.dart

3. 条件编译

通过 --dart-define 传递编译参数：

# 开发环境
flutter run --dart-define=ENV=dev

# 生产环境
flutter build apk --dart-define=ENV=prod

// 代码中读取
const env = String.fromEnvironment('ENV', defaultValue: 'dev');

---

三、打包发布优化方案

1. 减小应用体积

• 开启代码压缩：

  flutter build apk --release --obfuscate --split-debug-info=/output
  

• 移除未使用资源：

  # pubspec.yaml
  flutter:
    assets:
      - assets/images/ # 明确声明所需资源
  

2. 构建速度优化

• 分级构建：

  # 仅构建当前架构
  flutter build apk --target-platform android-arm64
  

• 缓存依赖：

  flutter pub get --offline # 使用本地缓存
  

3. 自动化发布流程

使用 fastlane 自动化：

# Fastfile
lane :build_prod do
  flutter_build(
    build_type: 'apk',
    flavor: 'prod'
  )
  upload_to_play_store() # 自动上传到 Google Play
end

---

四、环境切换工具类示例

abstract class EnvConfig {
  static const _env = String.fromEnvironment('ENV');

  static String get apiBaseUrl {
    switch (_env) {
      case 'prod':
        return 'https://api.prod.com';
      case 'staging':
        return 'https://api.staging.com';
      default:
        return 'http://localhost:8080';
    }
  }

  static bool get enableAnalytics => _env == 'prod';
}

---

五、最佳实践总结

1. 环境隔离：严格分离开发/生产数据源，避免测试数据污染线上
2. 安全防护：禁止将生产密钥硬编码在代码中
3. 构建监控：记录每次构建的耗时和体积变化
4. 版本对齐：确保 pubspec.lock 提交到仓库，避免依赖版本漂移

关键指标优化效果：
经过优化后，典型项目可达成：

• 应用体积减少 30%~50%
• 构建时间缩短 40%
• 发布流程从手动 20 分钟缩短至 3 分钟自动化

通过以上方案，可实现高效的环境管理及发布流程，适应敏捷开发需求。