Flutter判断应用首次运行插件is_first_run_plus的使用

这是一个基于Julian Aßmann的插件 flutter_is_first_run 的分叉版本。

该插件用于检查应用程序是否是第一次运行。它内部使用了 hive_flutter 和 package_info_plus 插件。

开始使用

在你的 pubspec.yaml 文件中添加 is_first_run_plus 依赖：

dependencies:
  is_first_run_plus: ^最新版本号

然后运行 flutter pub get 来获取这个包。

使用方法

首先，你需要导入 is_first_run_plus.dart 文件：

import 'package:is_first_run_plus/is_first_run_plus.dart';

检查应用是否是第一次运行

你可以使用 IsFirstRun.isFirstRun() 方法来检查应用是否是第一次运行：

bool firstRun = await IsFirstRun.isFirstRun();

如果这是安装应用后第一次调用此方法，那么该方法将返回 true，直到应用关闭并重新启动。重新启动应用后，它会返回 false。

检查是否是第一次调用

你还可以使用 IsFirstRun.isFirstCall() 方法来检查是否是第一次调用：

bool firstCall = await IsFirstRun.isFirstCall();

如果这是安装应用后第一次调用此方法，那么该方法将返回 true，之后每次调用都会返回 false。

检查特定版本的应用是否是第一次运行或调用

你也可以使用带 build 参数的方法来检查特定版本的应用是否是第一次运行或调用：

bool firstRunSinceBuild66 = await IsFirstRun.isFirstRunSince(build: 66);
bool firstCallSinceBuild66 = await IsFirstRun.isFirstCallSince(build: 66);

重置插件

你可以通过调用 IsFirstRun.reset() 方法来重置插件：

await IsFirstRun.reset();

重置后，再次调用 isFirstRun() 会返回 true，直到应用关闭并重新启动。重置后，第一次调用 isFirstCall() 也会返回 true，之后每次调用都会返回 false。

示例代码

以下是一个简单的页面，展示了如何使用 IsFirstRun.isFirstRun() 方法的结果。按钮允许你再次调用 IsFirstRun.isFirstRun() 方法，重置按钮则调用 IsFirstRun.reset() 方法。

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

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

class MyApp extends StatelessWidget {
  // 这个小部件是你的应用的根。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: MyHomePage(title: 'is_first_run demo'),
    );
  }
}

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

  final String title;

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  bool? _isFirstRun;
  bool? _isFirstCall;

  void _checkFirstRun() async {
    bool ifr = await IsFirstRun.isFirstRun();
    setState(() {
      _isFirstRun = ifr;
    });
  }

  void _checkFirstCall() async {
    bool ifc = await IsFirstRun.isFirstCall();
    setState(() {
      _isFirstCall = ifc;
    });
  }

  void _reset() async {
    await IsFirstRun.reset();
    _checkFirstRun();
    _checkFirstCall();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
                child: Text('检查是否是第一次运行'),
                onPressed: _checkFirstRun),
            ElevatedButton(
                child: Text('检查是否是第一次调用'),
                onPressed: _checkFirstCall),
            ElevatedButton(
                child: Text('重置'),
                onPressed: _reset),
            SizedBox(height: 24),
            Text(
                '是否是第一次运行: ${_isFirstRun != null ? _isFirstRun.toString() : '未知'}'),
            Text(
                '是否是第一次调用: ${_isFirstCall != null ? _isFirstCall.toString() : '未知'}'),
          ],
        ),
      ),
    );
  }
}