鸿蒙flutter第三方库适配 - 文件加密工具

见山是山-见水是水2026-04-13 12:58

文件加密工具应用

欢迎加入开源鸿蒙跨平台社区：

https://openharmonycrossplatform.csdn.net

适配的第三方库地址：

一、项目概述

运行效果图




1.1 应用简介

文件加密工具是一款专业可靠的文件安全应用，帮助用户对敏感文件进行加密保护。应用支持AES-256、Salsa20、XOR三种加密算法，用户可设置密码保护，并可选配生物认证（指纹/面容）增强安全性。加密后的文件可安全存储，需要时一键解密，同时支持安全删除功能，确保文件数据不被恢复。

应用以稳重的靛蓝色为主色调，象征安全与信任。涵盖加密、文件、历史、设置四大模块。用户可以轻松选择文件、设置密码、加密保护、管理加密文件，实现文件的安全管理。

1.2 核心功能

功能模块 功能描述 实现方式
文件选择 选择需要加密的文件 file_selector
文件加密 使用密码加密文件 encrypt库
文件解密 输入密码解密文件 encrypt库
密码保护 设置加密密码 密码输入
密码提示 设置密码找回提示 提示文字
生物认证 指纹/面容识别验证 local_auth
加密历史 查看加密文件记录 本地存储
安全删除 覆写后删除文件 安全擦除
加密统计 查看加密文件统计 数据聚合

1.3 加密算法定义

序号 算法名称 密钥长度 描述 安全等级
1 AES-256 256位 高级加密标准，安全可靠 ⭐⭐⭐⭐⭐
2 Salsa20 256位 流加密算法，速度快 ⭐⭐⭐⭐
3 XOR 可变 简单异或加密，速度快 ⭐⭐

1.4 文件状态定义

序号 状态名称 描述 颜色
1 普通 未加密状态 灰色
2 已加密 文件已加密保护 绿色
3 已解密 文件已解密恢复 蓝色

1.5 加密文件信息

序号 字段名称 是否必填 说明
1 原始文件名 ✅ 加密前文件名
2 加密文件名 ✅ 加密后文件名
3 原始路径 ✅ 原始文件路径
4 加密路径 可选 加密文件存储路径
5 原始大小 ✅ 原始文件大小
6 加密大小 可选 加密后文件大小
7 加密算法 ✅ 使用的加密算法
8 加密时间 ✅ 加密操作时间
9 解密时间 可选 解密操作时间
10 文件状态 ✅ 当前文件状态
11 密码提示 可选 密码找回提示

1.6 技术栈

技术领域 技术选型 版本要求
开发框架 Flutter >= 3.0.0
编程语言 Dart >= 2.17.0
设计规范 Material Design 3 -
文件选择 file_selector >= 1.0.3
加密算法 encrypt >= 5.0.3
生物认证 local_auth >= 2.3.0
文件路径 path_provider >= 2.1.4
目标平台 鸿蒙OS / Android / iOS API 21+

1.7 项目结构

复制代码 
lib/
└── main_file_encryptor.dart
    ├── FileEncryptorApp               # 应用入口
    ├── EncryptionAlgorithm            # 加密算法枚举
    ├── FileStatus                     # 文件状态枚举
    ├── EncryptedFile                  # 加密文件模型
    ├── FileEncryptorHomePage          # 主页面（底部导航）
    ├── _buildEncryptPage              # 加密页面
    ├── _buildFilesPage                # 文件列表页
    ├── _buildHistoryPage              # 历史记录页
    ├── _buildSettingsPage             # 设置页
    ├── _encryptAES                    # AES加密
    ├── _decryptAES                    # AES解密
    ├── _encryptSalsa20                # Salsa20加密
    ├── _decryptSalsa20                # Salsa20解密
    ├── _encryptXOR                    # XOR加密
    └── _decryptXOR                    # XOR解密

二、系统架构

2.1 整体架构图

Data Layer
Business Layer
Presentation Layer
主页面

