Flutter重生/恢复状态插件flutter_phoenix的使用

Flutter重生/恢复状态插件flutter_phoenix的使用

轻松地从头开始重启您的应用程序，从而丢弃任何先前的状态。

Flutter 3.0

从1.1.0版本开始，flutter_phoenix的目标SDK为2.17.0及以上。 如果您想继续使用flutter_phoenix但无法迁移到Dart SDK 2.17.0，请使用版本1.0.0。

Flutter 2.0 和 null-safety

从1.0.0版本开始，flutter_phoenix是null-safe的，并且要求Dart SDK 2.12.0及以上。 如果您想继续使用flutter_phoenix但无法迁移到null-safety，请使用版本0.1.0。

使用方法

将您的App小部件包裹在Phoenix小部件中。

void main() {
  runApp(
    Phoenix(
      child: App(),
    ),
  );
}

当您想要重启应用程序时（重新构建整个小部件树），调用rebirth静态方法。

Phoenix.rebirth(context);

免责声明：

Phoenix在应用程序级别重启您的应用程序，重新构建您的应用程序小部件树，从而丢弃任何先前的状态。

Phoenix不会在操作系统级别完全重启您的应用程序进程。

使用场景

以下是Phoenix可以帮忙的一些非详尽列表：

• 在注销后重启应用程序
• 在应用程序初始化过程失败后重启应用程序
• 在应用程序中发生特定事件后重启应用程序
• …

安装

依赖项

在您的pubspec.yaml文件中作为依赖项添加该包。

dependencies:
  flutter_phoenix: "^1.0.0"

导入

在您的代码文件中导入该包。

import 'package:flutter_phoenix/flutter_phoenix.dart';

许可证

Flutter Phoenix 是在 MIT 许可证下发布的。

致谢

此包是从@rrousselGit在Stack Overflow上的回答中提取出来的。

关于我们

截至2022年7月，该包由法国移动应用Dailyn的前端团队维护。

示例代码

以下是一个完整的示例，展示了如何使用Phoenix插件来重启应用程序。

import 'dart:async';

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

void main() {
  runApp(
    /// 1. 将您的App小部件包裹在Phoenix小部件中
    Phoenix(
      child: App(),
    ),
  );
}

class App extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData.light(),
      home: const SplashScreen(),
    );
  }
}

class SplashScreen extends StatefulWidget {
  const SplashScreen();

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

class _SplashScreenState extends State<SplashScreen> {
  [@override](/user/override)
  void initState() {
    super.initState();

    simulateInitialDataLoading();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: Colors.black,
      body: SizedBox(
        width: double.infinity,
        height: double.infinity,
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          crossAxisAlignment: CrossAxisAlignment.center,
          children: const [
            Text(
              '初始屏幕',
              style: TextStyle(
                  color: Colors.white,
                  fontSize: 34,
                  fontWeight: FontWeight.w700),
            ),
          ],
        ),
      ),
    );
  }

  Future<Timer> simulateInitialDataLoading() async {
    return Timer(
      const Duration(seconds: 2),
      () => Navigator.push(
        context,
        MaterialPageRoute(
          builder: (context) => const MainScreen(),
        ),
      ),
    );
  }
}

class MainScreen extends StatelessWidget {
  const MainScreen();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: SafeArea(
        child: Container(
          width: double.infinity,
          height: double.infinity,
          padding: const EdgeInsets.symmetric(horizontal: 24.0, vertical: 48.0),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              const Text(
                'Flutter Phoenix',
                style: TextStyle(fontSize: 34, fontWeight: FontWeight.w700),
              ),
              const SizedBox(height: 24),
              const Text(
                'Phoenix小部件使您可以从头开始重建小部件树，丢弃任何状态。'
                '\n\n它基本上会重新构建您的整个应用程序。'
                '\n\n使用方法非常简单：'
                '\n\n1. 将根App小部件包裹在Phoenix小部件中'
                '\n\n2. 调用Phoenix.rebirth(context); 以重建您的应用程序',
                style: TextStyle(
                    fontSize: 16, fontWeight: FontWeight.w400, height: 1.5),
              ),
              const Spacer(),
              SizedBox(
                width: double.infinity,
                height: 48.0,
                child: TextButton(
                  style: TextButton.styleFrom(
                    backgroundColor: Colors.red,
                    primary: Colors.white,
                  ),
                  child: const Text('Phoenix.rebirth(context);'),

                  /// 2. 调用Phoenix.rebirth(context)以重建您的应用程序
                  onPressed: () => Phoenix.rebirth(context),
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}