Flutter在OpenHarmony开发电子合同App实践-育师

1. 项目背景与核心需求

在移动应用开发领域，跨平台框架Flutter因其高效的渲染性能和一致的UI体验备受开发者青睐。而OpenHarmony作为国产分布式操作系统，正在构建自主可控的生态体系。将Flutter应用于OpenHarmony平台开发电子合同签署App，既能复用Flutter丰富的跨平台能力，又能满足国产化环境下的合规需求。

电子合同签署的核心业务流程通常包括：

合同模板管理与在线编辑
签署方身份认证（短信/活体检测/CA证书）
合同内容哈希值计算与存证
签署行为可视化记录
合同归档与验真服务

这些功能高度依赖后端API的稳定集成。在OpenHarmony环境下，还需要特别注意：

系统权限申请的特殊处理
国产加密算法的适配支持
分布式设备间的数据同步机制

2. 环境搭建与工程初始化

2.1 Flutter for OpenHarmony环境配置

首先需要搭建支持OpenHarmony的Flutter开发环境：

# 安装OHOS专用Flutter SDK git clone -b ohos https://gitee.com/openharmony-sig/flutter_flutter.git export PATH="$PATH:`pwd`/flutter/bin" # 安装OHOS工具链 flutter doctor --android-licenses flutter config --enable-ohos

常见问题解决方案：

网络资源下载失败：修改flutter/packages/flutter_tools/gradle/flutter.gradle中的仓库地址为国内镜像
Gradle卡顿：在android/build.gradle中添加阿里云镜像：
```
maven { url 'https://maven.aliyun.com/repository/public' }
```
权限问题：对/opt/harmony目录执行chmod -R 777授权

2.2 工程创建与基础配置

创建支持OHOS的Flutter工程：

flutter create --platforms=ohos contract_signer cd contract_signer

关键配置文件调整：

ohos/config.json中添加网络权限：

"reqPermissions": [ { "name": "ohos.permission.INTERNET" } ]

pubspec.yaml声明依赖：

dependencies: dio: ^5.3.2 # HTTP客户端 crypto: ^3.0.3 # 哈希计算 pointycastle: ^3.7.1 # 国密算法支持

3. API通信层设计与实现

3.1 网络请求封装

采用Dio实现带加密签名的请求拦截器：

