flutter build hap --release` 后版本号被改回 1.0.0

flutter build hap --release 后版本号被改回 1.0.0?

欢迎大家加入开源鸿蒙跨平台开发者社区

背景

在工程里改好了鸿蒙侧应用版本(常见位置是 ohos/AppScope/app.json5 ;部分文档或工具里也会口语说成 app.json),其中的 版本名称 (对应 version 里的 name)是你期望的值。随后执行:

bash 复制代码
flutter build hap --release

出包后再打开同一份配置文件,发现版本又被写回 1.0.0 (或与 pubspec.yaml 里一致的基础版本)。

现象

  • 手动改的 版本名 / 版本号 在 Release 构建后丢失或被覆盖。
  • 反复构建时,版本似乎总跟着某处「默认来源」走,而不是保留你在 OH 工程里的手工编辑。

原因(机制说明)

当前 Flutter OpenHarmony 出包流程里,构建会用 pubspec.yaml 中的 version(以及可选的构建参数)去同步/写回鸿蒙应用配置 ,而不是以「仅存在于 app.json5 里、且未在 Dart 侧声明」的修改为准。

因此:

  • 若 pubspec.yaml 仍是默认的 version: 1.0.0+1 之类,构建后 OH 侧展示版本很容易被同步成 1.0.0。
  • 只改 app.json5、不改 pubspec.yaml 也不在命令行指定版本时,下一次 flutter build hap 仍可能按上述规则覆盖,看起来像「字段被重置」。

解决办法

1. 在 pubspec.yaml 中维护版本(推荐日常开发)

与 Android/iOS 习惯一致,在根目录 pubspec.yaml 中写:

yaml 复制代码
version: 4.0.3+10000

即 版本名+版本号 (+ 后为 versionCode 类递增数字)。再执行 flutter build hap,构建产物会与之一致,避免和手工改 OH 文件「打架」。

2. 构建命令行临时指定(适合 CI / 单次出包)

不改文件时,可在构建时显式传入:

bash 复制代码
flutter build hap --release --build-name=4.0.3 --build-number=10000
  • --build-name:对应对外展示的版本名称(如 4.0.3)。
  • --build-number:对应递增的构建号 / 数字版本(如 10000)。

流水线里建议固定用同一套规则(读环境变量或标签)传入这两个参数,避免每次本地默认值覆盖。

3. 不要依赖「只改 OH 目录、不改 Dart 工程版本」

若团队规范是「以 Flutter 工程为准」,应把 唯一真相源 放在 pubspec.yaml 或 CI 传入的 --build-name / --build-number,而不是只改 app.json5。

小结

做法 说明
改 pubspec.yaml 的 version 与 flutter build hap 默认逻辑一致,推荐
使用 --build-name / --build-number 适合脚本与发布流水线
只改 ohos/AppScope/app.json5 易被后续构建覆盖,需配合上述其一

参考命令:

bash 复制代码
flutter build hap --release --build-name=4.0.3 --build-number=10000
相关推荐
SoaringHeart1 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
恋猫de小郭14 小时前
Flutter 3.50.0 Release 的第一个崩溃,修好了,还没 hotfix
android·前端·flutter
程序员老刘1 天前
跨平台开发地图 | 2026年11月
flutter·ai编程·客户端
传奇开心果编程2 天前
【Flutter踩坑排雷】第30课:异常未捕获坑|未捕获异常直接闪退,全局兜底故障处理
android·flutter·ios·移动开发·dart·ui框架·声明式ui
恋猫de小郭2 天前
Flutter Native Interop 稳定了,Platform Channel 要退场了
android·前端·flutter
好的佩奇2 天前
Dart 之可迭代对象与生成器
android·flutter·dart
恋猫de小郭3 天前
Flutter Analyzer 系列坑推进,必看,AI 时代这玩意最吃你内存
android·前端·flutter
LinXunFeng3 天前
拿竞品 App 一扫,技术栈全暴露了
android·flutter·开源
传奇开心果编程4 天前
【Flutter踩坑排雷】第28课:平台目录缺失与修复坑|`flutter create` 的“重建”与“覆盖”边界
android·flutter·ios·移动开发·跨平台·dart·声明式ui
程序员老刘·4 天前
Flutter 3.50更新,开发者应该关注什么?
flutter·ai编程·跨平台开发