课程简介

本课程基于一个真实的项目 CleanMark AI（AI 智能去水印工具），从零开始讲解如何使用 Flutter 开发一个支持 Android、iOS 和 HarmonyOS 三端的跨平台应用。

项目特点：

• 完整的商业应用流程（12个页面）
• 积分制付费模式
• AI 图片/视频处理
• 华为广告 SDK 集成
• Clean Architecture 架构
• HarmonyOS NEXT 适配

适合人群：

• 有 Flutter 基础，想学习 HarmonyOS 适配的开发者
• 想了解跨平台开发最佳实践的工程师
• 需要快速上手商业项目开发的团队

---

课程目录

第一部分：项目基础（3篇）

第01篇：项目架构设计与技术选型

• 为什么选择 Flutter + HarmonyOS
• Clean Architecture 在 Flutter 中的实践
• 技术栈选型：Riverpod vs Bloc vs Provider
• 项目目录结构设计
• 开发环境搭建（Flutter SDK + DevEco Studio）

第02篇：路由与状态管理实战

• go_router 路由配置与页面跳转
• Riverpod 状态管理最佳实践
• 用户登录状态管理
• 积分系统的状态设计
• 路由守卫与权限控制

第03篇：UI 设计规范与主题系统

• 深色模式设计规范
• 自定义主题系统实现
• 渐变色与卡片设计
• 响应式布局适配
• 常用组件封装（按钮、输入框、卡片）

---

第二部分：HarmonyOS 适配（4篇）

第04篇：HarmonyOS 平台差异与适配策略

• HarmonyOS NEXT 与 Android/iOS 的差异
• Platform Channel 通信机制
• ArkTS 与 Dart 的数据交互
• 平台判断与条件编译
• 适配层设计模式

第05篇：图片选择器的三端适配实战

• image_picker 插件架构分析
• Android 平台实现（Kotlin）
• iOS 平台实现（Swift）
• HarmonyOS 平台实现（ArkTS）
• 统一接口设计与错误处理

第06篇：本地存储的跨平台实现

• shared_preferences 插件原理
• Android SharedPreferences 封装
• iOS UserDefaults 封装
• HarmonyOS Preferences 封装
• 数据迁移与版本管理

第07篇：视频播放器的 HarmonyOS 适配

• video_player 插件架构
• HarmonyOS AVPlayer API 使用
• 视频控制器实现
• 播放状态管理
• 性能优化与内存管理

---

第三部分：核心功能实现（5篇）

第08篇：启动页与引导页的动画实现

• 启动页渐变动画
• 引导页滑动切换
• 进度指示器设计
• 首次启动判断
• 页面跳转动画

第09篇：图片去水印功能实战

• 图片上传与预览
• 手绘遮罩功能实现
• BBox 坐标转换
• 图片对比滑动组件
• 处理进度展示

第10篇：视频去水印与进度管理

• 视频文件选择与验证
• 环形进度条实现
• 模拟处理进度
• 视频结果展示
• 保存到相册功能

第11篇：积分系统与广告集成

• 积分业务规则设计
• 华为广告 SDK 集成
• 激励视频广告实现
• 积分历史记录
• 交易流水展示

第12篇：历史记录与任务管理

• 任务列表设计
• 图片/视频记录分类
• 状态徽章组件
• 详情页实现
• 删除与重新下载

---

第四部分：工程化与优化（3篇）

第13篇：网络请求与错误处理

• dio 拦截器配置
• Token 自动刷新
• 统一错误处理
• 网络状态监听
• 请求重试机制

第14篇：性能优化与内存管理

• 图片缓存策略
• 列表性能优化
• 内存泄漏排查
• 启动速度优化
• 包体积优化

第15篇：测试与发布

• 单元测试编写
• Widget 测试实践
• HarmonyOS 打包配置
• 应用签名与上架
• 多渠道打包

---

学习路径建议

初级开发者（0-6个月 Flutter 经验）

建议学习顺序：01 → 02 → 03 → 08 → 09 → 10

中级开发者（6-12个月 Flutter 经验）

建议学习顺序：01 → 04 → 05 → 06 → 07 → 11 → 12 → 13

高级开发者（1年以上 Flutter 经验）

建议学习顺序：04 → 05 → 06 → 07 → 14 → 15

---

配套资源

• 完整源码：GitCode源码
• 答疑社群：微信群

---

课程特色

✅ 真实项目驱动：不是 Demo，是可以直接上线的商业项目
✅ 三端适配实战：Android/iOS/HarmonyOS 完整适配方案
✅ 最佳实践总结：避坑指南，节省你的开发时间
✅ 代码规范严格：遵循 Flutter 官方规范和 Clean Architecture
✅ 持续更新：跟随 Flutter 和 HarmonyOS 版本更新

---

预计学习时长

• 快速通读：3-5 天（每天 2-3 小时）
• 深度学习：2-3 周（每天 2-3 小时）
• 项目实战：1-2 个月（边学边做）

---

作者寄语

这套课程凝聚了我在 Flutter 跨平台开发中的实战经验，特别是 HarmonyOS 适配部分，踩过很多坑，也总结了很多经验。

希望这套课程能帮助你快速掌握 Flutter + HarmonyOS 开发，少走弯路，早日上线自己的应用。

如果你在学习过程中遇到问题，欢迎在 GitCode 提 Issue 或加入答疑群交流。

让我们开始这段跨平台开发之旅吧！ 🚀

---

下一篇预告：第01篇 - 项目架构设计与技术选型