Flutter请求管理插件flutter_request_kit的使用

⚠️ 项目正在开发中 ⚠️

该项目正在积极开发中，因此可能会快速变化。

Flutter Request Kit

Flutter Request Kit 是一个用于用户参与应用开发的Flutter包。它允许用户在应用内直接提出新功能建议、投票和讨论这些建议。

动机

启动SaaS（软件即服务）项目很难，获得良好的反馈更难。我们希望有一个“迷你论坛”，让用户能够表达他们的不满，提出更改或新功能的建议。我们还需要一种与他们沟通并进一步发展这些想法的方式。

我们的规则：

• 无外部依赖：它不应与其他包产生冲突。
• 自适应主题：UI应能适应父应用程序的主题。
• 国际化支持：必须支持本地化，并适应不同的语言环境。

我们的需求：

• 必须易于设置。
• 必须性能良好且可靠。

开始使用

设置

在 pubspec.yaml 文件中添加 flutter_request_kit：

flutter pub add flutter_request_kit

使用

基本设置

以下是一个完整的示例代码，展示了如何使用 flutter_request_kit 插件来创建一个简单的请求管理页面。

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

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Request Kit Demo',
      theme: ThemeData(
        primaryColor: Colors.blue,
        primaryColorLight: Colors.lightBlue,
        primaryColorDark: Colors.blue[900],
        inputDecorationTheme: const InputDecorationTheme(
          border: OutlineInputBorder(
            borderRadius: BorderRadius.all(Radius.circular(4)),
          ),
          constraints: BoxConstraints(maxHeight: 42),
          contentPadding: EdgeInsets.symmetric(horizontal: 12),
        ),
        iconButtonTheme: IconButtonThemeData(
          style: IconButton.styleFrom(
            shape: RoundedRectangleBorder(
              borderRadius: BorderRadius.circular(4),
            ),
            iconSize: 24,
          ),
        ),
        extensions: const [
          RequestStatusPillTheme(),
          RequestVotingBoxTheme(),
          RequestItemCardTheme(),
        ],
      ),
      home: const RequestHomePage(),
    );
  }
}

class RequestHomePage extends StatefulWidget {
  const RequestHomePage({super.key});

  [@override](/user/override)
  State<RequestHomePage> createState() => _RequestHomePageState();
}

class _RequestHomePageState extends State<RequestHomePage> {
  // 模拟当前用户作为请求的创建者
  final Creator currentUser = const Creator(
    userId: 'user123',
    username: 'johndoe',
    isAdmin: true,
  );

  Future<RequestItem> addRequest(RequestItem item) async {
    // 模拟向服务器发送请求
    await Future.delayed(const Duration(seconds: 1));
    return item.copyWith(id: 'new_id');
  }

  late final store = RequestStore(
    requests: <RequestItem>[],
    onAddRequest: (item) async {
      return addRequest(item);
    },
    onAddComment: (requestId, comment) {
      debugPrint(requestId);
      debugPrint(comment.toString());
    },
    onDeleteRequest: print,
    onUpdateRequest: print,
    onVoteChange: print,
  );

  [@override](/user/override)
  Widget build(BuildContext context) {
    return GestureDetector(
      onTap: () => FocusScope.of(context).unfocus(),
      child: Scaffold(
        appBar: AppBar(
          title: const Text('Flutter Request Kit Demo'),
        ),
        body: RequestPage(
          currentUser: currentUser,
          store: store,
          locale: RequestKitLocales.enUS.locale,
          theme: Theme.of(context),
        ),
      ),
    );
  }
}