Flutter加密或安全服务插件seald_sdk_flutter的使用

SealdSDK允许您在Flutter应用程序中使用Seald加密的全部功能。您可以为应用程序的用户创建和检索Seald身份，加密和解密文件，创建加密会话，添加或撤销接收者等。

基本示例

以下是一个基本的示例，展示了如何使用seald_sdk_flutter插件进行加密和解密操作：

import 'package:seald_sdk_flutter/seald_sdk.dart';
import 'dart:convert';

Future<void> main() async {
  final SealdSdk seald = SealdSdk(
    apiURL: 'https://your-api-url.com',
    appId: 'your-app-id',
  );

  // 创建一个Seald身份
  final SealdAccountInfo info = await seald.createAccountAsync('your-jwt-token');

  // 创建加密会话
  final SealdEncryptionSession es = await seald.createEncryptionSessionAsync([info.userId]);

  // 加密文件
  final Uint8List encryptedFile = await es.encryptFileAsync(
    Uint8List.fromList(utf8.encode('Secret file content')),
    'SecretFile.txt',
  );

  // 解密文件
  final Uint8List decryptedFile = await es.decryptFileAsync(encryptedFile);

  print('Original content: ${utf8.decode(decryptedFile)}');
}

安装步骤

iOS安装

为了在iOS上安装此插件，您需要将项目的全局平台设置为至少iOS 13。为此，请编辑您的./ios/Podfile文件，并添加以下行：

platform :ios, '13.0'

注意事项

• Hot-Reload / Hot-Restart: Seald SDK不兼容Flutter的热重载/热重启功能。如果尝试使用这些功能，可能会遇到DATABASE_LOCKED错误。

• JWT生成: Seald使用JWT来管理许可证和身份。JWT应由您的后端生成，并在用户注册时发送给用户。JWT的secretId和secret可以从您的管理仪表板生成，并且不应出现在客户端代码中。

完整示例Demo

下面是一个更完整的示例，展示了如何在Flutter应用中集成seald_sdk_flutter插件，包括创建用户、加密和解密文件等功能：

import 'dart:convert';
import 'dart:io';
import 'dart:typed_data';
import 'package:flutter/material.dart';
import 'package:path_provider/path_provider.dart' as path_provider;
import 'package:seald_sdk_flutter/seald_sdk.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Seald SDK Demo')),
        body: Center(child: SealdDemo()),
      ),
    );
  }
}

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

class _SealdDemoState extends State<SealdDemo> {
  late Future<String> _futureResult;

  [@override](/user/override)
  void initState() {
    super.initState();
    _futureResult = testSealdSdk();
  }

  Future<String> testSealdSdk() async {
    final Directory tmpDir = await path_provider.getApplicationDocumentsDirectory();
    final Directory dbDir = Directory('${tmpDir.path}/seald-test-db');

    if (dbDir.existsSync()) {
      dbDir.deleteSync(recursive: true);
    }

    final SealdSdk sdk = SealdSdk(
      apiURL: 'https://your-api-url.com',
      appId: 'your-app-id',
      databasePath: '${dbDir.path}/sdk1',
      databaseEncryptionKey: Uint8List.fromList(List.filled(64, 0)), // 使用真实的加密密钥
      logLevel: -1,
      instanceName: "Dart-Instance-1",
    );

    final SealdAccountInfo accountInfo = await sdk.createAccountAsync('your-jwt-token');

    final SealdEncryptionSession es = await sdk.createEncryptionSessionAsync([accountInfo.userId]);
    
    final Uint8List encryptedFile = await es.encryptFileAsync(
      Uint8List.fromList(utf8.encode('Hello, Seald!')),
      'test.txt',
    );

    final Uint8List decryptedFile = await es.decryptFileAsync(encryptedFile);

    return utf8.decode(decryptedFile);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return FutureBuilder<String>(
      future: _futureResult,
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.done) {
          if (snapshot.hasError) {
            return Text('Error: ${snapshot.error}');
          } else {
            return Text('Decrypted content: ${snapshot.data}');
          }
        } else {
          return CircularProgressIndicator();
        }
      },
    );
  }
}