docs: update Flutter OH POC and project structure for SDK version alignment
This commit is contained in:
@@ -87,7 +87,7 @@ conti-app/
|
||||
|
||||
**OHOS SDK 边界**:OpenHarmony 的 Flutter 分支与官方 stable 不同步。Android/iOS 仍以 FVM 锁定的 Flutter 3.44.9 为基线;`harmony` 分支已用 Flutter_OH 3.41.10-ohos-1.0.0 / Dart 3.11.5 完成 HAP 编译验证。两套 SDK 不可混用,任一侧升级都必须重新验证依赖解析、生成代码和对应平台构建(见 [07-native-integration.md](./07-native-integration.md))。
|
||||
|
||||
**未来收敛条件**:当 Flutter_OH 发布并验证可用的 Flutter **3.44.x / Dart 3.12.x** 对齐版本时,可评审将 `harmony` 与 Android/iOS 收敛到同一 SDK 基线。版本号相同不是自动放行条件;必须重新完成依赖解析、Riverpod/Pigeon 生成物核验、HAP 构建及真机原生能力验证后才能切换。
|
||||
**未来收敛条件**:Flutter_OH 上游文档计划在 **2026 年 9 月**提供 Flutter **3.44.x / Dart 3.12.x** 对齐版本;发布实际 Tag/Commit 可获取后,可评审将 `harmony` 与 Android/iOS 收敛到同一 SDK 基线。计划日期或版本号相同都不是自动放行条件;必须重新完成依赖解析、Riverpod/Pigeon 生成物核验、HAP 构建及真机原生能力验证后才能切换。
|
||||
|
||||
**为什么必须用 FVM 锁**:monorepo 里各人本地 Flutter 版本不一致,会导致同一份代码有人 `flutter analyze` 过、有人不过,生成代码(`build_runner` 产物)也可能不一致——这类问题排查成本远高于装一次 FVM。CI 也用 `.fvmrc` 里的版本,保证本地和流水线一致。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user