前言前两篇解决了「SDK 怎么装」第 1 篇用fvm fork别名直装 tag一条命令实测 1 分 49 秒端到端第 2 篇是不依赖 fvm 的手动 bootstrap 兜底路。装好 SDK 只是开始——让 HAP 构建出来、装进设备、画面真正跑起来才是消费侧的最后一关也是坑最集中的一关。本篇覆盖从环境准备到运行验证的完整链路三件套工具链hdc / ohpm / hvigor与 PATH 配置模拟器127.0.0.1:5555的 HAP 安装与flutter run直跑没有真机证书时怎么用占位签名出可安装的 HAPhdc shell snapshot_display截图取证以及模拟器的能力边界。文末附消费侧CP1-CP14 踩坑全收录前两篇散落提到的坑在这里汇总成权威速查表。全部环境数据来自本机实测macOS DevEco Studio26.0.0 Release OpenHarmony SDK/API262026-10 记录。Flutter OH 适配版当前为3.47.8-ohos-1.0.0环境搭建见 OpenHarmony-flutter 环境搭建指导。背景提示ohos Flutter 是社区分叉三层架构、三个接缝、七层适配工作见第 1 篇第一章SDK 安装与版本核验见第 1、2 篇本篇只讲「运行」这一段。一、运行环境全景1.1 工具链三件套hdc / ohpm / hvigor鸿蒙侧运行 Flutter 项目依赖三组工具来源不同、职责不同工具来源职责hdcOpenHarmony SDK toolchains 目录设备连接安装 HAP、执行 shell 命令、拉取文件鸿蒙版 adbohpm/node/hvigorDevEco Studio 内置Contents/tools鸿蒙工程的包管理与构建hvigor 驱动 HAP 产出DevEco Studio 本体独立安装SDK 托管Contents/sdk JBRContents/jbr内置 JDK本机实测的环境变量配置macOS路径按自己安装位置改# hdc鸿蒙设备连接工具随 OpenHarmony SDK 提供H/Users/zacksleo/Library/OpenHarmony/Sdk/26.0.0/toolchains/hdc# DevEco Studio 内置工具链ohpm / node / hvigorDE/Applications/DevEco-Studio.app/Contents/toolsexportPATH$H:$DE/ohpm/bin:$DE/node/bin:$DE/hvigor/bin:$PATHexportDEVECO_SDK_HOME/Applications/DevEco-Studio.app/Contents/sdkexportJAVA_HOME/Applications/DevEco-Studio.app/Contents/jbr/Contents/Home三个环境变量里最容易漏的是DEVECO_SDK_HOME——hvigor 构建 HAP 时按它找 SDK不配就报 SDK 找不到。JAVA_HOME指向 DevEco 内置的 JBR 而不是系统 JDK可以省一次 JDK 版本适配。1.2 模拟器127.0.0.1:5555鸿蒙模拟器启动后通过127.0.0.1:5555暴露 adb/hdc 端口。这个地址会出现在两处fvm flutter devices里它作为一台设备列出fvm flutter run -d 127.0.0.1:5555作为目标设备参数。模拟器环境的两个特征要提前知道4.1 节展开它是 API 26 环境、不支持部分原生特性如 HDS 光影模拟器通过 ≠ 真机通过。模拟器的获取与启动走 DevEco Studio 自带的 Emulator与真机不同不需要任何证书/账号材料API 版本在创建模拟器时选择。本机记录的组合是API 26 oh-3.47.8-release——截图归档时把这两个值一起写进文件名4.4 节否则证据无法复现。1.3 真机连接真机走 USB 连接hdc识别后同样会出现在fvm flutter devices的设备列表里设备号与模拟器不同。真机验收的三个注意首次连接要在设备上确认调试授权真机装 HAP 需要匹配的签名 profile占位签名一般只够模拟器见第三章真机才是基线——模拟器的 1703/20 与真机的 1723/1723 差距就是「模拟器数字不能当基线」的最好注脚完整口径见生产侧第 10 篇 §3.4–3.5。1.4 环境就绪自检30 秒三层检查开跑之前花 30 秒把环境三层自检一遍后面所有异常都能先排除「环境问题」这个最大嫌疑人# ① 工具链层三件套都在 PATH 里whichhdcwhichohpmwhichhvigor# ② SDK 层flutter 工具链是否报告 ohos 侧就绪fvm flutter doctor-v# ③ 设备层目标设备能否被列出fvm flutter devices三层各自的快速判读① 有command not found→ 1.1 节的 PATH 没配进当前 shell~/.zshrc写了没source是最常见原因② doctor 里 ohos 工具链项缺失/红色 →DEVECO_SDK_HOME或JAVA_HOME没生效echo $DEVECO_SDK_HOME确认一下③ 模拟器没出现 → 模拟器没启动或端口不是 5555真机没出现 → USB 未授权或hdc没识别。二、在模拟器上跑起来四步链路2.1 构建 HAP在项目根目录执行fvm flutter build hap产物落在ohos/entry/build/default/outputs/default/下文件名取决于签名配置签名配置产物可安装性未配置签名entry-default-unsigned.hap模拟器可装真机不行配置了占位/正式签名default-signed.hap模拟器可装真机需匹配 profile这个「文件名随签名变」的行为是 flutter_tools 的 ohos 构建逻辑决定的排查构建问题直接读源码3.2 节给命令。2.2 安装 HAP 到模拟器不走flutter run手动装 HAP 验证构建产物-r 覆盖安装$Hinstall-r项目/ohos/entry/build/default/outputs/default/entry-default-unsigned.hap手动安装的价值当flutter run链路报出难懂的复合错误时把「构建」和「安装/启动」拆开能立刻定位问题在哪一半。2.3 一步到位flutter run确认设备在线后直接跑fvm flutter run-d127.0.0.1:5555--debug这条命令串起「构建 → 安装 → 启动 → 日志」全链路是日常开发的主路径。ohos 工具链的验收标准之一就是热重载可用对应第 1 篇 1.4 节 L4 层的判据r热重载、R热重启都应正常响应返回键与页面生命周期也应在这一档验证。2.4 截图取证snapshot_display 三行命令「跑起来了」不能只凭肉眼要留下可复核的证据。模拟器/真机截图走hdc两步先截到设备再拉到本地# 截图保存到设备hdc shellsnapshot_display -f /data/local/tmp/shot.jpeg# 拉取到本地hdcfilerecv /data/local/tmp/shot.jpeg ./screenshot.jpeg下面是 harmony_ui「展示类」组件页跑在鸿蒙模拟器上的注解截图2026-10-13模拟器 API 26 oh-3.47.8-release上图右侧标注了这张截图能证明的四个事实正好对应第 1 篇七层工作里的几层验收同一份 Dart 代码零改动跑在鸿蒙上框架层/引擎层三层复用文字、图标、字阶全部正常字体端口 默认字体族在位——第 10 篇要专门讲的「字体静默故障」在这张图里是反例证据鸿蒙长栏来自组件库、不来自系统控件嵌入层重写 组件层自绘列表滚动流畅、无花屏渲染后端 Impeller Vulkan 交换链正常。另一张是 ohos_icons 图标库 gallery 页的真实运行截图534 个图标、分类筛选、搜索框DEBUG 构建图标库页面是「字体/图标端口是否活着」最直接的试纸——534 个图标全量渲染任何一个缺字都会一眼可见。这类 gallery 页建议每个项目都留一个当验收页。2.5 热重载与热重启四项动作验证ohos 工具链 L4 层的验收标准是「热重载可用返回键与生命周期正确」。落到操作上是四项动作r热重载改一处文字/样式后按r画面秒级更新且状态不丢表单输入、滚动位置保留——画面无反应时先fvm flutter --version确认工具链版本对R热重启应用从main()重启状态全部重置、首帧重建——黑屏时间明显变长要记下来可能是首帧路径的回归信号返回键每个可 push 的页面按返回键应 pop 当前页而不是直接退出应用生命周期按 Home 键退后台再回前台画面应正常重建不丢失。换新设备或新 SDK 版本时四项都要重新过一遍只测了r就说「热重载正常」是消费侧最常见的验收缩水。2.6 首屏异常速查首屏出问题时的三步快查先排除链路问题再怀疑代码黑屏先确认装的是可安装 HAP3.2 节shouldCodesign逻辑再fvm flutter devices确认设备没掉线有画面但无文字/图标这是字体端口信号——消费侧口径是「记录 升级/换版本试」根因诊断见第 10 篇能跑但交互错乱返回键/手势先fvm flutter --version确认 SDK 与.fvmrc绑定的是同一版本再排查组件层。三、签名没有真机证书时怎么出包3.1 占位签名配置正式签名需要申请华为开发者证书与 profile。开发/模拟器阶段没有这些材料时在ohos/build-profile.json5的signingConfigs里放一套占位材料即可出可安装的 HAP{ name: default, type: OpenHarmony, material: { storeFile: ./signingConfigs/dummy.p12, storePassword: dummy, keyAlias: dummy, keyPassword: dummy, signAlg: SHA256withECDSA, profile: ./signingConfigs/dummy.p7b, certpath: ./signingConfigs/dummy.cer } }两个硬性要求type和material字段缺一不可——ohos 工具链按这个结构查找签名材料缺字段时构建报错或找不到signed.hap占位材料dummy.p12/p7b/cer只对模拟器有效真机安装会因 profile 不匹配被拒。3.2 shouldCodesign读源码比猜报错快配了占位签名后产物文件名从entry-default-unsigned.hap变成default-signed.hap。这不是玄学是 flutter_tools 的 ohos 构建逻辑在判断shouldCodesign没有签名配置时工具链期待的是default-signed.hap不存在的路径安装环节就会扑空配了占位签名后产物路径才是可安装的 HAP。遇到「构建成功但装不上」「产物文件名对不上」这类问题时直接读 flutter_tools 源码比对着报错猜快得多路径以你本机 SDK 版本为准rg-nsigned.hap|unsigned.hap|shouldCodesign|signingConfig\~/fvm/versions/ohos/oh-3.47.8-release/packages/flutter_tools/lib/src/ohos/经验ohos 分叉的 flutter_tools 有独立的lib/src/ohos/目录13 个源文件第 1 篇 L6 层所有「构建/安装/设备」行为的最终答案都在这个目录里rg是首选武器。四、UI 验证手段与模拟器边界4.1 模拟器不支持的特性模拟器是验收的下限不是上限。本机实测确认的边界模拟器不支持原生 HDS 光影等特性——涉及光影效果的组件在模拟器上看到的不是最终形态需要自绘等效实现或上真机确认模拟器的 API 级别本机为 API 26可能与目标真机不同版本相关的行为差异不能靠模拟器排除。4.2 「按下去才显示」的效果按压阴影这类瞬态效果uitest 的合成触摸无法定格截图触摸抬起瞬间效果就消失了。处理策略优先用单元测试覆盖逻辑按压状态机、阴影参数计算视觉验证上真机用snapshot_display连拍或录屏自动化验收里把这类效果标记为「人工确认项」不纳入自动冒烟。4.3 版本验证的最终口径运行阶段的所有版本疑问回到第 2 篇的三层核验fvm flutter --version横幅 flutter.version.json元数据。运行日志里的版本号、HAP 里的 manifest、SDK 目录名三处对不上时一律以flutter.version.json为准。4.4 截图证据的归档规范截图不是「跑起来了」的自证而是可复核的证据。归档四件事命名日期_SDK版本_设备_页面.jpeg例如20261013_3.47.8-ohos-1.0.0_emulator-api26_gallery.jpeg——2.4 节注解图右下角标「模拟器 API 26 · oh-3.47.8-release · 截图 2026-10-13」就是这个口径存放项目内docs/screenshots/或专门证据目录随代码提交进仓库说明每张截图配一行「它证明了什么」2.4 节右侧标注的四个事实就是模板报障成套反馈问题时截图必须与flutter.version.json摘录成对出现对方不用追问版本就能复现。五、验收判据模拟器、真机与三档5.1 三档判据消费侧的验收分三档逐档递进生产侧的完整验证门 M0-M5 见第 5 篇 §6.4设备侧证据见第 10 篇档在哪跑能证明什么典型命令冒烟档模拟器 debug构建链路通、画面出来、热重载可用fvm flutter run -d 127.0.0.1:5555 --debug功能档真机 debug签名匹配、生命周期/返回键正确、光影等真机特性fvm flutter run -d 真机设备号交付档真机三档debug/profile/release交付形态完整AOT/优化路径无回归fvm flutter build hap --release 安装 snapshot_display5.2 模拟器的数字不是基线生产侧验证时拿到过一组对照同一套引擎单测模拟器 1703 通过 / 20 失败纯环境性无 Vulkan 设备、QoS 差异真机 1723/1723 全绿。把模拟器的数字当基线会把 20 个环境性失败误判成回归。消费侧的对应口径模拟器冒烟通过只说明「链路没断」谈「能不能交付」之前真机 debug 档至少完整走一遍。5.3 三档验收清单把 5.1 的三档拆成可打勾的清单每项都对应前文某个验证手段档清单项通过标准对应手段冒烟档flutter doctor -v无缺失项ohos 工具链项全绿1.4 节三层自检冒烟档HAP 构建 安装成功install -r返回成功2.1/2.2 节冒烟档首帧出现 热重载可用r秒级生效、状态不丢2.3/2.5 节功能档返回键 / 生命周期正确每页可 pop、回前台不丢画面2.5 节功能档文字 / 图标 / 字阶正常gallery 页全量渲染无缺字2.4 节试纸功能档滚动无花屏 / 掉帧目测 截图留证2.4 节交付档build hap --release成功AOT / 优化路径无回归5.1 节交付档真机安装 启动 截图归档profile 匹配、证据成套2.4/4.4 节六、常见问题 FAQ消费侧 CP1-CP14前两篇各自带了踩坑速查/FAQ 章节这一节把消费侧用别人发好的 SDK的全部 14 个坑汇成权威速查表按实际发生顺序编号每条「现象 → 原因 → 处理」#现象原因处理CP1curl抓 release 页面挂起release 页是 JS 渲染 SPAHTML 里没有下载链用git ls-remote --tags探测 git clone --branch下载第 2 篇 2.1 节CP2timeout命令 not foundmacOS 无 GNU coreutils 的timeoutbrew 装了才是gtimeout后台进程 sleepkill手工限时第 2 篇 2.1 节CP3旧文章/脚本里的仓库域名与实际不符仓库已统一迁移到 AtomGit仓库地址一律写https://atomgit.com/org/repo.gitCP4首次安装下载慢/卡住未切国内镜像走海外 OBS 慢速通道镜像环境变量 本地代理两条都上1.1 节同思路CP5fvm install 3.47.8-ohos-1.0.0卡住/失败没带 fork 别名fvm 去默认仓库官方 flutter/flutter找这个引用写成fvm install 别名/tag确实不适合装 fvm 时走手动 clone第 2 篇CP6首次初始化卡在Resolving dependenciesflutter_tools pubspec 有 SSH 依赖 URL本机无 SSH 凭据两处换成 HTTPS 后重跑第 2 篇 2.4 节CP7首次初始化耗时 1 分钟中断后更慢要下载定制 Dart SDK 编译 flutter toolbin/cache半成品触发重下保证网络后耐心等别 Ctrl-C第 2 篇 2.3 节CP8pub 建议Try using the Flutter SDK version: 3.47.6建议值是上游官方版本本机装不了换满足约束的 ohos 分叉版本第 1 篇第八章CP9分支名与实际版本不一致如装oh-3.44.9-dev显示3.44.9ohos-0.0.1-canary1分支 HEAD 持续合入补丁版本号随补丁递进对外写框架版本号一切以flutter --version与flutter.version.json为准CP10在~/.fvm/下找不到 fork 配置fvm 4.x 缓存目录是~/fvm/versions不是~/.fvm以fvm list首行Cache directory为准CP11队友 clone 项目后flutter命令失效.fvm/软链被提交进仓库指向你的绝对路径.fvm/加入.gitignore队友自行fvm use第 1 篇 5.3 节CP12用上游engine.version对比 ohos 引擎「对不上」ohos 定制引擎与上游版本号故意不同看engine.ohos.version不与上游对比第 1 篇 7.2 节CP13AtomGit 直连慢/卡公司网络或代理未配置设HTTP_PROXY/HTTPS_PROXY/ALL_PROXY第 2 篇 2.2 节CP14切了 SDK 仍version solving failed.fvmrc没切对或旧.dart_tool缓存残留fvm flutter --version确认后清缓存重跑第 2 篇 5.1 节6.1 四个高频坑展开CP4下载慢的标准解法是两条一起上——只切镜像解决存储类下载git 类操作还要走代理# fvm / pub换国内镜像exportFLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cnexportPUB_HOSTED_URLhttps://pub.flutter-io.cn# git 操作走本地代理按自己环境改端口exportHTTP_PROXYhttp://127.0.0.1:1087exportHTTPS_PROXYhttp://127.0.0.1:1087exportALL_PROXYsocks5://127.0.0.1:1080CP5裸 tag 名装不上的本质fvm 认 tag但它需要一个fork 别名告诉它去哪个仓库找这个引用。不带别名时用的是默认仓库https://github.com/flutter/flutter.gitohos 的 tag 当然不在那里。所以解法不是绕开 fvm而是fvm fork addfvm install 别名/tag第 1 篇 5.2 节实测 1 分 49 秒装完只有环境不适合 fvm 时才回到手动 bootstrap第 2 篇。CP8上游版本号误导的判别口诀pub 报错里出现Try using the Flutter SDK version: X.Y.Z且 X.Y.Z不带-ohos后缀就是上游版本——照着装必失败正确动作是查分叉 tag 线里功能对应的版本。CP9分支名 ≠ 版本号的对外口径对外声明版本时写框架版本号如3.47.8-ohos-1.0.0或3.44.9ohos-0.0.1-canary1不写分支名分支名只是「安装时的把手」。生产侧fork 维护者的 P1-P29 踩坑体系与消费侧 CP 系列完全无重叠——那是「自己编引擎/发 SDK」时的坑完整明细分散在 07、08、10 三篇索引表见第 5 篇。6.2 版本与依赖快问快答现在应该装哪个 Flutter OH 版本当前发布线是3.47.8-ohos-1.0.0旧项目对照可选 3.44.9 线。装完用fvm flutter --version核对实际版本。DevEco Studio 与 API 版本DevEco Studio26.0.0 ReleaseOpenHarmony SDK/API26DEVECO_SDK_HOME指向.../Contents/sdk。本篇需要 pubspec / git 依赖吗不需要。本篇只涉及 Flutter OH SDK 的运行链路harmony_ui等组件库的引入方式见对应组件文章。6.3 坑索引每个坑在哪篇展开坑首现篇目详细展开位置CP1 release 页 SPA02第 2 篇 2.1 节CP2 macOS 无 timeout02第 2 篇 2.1 节CP3 仓库地址统一 AtomGit01第 1 篇 2.2 节CP4 下载慢/卡01本篇 6.1 节标准解法CP5 裸 tag 名装不上01第 1 篇 5.2 / 6.1 节手动兜底见第 2 篇CP6 SSH 依赖 URL02第 2 篇 2.4 节CP7 首次初始化中断02第 2 篇 2.3 节CP8 上游版本号误导01第 1 篇第八章 本篇 6.1 节口诀CP9 分支名 ≠ 版本号01第 1 篇 3.1 节 本篇 6.1 节口径CP10 fvm 缓存目录02第 2 篇 2.2 节CP11.fvm/软链入库01第 1 篇 5.3 节CP12 引擎版本对比口径01第 1 篇 7.2 节CP13 AtomGit 直连慢02第 2 篇 2.2 节CP14 切 SDK 仍解析失败02第 2 篇 5.1 节七、从零到首屏完整命令序列把第 1-3 篇的命令串成一条主线全新机器视角当前 tag 版本路线# 0. 镜像与代理6.1 节 P4 标准解法exportFLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cnexportPUB_HOSTED_URLhttps://pub.flutter-io.cn# 1. 按 tag 浅克隆当前 SDK第 2 篇路径 Bgitclone--depth1--branch3.47.8-ohos-1.0.0\https://atomgit.com/oh-flutter/flutter_flutter.git\~/fvm/versions/ohos/oh-3.47.8-release# 2. 项目内切换cd项目目录fvm use ohos/oh-3.47.8-release# 3. 三层自检第 1 篇 5.4 节fvm listfvm flutter--versioncat~/fvm/versions/ohos/oh-3.47.8-release/bin/cache/flutter.version.json# 4. 鸿蒙工具链环境本篇 1.1 节exportPATH$H:$DE/ohpm/bin:$DE/node/bin:$DE/hvigor/bin:$PATHexportDEVECO_SDK_HOME/Applications/DevEco-Studio.app/Contents/sdkexportJAVA_HOME/Applications/DevEco-Studio.app/Contents/jbr/Contents/Home# 5. 跑起来模拟器fvm flutter run-d127.0.0.1:5555--debug# 6. 截图取证本篇 2.4 节hdc shellsnapshot_display -f /data/local/tmp/shot.jpeghdcfilerecv /data/local/tmp/shot.jpeg ./screenshot.jpeg六步走完「装 SDK → 跑起来 → 留下证据」的消费侧闭环就完成了。八、系列导航本文是「鸿蒙Flutter框架 0day适配实战」系列的第 3 篇消费侧三篇到此完结。全系列 10 篇#篇目侧一句话主题01背景、分叉仓库、版本命名与 fvm fork 安装消费三层架构、三个接缝、七层工作量、fvm 直装 tag、版本墙02tag 版本的手动安装与三层核验消费浅克隆 bootstrap、首次初始化、SSH 修复、异常分诊03鸿蒙模拟器/真机跑 Flutter 消费侧踩坑集本篇消费工具链三件套、HAP 构建/安装/运行、占位签名、截图取证、CP1-CP1404flutter build hap 自动签名消费P12/CSR、AGC 证书与 Profile、纯 Dart AES-GCM、C0-C10 复用05上游同步总览、BC 全景与端到端 SOP生产批次解剖、五阶段验证门、12 项适配表、端到端 SOP 与 P1-P29 索引06Phase 12基线建立与 Framework 适配生产代理 HTTP/1.1 修障、421 文件重打、Dart SDK 源码构建07Phase 3 Engine三方重放与冲突裁决生产826 文件、15 真冲突两分法、契约对齐 16 项08引擎构建链攻防生产依赖树、工具链版本、链接与测试面 27 坑09构建发布与产物分发生产版本锁、11 个工件Dart SDK 双宿主、11 条覆盖键、换新 tag 铁律10验证与真机验收生产三档引擎、设备侧单测、字体图标静默故障配套仓库与文档oh-flutter 分叉仓库当前 tag 3.47.8-ohos-1.0.0atomgit.com/oh-flutter/flutter_flutterFlutter OH 环境搭建指导https://atomgit.com/oh-flutter/flutter_samples/blob/master/ohos/docs/03_environment/OpenHarmony-flutter%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA%E6%8C%87%E5%AF%BC.md自研组件库 harmony_ui本篇截图主角atomgit.com/oh-flutter/harmony_ui总结消费侧三篇到这里闭环第 1 篇背景 fvm 直装 tag第 2 篇手动 bootstrap 兜底 版本核验本篇把 HAP 真正跑到了模拟器/真机上——工具链三件套配好 PATHflutter build hap出包install -r或flutter run装进127.0.0.1:5555没有证书就用占位签名验收靠snapshot_display截图取证P1-P10 踩坑全收录兜底。记住两条口径模拟器通过只是链路没断真机才是基线构建行为对不上时rgflutter_tools 的lib/src/ohos/目录永远比猜报错快。下一篇第 4 篇补上消费侧最后一块flutter build hap自动签名——为 flutter_tools 增加 11 文件、79 个单测的签名模块让一条命令直接产出可装真机的签名 HAP不再手动过 DevEco Studio。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源oh-flutter 分叉仓库当前 tag 3.47.8-ohos-1.0.0atomgit.com/oh-flutter/flutter_flutterFlutter OH 环境搭建指导OpenHarmony-flutter 环境搭建指导DevEco Studio 26.0.0 Release 下载developer.huawei.comOpenHarmony 官方文档API 26atomgit.com/openharmony/docsfvm 多版本管理器github.com/leoafarias/fvmFlutter 官方架构文档docs.flutter.devpub 国内镜像pub.flutter-io.cnFlutter 国内镜像配置说明docs.flutter.cn镜像与代理开源鸿蒙跨平台社区openharmonycrossplatform.csdn.net环境与版本本文的示例与截图基于以下环境组合2026-10 实测组件版本说明上游 Flutter SDK3.47.8github.com/flutter/flutterFlutter SDKOH 适配版3.47.8-ohos-1.0.0oh-flutter/flutter_flutteroh-3.47-dev分支DevEco Studio26.0.0 Release提供 hvigor / ohpm / hdc / JBR 等工具链OpenHarmony SDK / APIAPI 2626.0.0模拟器与 SDK 均为 API 26运行设备OpenHarmony 模拟器API 261280×2832环境搭建分叉获取、DevEco Studio 与 SDK 配置、模拟器创建请按官方指导操作OpenHarmony-flutter 环境搭建指导。 
长河君 · 2026/10/30 2:42:54 · 阅读 1.2k 鸿蒙Flutter框架 0day适配实战：03 在鸿蒙模拟器/真机上跑 Flutter：从 HAP 构建到截图验证
前言前两篇解决了「SDK 怎么装」第 1 篇用fvm fork别名直装 tag一条命令实测 1 分 49 秒端到端第 2 篇是不依赖 fvm 的手动 bootstrap 兜底路。装好 SDK 只是开始——让 HAP 构建出来、装进设备、画面真正跑起来才是消费侧的最后一关也是坑最集中的一关。本篇覆盖从环境准备到运行验证的完整链路三件套工具链hdc / ohpm / hvigor与 PATH 配置模拟器127.0.0.1:5555的 HAP 安装与flutter run直跑没有真机证书时怎么用占位签名出可安装的 HAPhdc shell snapshot_display截图取证以及模拟器的能力边界。文末附消费侧CP1-CP14 踩坑全收录前两篇散落提到的坑在这里汇总成权威速查表。全部环境数据来自本机实测macOS DevEco Studio26.0.0 Release OpenHarmony SDK/API262026-10 记录。Flutter OH 适配版当前为3.47.8-ohos-1.0.0环境搭建见 OpenHarmony-flutter 环境搭建指导。背景提示ohos Flutter 是社区分叉三层架构、三个接缝、七层适配工作见第 1 篇第一章SDK 安装与版本核验见第 1、2 篇本篇只讲「运行」这一段。一、运行环境全景1.1 工具链三件套hdc / ohpm / hvigor鸿蒙侧运行 Flutter 项目依赖三组工具来源不同、职责不同工具来源职责hdcOpenHarmony SDK toolchains 目录设备连接安装 HAP、执行 shell 命令、拉取文件鸿蒙版 adbohpm/node/hvigorDevEco Studio 内置Contents/tools鸿蒙工程的包管理与构建hvigor 驱动 HAP 产出DevEco Studio 本体独立安装SDK 托管Contents/sdk JBRContents/jbr内置 JDK本机实测的环境变量配置macOS路径按自己安装位置改# hdc鸿蒙设备连接工具随 OpenHarmony SDK 提供H/Users/zacksleo/Library/OpenHarmony/Sdk/26.0.0/toolchains/hdc# DevEco Studio 内置工具链ohpm / node / hvigorDE/Applications/DevEco-Studio.app/Contents/toolsexportPATH$H:$DE/ohpm/bin:$DE/node/bin:$DE/hvigor/bin:$PATHexportDEVECO_SDK_HOME/Applications/DevEco-Studio.app/Contents/sdkexportJAVA_HOME/Applications/DevEco-Studio.app/Contents/jbr/Contents/Home三个环境变量里最容易漏的是DEVECO_SDK_HOME——hvigor 构建 HAP 时按它找 SDK不配就报 SDK 找不到。JAVA_HOME指向 DevEco 内置的 JBR 而不是系统 JDK可以省一次 JDK 版本适配。1.2 模拟器127.0.0.1:5555鸿蒙模拟器启动后通过127.0.0.1:5555暴露 adb/hdc 端口。这个地址会出现在两处fvm flutter devices里它作为一台设备列出fvm flutter run -d 127.0.0.1:5555作为目标设备参数。模拟器环境的两个特征要提前知道4.1 节展开它是 API 26 环境、不支持部分原生特性如 HDS 光影模拟器通过 ≠ 真机通过。模拟器的获取与启动走 DevEco Studio 自带的 Emulator与真机不同不需要任何证书/账号材料API 版本在创建模拟器时选择。本机记录的组合是API 26 oh-3.47.8-release——截图归档时把这两个值一起写进文件名4.4 节否则证据无法复现。1.3 真机连接真机走 USB 连接hdc识别后同样会出现在fvm flutter devices的设备列表里设备号与模拟器不同。真机验收的三个注意首次连接要在设备上确认调试授权真机装 HAP 需要匹配的签名 profile占位签名一般只够模拟器见第三章真机才是基线——模拟器的 1703/20 与真机的 1723/1723 差距就是「模拟器数字不能当基线」的最好注脚完整口径见生产侧第 10 篇 §3.4–3.5。1.4 环境就绪自检30 秒三层检查开跑之前花 30 秒把环境三层自检一遍后面所有异常都能先排除「环境问题」这个最大嫌疑人# ① 工具链层三件套都在 PATH 里whichhdcwhichohpmwhichhvigor# ② SDK 层flutter 工具链是否报告 ohos 侧就绪fvm flutter doctor-v# ③ 设备层目标设备能否被列出fvm flutter devices三层各自的快速判读① 有command not found→ 1.1 节的 PATH 没配进当前 shell~/.zshrc写了没source是最常见原因② doctor 里 ohos 工具链项缺失/红色 →DEVECO_SDK_HOME或JAVA_HOME没生效echo $DEVECO_SDK_HOME确认一下③ 模拟器没出现 → 模拟器没启动或端口不是 5555真机没出现 → USB 未授权或hdc没识别。二、在模拟器上跑起来四步链路2.1 构建 HAP在项目根目录执行fvm flutter build hap产物落在ohos/entry/build/default/outputs/default/下文件名取决于签名配置签名配置产物可安装性未配置签名entry-default-unsigned.hap模拟器可装真机不行配置了占位/正式签名default-signed.hap模拟器可装真机需匹配 profile这个「文件名随签名变」的行为是 flutter_tools 的 ohos 构建逻辑决定的排查构建问题直接读源码3.2 节给命令。2.2 安装 HAP 到模拟器不走flutter run手动装 HAP 验证构建产物-r 覆盖安装$Hinstall-r项目/ohos/entry/build/default/outputs/default/entry-default-unsigned.hap手动安装的价值当flutter run链路报出难懂的复合错误时把「构建」和「安装/启动」拆开能立刻定位问题在哪一半。2.3 一步到位flutter run确认设备在线后直接跑fvm flutter run-d127.0.0.1:5555--debug这条命令串起「构建 → 安装 → 启动 → 日志」全链路是日常开发的主路径。ohos 工具链的验收标准之一就是热重载可用对应第 1 篇 1.4 节 L4 层的判据r热重载、R热重启都应正常响应返回键与页面生命周期也应在这一档验证。2.4 截图取证snapshot_display 三行命令「跑起来了」不能只凭肉眼要留下可复核的证据。模拟器/真机截图走hdc两步先截到设备再拉到本地# 截图保存到设备hdc shellsnapshot_display -f /data/local/tmp/shot.jpeg# 拉取到本地hdcfilerecv /data/local/tmp/shot.jpeg ./screenshot.jpeg下面是 harmony_ui「展示类」组件页跑在鸿蒙模拟器上的注解截图2026-10-13模拟器 API 26 oh-3.47.8-release上图右侧标注了这张截图能证明的四个事实正好对应第 1 篇七层工作里的几层验收同一份 Dart 代码零改动跑在鸿蒙上框架层/引擎层三层复用文字、图标、字阶全部正常字体端口 默认字体族在位——第 10 篇要专门讲的「字体静默故障」在这张图里是反例证据鸿蒙长栏来自组件库、不来自系统控件嵌入层重写 组件层自绘列表滚动流畅、无花屏渲染后端 Impeller Vulkan 交换链正常。另一张是 ohos_icons 图标库 gallery 页的真实运行截图534 个图标、分类筛选、搜索框DEBUG 构建图标库页面是「字体/图标端口是否活着」最直接的试纸——534 个图标全量渲染任何一个缺字都会一眼可见。这类 gallery 页建议每个项目都留一个当验收页。2.5 热重载与热重启四项动作验证ohos 工具链 L4 层的验收标准是「热重载可用返回键与生命周期正确」。落到操作上是四项动作r热重载改一处文字/样式后按r画面秒级更新且状态不丢表单输入、滚动位置保留——画面无反应时先fvm flutter --version确认工具链版本对R热重启应用从main()重启状态全部重置、首帧重建——黑屏时间明显变长要记下来可能是首帧路径的回归信号返回键每个可 push 的页面按返回键应 pop 当前页而不是直接退出应用生命周期按 Home 键退后台再回前台画面应正常重建不丢失。换新设备或新 SDK 版本时四项都要重新过一遍只测了r就说「热重载正常」是消费侧最常见的验收缩水。2.6 首屏异常速查首屏出问题时的三步快查先排除链路问题再怀疑代码黑屏先确认装的是可安装 HAP3.2 节shouldCodesign逻辑再fvm flutter devices确认设备没掉线有画面但无文字/图标这是字体端口信号——消费侧口径是「记录 升级/换版本试」根因诊断见第 10 篇能跑但交互错乱返回键/手势先fvm flutter --version确认 SDK 与.fvmrc绑定的是同一版本再排查组件层。三、签名没有真机证书时怎么出包3.1 占位签名配置正式签名需要申请华为开发者证书与 profile。开发/模拟器阶段没有这些材料时在ohos/build-profile.json5的signingConfigs里放一套占位材料即可出可安装的 HAP{ name: default, type: OpenHarmony, material: { storeFile: ./signingConfigs/dummy.p12, storePassword: dummy, keyAlias: dummy, keyPassword: dummy, signAlg: SHA256withECDSA, profile: ./signingConfigs/dummy.p7b, certpath: ./signingConfigs/dummy.cer } }两个硬性要求type和material字段缺一不可——ohos 工具链按这个结构查找签名材料缺字段时构建报错或找不到signed.hap占位材料dummy.p12/p7b/cer只对模拟器有效真机安装会因 profile 不匹配被拒。3.2 shouldCodesign读源码比猜报错快配了占位签名后产物文件名从entry-default-unsigned.hap变成default-signed.hap。这不是玄学是 flutter_tools 的 ohos 构建逻辑在判断shouldCodesign没有签名配置时工具链期待的是default-signed.hap不存在的路径安装环节就会扑空配了占位签名后产物路径才是可安装的 HAP。遇到「构建成功但装不上」「产物文件名对不上」这类问题时直接读 flutter_tools 源码比对着报错猜快得多路径以你本机 SDK 版本为准rg-nsigned.hap|unsigned.hap|shouldCodesign|signingConfig\~/fvm/versions/ohos/oh-3.47.8-release/packages/flutter_tools/lib/src/ohos/经验ohos 分叉的 flutter_tools 有独立的lib/src/ohos/目录13 个源文件第 1 篇 L6 层所有「构建/安装/设备」行为的最终答案都在这个目录里rg是首选武器。四、UI 验证手段与模拟器边界4.1 模拟器不支持的特性模拟器是验收的下限不是上限。本机实测确认的边界模拟器不支持原生 HDS 光影等特性——涉及光影效果的组件在模拟器上看到的不是最终形态需要自绘等效实现或上真机确认模拟器的 API 级别本机为 API 26可能与目标真机不同版本相关的行为差异不能靠模拟器排除。4.2 「按下去才显示」的效果按压阴影这类瞬态效果uitest 的合成触摸无法定格截图触摸抬起瞬间效果就消失了。处理策略优先用单元测试覆盖逻辑按压状态机、阴影参数计算视觉验证上真机用snapshot_display连拍或录屏自动化验收里把这类效果标记为「人工确认项」不纳入自动冒烟。4.3 版本验证的最终口径运行阶段的所有版本疑问回到第 2 篇的三层核验fvm flutter --version横幅 flutter.version.json元数据。运行日志里的版本号、HAP 里的 manifest、SDK 目录名三处对不上时一律以flutter.version.json为准。4.4 截图证据的归档规范截图不是「跑起来了」的自证而是可复核的证据。归档四件事命名日期_SDK版本_设备_页面.jpeg例如20261013_3.47.8-ohos-1.0.0_emulator-api26_gallery.jpeg——2.4 节注解图右下角标「模拟器 API 26 · oh-3.47.8-release · 截图 2026-10-13」就是这个口径存放项目内docs/screenshots/或专门证据目录随代码提交进仓库说明每张截图配一行「它证明了什么」2.4 节右侧标注的四个事实就是模板报障成套反馈问题时截图必须与flutter.version.json摘录成对出现对方不用追问版本就能复现。五、验收判据模拟器、真机与三档5.1 三档判据消费侧的验收分三档逐档递进生产侧的完整验证门 M0-M5 见第 5 篇 §6.4设备侧证据见第 10 篇档在哪跑能证明什么典型命令冒烟档模拟器 debug构建链路通、画面出来、热重载可用fvm flutter run -d 127.0.0.1:5555 --debug功能档真机 debug签名匹配、生命周期/返回键正确、光影等真机特性fvm flutter run -d 真机设备号交付档真机三档debug/profile/release交付形态完整AOT/优化路径无回归fvm flutter build hap --release 安装 snapshot_display5.2 模拟器的数字不是基线生产侧验证时拿到过一组对照同一套引擎单测模拟器 1703 通过 / 20 失败纯环境性无 Vulkan 设备、QoS 差异真机 1723/1723 全绿。把模拟器的数字当基线会把 20 个环境性失败误判成回归。消费侧的对应口径模拟器冒烟通过只说明「链路没断」谈「能不能交付」之前真机 debug 档至少完整走一遍。5.3 三档验收清单把 5.1 的三档拆成可打勾的清单每项都对应前文某个验证手段档清单项通过标准对应手段冒烟档flutter doctor -v无缺失项ohos 工具链项全绿1.4 节三层自检冒烟档HAP 构建 安装成功install -r返回成功2.1/2.2 节冒烟档首帧出现 热重载可用r秒级生效、状态不丢2.3/2.5 节功能档返回键 / 生命周期正确每页可 pop、回前台不丢画面2.5 节功能档文字 / 图标 / 字阶正常gallery 页全量渲染无缺字2.4 节试纸功能档滚动无花屏 / 掉帧目测 截图留证2.4 节交付档build hap --release成功AOT / 优化路径无回归5.1 节交付档真机安装 启动 截图归档profile 匹配、证据成套2.4/4.4 节六、常见问题 FAQ消费侧 CP1-CP14前两篇各自带了踩坑速查/FAQ 章节这一节把消费侧用别人发好的 SDK的全部 14 个坑汇成权威速查表按实际发生顺序编号每条「现象 → 原因 → 处理」#现象原因处理CP1curl抓 release 页面挂起release 页是 JS 渲染 SPAHTML 里没有下载链用git ls-remote --tags探测 git clone --branch下载第 2 篇 2.1 节CP2timeout命令 not foundmacOS 无 GNU coreutils 的timeoutbrew 装了才是gtimeout后台进程 sleepkill手工限时第 2 篇 2.1 节CP3旧文章/脚本里的仓库域名与实际不符仓库已统一迁移到 AtomGit仓库地址一律写https://atomgit.com/org/repo.gitCP4首次安装下载慢/卡住未切国内镜像走海外 OBS 慢速通道镜像环境变量 本地代理两条都上1.1 节同思路CP5fvm install 3.47.8-ohos-1.0.0卡住/失败没带 fork 别名fvm 去默认仓库官方 flutter/flutter找这个引用写成fvm install 别名/tag确实不适合装 fvm 时走手动 clone第 2 篇CP6首次初始化卡在Resolving dependenciesflutter_tools pubspec 有 SSH 依赖 URL本机无 SSH 凭据两处换成 HTTPS 后重跑第 2 篇 2.4 节CP7首次初始化耗时 1 分钟中断后更慢要下载定制 Dart SDK 编译 flutter toolbin/cache半成品触发重下保证网络后耐心等别 Ctrl-C第 2 篇 2.3 节CP8pub 建议Try using the Flutter SDK version: 3.47.6建议值是上游官方版本本机装不了换满足约束的 ohos 分叉版本第 1 篇第八章CP9分支名与实际版本不一致如装oh-3.44.9-dev显示3.44.9ohos-0.0.1-canary1分支 HEAD 持续合入补丁版本号随补丁递进对外写框架版本号一切以flutter --version与flutter.version.json为准CP10在~/.fvm/下找不到 fork 配置fvm 4.x 缓存目录是~/fvm/versions不是~/.fvm以fvm list首行Cache directory为准CP11队友 clone 项目后flutter命令失效.fvm/软链被提交进仓库指向你的绝对路径.fvm/加入.gitignore队友自行fvm use第 1 篇 5.3 节CP12用上游engine.version对比 ohos 引擎「对不上」ohos 定制引擎与上游版本号故意不同看engine.ohos.version不与上游对比第 1 篇 7.2 节CP13AtomGit 直连慢/卡公司网络或代理未配置设HTTP_PROXY/HTTPS_PROXY/ALL_PROXY第 2 篇 2.2 节CP14切了 SDK 仍version solving failed.fvmrc没切对或旧.dart_tool缓存残留fvm flutter --version确认后清缓存重跑第 2 篇 5.1 节6.1 四个高频坑展开CP4下载慢的标准解法是两条一起上——只切镜像解决存储类下载git 类操作还要走代理# fvm / pub换国内镜像exportFLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cnexportPUB_HOSTED_URLhttps://pub.flutter-io.cn# git 操作走本地代理按自己环境改端口exportHTTP_PROXYhttp://127.0.0.1:1087exportHTTPS_PROXYhttp://127.0.0.1:1087exportALL_PROXYsocks5://127.0.0.1:1080CP5裸 tag 名装不上的本质fvm 认 tag但它需要一个fork 别名告诉它去哪个仓库找这个引用。不带别名时用的是默认仓库https://github.com/flutter/flutter.gitohos 的 tag 当然不在那里。所以解法不是绕开 fvm而是fvm fork addfvm install 别名/tag第 1 篇 5.2 节实测 1 分 49 秒装完只有环境不适合 fvm 时才回到手动 bootstrap第 2 篇。CP8上游版本号误导的判别口诀pub 报错里出现Try using the Flutter SDK version: X.Y.Z且 X.Y.Z不带-ohos后缀就是上游版本——照着装必失败正确动作是查分叉 tag 线里功能对应的版本。CP9分支名 ≠ 版本号的对外口径对外声明版本时写框架版本号如3.47.8-ohos-1.0.0或3.44.9ohos-0.0.1-canary1不写分支名分支名只是「安装时的把手」。生产侧fork 维护者的 P1-P29 踩坑体系与消费侧 CP 系列完全无重叠——那是「自己编引擎/发 SDK」时的坑完整明细分散在 07、08、10 三篇索引表见第 5 篇。6.2 版本与依赖快问快答现在应该装哪个 Flutter OH 版本当前发布线是3.47.8-ohos-1.0.0旧项目对照可选 3.44.9 线。装完用fvm flutter --version核对实际版本。DevEco Studio 与 API 版本DevEco Studio26.0.0 ReleaseOpenHarmony SDK/API26DEVECO_SDK_HOME指向.../Contents/sdk。本篇需要 pubspec / git 依赖吗不需要。本篇只涉及 Flutter OH SDK 的运行链路harmony_ui等组件库的引入方式见对应组件文章。6.3 坑索引每个坑在哪篇展开坑首现篇目详细展开位置CP1 release 页 SPA02第 2 篇 2.1 节CP2 macOS 无 timeout02第 2 篇 2.1 节CP3 仓库地址统一 AtomGit01第 1 篇 2.2 节CP4 下载慢/卡01本篇 6.1 节标准解法CP5 裸 tag 名装不上01第 1 篇 5.2 / 6.1 节手动兜底见第 2 篇CP6 SSH 依赖 URL02第 2 篇 2.4 节CP7 首次初始化中断02第 2 篇 2.3 节CP8 上游版本号误导01第 1 篇第八章 本篇 6.1 节口诀CP9 分支名 ≠ 版本号01第 1 篇 3.1 节 本篇 6.1 节口径CP10 fvm 缓存目录02第 2 篇 2.2 节CP11.fvm/软链入库01第 1 篇 5.3 节CP12 引擎版本对比口径01第 1 篇 7.2 节CP13 AtomGit 直连慢02第 2 篇 2.2 节CP14 切 SDK 仍解析失败02第 2 篇 5.1 节七、从零到首屏完整命令序列把第 1-3 篇的命令串成一条主线全新机器视角当前 tag 版本路线# 0. 镜像与代理6.1 节 P4 标准解法exportFLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cnexportPUB_HOSTED_URLhttps://pub.flutter-io.cn# 1. 按 tag 浅克隆当前 SDK第 2 篇路径 Bgitclone--depth1--branch3.47.8-ohos-1.0.0\https://atomgit.com/oh-flutter/flutter_flutter.git\~/fvm/versions/ohos/oh-3.47.8-release# 2. 项目内切换cd项目目录fvm use ohos/oh-3.47.8-release# 3. 三层自检第 1 篇 5.4 节fvm listfvm flutter--versioncat~/fvm/versions/ohos/oh-3.47.8-release/bin/cache/flutter.version.json# 4. 鸿蒙工具链环境本篇 1.1 节exportPATH$H:$DE/ohpm/bin:$DE/node/bin:$DE/hvigor/bin:$PATHexportDEVECO_SDK_HOME/Applications/DevEco-Studio.app/Contents/sdkexportJAVA_HOME/Applications/DevEco-Studio.app/Contents/jbr/Contents/Home# 5. 跑起来模拟器fvm flutter run-d127.0.0.1:5555--debug# 6. 截图取证本篇 2.4 节hdc shellsnapshot_display -f /data/local/tmp/shot.jpeghdcfilerecv /data/local/tmp/shot.jpeg ./screenshot.jpeg六步走完「装 SDK → 跑起来 → 留下证据」的消费侧闭环就完成了。八、系列导航本文是「鸿蒙Flutter框架 0day适配实战」系列的第 3 篇消费侧三篇到此完结。全系列 10 篇#篇目侧一句话主题01背景、分叉仓库、版本命名与 fvm fork 安装消费三层架构、三个接缝、七层工作量、fvm 直装 tag、版本墙02tag 版本的手动安装与三层核验消费浅克隆 bootstrap、首次初始化、SSH 修复、异常分诊03鸿蒙模拟器/真机跑 Flutter 消费侧踩坑集本篇消费工具链三件套、HAP 构建/安装/运行、占位签名、截图取证、CP1-CP1404flutter build hap 自动签名消费P12/CSR、AGC 证书与 Profile、纯 Dart AES-GCM、C0-C10 复用05上游同步总览、BC 全景与端到端 SOP生产批次解剖、五阶段验证门、12 项适配表、端到端 SOP 与 P1-P29 索引06Phase 12基线建立与 Framework 适配生产代理 HTTP/1.1 修障、421 文件重打、Dart SDK 源码构建07Phase 3 Engine三方重放与冲突裁决生产826 文件、15 真冲突两分法、契约对齐 16 项08引擎构建链攻防生产依赖树、工具链版本、链接与测试面 27 坑09构建发布与产物分发生产版本锁、11 个工件Dart SDK 双宿主、11 条覆盖键、换新 tag 铁律10验证与真机验收生产三档引擎、设备侧单测、字体图标静默故障配套仓库与文档oh-flutter 分叉仓库当前 tag 3.47.8-ohos-1.0.0atomgit.com/oh-flutter/flutter_flutterFlutter OH 环境搭建指导https://atomgit.com/oh-flutter/flutter_samples/blob/master/ohos/docs/03_environment/OpenHarmony-flutter%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA%E6%8C%87%E5%AF%BC.md自研组件库 harmony_ui本篇截图主角atomgit.com/oh-flutter/harmony_ui总结消费侧三篇到这里闭环第 1 篇背景 fvm 直装 tag第 2 篇手动 bootstrap 兜底 版本核验本篇把 HAP 真正跑到了模拟器/真机上——工具链三件套配好 PATHflutter build hap出包install -r或flutter run装进127.0.0.1:5555没有证书就用占位签名验收靠snapshot_display截图取证P1-P10 踩坑全收录兜底。记住两条口径模拟器通过只是链路没断真机才是基线构建行为对不上时rgflutter_tools 的lib/src/ohos/目录永远比猜报错快。下一篇第 4 篇补上消费侧最后一块flutter build hap自动签名——为 flutter_tools 增加 11 文件、79 个单测的签名模块让一条命令直接产出可装真机的签名 HAP不再手动过 DevEco Studio。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源oh-flutter 分叉仓库当前 tag 3.47.8-ohos-1.0.0atomgit.com/oh-flutter/flutter_flutterFlutter OH 环境搭建指导OpenHarmony-flutter 环境搭建指导DevEco Studio 26.0.0 Release 下载developer.huawei.comOpenHarmony 官方文档API 26atomgit.com/openharmony/docsfvm 多版本管理器github.com/leoafarias/fvmFlutter 官方架构文档docs.flutter.devpub 国内镜像pub.flutter-io.cnFlutter 国内镜像配置说明docs.flutter.cn镜像与代理开源鸿蒙跨平台社区openharmonycrossplatform.csdn.net环境与版本本文的示例与截图基于以下环境组合2026-10 实测组件版本说明上游 Flutter SDK3.47.8github.com/flutter/flutterFlutter SDKOH 适配版3.47.8-ohos-1.0.0oh-flutter/flutter_flutteroh-3.47-dev分支DevEco Studio26.0.0 Release提供 hvigor / ohpm / hdc / JBR 等工具链OpenHarmony SDK / APIAPI 2626.0.0模拟器与 SDK 均为 API 26运行设备OpenHarmony 模拟器API 261280×2832环境搭建分叉获取、DevEco Studio 与 SDK 配置、模拟器创建请按官方指导操作OpenHarmony-flutter 环境搭建指导。