Flutter功能扩展插件flutter_ahlib的使用

简介

flutter_ahlib 是一个个人开发的 Flutter 库，包含了一些有用的控件和实用工具。该库主要用于扩展 Flutter 的功能，帮助开发者更高效地构建应用。

特性

• 包含通用控件、列表控件、图片控件以及实用工具。
• 支持 Flutter 2.x，并通过了相关测试。

官方地址

请访问 pub.dev/packages/flutter_ahlib 获取更多详细信息。

使用方法

导入方式

可以按需导入不同的模块：

// 导入整个库，包括通用控件、列表控件、图片控件和实用工具。
import 'package:flutter_ahlib/flutter_ahlib.dart';

// 只导入实用工具模块。
import 'package:flutter_ahlib/flutter_ahlib_util.dart';

库内容

通用控件

动画按钮控件

// 动画浮动按钮（AnimatedFab）
AnimatedFab(
  child: Icon(Icons.add),
  onPressed: () {
    print("点击了按钮");
  },
)

自定义滚动效果

// 自定义滚动物理特性（CustomScrollPhysics）
CustomScrollPhysics(
  controller: CustomScrollPhysicsController(),
  child: ListView.builder(
    itemCount: 50,
    itemBuilder: (context, index) => ListTile(title: Text("Item $index")),
  ),
)

列表控件

分页数据视图

// 分页数据视图（PaginationDataView）
PaginationDataView<int>(
  itemCount: 100,
  itemBuilder: (context, index) => ListTile(title: Text("Item $index")),
  onLoadMore: (page) async {
    await Future.delayed(Duration(seconds: 2));
    return List.generate(20, (i) => page * 20 + i);
  },
)

图片控件

延迟加载网络图片

// 延迟加载本地或网络图片（LocalOrCachedNetworkImage）
LocalOrCachedNetworkImage(
  url: "https://example.com/image.png",
  placeholder: CircularProgressIndicator(),
)

实用工具

下载文件

// 下载文件到本地（downloadFile）
Future<void> downloadFile(String url, String savePath) async {
  final result = await downloadFile(url, savePath);
  if (result.isOk) {
    print("下载成功！");
  } else {
    print("下载失败：${result.unwrapErr()}");
  }
}

示例代码

以下是一个完整的示例代码，展示了如何使用 flutter_ahlib 构建一个简单的日志记录界面：

import 'package:flutter/material.dart';
import 'package:flutter_ahlib/flutter_ahlib.dart';
import 'package:flutter_ahlib_example/page/index.dart';

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

final _logger = ValueNotifier<String>('Logger:');
final _controller = ScrollController();

void printLog(Object? s, {bool alsoPrint = true, bool logPrefix = true}) {
  alsoPrint ? print(s) : null;
  Future.microtask(() {
    var text = s?.toString() ?? '<null>';
    _logger.value += (logPrefix ? '\n[log] ' : '\n') + text;
    WidgetsBinding.instance?.addPostFrameCallback((_) => _controller.scrollToBottom());
  });
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'flutter_ahlib example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ).withSplashFactory(CustomInkRipple.preferredSplashFactory),
      home: const IndexPage(),
      builder: (context, child) => Scaffold(
        body: Column(
          children: [
            Expanded(
              child: ViewInsetsData(
                viewInsets: MediaQuery.of(context).viewInsets,
                child: child!,
              ),
            ),
            const Divider(height: 0, thickness: 1),
            SizedBox(
              height: (MediaQuery.of(context).size.height - MediaQuery.of(context).padding.vertical) / 5,
              width: double.infinity,
              child: Stack(
                fit: StackFit.expand,
                children: [
                  Scrollbar(
                    controller: _controller,
                    child: SingleChildScrollView(
                      controller: _controller,
                      padding: const EdgeInsets.symmetric(horizontal: 10, vertical: 8),
                      scrollDirection: Axis.vertical,
                      child: SingleChildScrollView(
                        scrollDirection: Axis.horizontal,
                        child: ValueListenableBuilder<String>(
                          valueListenable: _logger,
                          builder: (_, logger, __) => Text(
                            logger,
                            style: const TextStyle(fontFamily: 'monospace'),
                          ),
                        ),
                      ),
                    ),
                  ),
                  Positioned(
                    right: 0,
                    top: 0,
                    child: IconButton(
                      icon: const Icon(Icons.delete),
                      onPressed: () => _logger.value = 'Logger:',
                    ),
                  ),
                ],
              ),
            ),
          ],
        ),
      ),
    );
  }
}

依赖项

请查看项目的 pubspec.yaml 文件以了解详细依赖项：

environment:
  sdk: ">=2.16.2 <3.0.0"

dependencies:
  flutter_cache_manager: ^3.3.0
  flutter_staggered_grid_view: ^0.6.1
  http: ^0.13.4
  logger: ^1.1.0
  path: 1.8.0
  photo_view: ^0.14.0

dev_dependencies:
  flutter_lints: ^1.0.0