class APIClient { final Dio _dio = Dio(BaseOptions( baseUrl: 'https://api.contract.com/v1', connectTimeout: const Duration(seconds: 10), )); void _addSignInterceptor() { _dio.interceptors.add(InterceptorsWrapper( onRequest: (options, handler) async { // 生成请求签名 final timestamp = DateTime.now().millisecondsSinceEpoch; final nonce = Uuid().v4(); final sign = _generateSign( method: options.method, path: options.path, timestamp: timestamp, nonce: nonce, ); options.headers.addAll({ 'X-App-Key': appKey, 'X-Timestamp': timestamp, 'X-Nonce': nonce, 'X-Signature': sign, }); return handler.next(options); }, )); } String _generateSign({required String method, required String path, required int timestamp, required String nonce}) { final content = '$method|$path|$timestamp|$nonce'; return crypto.sha256.convert(utf8.encode(content)).toString(); } }

3.2 国密算法适配

在OpenHarmony环境下需支持SM2/SM3/SM4算法：

import 'package:pointycastle/api.dart'; import 'package:pointycastle/asymmetric/api.dart'; import 'package:pointycastle/asymmetric/sm2.dart'; class SM2Util { static Uint8List encrypt(String plaintext, String publicKey) { final keyParser = SM2PublicKeyParser(); final pubKey = keyParser.parse(publicKey); final cipher = SM2Engine() ..init(true, PublicKeyParameter<SM2PublicKey>(pubKey)); return cipher.process(utf8.encode(plaintext) as Uint8List); } }

4. 核心业务API集成

4.1 合同模板API

实现模板列表获取与预览：

Future<List<ContractTemplate>> fetchTemplates() async { final response = await _dio.get('/templates'); return (response.data['data'] as List) .map((e) => ContractTemplate.fromJson(e)) .toList(); } Future<Uint8List> previewTemplate(String templateId) async { final response = await _dio.get( '/templates/$templateId/preview', options: Options(responseType: ResponseType.bytes), ); return response.data; }

4.2 签署流程API

完整的电子签署流程实现：

class SignService { Future<SignSession> createSession({ required String templateId, required List<Signer> signers, }) async { final response = await _dio.post('/sessions', data: { 'template_id': templateId, 'signers': signers.map((e) => e.toJson()).toList(), }); return SignSession.fromJson(response.data['data']); } Future<void> addSeal(String sessionId, Uint8List sealImage) async { final formData = FormData.fromMap({ 'seal': MultipartFile.fromBytes(sealImage, filename: 'seal.png'), }); await _dio.post('/sessions/$sessionId/seal', data: formData); } Future<Contract> confirmSign(String sessionId) async { final response = await _dio.post('/sessions/$sessionId/confirm'); return Contract.fromJson(response.data['data']); } }

5. OpenHarmony特性适配

5.1 分布式设备协同

利用OHOS的分布式能力实现多设备签署：

import 'package:ohos_distributed/distributed.dart'; class DistributedSigner { final DistributedManager _manager = DistributedManager(); Future<void> shareSession(String deviceId, String sessionId) async { await _manager.transferData( deviceId, { 'type': 'contract_session', 'session_id': sessionId, }, onSuccess: () => print('Session shared successfully'), ); } }

5.2 系统级安全存储

使用OHOS的安全存储保存敏感数据：

import 'package:ohos_security/security.dart'; class SecureStorage { static Future<void> saveToken(String token) async { await SecurityStore.putString( key: 'auth_token', value: token, options: SecurityOptions( encrypt: true, authRequired: true, ), ); } }

6. 性能优化实践

6.1 图片缓存策略

针对合同预览图片的缓存优化：

class CachedImageProvider extends ImageProvider<CachedImageProvider> { final String url; final MemoryCache cache = MemoryCache(); Future<Uint8List> _downloadImage() async { if (cache.contains(url)) return cache.get(url); final response = await dio.get(url, options: Options(responseType: ResponseType.bytes)); cache.set(url, response.data); return response.data; } }

6.2 请求合并与节流

对高频操作如签署状态检查进行优化：

class ThrottledAPI { final Map<String, DateTime> _lastCallTimes = {}; Future<T> throttle<T>(String key, Future<T> Function() fn, {Duration threshold = const Duration(seconds: 1)}) async { final now = DateTime.now(); if (_lastCallTimes.containsKey(key)) { final elapsed = now.difference(_lastCallTimes[key]!); if (elapsed < threshold) { await Future.delayed(threshold - elapsed); } } _lastCallTimes[key] = now; return fn(); } }

7. 调试与问题排查

7.1 常见API错误处理

try { await signService.confirmSign(sessionId); } on DioException catch (e) { if (e.response?.statusCode == 401) { showAuthError(); } else if (e.type == DioExceptionType.connectionTimeout) { showNetworkError(); } } on SM2Exception catch (e) { logger.error('国密算法异常: ${e.message}'); }

7.2 网络抓包调试

配置Charles代理进行HTTPS抓包：

void enableProxy() { (dio.httpClientAdapter as DefaultHttpClientAdapter).onHttpClientCreate = (client) { client.findProxy = (uri) => "PROXY 192.168.1.100:8888"; client.badCertificateCallback = (cert, host, port) => true; // 仅调试使用 return client; }; }

在项目开发过程中，我发现OpenHarmony的权限管理比Android更加严格，特别是涉及分布式能力调用时，必须提前在config.json中声明所有需要的权限。另外，Flutter的热重载功能在OHOS平台上有时会出现状态丢失的问题，建议在开发重要业务逻辑时使用全量重启保证稳定性。