第一阶段笔记

【Flutter for OpenHarmony】开源鸿蒙跨平台训练营Day1-Flutter开发环境配置https://blog.csdn.net/2601_95069475/article/details/157325720?spm=1001.2014.3001.5501https://blog.csdn.net/2601_95069475/article/details/157325720?spm=1001.2014.3001.5501

【Flutter for OpenHarmony】开源鸿蒙跨平台训练营Day2-多终端工程创建运行、代码提交至AtomGit平台自建公开仓库https://blog.csdn.net/2601_95069475/article/details/157331750?spm=1001.2014.3001.5501https://blog.csdn.net/2601_95069475/article/details/157331750?spm=1001.2014.3001.5501【Flutter for OpenHarmony】开源鸿蒙跨平台训练营Day3-Flutter请求网络，实现数据清单列表https://blog.csdn.net/2601_95069475/article/details/157390233?spm=1001.2014.3001.5501https://blog.csdn.net/2601_95069475/article/details/157390233?spm=1001.2014.3001.5501【Flutter for OpenHarmony】开源鸿蒙跨平台训练营Day4-6 -基于day3实现列表清单上拉加载、下拉刷新及数据加载提示能力https://blog.csdn.net/2601_95069475/article/details/157430261?spm=1001.2014.3001.5501https://blog.csdn.net/2601_95069475/article/details/157430261?spm=1001.2014.3001.5501

第一阶段知识点梳理

一、环境搭建核心技能

1.多工具协同配置：掌握 Visual Studio Code、Git、DevEco Studio、Java 17、Android Studio 的安装与环境变量联动配置，理解各工具在 Flutter for OpenHarmony 开发中的角色（如 DevEco Studio 负责鸿蒙 SDK 管理、Java 17 提供运行时支持）。

2.源码克隆与依赖管理：通过 Git Bash 克隆 OpenHarmony 版 Flutter 源码，解决依赖下载源配置、版本兼容性问题（如 Dart SDK 与 json_serializable 版本匹配）。

3.模拟器与真机适配：完成 HarmonyOS 模拟器创建（手机 / 平板 / 手表等多终端），掌握 ADB 工具验证与设备连接调试方法。

二、工程开发与版本控制

1.多终端工程创建：基于 DevEco Studio 创建 OpenHarmony 跨平台工程，配置 Bundle 名称、兼容 SDK 版本、多设备类型适配参数。

2.Git 与 AtomGit 操作：掌握 SSH 密钥生成与配置、仓库创建、代码提交（add/commit/push）、分支管理规范，理解.gitignore 文件配置与开源许可证选择逻辑。

3.工程编译与部署：熟悉 DevEco Studio 编译流程，解决编译缓存、模块依赖冲突问题，实现多终端部署验证。

三、功能开发核心能力

1.网络请求集成：掌握 Dio、http 等网络库接入流程，理解 pubspec.yaml 依赖配置规则，解决网络权限声明、跨域请求等问题。

2.数据处理与解析：基于 json_annotation 实现 JSON 数据模型序列化 / 反序列化，使用 build_runner 生成解析代码，处理数据格式不匹配、空字段等异常。

3.列表 UI 构建：使用 Flutter ListView、Card 组件实现数据清单展示， 处理图片加载，实现列表项点击交互。

4.高级交互实现：开发下拉刷新、上拉加载更多功能，设计全场景加载提示（初始加载 / 刷新中 / 加载失败 / 无更多数据）。

第一阶段开发问题及解决办法总结

问题排查

1.环境类问题：解决 SDK 版本不兼容、环境变量配置错误、依赖下载失败等问题，掌握 flutter clean、flutter pub get 等命令的使用场景。

2.编译类问题：排查代码语法错误、模块配置冲突、资源文件缺失等编译失败原因，理解日志分析方法。

3.运行类问题：处理模拟器启动失败、应用安装失败、数据加载异常等问题，优化 UI 渲染性能（如列表卡顿、动画不流畅）。

问题解决

环境搭建类问题

1. 工具安装验证失败

问题：Git/Java/Android Studio 安装后，命令行输入验证命令（如git --version）提示 "不是内部或外部命令"。

解决办法：检查系统环境变量 Path 路径，确认已添加工具的可执行文件目录（如 Git 的 cmd 目录、Java 的 bin 目录）；重启命令行或电脑使配置生效；若仍失败，重新安装工具并勾选 "添加到系统 PATH" 选项。

