FAQ
环境搭建问题
- 执行 Flutter 命令时报错 Error: The Flutter directory is not a clone of the GitHub project
- 执行 Flutter 命令时报错 Error: Unable to find git in your PATH
- 遇到 [!] No Hmos SDK found. Try setting the HOS_SDK_HOME enviroment variable. 报错
- 断网环境 flutter pub get 执行失败
- 【Windows】flutter pub get 报错 Package not available（长路径问题）
- mac环境release版本的应用编译失败
- flutter从Windows复制到linux或mac环境后无法运行
- ~/.npmrc 的配置
- ~/.ohpmrc 的配置
- 模拟器运行默认计数器应用闪退
- [ios][release] GeneratedPluginRegistrant.m Module not found
- 【Windows】flutter doctor -v 无反应
- 执行 flutter upgrade 报错
Engine编译问题
应用编译构建问题
- 使用 Flutter 命令行编译构建应用报错
- 拷贝或克隆其他 Flutter OH 项目到本地后无法运行
- 配置别名，简化日常开发的编译命令
- 应用编译成功，安装后出现白屏的情况
- 应用编译报错，flutter插件结构重构前的版本使用了重构后的插件库
- Flutter编译插件时引入预编译so包，so包未打入har包
- flutter pub get 依赖冲突报错
- flutter三方库依赖错误
- The SDK license agreement is not accepted
- 通过 flutter build hap --release 编译版本会导致 app.json versionName 字段重置
- 应用编译报错flutter工程和依赖的插件工程不是在同一个磁盘
- Note that you need plugins to import files that are not JavaScript
- DevEco工具同步或者运行Flutter新模板工程依赖的插件与SDK不在一个磁盘
签名与发布问题
- Flutter OH 项目自动签名报错
- 通过 flutter build hap --release 编译版本会导致 app.json versionName 字段重置
- Release 构建异常（闪退或仍处于调试模式）
- 上线包使用了 debug 版本的 flutter.har 导致运行闪退
- 权限与 Profile
代码开发问题
- dart代码中判断当前平台是否是ohos
- 代码中存在Platform.isOhos会导致flutter run、flutter build har、flutter attach失败
- Flutter OpenHarmony原生端获取到图片资源
- flutter inappwebview设置高度后网页内容被拉伸
- Flutter项目如何适配折叠屏
- Flutter项目启动闪退
- 设置启动页后加载 Flutter 页面出现闪动
- 插件工程的 ohos 目录无法在 DevEco 中同步
- 5.0系统无法显示视频缩略图
三方库与插件适配问题
- 插件工程的 ohos 目录无法在 DevEco 中同步
- flutter pub get 依赖冲突报错
- FFI 插件通过 git 引入后 har 未打入 so 包
- Flutter 插件调用报 MissingPluginException
渲染引擎与UI问题
- flutter inappwebview 设置高度后网页内容被拉伸
- Tab组件（TabBar/TabBarView）使用注意事项（手势冲突）
- Flutter 项目如何适配折叠屏
- 设置启动页后加载 Flutter 页面出现闪动
- 鸿蒙端使用 flutter_svg 渲染 SVG 时出现锯齿
- 物理键盘 Numlock、Capslock、ScrollLock 暂不支持
运行问题
- 编译OpenHarmony后运行出现运行时错误
- app包安装成功后，运行闪退
- 应用编译成功，安装后出现白屏的情况
- 开启混淆导致白屏/闪退场景
- app包安装成功后，运行时在启动，页面切换等场景下出现短暂一帧的闪黑屏/白屏
- 页面顶部区域出现安全避让区异常