Flutter-OH 原生代码断点调试指导

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

本文介绍如何在 DevEco Studio 中对 Flutter OH 应用的 ohos 平台化代码 进行断点调试，包括项目内 ArkTS 代码、Flutter SDK 适配层以及三方库的 ohos 缓存代码。

一、前置条件

• 已安装 DevEco Studio（建议使用支持 OpenHarmony/鸿蒙的版本）
• 已创建 Flutter OH 应用项目，并能正常编译运行
• 已连接真机或已启动 OpenHarmony 模拟器

二、调试项目内的 ohos 平台化代码

1. 用 DevEco Studio 打开 ohos 工程

• 使用 DevEco Studio 打开 Flutter 项目下的 ohos 目录（不要打开整个 Flutter 项目根目录）。

  

• 在工程中定位并打开需要调试的 ArkTS/TS 文件。

  

2. 设置断点

• 在目标代码行的行号左侧单击，出现红色圆点即表示断点已设置。

  

• 建议在以下位置设置断点：函数入口、关键变量赋值处、事件回调内、平台通道（Method Channel / FFI）调用处。

3. 启动调试

• 在 DevEco Studio 顶部选择运行目标：真机或模拟器。

  

• 点击工具栏上的 「调试」 按钮（绿色虫子图标），启动调试会话。

  

• 工程将自动编译并部署到设备，应用启动后执行到断点处会自动暂停，此时可查看变量、调用栈、单步执行等。

  

三、调试 Flutter OH 平台缓存代码

如需排查 Flutter SDK 或三方库的 ohos 适配层问题，可直接对缓存目录中的源码设断点调试。

1. 调试 Flutter SDK 的 ohos 适配层

• 缓存路径（请将 Flutter项目 替换为你的项目根目录）：

  Flutter项目/ohos/oh_modules/.ohpm/@ohos+flutter_ohos/oh_modules/@ohos/flutter_ohos

  

• 在该路径下打开需要调试的 ArkTS/TS 文件，按 「二」 中步骤 2、3 设置断点并启动调试即可。

说明：此处为 SDK 的本地缓存，修改仅对当前项目生效；升级 Flutter OH 或执行 flutter pub get 等操作可能覆盖或更新缓存内容。

2. 调试三方库的 ohos 适配层

• 缓存路径：Flutter项目/ohos/oh_modules

• 在 oh_modules 下找到目标三方库对应的 ohos 实现目录，打开需要调试的源码文件，同样按 「二」 中步骤 2、3 设置断点并启动调试。

四、常见问题与解决

五、小结

• 项目内 ohos 代码：用 DevEco Studio 打开 ohos 目录 → 设断点 → 选设备 → 点「调试」。
• SDK/三方库缓存代码：在 ohos/oh_modules 或 SDK 缓存路径下打开对应源码，按同样方式调试即可。
• 遇到断点不生效时，优先确认是 Debug 构建且断点落在实际执行路径上；复杂问题建议真机调试。