gogoboom_flutter_common 是一个 Flutter 通用功能插件，旨在为开发者提供一些常用的功能和工具，以减少重复代码的编写，提高开发效率。以下是如何使用 gogoboom_flutter_common 插件的一些常见功能和步骤。

1. 安装插件

首先，你需要在 pubspec.yaml 文件中添加 gogoboom_flutter_common 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  gogoboom_flutter_common: ^1.0.0  # 请使用最新版本

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

2. 导入插件

在你的 Dart 文件中导入插件：

import 'package:gogoboom_flutter_common/gogoboom_flutter_common.dart';

3. 插件的功能介绍与使用

3.1. 网络请求

gogoboom_flutter_common 提供了简化的网络请求功能。你可以使用 HttpUtil 类来发送 HTTP 请求。

void fetchData() async {
  var response = await HttpUtil.get('https://jsonplaceholder.typicode.com/posts');
  print(response.body);
}

3.2. 本地存储

插件提供了 SharedPreferencesUtil 类来简化本地存储操作。

void saveData() async {
  await SharedPreferencesUtil.setString('key', 'value');
}

void getData() async {
  String value = await SharedPreferencesUtil.getString('key');
  print(value);
}

3.3. 工具类

插件还提供了一些常用的工具类，例如 DateUtil 用于日期格式化，StringUtil 用于字符串操作等。

void formatDate() {
  String formattedDate = DateUtil.formatDate(DateTime.now(), 'yyyy-MM-dd');
  print(formattedDate);
}

void checkString() {
  bool isEmpty = StringUtil.isEmpty('');
  print(isEmpty); // true
}

3.4. 路由管理

插件提供了 RouteUtil 类来简化页面路由跳转。

void navigateToNextPage(BuildContext context) {
  RouteUtil.push(context, '/nextPage');
}

3.5. 对话框工具

插件提供了 DialogUtil 类来简化对话框的显示。

void showAlertDialog(BuildContext context) {
  DialogUtil.showAlertDialog(
    context,
    title: '提示',
    content: '这是一个提示对话框',
    confirmText: '确定',
    onConfirm: () {
      print('确定');
    },
  );
}

4. 自定义配置

你可以通过 CommonConfig 类来配置插件的一些默认行为。例如，配置网络请求的基础 URL 和超时时间。

void configurePlugin() {
  CommonConfig.baseUrl = 'https://api.example.com';
  CommonConfig.timeout = Duration(seconds: 30);
}

5. 错误处理

插件提供了统一的错误处理机制。你可以通过 ErrorHandler 类来处理网络请求中的错误。

void handleError() async {
  try {
    var response = await HttpUtil.get('https://jsonplaceholder.typicode.com/invalid');
  } catch (e) {
    ErrorHandler.handleError(e);
  }
}

6. 日志记录

插件提供了 LogUtil 类来简化日志记录。

void logMessage() {
  LogUtil.d('这是一个调试日志');
  LogUtil.e('这是一个错误日志');
}

7. 其他功能

插件还提供了其他一些功能，如 PermissionUtil 用于权限请求，ImageUtil 用于图片处理等。你可以根据项目需求选择使用。

8. 示例代码

以下是一个简单的示例代码，展示了如何使用 gogoboom_flutter_common 插件的部分功能：

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

void main() {
  configurePlugin();
  runApp(MyApp());
}

void configurePlugin() {
  CommonConfig.baseUrl = 'https://jsonplaceholder.typicode.com';
  CommonConfig.timeout = Duration(seconds: 30);
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('gogoboom_flutter_common 示例'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: () => fetchData(),
                child: Text('获取数据'),
              ),
              ElevatedButton(
                onPressed: () => showAlertDialog(context),
                child: Text('显示对话框'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  void fetchData() async {
    var response = await HttpUtil.get('/posts');
    print(response.body);
  }

  void showAlertDialog(BuildContext context) {
    DialogUtil.showAlertDialog(
      context,
      title: '提示',
      content: '这是一个提示对话框',
      confirmText: '确定',
      onConfirm: () {
        print('确定');
      },
    );
  }
}