2. 环境变量配置错误

问题：配置 JAVA_HOME/ANDROID_HOME 后，DevEco Studio/Android Studio 无法识别对应 SDK/JDK。

解决办法：确认变量值为工具安装根目录；检查 Path 路径中已添加%JAVA_HOME%\bin、%ANDROID_HOME%\platform-tools等子目录；通过echo %JAVA_HOME%命令验证变量是否生效。

3. 依赖下载失败

问题：执行flutter pub get时，依赖包下载提示 "无法连接到 pub.dev"。

解决办法：检查网络连接，关闭代理或 VPN；若单个依赖下载失败，单独执行flutter pub add 依赖名:版本号强制指定版本下载。

4. 模拟器启动失败

问题：模拟器启动时提示 "虚拟化未开启"。

解决办法：进入 BIOS 开启 CPU 虚拟化功能；更新显卡驱动。

工程与版本控制类问题

1. Flutter 工程无法识别

问题：执行flutter pub add http时，提示 "Expected to find project root in current working directory"。

解决办法：确认当前目录包含 pubspec.yaml 文件，若无则通过flutter create --platforms ohos 工程名创建标准鸿蒙适配工程；切换至工程根目录后重新执行命令。

2. Git 提交权限不足

问题：向 AtomGit 仓库 push 代码时，提示 "Permission denied (publickey)"。

解决办法：重新生成 SSH 密钥对；复制公钥内容到 AtomGit 账户的 SSH 公钥配置中；通过ssh -T git@gitcode.com验证连接，成功提示 "Welcome to GitCode" 即可。

3. 依赖版本冲突

问题：执行flutter pub get时，提示 "Dart SDK version solving failed"。

解决办法：降低冲突依赖版本，选择与当前 Dart SDK 兼容的版本；在 pubspec.yaml 中明确指定兼容的 SDK 版本范围。

4. 多终端工程部署失败

问题：工程在手机模拟器运行正常，在平板 / 手表模拟器运行时提示 "安装失败" 或界面错乱。

解决办法：检查工程的 Compatible SDK 版本是否与模拟器 API 版本匹配；针对小屏幕终端（如手表）优化 UI 布局（减小字体、图片尺寸，简化列表项结构）；在 DevEco Studio 中确认设备类型已勾选对应终端（如 Phone、Tablet、Wearable）。

功能开发类问题

1. 网络请求失败

问题：调用 Dio 接口时，提示 "ConnectionTimeout" 。

解决办法：检查接口地址是否正确；确认网络连接正常，鸿蒙应用已获取网络权限。

2. JSON 解析失败

问题：网络请求返回数据后，无法转换为 ScenicSpotModel 模型，提示 "Missing required key"。

解决办法：检查 JSON 字段与模型类字段是否一致，确保模型类所有 required 字段在 JSON 中均存在，无空值；重新生成解析代码，确保 scenic_spot_model.g.dart 文件正确生成。

编译与运行类问题

1. 编译缓存导致的错误

问题：修改代码后重新编译，仍运行旧版本功能或提示编译错误。

解决办法：执行flutter clean清除编译缓存和依赖缓存；重新执行flutter pub get获取最新依赖；关闭 DevEco Studio 和 VS Code，删除工程目录下的.build 和.dart_tool 文件夹后重新打开工程。

2. 鸿蒙应用启动失败

问题：执行flutter run后，应用安装成功但无法启动，提示 "Ability not found"。

解决办法：检查 module.json5 中 abilities 配置的 srcEntry 路径是否正确；确认 Bundle 名称与工程配置一致。

 相关资料

Windows 11 OpenHarmony 版 Flutter 开发环境搭建完整指南（内含VScode代码编辑器、Git版本控制工具、Java、Android S tudio、HarmonyOS/OpenHarmony开发IDE安装）
https://bxming.blog.csdn.net/article/details/156203074https://bxming.blog.csdn.net/article/details/156203074Windows 11 OpenHarmony 版 Flutter 开发环境搭建常见问题解决方法https://bxming.blog.csdn.net/article/details/156203132https://bxming.blog.csdn.net/article/details/156203132

---

欢迎加入开源鸿蒙跨平台社区 https://openharmonycrossplatform.csdn.net