Flutter通用功能插件general_lib的使用

Flutter通用功能插件general_lib的使用

1. 简介

general_lib 是一个Flutter通用功能插件，旨在为开发者提供一组常用的功能和工具类，简化开发过程。该插件包含了许多实用的功能，如网络请求、数据存储、权限管理等，帮助开发者快速构建高效的应用程序。

2. 安装

在使用 general_lib 之前，首先需要将其添加到项目的 pubspec.yaml 文件中：

dependencies:
  general_lib: ^1.0.0  # 请根据实际情况选择版本号

然后运行以下命令来安装依赖：

flutter pub get

3. 使用示例

下面是一个完整的示例项目，展示了如何使用 general_lib 中的一些常见功能。

3.1 创建一个新的Flutter项目

首先，创建一个新的Flutter项目：

flutter create general_lib_example
cd general_lib_example

3.2 修改 main.dart

在 lib/main.dart 文件中，我们将展示如何使用 general_lib 的一些功能。以下是完整的代码示例：

import 'package:flutter/material.dart';
import 'package:general_lib/general_lib.dart';  // 导入general_lib

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'General Lib Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  String _response = '点击按钮发起网络请求';

  // 发起网络请求
  void _makeNetworkRequest() async {
    try {
      // 使用general_lib中的HttpUtil进行网络请求
      final response = await HttpUtil().get('https://jsonplaceholder.typicode.com/posts/1');
      setState(() {
        _response = response.toString();
      });
    } catch (e) {
      setState(() {
        _response = '请求失败: $e';
      });
    }
  }

  // 存储数据到本地
  void _saveDataToLocal() async {
    try {
      // 使用general_lib中的LocalStorage进行数据存储
      await LocalStorage().setString('key', 'value');
      setState(() {
        _response = '数据已成功保存到本地';
      });
    } catch (e) {
      setState(() {
        _response = '保存数据失败: $e';
      });
    }
  }

  // 读取本地数据
  void _readDataFromLocal() async {
    try {
      // 使用general_lib中的LocalStorage读取数据
      final value = await LocalStorage().getString('key');
      setState(() {
        _response = '读取到的值: $value';
      });
    } catch (e) {
      setState(() {
        _response = '读取数据失败: $e';
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('General Lib Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              '$_response',
              style: TextStyle(fontSize: 16),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _makeNetworkRequest,
              child: Text('发起网络请求'),
            ),
            SizedBox(height: 10),
            ElevatedButton(
              onPressed: _saveDataToLocal,
              child: Text('保存数据到本地'),
            ),
            SizedBox(height: 10),
            ElevatedButton(
              onPressed: _readDataFromLocal,
              child: Text('读取本地数据'),
            ),
          ],
        ),
      ),
    );
  }
}

3.3 运行项目

确保你已经连接了设备或启动了模拟器，然后运行以下命令来启动应用：

flutter run

4. 功能说明

• 网络请求：general_lib 提供了 HttpUtil 类，简化了网络请求的操作。你可以轻松地发起 GET、POST、PUT、DELETE 等类型的请求，并处理响应数据。

  final response = await HttpUtil().get('https://api.example.com/data');
  

• 本地存储：general_lib 提供了 LocalStorage 类，用于在本地存储键值对数据。你可以轻松地保存、读取和删除本地数据。

  // 保存数据
  await LocalStorage().setString('key', 'value');
  
  // 读取数据
  final value = await LocalStorage().getString('key');
  
  // 删除数据
  await LocalStorage().remove('key');
  

• 权限管理：general_lib 提供了 PermissionUtil 类，帮助你轻松处理应用所需的权限，如相机、存储、定位等。

  final permissionStatus = await PermissionUtil.requestPermission(Permission.camera);
  if (permissionStatus.isGranted) {
    // 权限已授予
  } else {
    // 权限被拒绝
  }