跨平台开发 / 系统课时
集中读取应用配置
集中读取应用配置
随着 Flutter 项目规模增长,环境变量、功能开关和运行参数容易散落在多个文件中。本篇将把这些配置统一收敛到配置对象,让业务代码只依赖明确的配置接口。
学习目标
- 理解集中配置对象解决的问题。
- 掌握从环境变量创建统一配置模型的方法。
- 能够减少业务代码中的环境判断逻辑。
为什么需要统一配置入口
小型项目可以直接使用 String.fromEnvironment 读取参数,但随着模块增加,接口地址、应用名称、调试开关等信息会被多个地方重复读取。
重复读取会带来两个问题:一是环境切换时容易遗漏修改,二是业务代码开始关心部署细节。
集中配置的思路是创建一个应用配置对象,在应用启动阶段完成初始化,后续模块只依赖配置对象。
创建应用配置对象
下面示例使用一个不可变配置类保存运行参数。
dart
class AppConfig {
const AppConfig({
required this.apiBaseUrl,
required this.enableLog,
});
final String apiBaseUrl;
final bool enableLog;
factory AppConfig.fromEnvironment() {
return const AppConfig(
apiBaseUrl: String.fromEnvironment(
'API_BASE_URL',
defaultValue: 'https://dev.example.com',
),
enableLog: bool.fromEnvironment(
'ENABLE_LOG',
defaultValue: true,
),
);
}
}
void main() {
const config = AppConfig.fromEnvironment();
print(config.apiBaseUrl);
print(config.enableLog);
}预期输出
text
https://dev.example.com
true配置读取逻辑集中在 AppConfig 中,页面、网络层和业务服务不需要知道参数来自哪里。
在应用启动阶段传递配置
实际项目中通常会在应用入口创建配置对象,再注入到需要使用的模块中。
例如:
dart
void main() {
const config = AppConfig.fromEnvironment();
runApp(MyApp(config: config));
}预期结果
text
Application starts with a single shared configuration instance.这样可以保证同一次运行过程中所有模块看到的配置一致。
配置对象的设计边界
配置对象应该保存环境相关的静态信息,例如:
| 类型 | 示例 |
|---|---|
| 服务地址 | API Base URL |
| 功能开关 | 是否启用新页面 |
| 环境标识 | dev、test、prod |
不建议把用户登录状态、缓存数据等运行时变化内容放入配置对象。这些数据属于状态管理范围,不属于构建配置。
当配置数量较多时,可以继续拆分为网络配置、功能配置等小对象,但入口仍应保持统一,避免业务代码直接依赖环境变量。
按自己的节奏,确认真正理解。