Flutter插件torus_direct的使用方法详解

Flutter插件torus_direct的使用方法详解

Torus CustomAuth SDK 是一个用于 Flutter 应用程序的插件。它允许开发者通过各种 OAuth 提供商（如 Google、Facebook、Reddit 和 Discord）进行身份验证。

开始使用Flutter插件torus_direct

首先，查看 example/ 文件夹以获取完整的示例代码。

使用步骤

1. 在你的 pubspec.yaml 文件中添加 torus_direct 包，并导入该包：

import 'package:torus_direct/torus_direct.dart';

1. 选择你将要使用的 OAuth 提供商。你可以查看 Torus CustomAuth 支持的 OAuth 提供商 获取更多信息。

2. 前往 Torus Developer 创建你的 OAuth 提供商对应的验证器，并配置相应的设置。

3. 初始化插件：

await TorusDirect.init(
    network: TorusNetwork.testnet,
    redirectUri: Uri.parse(
        'torusapp://org.torusresearch.torusdirectandroid/redirect')); // 替换为你的应用URL

1. 当用户与你的应用程序交互时，触发登录：

TorusDirect.triggerLogin(
    typeOfLogin: TorusLogin.google,
    verifier: 'google-lrc',
    clientId:
        '221898609709-obfn3p63741l5333093430j3qeiinaa8.apps.googleusercontent.com',
    jwtParams: {});

Android 特定配置

在你的 android/app/build.gradle 文件中添加以下内容来配置自定义 URL 方案：

manifestPlaceholders = [
    'torusRedirectScheme': 'torusapp',
    'torusRedirectHost': 'org.torusresearch.torusdirectandroid',
    'torusRedirectPathPrefix': '/redirect'
]

iOS 特定配置

在 XCode 中打开项目 (ios/Runner.xcworkspace) 并添加自定义 URL 类型。然后在 ios/Runner/AppDelegate.swift 中添加以下代码来处理重定向 URL：

import UIKit
import Flutter
import TorusSwiftDirectSDK

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    GeneratedPluginRegistrant.register(with: self)
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
    
  // 处理重定向 URL 并发送到 Torus Direct 实例
  override func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    TorusSwiftDirectSDK.handle(url: url)
    return true
  }
}

完整示例代码

以下是一个完整的示例代码，展示了如何在 Flutter 应用程序中使用 torus_direct 插件：

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:torus_direct/torus_direct.dart';

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _privateKey = '<empty>';

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，因此我们在异步方法中初始化。
  Future<void> initPlatformState() async {
    await TorusDirect.init(
        network: TorusNetwork.testnet,
        redirectUri: Uri.parse(
            'torusapp://org.torusresearch.torusdirectandroid/redirect'));
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Torus CustomAuth 示例'),
        ),
        body: Center(
            child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Padding(
              padding: const EdgeInsets.all(8.0),
              child: Text('使用登录'),
            ),
            ElevatedButton(
                onPressed: _login(_withGoogle), child: Text('Google')),
            ElevatedButton(
                onPressed: _login(_withFacebook), child: Text('Facebook')),
            ElevatedButton(
                onPressed: _login(_withReddit), child: Text('Reddit ')),
            ElevatedButton(
                onPressed: _login(_withDiscord), child: Text('Discord')),
            Padding(
              padding: const EdgeInsets.all(8.0),
              child: Text('私钥: $_privateKey'),
            )
          ],
        )),
      ),
    );
  }

  VoidCallback _login(Future<TorusCredentials> Function() method) {
    return () async {
      try {
        final TorusCredentials credentials = await method();
        setState(() {
          _privateKey = credentials.privateKey;
        });
      } on UserCancelledException {
        print("用户取消了。");
      } on NoAllowedBrowserFoundException {
        print("未找到允许的浏览器。");
      }
    };
  }

  Future<TorusCredentials> _withGoogle() {
    return TorusDirect.triggerLogin(
        typeOfLogin: TorusLogin.google,
        verifier: 'google-lrc',
        clientId:
            '221898609709-obfn3p63741l5333093430j3qeiinaa8.apps.googleusercontent.com',
        jwtParams: {});
  }

  Future<TorusCredentials> _withFacebook() {
    return TorusDirect.triggerLogin(
        typeOfLogin: TorusLogin.facebook,
        verifier: 'facebook-lrc',
        clientId: '617201755556395',
        jwtParams: {});
  }

  Future<TorusCredentials> _withReddit() {
    return TorusDirect.triggerLogin(
        typeOfLogin: TorusLogin.reddit,
        verifier: 'torus-reddit-test',
        clientId: 'YNsv1YtA_o66fA',
        jwtParams: {});
  }

  Future<TorusCredentials> _withDiscord() {
    return TorusDirect.triggerLogin(
        typeOfLogin: TorusLogin.discord,
        verifier: 'discord-lrc',
        clientId: '682533837464666198',
        jwtParams: {});
  }
}