跨平台开发 / 系统课时
用 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: truedefaultValue 用于没有传入参数时的降级行为,适合本地开发场景。生产构建通常应明确传入全部必要参数,避免因为默认值导致错误部署。
在构建流程中管理环境参数
发布应用时,可以将参数放入构建脚本,而不是手动输入命令。例如 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。更好的方式是集中封装配置对象,由其他模块依赖这个对象。
按自己的节奏,确认真正理解。