1. 项目概述与背景
Flutter作为Google推出的跨平台UI框架,凭借其高效的渲染性能和"一次编写,多端运行"的特性,已经成为移动开发领域的重要选择。而鸿蒙OS(HarmonyOS)作为华为自主研发的分布式操作系统,正在构建自己的生态体系。将Flutter与鸿蒙结合,可以实现代码在Android、iOS和鸿蒙三大平台上的复用,大幅提升开发效率。
在这个项目中,我们重点解决Flutter应用在鸿蒙平台上的网络请求实现。网络请求作为移动应用的基础功能,其稳定性和易用性直接影响开发体验。Dio作为Flutter生态中最受欢迎的HTTP客户端库之一,提供了强大的网络请求能力和灵活的扩展接口,非常适合作为跨平台开发的网络请求解决方案。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与项目初始化
2.1 开发环境配置
在开始Flutter鸿蒙跨端开发前,需要确保开发环境正确配置:
-
Flutter SDK安装:
- 下载最新稳定版Flutter SDK(当前推荐3.19.0+)
- 解压后添加flutter/bin目录到系统PATH环境变量
- 运行
flutter doctor检查基础环境
-
鸿蒙开发环境:
- 安装DevEco Studio 3.1或更高版本
- 配置鸿蒙SDK(API Version 9+)
- 安装OHOS工具链(通过DevEco Studio的SDK Manager)
-
IDE选择:
- Android Studio(推荐安装Flutter和Dart插件)
- 或VS Code(安装Flutter扩展)
提示:鸿蒙平台开发需要额外配置OHOS工具链,这是与常规Flutter开发的主要区别点。确保在DevEco Studio中正确安装OHOS SDK。
2.2 创建Flutter鸿蒙项目
在终端执行以下命令创建支持鸿蒙平台的Flutter项目:
bash复制flutter create --platform ohos xiu_mall
关键参数说明:
--platform ohos:指定项目支持鸿蒙平台- 项目名称(xiu_mall)使用小写字母和下划线组合
创建完成后,项目结构如下:
code复制xiu_mall/
├── android/ # Android平台代码
├── ios/ # iOS平台代码
├── ohos/ # 鸿蒙平台特有代码
├── lib/ # 跨平台Dart代码
└── pubspec.yaml # 项目依赖配置文件
2.3 项目目录结构优化
为提高代码可维护性,我们采用功能模块化的目录结构:
bash复制lib/
├── api/ # 网络请求相关
│ ├── cat_api.dart # 猫咪API服务
│ └── http_util.dart # Dio封装
├── components/ # 公共UI组件
│ └── cat_card.dart # 猫咪卡片组件
├── constants/ # 常量配置
│ └── api_constants.dart
├── models/ # 数据模型
│ └── cat_model.dart
├── pages/ # 页面组件
│ ├── cats/ # 猫咪页面
│ ├── login/ # 登录页面
│ └── main/ # 主页面
├── routes/ # 路由配置
│ └── index.dart
├── stores/ # 状态管理
│ └── cat_store.dart
└── main.dart # 应用入口
这种结构清晰分离了不同职责的代码,便于团队协作和后续功能扩展。
3. Dio网络请求架构实现
3.1 Dio库集成与基础配置
3.1.1 添加依赖
在pubspec.yaml中添加Dio和Provider(状态管理)依赖:
yaml复制dependencies:
flutter:
sdk: flutter
dio: ^5.5.0 # 网络请求库
provider: ^6.1.2 # 状态管理
cached_network_image: ^3.3.0 # 图片缓存
执行flutter pub get安装依赖。
3.1.2 基础Dio封装
创建lib/api/http_util.dart实现Dio的基础封装:
dart复制import 'package:dio/dio.dart';
class HttpUtil {
static final HttpUtil _instance = HttpUtil._internal();
late Dio _dio;
factory HttpUtil() => _instance;
HttpUtil._internal() {
_dio = Dio(BaseOptions(
connectTimeout: const Duration(seconds: 15),
receiveTimeout: const Duration(seconds: 15),
headers: {
'Content-Type': 'application/json',
},
));
// 添加拦截器
_dio.interceptors.add(InterceptorsWrapper(
onRequest: (options, handler) {
// 可在此添加统一请求头
return handler.next(options);
},
onResponse: (response, handler) {
// 统一处理响应数据
return handler.next(response);
},
onError: (DioException e, handler) {
// 统一错误处理
return handler.next(e);
},
));
}
Future<dynamic> get(String url, {Map<String, dynamic>? params}) async {
try {
final response = await _dio.get(url, queryParameters: params);
return response.data;
} on DioException catch (e) {
throw _handleError(e);
}
}
String _handleError(DioException e) {
switch (e.type) {
case DioExceptionType.connectionTimeout:
return '连接超时,请检查网络';
case DioExceptionType.badResponse:
return '服务器错误: ${e.response?.statusCode}';
default:
return '网络请求失败: ${e.message}';
}
}
}
关键设计点:
- 使用单例模式确保全局只有一个Dio实例
- 配置合理的超时时间(15秒)
- 添加拦截器实现统一请求/响应处理
- 封装基础GET方法,其他HTTP方法类似实现
3.2 网络请求架构设计
3.2.1 分层架构设计
我们采用典型的三层架构:
- 数据层:负责原始网络请求(HttpUtil)
- 服务层:业务API封装(如CatApi)
- 展示层:UI调用和状态管理
dart复制// 数据层调用示例
final data = await HttpUtil().get('https://api.example.com/data');
// 服务层封装示例
class C
