Firebase远程助手

此插件使您更方便地使用Firebase远程配置。

使用方法

等待初始化：

// 获取实例
final remoteHelper = FirebaseRemoteHelper.instance;

// 初始化
await remoteHelper.initial(
    fetchTimeout: const Duration(seconds: 3), // 可选，默认为1分钟
    minimumFetchInterval: const Duration(minutes: 60), // 可选，默认为60分钟
    defaultParameters: {
        'bool': true,
        'int': 5,
        'String': '这是字符串',
        'mapInt': {'a': 1, 'b': 2},
        'mapString': {'a': 'a', 'b': 'b'},
        'mapBool': {'a': true, 'b': false},
        'listInt': [1, 2, 3],
        'listString': ['a', 'b', 'c'],
        'listBool': [true, false, true],
    }, // 可选，默认未设置
);

或者您可以先调用initial，稍后等待其完成初始化：

// 初始化
remoteHelper.initial();

// 稍后等待初始化完成
await remoteHelper.ensureInitialized;

注意： 您应该为所有使用的参数提供默认值以避免问题。

按特定类型获取值：

/// 数字：
/// 在Firebase上的示例值：1
remoteHelper.getInt('key');

/// 布尔值：
/// 在Firebase上的示例值：true/false
remoteHelper.getBool('key');

/// 数字：
/// 在Firebase上的示例值：1.0
remoteHelper.getDouble('key');

/// 字符串： 
/// 在Firebase上的示例值："something"
remoteHelper.getString('key');

/// JSON作为列表： 
/// 在Firebase上的示例值：["something", "something other"]
///
/// 只支持bool, num, String作为返回类型的列表
remoteHelper.getList<String>('key');

/// JSON作为映射：
/// 在Firebase上的示例值：{"someKey": 1, "someKey other": 2}
///
/// 只支持bool, num, String作为映射值的类型
remoteHelper.getMap<int>('key');

按RemoteConfigValue获取值：

/// 返回RemoteConfigValue
/// 然后您可以使用.asBool, .asInt, .asDouble, .asString, .asMap, .asList
remoteHelper.get('key'); 

### 完整示例代码

以下是一个完整的示例代码，展示了如何使用`firebase_remote_helper`插件：

```dart
import 'package:flutter/material.dart';
import 'package:firebase_remote_config/firebase_remote_config.dart';
import 'package:firebase_remote_helper/firebase_remote_helper.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 获取实例
  final remoteHelper = FirebaseRemoteHelper.instance;

  // 初始化
  await remoteHelper.initial(
      fetchTimeout: const Duration(seconds: 3), // 可选，默认为1分钟
      minimumFetchInterval: const Duration(minutes: 60), // 可选，默认为60分钟
      defaultParameters: {
          'bool': true,
          'int': 5,
          'String': '这是字符串',
          'mapInt': {'a': 1, 'b': 2},
          'mapString': {'a': 'a', 'b': 'b'},
          'mapBool': {'a': true, 'b': false},
          'listInt': [1, 2, 3],
          'listString': ['a', 'b', 'c'],
          'listBool': [true, false, true],
      }, // 可选，默认未设置
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Firebase Remote Config Demo')),
        body: Center(
          child: FutureBuilder(
            future: remoteHelper.ensureInitialized,
            builder: (context, snapshot) {
              if (snapshot.connectionState == ConnectionState.done) {
                return Column(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: [
                    Text('Int Value: ${remoteHelper.getInt('key')}'),
                    Text('Bool Value: ${remoteHelper.getBool('key')}'),
                    Text('Double Value: ${remoteHelper.getDouble('key')}'),
                    Text('String Value: ${remoteHelper.getString('key')}'),
                    Text('List Value: ${remoteHelper.getList<String>('key').join(', ')}'),
                    Text('Map Value: ${remoteHelper.getMap<int>('key').toString()}'),
                  ],
                );
              } else {
                return CircularProgressIndicator();
              }
            },
          ),
        ),
      ),
    );
  }
}