app_cloud_config 是一个用于在 Flutter 应用中管理云端配置的插件。它允许你从云端（如 Firebase Remote Config）获取配置参数，并在应用中使用这些参数。以下是如何使用 app_cloud_config 插件的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 app_cloud_config 依赖：

dependencies:
  flutter:
    sdk: flutter
  app_cloud_config: ^0.1.0  # 请检查最新版本

然后运行 flutter pub get 来安装依赖。

2. 初始化插件

在你的 Flutter 应用启动时，初始化 app_cloud_config 插件。通常，你可以在 main.dart 文件中进行初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化云端配置
  await AppCloudConfig.initialize(
    remoteConfigSettings: RemoteConfigSettings(
      fetchTimeout: const Duration(seconds: 10),
      minimumFetchInterval: const Duration(hours: 1),
    ),
  );

  runApp(MyApp());
}

3. 获取云端配置

在应用中使用 AppCloudConfig 来获取云端配置参数。你可以通过 getString、getInt、getBool 等方法获取不同类型的配置值。

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Cloud Config Example'),
        ),
        body: Center(
          child: FutureBuilder(
            future: AppCloudConfig.instance.getString('my_config_key'),
            builder: (context, snapshot) {
              if (snapshot.connectionState == ConnectionState.waiting) {
                return CircularProgressIndicator();
              } else if (snapshot.hasError) {
                return Text('Error: ${snapshot.error}');
              } else {
                return Text('Config Value: ${snapshot.data}');
              }
            },
          ),
        ),
      ),
    );
  }
}

4. 设置默认值

你可以在初始化时设置默认值，以确保在没有网络连接的情况下，应用仍然可以使用默认配置。

await AppCloudConfig.initialize(
  remoteConfigSettings: RemoteConfigSettings(
    fetchTimeout: const Duration(seconds: 10),
    minimumFetchInterval: const Duration(hours: 1),
  ),
  defaults: {
    'my_config_key': 'default_value',
  },
);

5. 强制刷新配置

在某些情况下，你可能需要强制刷新云端配置。你可以使用 fetchAndActivate 方法来实现：

await AppCloudConfig.instance.fetchAndActivate();

6. 处理错误

在使用云端配置时，可能会遇到网络错误或其他问题。你可以通过 try-catch 块来处理这些错误：

try {
  await AppCloudConfig.instance.fetchAndActivate();
} catch (e) {
  print('Failed to fetch cloud config: $e');
}

7. 监听配置变化

如果需要监听配置的变化，可以使用 onConfigUpdated 回调：

AppCloudConfig.instance.onConfigUpdated.listen((config) {
  print('Config updated: $config');
});

8. 使用 Firebase Remote Config

如果你使用的是 Firebase Remote Config，确保你已经按照 Firebase 的文档正确配置了 Firebase 项目，并在 pubspec.yaml 中添加了 firebase_core 和 firebase_remote_config 依赖。

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^latest_version
  firebase_remote_config: ^latest_version
  app_cloud_config: ^latest_version

然后在 main.dart 中初始化 Firebase：

import 'package:firebase_core/firebase_core.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // 初始化云端配置
  await AppCloudConfig.initialize(
    remoteConfigSettings: RemoteConfigSettings(
      fetchTimeout: const Duration(seconds: 10),
      minimumFetchInterval: const Duration(hours: 1),
    ),
  );

  runApp(MyApp());
}