Flutter挑战与任务管理插件nudge_challenges_v2的使用

Flutter挑战与任务管理插件nudge_challenges_v2的使用

nudge_challenges_v2 是一款官方提供的任务管理和激励系统插件，专为 Flutter 应用设计。它可以帮助开发者轻松实现任务挑战功能，提升用户的参与度和留存率。

插件功能概览

• 任务管理：支持动态创建、更新和删除任务。
• 挑战激励：用户完成任务后可获得积分或奖励。
• 实时数据同步：支持与服务器端的数据同步。
• 灵活配置：可通过参数自定义任务的难度和奖励机制。

使用步骤

1. 添加依赖

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

dependencies:
  nudge_challenges_v2: ^1.0.0

运行 flutter pub get 安装依赖。

2. 初始化插件

在应用启动时初始化插件，并设置 API 配置：

import 'package:nudge_challenges_v2/nudge_challenges_v2.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: MyHomePage(),
      // 初始化插件
      builder: (context, child) {
        NudgeChallengesV2.init(apiKey: "your_api_key", baseUrl: "https://api.nudge.com");
        return child!;
      },
    );
  }
}

3. 创建任务

通过调用插件方法创建任务：

Future<void> createTask() async {
  try {
    await NudgeChallengesV2.createTask(
      title: "每日签到",
      description: "完成每日签到任务",
      points: 10, // 完成任务后获得的积分
      difficulty: TaskDifficulty.easy, // 任务难度
      dueDate: DateTime.now().add(Duration(days: 1)), // 截止日期
    );
    print("任务创建成功！");
  } catch (e) {
    print("任务创建失败: $e");
  }
}

4. 获取用户任务列表

获取当前用户的任务列表：

Future<void> fetchTasks() async {
  try {
    final tasks = await NudgeChallengesV2.getTasks();
    print("任务列表: ${tasks.map((t) => t.title).toList()}");
  } catch (e) {
    print("获取任务失败: $e");
  }
}

5. 用户完成任务

当用户完成任务时，调用完成任务的方法：

Future<void> completeTask(String taskId) async {
  try {
    await NudgeChallengesV2.completeTask(taskId);
    print("任务已完成！");
  } catch (e) {
    print("任务完成失败: $e");
  }
}

示例 Demo

以下是一个完整的示例代码，展示如何集成 nudge_challenges_v2 插件并实现任务管理功能：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: MyHomePage(),
      builder: (context, child) {
        NudgeChallengesV2.init(apiKey: "your_api_key", baseUrl: "https://api.nudge.com");
        return child!;
      },
    );
  }
}

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  List<String> taskTitles = [];

  [@override](/user/override)
  void initState() {
    super.initState();
    fetchTasks(); // 初始化时获取任务列表
  }

  Future<void> createTask() async {
    try {
      await NudgeChallengesV2.createTask(
        title: "每日阅读",
        description: "每天阅读一篇文章",
        points: 5,
        difficulty: TaskDifficulty.medium,
        dueDate: DateTime.now().add(Duration(days: 1)),
      );
      print("任务创建成功！");
    } catch (e) {
      print("任务创建失败: $e");
    }
  }

  Future<void> fetchTasks() async {
    try {
      final tasks = await NudgeChallengesV2.getTasks();
      setState(() {
        taskTitles = tasks.map((t) => t.title).toList();
      });
    } catch (e) {
      print("获取任务失败: $e");
    }
  }

  Future<void> completeTask(String taskId) async {
    try {
      await NudgeChallengesV2.completeTask(taskId);
      print("任务已完成！");
      fetchTasks(); // 更新任务列表
    } catch (e) {
      print("任务完成失败: $e");
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("任务管理示例")),
      body: Column(
        children: [
          ElevatedButton(
            onPressed: createTask,
            child: Text("创建新任务"),
          ),
          SizedBox(height: 20),
          Text("当前任务列表:"),
          ListView.builder(
            shrinkWrap: true,
            itemCount: taskTitles.length,
            itemBuilder: (context, index) {
              return ListTile(
                title: Text(taskTitles[index]),
                trailing: IconButton(
                  icon: Icon(Icons.done),
                  onPressed: () => completeTask(taskTitles[index]),
                ),
              );
            },
          ),
        ],
      ),
    );
  }
}