FileEncryptorHomePage
加密页
文件列表页
历史记录页
设置页
快速操作
算法选择
安全选项
文件列表
解密操作
删除操作
文件选择器

FileSelector
加密处理器

Encryptor
认证管理器

AuthManager
EncryptedFile

加密文件
EncryptionAlgorithm

加密算法
FileStatus

文件状态

2.2 类图设计

uses
uses
manages
FileEncryptorApp
+Widget build()
<<enumeration>>
EncryptionAlgorithm
+String label
+String description
+aes()
+salsa20()
+xor()
<<enumeration>>
FileStatus
+String label
+Color color
+normal()
+encrypted()
+decrypted()
EncryptedFile
+String id
+String originalName
+String encryptedName
+String originalPath
+String? encryptedPath
+int originalSize
+int? encryptedSize
+EncryptionAlgorithm algorithm
+DateTime encryptedAt
+DateTime? decryptedAt
+FileStatus status
+String? passwordHint
+formattedOriginalSize
+formattedEncryptedSize
+copyWith()
FileEncryptorHomePage
-int _currentIndex
-List<EncryptedFile> _encryptedFiles
-EncryptionAlgorithm _selectedAlgorithm
-bool _useBiometric
-bool _isBiometricAvailable
+selectAndEncryptFile()
+decryptFile()
+deleteEncryptedFile()
+encryptAES()
+decryptAES()
+encryptSalsa20()
+decryptSalsa20()

2.3 页面导航流程

加密文件
解密文件
通过
失败
解密
删除
应用启动
加密页
快速操作
选择文件
文件列表
设置密码
选择算法
执行加密
加密完成
选择文件
输入密码
生物认证
执行解密
认证失败
解密完成
文件列表页
查看加密文件
操作选择
安全删除
历史记录页
查看操作历史
设置页
查看应用信息
清除所有数据

2.4 文件加密流程

文件系统 加密处理器 文件选择器 加密页 用户 文件系统 加密处理器 文件选择器 加密页 用户 点击加密文件 打开文件选择 显示文件列表 选择文件 返回选中文件 显示密码设置对话框 输入密码和提示 开始加密 读取原文件 返回文件数据 生成加密密钥 执行加密算法 保存加密文件 返回加密结果 显示加密成功

三、核心模块设计

3.1 数据模型设计

3.1.1 加密算法枚举 (EncryptionAlgorithm)
dart 复制代码 
enum EncryptionAlgorithm {
  aes(label: 'AES-256', description: '高级加密标准，安全可靠'),
  salsa20(label: 'Salsa20', description: '流加密算法，速度快'),
  xor(label: 'XOR', description: '简单异或加密，速度快');

  final String label;
  final String description;
  const EncryptionAlgorithm({
    required this.label,
    required this.description,
  });
}
3.1.2 文件状态枚举 (FileStatus)
dart 复制代码 
enum FileStatus {
  normal(label: '普通', color: Colors.grey),
  encrypted(label: '已加密', color: Colors.green),
  decrypted(label: '已解密', color: Colors.blue);

  final String label;
  final Color color;
  const FileStatus({
    required this.label,
    required this.color,
  });
}
3.1.3 加密文件模型 (EncryptedFile)
dart 复制代码 
class EncryptedFile {
  final String id;
  final String originalName;
  final String encryptedName;
  final String originalPath;
  final String? encryptedPath;
  final int originalSize;
  final int? encryptedSize;
  final EncryptionAlgorithm algorithm;
  final DateTime encryptedAt;
  final DateTime? decryptedAt;
  final FileStatus status;
  final String? passwordHint;

  String get formattedOriginalSize => _formatFileSize(originalSize);
  String get formattedEncryptedSize =>
      encryptedSize != null ? _formatFileSize(encryptedSize!) : '';
}
3.1.4 加密算法使用分布

70% 20% 10% 加密算法使用分布示例 AES-256 Salsa20 XOR

