Flutter配置管理插件flutter_config的使用

Flutter应用程序在开发、测试和生产环境中经常需要使用不同的配置变量。为了简化这些配置的管理，flutter_config插件提供了一种方便的方式来将环境变量暴露给Dart代码以及iOS和Android的原生代码。

基本用法

创建.env文件

首先，在你的Flutter项目的根目录下创建一个新的.env文件，并添加你想要使用的环境变量：

API_URL=https://myapi.com
FABRIC_ID=abcdefgh

在main.dart中加载环境变量

接下来，在main.dart文件中加载所有的环境变量：

import 'package:flutter/material.dart';
import 'package:flutter_config/flutter_config.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // 必须由FlutterConfig调用
  await FlutterConfig.loadEnvVariables();

  runApp(MyApp());
}

现在，你可以在应用程序的任何地方访问你的环境变量：

import 'package:flutter_config/flutter_config.dart';

final fabricId = FlutterConfig.get('FABRIC_ID') as String; // 返回'abcdefgh'

注意：这个模块不会混淆或加密打包时的秘密密钥，因此请不要在.env中存储敏感信息。由于基本上无法防止用户反向工程移动应用的秘密，所以请设计你的应用程序（和API）时考虑到这一点。

在Swift中加载环境变量

如果你的应用程序有iOS部分，你可以按照以下步骤在Swift中加载环境变量：

1. 导入插件：

   import flutter_config
   

2. 使用环境变量：

   flutter_config.FlutterConfigPlugin.env(for: "ENV_API_KEY")
   

开始使用

安装最新版本的插件后，请参考Android设置指南进行初始设置和高级选项。对于iOS，无需额外设置，但对于高级用法，请参考iOS设置指南。

测试

当你需要在测试中使用FlutterConfig时，可以简单地使用loadValueForTesting方法来模拟环境变量：

import 'package:flutter_config/flutter_config.dart';
import 'package:test/test.dart';

void main() {
  FlutterConfig.loadValueForTesting({'BASE_URL': 'https://www.mockurl.com'});
  
  test('mock http client test', () {
    final client = HttpClient(
      baseUrl: FlutterConfig.get('BASE_URL')
    );
  });
}

示例Demo

下面是一个完整的示例，展示了如何在一个简单的Flutter应用程序中使用flutter_config插件：

import 'package:flutter/material.dart';
import 'package:flutter_config/flutter_config.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FlutterConfig.loadEnvVariables();

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    var allValues = <Widget>[];

    FlutterConfig.variables.forEach((k, v) {
      allValues.add(Text('$k: $v'));
    });

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
            child: Column(children: [
          ...allValues,
          SizedBox(
            height: 20,
          ),
          Text('Values of fabric Id: ${FlutterConfig.get('FABRIC_ID')}'),
        ])),
      ),
    );
  }
}

该示例演示了如何读取并显示所有环境变量，同时特别显示了一个特定变量FABRIC_ID的值。

通过以上步骤，你可以轻松地在Flutter项目中集成flutter_config插件，从而更好地管理和使用环境变量。