Flutter多功能工具插件master_utility的使用

master_utility 是一个功能强大的Flutter插件，提供了一系列实用工具来简化开发过程。本文将详细介绍如何在Flutter项目中使用该插件，并提供一些示例代码。

支持平台

• Android
• iOS

如何添加到项目中

在 pubspec.yaml 文件中添加以下依赖：

dependencies:
  master_utility: ^latest_version

记得替换 ^latest_version 为实际的最新版本号。

导入包

在需要使用的文件中导入包：

import 'package:master_utility/master_utility.dart';

使用方法

初始化和设置主应用

在 main.dart 中初始化并设置主应用：

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

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await PreferenceHelper.init(encryptionKey: "your-encryption-key");
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MasterUtilityMaterialApp(
      title: 'Example App',
      home: ExampleView(),
    );
  }
}

功能点介绍及示例

键盘视图助手

用于显示“完成”按钮的键盘视图：

FocusNode focusNode = FocusNode();

// 在文本字段中使用
AppTextField(
  focusNode: focusNode,
  label: "TextField to View Done Keyboard",
  showDoneKeyboard: true, // 默认情况下done view为false
);

导航助手

简化页面导航：

NavigationHelper.navigatePop();
NavigationHelper.navigatePush(route: routeName());
NavigationHelper.navigatePushReplacement(route: routeName());
NavigationHelper.navigatePushRemoveUntil(route: routeName());

尺寸助手

动态调整尺寸：

SizeHelper.setMediaQuerySize();

Container(
  width: 0.03.w,    // 它将占据屏幕宽度的30%
  height: 0.03.h,   // 它将占据屏幕高度的30%
);

Text('Sizer Helper', style: TextStyle(fontSize: 5.5.fs));

图像选择助手

选择图像或视频：

final result = await ImagePickerHelper.multiMediaPicker();

// 自定义媒体选择器
final result = await ImagePickerHelper.customMediaPicker(
  pickerActionType: PickerActionType.camera
);

日期时间助手

格式化日期时间：

DateTime.now().toCustomFormatter(formatter: DateTimeFormatter.HOUR_MINUTE);

Toast助手

显示自定义Toast消息：

showToast(message: "Default Toast");

showCustomToast(
  message: "Custom Toast",
  backgroundColor: Colors.red,
  textColor: Colors.white,
  fontSize: 16.0,
  gravity: ToastGravity.BOTTOM
);

日志助手

记录日志信息：

LogHelper.logInfo("add log here");
LogHelper.logSuccess("add log here");
LogHelper.logWarning("add log here");
LogHelper.logError("add log here");

对话框助手

显示对话框和动作表单：

DialogHelper.showActionSheet<PickerActionType>(
  actions: const [
    SheetAction(key: PickerActionType.camera, label: "Camera"),
    SheetAction(key: PickerActionType.gallery, label: "Gallery"),
  ],
);

DialogHelper.showCustomAlertDialog(
  barrierDismissible: false,
  builder: (BuildContext context, widget) {
    return AlertDialog(
      title: const Text("No Internet"),
      content: const Text("Check your internet connection."),
      actions: [
        ElevatedButton(
          onPressed: () { Navigator.pop(context); },
          child: const Text("Try Again")
        )
      ],
    );
  }
);

缓存网络图像助手

缓存和显示网络图像：

AppNetworkImage(
  url: imageUrl,
  errorWidget: (p0, p1, p2) => Icon(Icons.error),
);

验证助手

验证输入数据：

validator: (v) => ValidationHelper.validateEmail(v);

API助手

进行API调用：

dioClient.setConfiguration(APIEndpoints.baseUrl);

Future<void> getApiCall() async {
  final request = APIRequest(
    url: url,
    methodType: MethodType.GET,
  );

  final response = await APIService().GetApiResponse(request, apiResponse: (dynamic data) {
    return Data.fromJson(data);
  });

  if (response.hasError) {
    ToastHelper.showCustomToast(backgroundColor: Colors.red, message: response.message.toString());
  } else {
    _newData = response.data;
  }
}

共享偏好助手

存储和获取共享偏好数据：

await PreferenceHelper().setStringPrefValue(key: key, value: value);
String getValue = await PreferenceHelper().getStringPrefValue(key: key);

图像裁剪助手

裁剪图像：

croppedImage = await ImageCropperHelper.cropImage(imagePath: fileResult.path);
LogHelper.logInfo("croppedImage result $croppedImage");

读取更多文本助手

实现展开和折叠文本：

ReadMoreTextHelper(
  'Flutter is Google’s mobile UI open source framework...',
  trimLines: 2,
  colorClickableText: Colors.blue,
  trimMode: TrimMode.Line,
  trimCollapsedText: 'Show more',
  trimExpandedText: 'Show less',
  moreStyle: TextStyle(fontSize: 14, fontWeight: FontWeight.bold),
);

双击冗余助手

防止双击事件：

ElevatedButton(
  onPressed: () {
    DoubleClickReduntHelper.handleDoubleClick();
    ToastHelper.showToast(message: "Default Toast");
  },
  child: const Text("Show Default Toast"),
);

权限处理助手

请求权限并处理回调：

PermissionHandlerService.handlePermissions(
  type: PermissionType.PHOTO,
  permissionDeniedDialog: () {
    return showDialog(
      context: context,
      builder: (context) {
        return const AlertDialog(title: Text("Custom Dialog"));
      },
    );
  },
  callBack: () async {
    final fileResult = await ImagePickerHelper.customMediaPicker(pickerActionType: PickerActionType.gallery);
    LogHelper.logInfo("result $fileResult");
    if (fileResult != null) {
      croppedImage.value = await ImageCropperHelper.cropImage(imagePath: fileResult.path);
      LogHelper.logInfo("croppedImage result $croppedImage");
    }
  }
);

以上是 master_utility 插件的主要功能和使用示例。通过这个插件，您可以大大简化Flutter应用的开发流程，提高开发效率。希望这些内容对您有所帮助！