3.2 页面结构设计

3.2.1 主页面布局

FileEncryptorHomePage
IndexedStack
加密页
文件列表页
历史记录页
设置页
NavigationBar
加密 Tab
文件 Tab
历史 Tab
设置 Tab

3.2.2 加密页结构

加密页
SliverAppBar
快速操作卡片
算法选择卡片
安全选项卡片
加密统计卡片
加密文件按钮
解密文件按钮
算法单选列表
生物认证开关
已加密数量
已解密数量
总大小

3.2.3 文件列表页结构

文件列表页
SliverAppBar
文件列表
文件卡片
状态图标
文件信息
密码提示
操作按钮

3.3 加密处理逻辑

AES
Salsa20
XOR
开始加密
读取原文件
获取文件数据
选择算法
AES加密
Salsa20加密
XOR加密
生成密钥
生成IV向量
执行加密
合并IV和密文
保存加密文件
返回结果

3.4 解密处理逻辑

是
否
否
是
AES
Salsa20
XOR
否
是
开始解密
需要生物认证?
执行生物认证
输入密码
认证成功?
认证失败
读取加密文件
提取IV向量
选择算法
AES解密
Salsa20解密
XOR解密
生成密钥
执行解密
解密成功?
密码错误
保存解密文件
返回结果

四、UI设计规范

4.1 配色方案

应用以稳重的靛蓝色为主色调，象征安全与信任：

颜色类型 色值 用途
主色 #3F51B5 (Indigo) 导航、主题元素
辅助色 #7986CB 次要按钮
第三色 #C5CAE9 背景装饰
强调色 #303F9F 重要操作
背景色 #FAFAFA 页面背景
卡片背景 #FFFFFF 信息卡片
加密色 #4CAF50 已加密状态
解密色 #2196F3 已解密状态
警告色 #F44336 删除操作

4.2 状态配色

状态 色值 视觉效果
普通 #9E9E9E 灰色
已加密 #4CAF50 绿色
已解密 #2196F3 蓝色

4.3 字体规范

元素 字号 字重 颜色
页面标题 24px Bold 主色
文件名 16px Bold 黑色
文件大小 12px Regular 灰色
状态标签 11px Bold 状态色
按钮文字 14px Medium 白色
提示文字 12px Regular 灰色

4.4 组件规范

4.4.1 快速操作卡片
复制代码 
┌─────────────────────────────────────┐
│  快速操作                              │
│                                     │
│  ┌─────────────┐  ┌─────────────┐  │
│  │     🔒      │  │     🔓      │  │
│  │  加密文件    │  │  解密文件    │  │
│  │ 选择文件加密 │  │ 解密已加密文件│  │
│  └─────────────┘  └─────────────┘  │
└─────────────────────────────────────┘
4.4.2 算法选择卡片
复制代码 
┌─────────────────────────────────────┐
│  加密算法                              │
│                                     │
│  ◉ AES-256                          │
│    高级加密标准，安全可靠       ✓     │
│                                     │
│  ○ Salsa20                          │
│    流加密算法，速度快                │
│                                     │
│  ○ XOR                              │
│    简单异或加密，速度快              │
└─────────────────────────────────────┘
4.4.3 文件卡片
复制代码 
┌─────────────────────────────────────┐
│  [🔒]  重要文档.pdf                  │
│        512 KB → 530 KB              │
│        [已加密] AES-256             │
│                                     │
│  💡 提示: 常用密码                   │
│                                     │
│              [解密]  [删除]          │
└─────────────────────────────────────┘
4.4.4 密码设置对话框
复制代码 
┌─────────────────────────────────────┐
│  设置加密密码                          │
│                                     │
│  ┌─────────────────────────────┐   │
│  │ 🔒 密码                      │   │
│  └─────────────────────────────┘   │
│                                     │
│  ┌─────────────────────────────┐   │
│  │ 💡 密码提示（可选）           │   │
│  └─────────────────────────────┘   │
│                                     │
│           [取消]    [确定]          │
└─────────────────────────────────────┘
4.4.5 加密统计卡片
复制代码 
┌─────────────────────────────────────┐
│  加密统计                              │
│                                     │
│    🔒        🔓        📊          │
│    3         1        2.8 MB       │
│  已加密    已解密     总大小         │
└─────────────────────────────────────┘

