Flutter密码输入插件agl_passcode的使用

一个一站式的包，用于实现设置密码、验证密码和更改密码的功能。

安装

首先在pubspec.yaml文件中添加agl_passcode作为依赖项。

然后导入：

import 'package:agl_passcode/lock_screen_helper.dart';

或者

import 'package:agl_passcode/passcode_screen.dart';

特性

• 创建新密码
• 将密码保存到安全的本地存储
• 验证/解锁密码
• 更改密码
• 忘记密码及回调
• 支持暗色和亮色主题

使用

你可以通过以下代码片段轻松设置新密码、验证密码并更改密码。

创建密码：

LockScreenHelper(isCreate: true, isEdit: false, isFromChangePasscode: false);

上述代码将创建密码并将密码保存在安全的本地存储中。

或者

下面的代码提供了在创建新密码后调用的回调，以便用户可以保存密码：

PasscodeScreen(
  isCreate: true,
  isFromChangePasscode: false,
  onConfirm: (isAuthenticated, pin) {
    // 处理认证并保存密码
  },
  pin: "",
  isDarkTheme: true,
);

验证密码：

密码验证是通过从安全存储获取密码来完成的。

LockScreenHelper(isCreate: false, isEdit: false, isFromChangePasscode: false);

或者

使用以下代码片段，通过传递正确的密码来验证密码：

PasscodeScreen(
  isCreate: false,
  isFromChangePasscode: false,
  onConfirm: (isAuthenticated, pin) {
    // 处理认证并保存密码
  },
  pin: "{正确密码}",
  isDarkTheme: true,
);

更改密码：

LockScreenHelper(isCreate: false, isEdit: true, isFromChangePasscode: true),

或者

PasscodeScreen(
  isCreate: false,
  isFromChangePasscode: true,
  onConfirm: (isAuthenticated, pin) {
    // 处理认证并保存密码
  },
  pin: "{正确密码}",
  isDarkTheme: true,
);

忘记密码：

下面的代码片段用于处理忘记密码的流程：

PasscodeScreen(
  isCreate: false,
  isFromChangePasscode: false,
  onConfirm: (isAuthenticated, pin) {
    if (pin == Strings.forgotPwdText) {
      // 处理忘记密码的流程，如启动新屏幕或使用pin_verify_screen.dart启动内置屏幕
    }
  },
  pin: "{正确密码}",
  isDarkTheme: true,
);

示例代码

import 'package:flutter/material.dart';
import 'package:agl_passcode/passcode_screen.dart';
import 'package:agl_passcode/src/pin_verify_screen.dart';
import 'package:agl_passcode/lock_screen_helper.dart';
import 'package:agl_passcode/strings.dart';

var passcode = "";

void main() => runApp(const MyApp());

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Passcode',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      themeMode: ThemeMode.light,
      initialRoute: '/',
      routes: {
        '/': (context) => const LaunchScreen(),
        '/set_passcode': (context) => LockScreenHelper(isCreate: true, isEdit: false, isFromChangePasscode: false),
        '/enter_passcode': (context) => LockScreenHelper(isCreate: false, isEdit: false, isFromChangePasscode: false),
        '/change_passcode': (context) => LockScreenHelper(isCreate: false, isEdit: true, isFromChangePasscode: true),
        '/forgot_password': (context) => const PinVerifyScreen(),
      },
    );
  }
}

void handleForgotPassword(String pin, BuildContext context) {
  if (pin == Strings.forgotPwdText) {
    Navigator.pushReplacementNamed(context, '/forgot_password');
  }
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: SafeArea(
          child: Center(
            child: Column(
              mainAxisSize: MainAxisSize.min,
              children: [
                TextButton(
                  onPressed: () {
                    Navigator.push(
                      context,
                      MaterialPageRoute(
                        builder: (context) => LockScreenHelper(isCreate: true, isEdit: false, isFromChangePasscode: false),
                      ),
                    );
                  },
                  child: const Text('Set Passcode'),
                ),
                TextButton(
                  onPressed: () {
                    Navigator.push(
                      context,
                      MaterialPageRoute(
                        builder: (context) => PasscodeScreen(
                          isCreate: false,
                          isFromConfirm: false,
                          onConfirm: (isAuthenticated, pin) {
                            if (isAuthenticated) {
                              Navigator.pop(context);
                            } else {
                              // 处理未认证的情况
                            }
                            handleForgotPassword(pin, context);
                          },
                          pin: passcode,
                          isDarkTheme: true,
                        ),
                      ),
                    );
                  },
                  child: const Text('Unlock'),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}