跨平台开发 / 系统课时

集中读取应用配置

集中读取应用配置

随着 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

不建议把用户登录状态、缓存数据等运行时变化内容放入配置对象。这些数据属于状态管理范围,不属于构建配置。

当配置数量较多时,可以继续拆分为网络配置、功能配置等小对象,但入口仍应保持统一,避免业务代码直接依赖环境变量。

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

目录与阅读设置

阅读设置

17

记录一个想法

集中读取应用配置

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

登录哪都通