五、核心功能实现

5.1 文件选择实现

dart 复制代码 
Future<void> _selectAndEncryptFile() async {
  try {
    final XFile? file = await openFile();
    if (file == null) return;

    final password = await _showPasswordDialog('设置加密密码');
    if (password == null || password.isEmpty) return;

    final inputFile = File(file.path);
    final bytes = await inputFile.readAsBytes();
    final stat = await inputFile.stat();

    final encryptedBytes = await _encryptData(bytes, password);

    final tempDir = await getApplicationDocumentsDirectory();
    final encryptedDir = Directory('${tempDir.path}/encrypted');
    if (!await encryptedDir.exists()) {
      await encryptedDir.create(recursive: true);
    }

    final encryptedFileName = '${file.name}.enc';
    final encryptedFilePath = '${encryptedDir.path}/$encryptedFileName';
    final encryptedFile = File(encryptedFilePath);
    await encryptedFile.writeAsBytes(encryptedBytes);

    // 保存加密文件信息...
  } catch (e) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('加密失败: $e')),
    );
  }
}

5.2 AES加密实现

dart 复制代码 
Uint8List _encryptAES(Uint8List data, String password) {
  final key = encrypt.Key.fromUtf8(password.padRight(32, '0').substring(0, 32));
  final iv = encrypt.IV.fromLength(16);
  final encrypter = encrypt.Encrypter(encrypt.AES(key));

  final encrypted = encrypter.encryptBytes(data, iv: iv);
  return Uint8List.fromList(iv.bytes + encrypted.bytes);
}

Uint8List _decryptAES(Uint8List data, String password) {
  final key = encrypt.Key.fromUtf8(password.padRight(32, '0').substring(0, 32));
  final iv = encrypt.IV(data.sublist(0, 16));
  final encrypter = encrypt.Encrypter(encrypt.AES(key));

  final encrypted = encrypt.Encrypted(data.sublist(16));
  final decrypted = encrypter.decryptBytes(encrypted, iv: iv);
  return Uint8List.fromList(decrypted);
}

5.3 Salsa20加密实现

dart 复制代码 
Uint8List _encryptSalsa20(Uint8List data, String password) {
  final key = encrypt.Key.fromUtf8(password.padRight(32, '0').substring(0, 32));
  final iv = encrypt.IV.fromLength(8);
  final encrypter = encrypt.Encrypter(encrypt.Salsa20(key));

  final encrypted = encrypter.encryptBytes(data, iv: iv);
  return Uint8List.fromList(iv.bytes + encrypted.bytes);
}

Uint8List _decryptSalsa20(Uint8List data, String password) {
  final key = encrypt.Key.fromUtf8(password.padRight(32, '0').substring(0, 32));
  final iv = encrypt.IV(data.sublist(0, 8));
  final encrypter = encrypt.Encrypter(encrypt.Salsa20(key));

  final encrypted = encrypt.Encrypted(data.sublist(8));
  final decrypted = encrypter.decryptBytes(encrypted, iv: iv);
  return Uint8List.fromList(decrypted);
}

5.4 生物认证实现

dart 复制代码 
Future<bool> _authenticateWithBiometric() async {
  try {
    return await _localAuth.authenticate(
      localizedReason: '请进行生物认证以解密文件',
      options: const AuthenticationOptions(
        stickyAuth: true,
        biometricOnly: true,
      ),
    );
  } catch (e) {
    debugPrint('生物认证失败: $e');
    return false;
  }
}

5.5 安全删除实现

