Flutter应用内提醒用户评价插件should_review的使用

should_review 是一个用于判断是否应提示用户对应用进行评价的Flutter插件。它根据应用启动次数或天数等条件来决定是否显示评价提示。

特性

• 根据首次启动后的天数和设定的时间间隔判断是否提示用户评价。
• 根据应用启动次数判断是否提示用户评价。
• 支持自定义条件（如用户完成特定操作的次数）。

开始使用

添加依赖

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

dependencies:
  should_review: ^0.2.5

使用示例

使用天数条件

import 'package:should_review/should_review.dart';

if (await ShouldReview.shouldReview(
    criteria: Criteria.days,
    minDays: 5,
    coolDownDays: 2,
)) {
    // 提示用户评价
    ShouldReview.neverReview(); // 确保 shouldReview 函数不再返回 true
}

使用启动次数条件

import 'package:should_review/should_review.dart';

// 在应用启动时调用此函数
ShouldReview.recordLaunch();

if (await ShouldReview.shouldReview(
    criteria: Criteria.timesLaunched,
    minLaunchTimes: 8,
    coolDownLaunchTimes: 4,
)) {
    // 提示用户评价
    ShouldReview.neverReview(); // 确保 shouldReview 函数不再返回 true
}

使用自定义条件

import 'package:should_review/should_review.dart';

// 每次用户完成特定操作时调用此函数
ShouldReview.recordCustomCriteriaMet("made_purchase");

if (await ShouldReview.shouldReview(
    criteria: Criteria.custom,
    customCriteriaKey: "made_purchase",
    minCustomCriteriaValue: 5,
    coolDownCustomCriteriaInterval: 2,
)) {
    // 提示用户评价
    ShouldReview.neverReview(); // 确保 shouldReview 函数不再返回 true
}

完整示例 Demo

以下是完整的示例代码，展示如何在 Flutter 应用中使用 should_review 插件。

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

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

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

class MyHomePage extends StatefulWidget {
  MyHomePage({Key key, this.title}) : super(key: key);

  final String title;

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  bool _hasPromptedRateApp = false;

  @override
  void initState() {
    super.initState();
    ShouldReview.recordLaunch(); // 记录应用启动
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            if (await ShouldReview.shouldReview(
                criteria: Criteria.days,
                minDays: 7,
                coolDownDays: 2)) {
              // 提示用户评价
              ScaffoldMessenger.of(context).showSnackBar(
                SnackBar(content: Text('请评价我们的应用！')),
              );
              ShouldReview.neverReview(); // 确保 shouldReview 函数不再返回 true
              setState(() => _hasPromptedRateApp = true);
            } else {
              ScaffoldMessenger.of(context).showSnackBar(
                SnackBar(content: Text('暂不提示评价')),
              );
            }
          },
          child: Text('检查是否应提示评价'),
        ),
      ),
    );
  }
}

以上代码展示了如何在应用启动时记录启动次数，并根据设定的条件决定是否提示用户评价。希望这些信息能帮助你在 Flutter 应用中实现用户评价提示功能。