以下是关于“Flutter安全存储插件native_secured_storage的使用”的详细内容：

Flutter安全存储插件native_secured_storage的使用

native_secured_storage 是一个为 Flutter 设计的安全存储插件，用于使用 Android Keystore 和 iOS Keychain 安全地存储和检索原始数据类型（int、double、bool 和 String）。这确保了数据在静止时被加密，并且即使设备被破解也能防止未经授权的访问。

为什么使用 native_secured_storage？

安全特性

1. Android Keystore 使用 EncryptedSharedPreferences

   • 使用 AES256 加密，并将唯一密钥安全地存储在 Android Keystore 中。
   • 确保加密和解密仅在设备上进行。

2. iOS Keychain

   • 直接集成到 Apple 的 Keychain 中，为敏感数据提供系统级安全性。
   • 如果可用，使用设备的 Secure Enclave 保护数据。

3. 不存储明文

   • 所有数据在保存之前都会被加密，确保敏感信息永远不会以明文形式存储。

4. 平台隔离

   • Android 和 iOS 分别实现确保数据在每个平台的原生环境中安全存储。

使用场景

• 认证: 安全地存储令牌、密码或敏感用户凭据。
• 偏好设置: 保存加密的应用程序偏好设置，如用户设置或功能标志。
• 安全标识符: 存储应用程序逻辑所需的唯一标识符或密钥。

特性

• 跨平台: 支持 Android 和 iOS。
• 类型支持: 安全处理 int、double、bool 和 String 类型。
• 易于使用的 API: 提供简化 Dart API 用于保存、检索和删除数据。
• 错误处理: 全面的错误处理机制，以便在加密或存储操作期间捕捉问题。

安装

在你的 pubspec.yaml 文件中添加 native_secured_storage：

dependencies:
  native_secured_storage: ^1.0.0

运行以下命令来安装包：

flutter pub get

使用方法

导入库

import 'package:native_secured_storage/native_secured_storage.dart';

保存值

await NativeSecuredStorage.save('key_name', 123); // 保存整数
await NativeSecuredStorage.save('key_name', 45.67); // 保存双精度浮点数
await NativeSecuredStorage.save('key_name', true); // 保存布尔值
await NativeSecuredStorage.save('key_name', 'Hello World'); // 保存字符串

检索值

final value = await NativeSecuredStorage.retrieve('key_name');
if (value != null) {
  print('Retrieved value: $value');
} else {
  print('No value found for the given key.');
}

删除值

await NativeSecuredStorage.delete('key_name');
print('Value deleted successfully.');

示例

以下是一个完整的示例，展示了如何使用 native_secured_storage 插件：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Native Secured Storage Example',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: SecureStorageDemo(),
    );
  }
}

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

class _SecureStorageDemoState extends State<SecureStorageDemo> {
  final TextEditingController _keyController = TextEditingController();
  final TextEditingController _valueController = TextEditingController();
  String? _retrievedValue;

  Future<void> _saveValue() async {
    final key = _keyController.text;
    final value = _valueController.text;

    if (key.isEmpty || value.isEmpty) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Key and value cannot be empty')),
      );
      return;
    }

    // 检测值类型以进行保存
    dynamic parsedValue;
    if (value.toLowerCase() == 'true' || value.toLowerCase() == 'false') {
      parsedValue = value.toLowerCase() == 'true';
    } else if (double.tryParse(value) != null) {
      parsedValue = value.contains('.') ? double.parse(value) : int.parse(value);
    } else {
      parsedValue = value;
    }

    try {
      await NativeSecuredStorage.save(key, parsedValue);
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Value saved successfully')),
      );
    } catch (e) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Error saving value: $e')),
      );
    }
  }

  Future<void> _retrieveValue() async {
    final key = _keyController.text;

    if (key.isEmpty) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Key cannot be empty')),
      );
      return;
    }

    try {
      final value = await NativeSecuredStorage.retrieve(key);
      setState(() {
        _retrievedValue = value?.toString();
      });
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Value retrieved successfully')),
      );
    } catch (e) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Error retrieving value: $e')),
      );
    }
  }

  Future<void> _deleteValue() async {
    final key = _keyController.text;

    if (key.isEmpty) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Key cannot be empty')),
      );
      return;
    }

    try {
      await NativeSecuredStorage.delete(key);
      setState(() {
        _retrievedValue = null;
      });
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Value deleted successfully')),
      );
    } catch (e) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Error deleting value: $e')),
      );
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Secure Storage Example'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            TextField(
              controller: _keyController,
              decoration: InputDecoration(labelText: 'Key'),
            ),
            TextField(
              controller: _valueController,
              decoration: InputDecoration(labelText: 'Value'),
            ),
            SizedBox(height: 16),
            Row(
              children: [
                ElevatedButton(
                  onPressed: _saveValue,
                  child: Text('Save'),
                ),
                SizedBox(width: 8),
                ElevatedButton(
                  onPressed: _retrieveValue,
                  child: Text('Retrieve'),
                ),
                SizedBox(width: 8),
                ElevatedButton(
                  onPressed: _deleteValue,
                  child: Text('Delete'),
                ),
              ],
            ),
            SizedBox(height: 16),
            if (_retrievedValue != null)
              Text('Retrieved Value: $_retrievedValue'),
          ],
        ),
      ),
    );
  }
}