Flutter身份验证插件stytch_dart_auth_sdk的使用

stytch_dart_auth_sdk 是一个用于在 Flutter 应用中实现身份验证的插件，它基于 Stytch 的身份验证服务。Stytch 提供了一套强大的身份验证解决方案，包括密码、OAuth、Magic Links、OTP 等多种身份验证方式。

以下是如何在 Flutter 项目中使用 stytch_dart_auth_sdk 的基本步骤：

1. 安装依赖

首先，你需要在 pubspec.yaml 文件中添加 stytch_dart_auth_sdk 依赖：

dependencies:
  flutter:
    sdk: flutter
  stytch_dart_auth_sdk: ^0.0.1  # 请检查最新版本

然后运行 flutter pub get 来安装依赖。

2. 初始化 SDK

在你的 Flutter 应用中，首先需要初始化 Stytch SDK。通常你可以在 main.dart 文件中进行初始化：

import 'package:stytch_dart_auth_sdk/stytch_dart_auth_sdk.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 Stytch SDK
  await StytchAuth.initialize(
    publicToken: 'YOUR_PUBLIC_TOKEN',  // 你的 Stytch Public Token
    environment: StytchEnvironment.live,  // 或者 StytchEnvironment.test
  );

  runApp(MyApp());
}

3. 实现身份验证功能

3.1 使用 Magic Links 进行身份验证

Magic Links 是一种无密码登录方式，用户通过点击发送到其邮箱的链接进行登录。

import 'package:stytch_dart_auth_sdk/stytch_dart_auth_sdk.dart';

Future<void> sendMagicLink(String email) async {
  try {
    await StytchAuth.magicLinks.email.send(
      email: email,
      loginRedirectUrl: 'https://yourapp.com/login',  // 登录成功后的重定向 URL
      signupRedirectUrl: 'https://yourapp.com/signup',  // 注册成功后的重定向 URL
    );
    print('Magic Link sent successfully');
  } catch (e) {
    print('Failed to send Magic Link: $e');
  }
}

3.2 使用 OAuth 进行身份验证

OAuth 允许用户通过第三方服务（如 Google、Facebook 等）进行登录。

import 'package:stytch_dart_auth_sdk/stytch_dart_auth_sdk.dart';

Future<void> startOAuth(String provider) async {
  try {
    await StytchAuth.oauth.start(
      provider: provider,  // 例如 'google', 'facebook'
      redirectUri: 'https://yourapp.com/oauth/callback',  // 回调 URL
    );
    print('OAuth started successfully');
  } catch (e) {
    print('Failed to start OAuth: $e');
  }
}

3.3 使用 OTP 进行身份验证

OTP（一次性密码）通常用于短信或邮箱验证。

import 'package:stytch_dart_auth_sdk/stytch_dart_auth_sdk.dart';

Future<void> sendOTP(String phoneNumber) async {
  try {
    await StytchAuth.otps.sms.send(
      phoneNumber: phoneNumber,
    );
    print('OTP sent successfully');
  } catch (e) {
    print('Failed to send OTP: $e');
  }
}

Future<void> verifyOTP(String code) async {
  try {
    await StytchAuth.otps.sms.verify(
      code: code,
    );
    print('OTP verified successfully');
  } catch (e) {
    print('Failed to verify OTP: $e');
  }
}

4. 处理用户会话

Stytch SDK 会自动管理用户会话。你可以通过以下方式检查用户是否已登录：

import 'package:stytch_dart_auth_sdk/stytch_dart_auth_sdk.dart';

Future<void> checkSession() async {
  try {
    final session = await StytchAuth.session.get();
    if (session != null) {
      print('User is logged in');
    } else {
      print('User is not logged in');
    }
  } catch (e) {
    print('Failed to check session: $e');
  }
}

5. 注销用户

你可以通过以下方式注销用户：

import 'package:stytch_dart_auth_sdk/stytch_dart_auth_sdk.dart';

Future<void> logout() async {
  try {
    await StytchAuth.session.revoke();
    print('User logged out successfully');
  } catch (e) {
    print('Failed to logout: $e');
  }
}

6. 处理回调

对于 Magic Links 和 OAuth，你需要在应用中处理回调。通常你可以在 MaterialApp 的 onGenerateRoute 或 onUnknownRoute 中处理这些回调。

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      onGenerateRoute: (settings) {
        if (settings.name == '/login') {
          // 处理 Magic Link 回调
          final token = settings.arguments as String;
          StytchAuth.magicLinks.authenticate(token: token);
        } else if (settings.name == '/oauth/callback') {
          // 处理 OAuth 回调
          final token = settings.arguments as String;
          StytchAuth.oauth.authenticate(token: token);
        }
        return null;
      },
      home: HomeScreen(),
    );
  }
}