跨平台开发 / 系统课时

用 dart-define 注入构建参数

用 dart-define 注入构建参数

在 Flutter 项目中,不同环境通常需要使用不同接口地址、功能开关或第三方服务配置。本篇将通过 dart-define 在构建阶段注入参数,让应用代码与具体环境解耦。

学习目标

  • 理解 dart-define 注入配置的工作方式。
  • 掌握在运行和打包时传递构建参数的方法。
  • 能够设计适合开发、测试和生产环境的参数管理方式。

为什么需要构建参数注入

实际项目通常至少包含开发、测试和生产环境。不同环境之间的差异往往只是少量配置,例如 API 地址、日志开关、调试模式或实验功能开关。

如果直接在业务代码中使用环境判断,会导致大量 if 分支散落在项目中。dart-define 提供了一种更简单的方式:在编译或运行命令中传入参数,由应用读取这些值。

使用 String.fromEnvironment 读取参数

Flutter 支持通过 String.fromEnvironment 读取编译时环境变量。它适合保存不会在运行过程中变化的配置。

下面是一个最小可运行示例:

dart
void main() {
  const apiBaseUrl = String.fromEnvironment(
    'API_BASE_URL',
    defaultValue: 'https://dev.example.com',
  );

  const enableNewFeature = bool.fromEnvironment(
    'ENABLE_NEW_FEATURE',
    defaultValue: false,
  );

  print('API: $apiBaseUrl');
  print('New feature enabled: $enableNewFeature');
}

运行时可以通过 --dart-define 传入值:

bash
flutter run --dart-define=API_BASE_URL=https://test.example.com --dart-define=ENABLE_NEW_FEATURE=true

预期输出

text
API: https://test.example.com
New feature enabled: true

defaultValue 用于没有传入参数时的降级行为,适合本地开发场景。生产构建通常应明确传入全部必要参数,避免因为默认值导致错误部署。

在构建流程中管理环境参数

发布应用时,可以将参数放入构建脚本,而不是手动输入命令。例如 CI 流程根据环境选择不同参数:

bash
flutter build appbundle \
  --release \
  --dart-define=API_BASE_URL=https://api.example.com \
  --dart-define=ENABLE_NEW_FEATURE=false

预期结果

text
Build command accepted and release package is generated with injected values.

实际生成的安装包会携带这些编译期常量,应用运行时无法动态修改它们。

使用时的边界

dart-define 适合公开配置,例如接口地址、功能开关和环境标识。但它不是安全存储方式,因为编译后的应用可能被分析,不能用于保存密码、私钥等敏感信息。

当配置数量增加时,不建议让业务页面直接读取 String.fromEnvironment。更好的方式是集中封装配置对象,由其他模块依赖这个对象。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 dart-define 注入构建参数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通