Flutter Secure Storage v10.0.0 重大版本更新解析

项目简介

Flutter Secure Storage 是一个流行的 Flutter 插件，用于在移动设备和 Web 平台上安全地存储敏感数据。它提供了跨平台的 API，可以在 Android、iOS、Web 和 Windows 上安全地保存密码、令牌和其他敏感信息。该插件使用各平台的安全存储机制，如 Android 的加密共享首选项、iOS 的 Keychain 服务等。

版本 10.0.0 主要变更

环境要求升级

本次大版本更新对开发环境提出了更高要求：

• 最低 Dart SDK 版本提升至 3.3.0
• 最低 Flutter 版本提升至 3.19.0
• Android 最低 SDK 版本从 19 提升至 23
• iOS 最低版本从 9 提升至 12

这些变更反映了现代移动开发的安全需求和性能优化方向，同时也让插件能够利用最新的平台特性。

Android 平台重大改进

1. 强制启用加密存储：

   • 现在 encryptedSharedPreferences 将默认启用且无法禁用
   • 旧版本中未加密存储的数据会自动迁移到加密存储中
   • 这一变更显著提升了数据安全性，确保所有 Android 设备上的数据都得到加密保护

2. 加密库迁移：

   • 从已弃用的 Jetpack Crypto 迁移到 Google Tink Crypto 库
   • Tink 是 Google 开发的现代加密库，提供更安全、更易用的加密原语

3. 技术栈升级：

   • 迁移至 Android SDK 35
   • Java 版本升级到 17
   • 代码分析器和代码清理工具更新
   • 多项代码质量改进

iOS 平台优化

1. Keychain 操作队列化：

   • 使用串行队列执行 Keychain 操作，避免潜在的并发问题
   • 提高了操作的安全性和可靠性

2. 代码质量提升：

   • 更新代码分析器
   • 进行代码清理和重构

Web 平台增强

1. WASM 兼容性：

   • 现在完全支持 WebAssembly (WASM) 环境
   • 为 Flutter Web 的现代开发提供了更好的支持

2. 新增会话存储选项：

   • 添加了 useSessionStorage 参数到 WebOptions
   • 开发者可以选择使用会话存储(sessionStorage)而非本地存储(localStorage)
   • 会话存储的数据在浏览器标签页关闭后会自动清除，适合临时敏感数据

Windows 平台更新

1. 依赖库升级：

   • 迁移到 win32 5.5.4 版本
   • 支持 Dart 3.4 / Flutter 3.22.0

2. 代码质量改进：

   • 更新代码分析器
   • 进行代码清理和优化

平台接口改进

• 平台接口代码进行了全面清理和优化
• 使用新版分析器提高代码质量
• 为未来的扩展打下更好基础

升级建议

对于现有项目，升级到 v10.0.0 需要注意以下几点：

1. 环境检查：确保项目满足最低 Dart 和 Flutter 版本要求
2. Android 适配：由于最低 SDK 版本提高到 23，需要检查目标用户设备兼容性
3. 数据迁移：Android 上的加密存储变更会自动迁移现有数据，但仍建议进行测试
4. Web 特性：考虑是否需要使用新的会话存储功能替代本地存储

这次大版本更新带来了显著的安全性和稳定性提升，特别是在加密存储方面的改进，使 Flutter Secure Storage 成为 Flutter 生态中更可靠的安全存储解决方案。对于新项目，建议直接采用此版本；对于现有项目，在充分测试后升级可以获得更好的安全保证。