dart 复制代码 
Future<void> _deleteEncryptedFile(EncryptedFile fileInfo) async {
  try {
    if (fileInfo.encryptedPath != null) {
      final file = File(fileInfo.encryptedPath!);
      if (await file.exists()) {
        // 安全删除：先覆写随机数据
        final length = await file.length();
        final random = Uint8List(length);
        for (int i = 0; i < length; i++) {
          random[i] = DateTime.now().millisecondsSinceEpoch % 256;
        }
        await file.writeAsBytes(random);
        // 然后删除文件
        await file.delete();
      }
    }

    setState(() {
      _encryptedFiles.removeWhere((f) => f.id == fileInfo.id);
    });
  } catch (e) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('删除失败: $e')),
    );
  }
}

六、交互设计

6.1 文件加密流程

文件系统 加密处理器 文件选择器 加密页 用户 文件系统 加密处理器 文件选择器 加密页 用户 点击加密文件 打开文件选择 返回选中文件 显示密码设置对话框 输入密码 开始加密 读取原文件 返回文件数据 执行加密 保存加密文件 返回结果 显示加密成功

6.2 文件解密流程

是
否
否
是
否
是
点击解密
需要生物认证?
执行生物认证
输入密码
认证成功?
认证失败
读取加密文件
执行解密
解密成功?
密码错误
保存解密文件
显示成功

6.3 安全删除流程

点击取消
点击确定
点击删除
确认对话框
取消
执行删除
读取文件
生成随机数据
覆写文件
删除文件
更新列表

七、扩展功能规划

7.1 后续版本规划

2024-01-07 2024-01-14 2024-01-21 2024-01-28 2024-02-04 2024-02-11 2024-02-18 2024-02-25 2024-03-03 2024-03-10 2024-03-17 2024-03-24 基础UI框架 文件加密功能 生物认证功能 云端加密 批量加密 文件夹加密 加密文件预览 密码强度检测 加密日志导出 V1.0 基础版本 V1.1 增强版本 V1.2 进阶版本 文件加密工具开发计划

7.2 功能扩展建议

7.2.1 云端加密

云加密功能：

  • 云存储文件加密
  • 端到端加密传输
  • 密钥托管服务
  • 多设备同步
7.2.2 批量加密

批量功能：

  • 多文件选择
  • 批量加密处理
  • 统一密码设置
  • 进度显示
7.2.3 文件夹加密

文件夹功能：

  • 整个文件夹加密
  • 自动识别文件类型
  • 递归加密处理
  • 压缩后加密

八、注意事项

8.1 开发注意事项

  1. 密码安全：不要在内存中明文存储密码

  2. 密钥管理：使用安全的密钥派生函数

  3. 文件权限：确保文件读写权限正确

  4. 错误处理：妥善处理加密解密异常

  5. 数据完整性：加密后验证数据完整性

8.2 常见问题

问题 原因 解决方案
加密失败 文件过大 分块处理
解密失败 密码错误 提示用户重试
生物认证失败 设备不支持 使用密码认证
文件损坏 加密中断 添加完整性校验
内存溢出 大文件处理 流式加密

8.3 使用技巧

🔐 文件加密工具使用技巧 🔐

密码设置技巧

  • 使用强密码（字母+数字+符号）
  • 设置有意义的密码提示
  • 定期更换加密密码
  • 不要使用常见密码

加密操作技巧

  • 重要文件优先加密
  • 选择合适的加密算法
  • 记住密码提示信息
  • 定期备份加密文件

安全管理技巧

  • 启用生物认证增强安全
  • 定期清理不需要的加密文件
  • 使用安全删除功能
  • 不要分享加密密码

九、运行说明

9.1 环境要求

环境 版本要求
Flutter SDK >= 3.0.0
Dart SDK >= 2.17.0
鸿蒙OS API 21+
Android API 21+
iOS 12.0+

9.2 依赖配置

在 pubspec.yaml 中添加以下依赖：

