finap_secure_shared_preferences 是一个用于在 Flutter 应用中安全存储数据的插件。它基于 SharedPreferences，但提供了额外的加密层，确保存储的数据更加安全。以下是如何使用 finap_secure_shared_preferences 插件的详细步骤。

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 finap_secure_shared_preferences 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  finap_secure_shared_preferences: ^1.0.0  # 请使用最新版本

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

2. 初始化插件

在使用插件之前，需要先进行初始化。通常可以在 main() 函数中完成初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FinapSecureSharedPreferences.init();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Secure Shared Preferences Demo',
      home: HomeScreen(),
    );
  }
}

3. 存储数据

使用 FinapSecureSharedPreferences 来存储数据。你可以存储 String、int、double、bool 等类型的数据。

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

class HomeScreen extends StatelessWidget {
  Future<void> _saveData() async {
    await FinapSecureSharedPreferences.setString('key1', 'secure_value');
    await FinapSecureSharedPreferences.setInt('key2', 123);
    await FinapSecureSharedPreferences.setBool('key3', true);
    print('Data saved securely');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Secure Shared Preferences'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: _saveData,
          child: Text('Save Secure Data'),
        ),
      ),
    );
  }
}

4. 读取数据

使用 FinapSecureSharedPreferences 来读取存储的数据。

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

class HomeScreen extends StatelessWidget {
  Future<void> _readData() async {
    String? value1 = await FinapSecureSharedPreferences.getString('key1');
    int? value2 = await FinapSecureSharedPreferences.getInt('key2');
    bool? value3 = await FinapSecureSharedPreferences.getBool('key3');
    print('Value1: $value1');
    print('Value2: $value2');
    print('Value3: $value3');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Secure Shared Preferences'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: _readData,
              child: Text('Read Secure Data'),
            ),
          ],
        ),
      ),
    );
  }
}

5. 删除数据

你可以使用 remove() 方法来删除存储的数据。

Future<void> _removeData() async {
  await FinapSecureSharedPreferences.remove('key1');
  print('Data removed');
}

6. 清除所有数据

你可以使用 clear() 方法来清除所有存储的数据。

Future<void> _clearData() async {
  await FinapSecureSharedPreferences.clear();
  print('All data cleared');
}

7. 注意事项

• finap_secure_shared_preferences 使用加密来保护存储的数据，因此它比普通的 SharedPreferences 更安全。
• 由于数据是加密存储的，读取和写入操作可能会比普通的 SharedPreferences 稍慢。
• 确保在使用插件之前进行初始化，否则可能会导致运行时错误。

8. 示例代码

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

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FinapSecureSharedPreferences.init();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Secure Shared Preferences Demo',
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatelessWidget {
  Future<void> _saveData() async {
    await FinapSecureSharedPreferences.setString('key1', 'secure_value');
    await FinapSecureSharedPreferences.setInt('key2', 123);
    await FinapSecureSharedPreferences.setBool('key3', true);
    print('Data saved securely');
  }

  Future<void> _readData() async {
    String? value1 = await FinapSecureSharedPreferences.getString('key1');
    int? value2 = await FinapSecureSharedPreferences.getInt('key2');
    bool? value3 = await FinapSecureSharedPreferences.getBool('key3');
    print('Value1: $value1');
    print('Value2: $value2');
    print('Value3: $value3');
  }

  Future<void> _removeData() async {
    await FinapSecureSharedPreferences.remove('key1');
    print('Data removed');
  }

  Future<void> _clearData() async {
    await FinapSecureSharedPreferences.clear();
    print('All data cleared');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Secure Shared Preferences'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: _saveData,
              child: Text('Save Secure Data'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _readData,
              child: Text('Read Secure Data'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _removeData,
              child: Text('Remove Data'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _clearData,
              child: Text('Clear All Data'),
            ),
          ],
        ),
      ),
    );
  }
}