yaml 复制代码 
dependencies:
  flutter:
    sdk: flutter
  file_selector: ^1.0.3
  encrypt: ^5.0.3
  local_auth: ^2.3.0
  path_provider: ^2.1.4
  share_plus: ^7.2.2
  intl: ^0.19.0

9.3 运行命令

bash 复制代码 
# 查看可用设备
flutter devices

# 运行到Web服务器
flutter run -d web-server -t lib/main_file_encryptor.dart --web-port 8149

# 运行到鸿蒙设备
flutter run -d 127.0.0.1:5555 lib/main_file_encryptor.dart

# 运行到Android设备
flutter run -d android lib/main_file_encryptor.dart

# 代码分析
flutter analyze lib/main_file_encryptor.dart

9.4 权限配置

Android权限 (android/app/src/main/AndroidManifest.xml)
xml 复制代码 
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.USE_BIOMETRIC" />
<uses-permission android:name="android.permission.USE_FINGERPRINT" />
iOS权限 (ios/Runner/Info.plist)
xml 复制代码 
<key>NSFaceIDUsageDescription</key>
<string>需要面容识别权限以解密文件</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>需要相册权限选择文件</string>

十、总结

文件加密工具应用通过整合文件选择、密码加密、生物认证、安全删除等功能，为用户提供了一站式的文件安全解决方案。应用支持AES-256、Salsa20、XOR三种加密算法，满足不同安全等级需求，用户可设置密码保护并选配生物认证增强安全性。

核心功能涵盖文件选择、文件加密、文件解密、密码保护、密码提示、生物认证、加密历史、安全删除、加密统计九大模块。用户可以轻松选择文件、设置密码、加密保护、管理加密文件，实现文件的安全管理。

应用采用 Material Design 3 设计规范，以稳重的靛蓝色为主色调，象征安全与信任。通过本应用，希望能够帮助用户更安全地保护敏感文件，确保数据安全不被泄露。

文件加密工具------守护您的数据安全

相关推荐
key_3_feng3 小时前
HarmonyOS 6.0 健康食谱应用开发方案
华为·harmonyos
麒麟ZHAO3 小时前
鸿蒙flutter第三方库适配 - 文件对比工具
数据库·redis·flutter·华为·harmonyos
互联网散修3 小时前
零基础鸿蒙应用开发第三十四节：MVVM架构下的商品管理登录页
架构·harmonyos·mvvm·登录
weixin_443478513 小时前
Flutter组件学习之图表
学习·flutter·信息可视化
猿饵块3 小时前
flutter--基础环境安装
flutter
弓.长.4 小时前
ReactNative for OpenHarmony项目鸿蒙化三方库：react-native-svg(CAPI) — 矢量图形组件
react native·react.js·harmonyos
不爱吃糖的程序媛4 小时前
鸿蒙三方库适配HPKCHECK 文件执行流程详解
华为·harmonyos
见山是山-见水是水4 小时前
Flutter 框架跨平台鸿蒙开发 - 电子发票智能管理
flutter·华为·harmonyos
HarmonyOS_SDK4 小时前
化繁为简：顺丰速运App如何通过 HarmonyOS SDK实现专业级空间测量
harmonyos
热门推荐
012026年4月技术前沿：AI大模型爆发、智能体革命与量子安全新纪元02GitHub 镜像站点03一周AI热点速览（2026.03.31-04.06）：GPT-6曝光、谷歌开源Gemma 4、资本狂飙与模型军备竞赛04基于 Docker 部署 Hermes Agent 并接入飞书机器人的完整指南05免费！不限量！用opencode接入英伟达（NVIDIA）大模型，轻松打造你的 AI 编程助手06AI Weekly | 2026年4月第二周 · GitHub热门项目与AI发展趋势深度解析07Oh My Codex 快速使用指南08CodeBuddy与WorkBuddy深度对比：腾讯两款AI工具差异及实操指南09从限购到畅通：GLM-5.1 Coding Plan接入攻略10VMware Workstation Pro 17 虚拟机完整安装教程（2026最新）