Flutter + OpenHarmony 架构演进：从单体到模块化、微前端与动态能力的现代化应用体系

┌───────────────────────────────────────┐
│           动态能力层 (Dynamic Layer)   │ ← 按需加载，独立版本
│  ┌─────────────┐  ┌─────────────┐     │
│  │ 健康分析模块 │  │ 车机控制模块 │ ... │
│  └─────────────┘  └─────────────┘     │
├───────────────────────────────────────┤
│           核心框架层 (Core Layer)      │ ← 稳定、共享、受控
│  ┌───────────────────────────────┐    │
│  │ 路由中心 │ 状态管理 │ 安全服务 │ ... │
│  └───────────────────────────────┘    │
├───────────────────────────────────────┤
│           基础设施层 (Infra Layer)     │ ← 跨平台抽象
│  ┌─────────────┐  ┌─────────────┐     │
│  │ Flutter SDK │  │ OH 插件桥接 │ ... │
│  └─────────────┘  └─────────────┘     │
└───────────────────────────────────────┘

health-superapp/
├── apps/
│   └── main_app/               # 主壳工程（轻量）
├── packages/
│   ├── core/                   # 核心框架（路由、主题、i18n）
│   ├── features/
│   │   ├── health_monitor/     # 健康监测（独立模块）
│   │   ├── car_control/        # 车机控制（独立模块）
│   │   └── user_profile/       # 用户中心
│   └── shared/
│       ├── models/             # 共享数据模型
│       ├── utils/              # 通用工具
│       └── design_system/      # 组件库（适配多端）
├── plugins/
│   └── oh_health_sensor/       # 自研 OpenHarmony 插件
└── tools/
    └── arch_lint/              # 架构约束检查脚本

# melos.yaml
packages:
  - apps/**
  - packages/**
  - plugins/**

dependency_overrides:
  flutter: ^3.24.0
  sdk: ">=3.4.0 <4.0.0"

scripts:
  check-arch: |
    dart run tools/arch_lint/bin/check.dart \
      --forbid packages/features/*/ -> packages/features/*/

// core/lib/router/app_router.dart
import 'package:features/health_monitor/health_monitor_page.dart'
    deferred as health;

class AppRouter {
  Future<Widget> loadPage(String route) async {
    switch (route) {
      case '/health':
        await health.loadLibrary(); // 动态加载
        return health.HealthMonitorPage();
      default:
        throw Exception('Route not found');
    }
  }
}

// apps/main_app/module.json5
{
  "dynamicFeatures": [
    "health_analysis.hsp",   // 健康分析引擎
    "car_voice_control.hsp"  // 车机语音控制
  ]
}

// shared/lib/interfaces/health_service.dart
abstract class IHealthService {
  Stream<int> get heartRateStream;
  Future<void> startMonitoring();
}

// features/health_monitor/lib/health_service_impl.dart
class HealthServiceImpl implements IHealthService { ... }

// core/lib/service_locator.dart
final locator = GetIt.instance;
locator.registerLazySingleton<IHealthService>(() => HealthServiceImpl());

// 其他模块使用
final service = locator<IHealthService>();
service.startMonitoring();

// shared/design_system/lib/device_aware_widget.dart
Widget buildDeviceAware(BuildContext context, {
  Widget? phone,
  Widget? wearable,
  Widget? car,
  Widget? tv,
}) {
  final device = OhDeviceType.current;
  return switch (device) {
    OhDeviceType.phone => phone ?? const SizedBox(),
    OhDeviceType.wearable => wearable ?? const SizedBox(),
    OhDeviceType.car => car ?? const SizedBox(),
    OhDeviceType.tv => tv ?? const SizedBox(),
  };
}

// features/health_monitor/lib/monitor_presenter.dart
void startMonitoring() {
  if (OhDevice.hasSensor(SensorType.heartRate)) {
    _sensorService.start();
  }
  
  if (OhDevice.supports(DistributedCapability.taskMigration)) {
    _distributedService.enableSync();
  }
}

# 使用 melos + build_runner
melos run build --scope=health_monitor --include-dependents

# .gitlab-ci.yml
build_all_devices:
  script:
    - flutter build ohos --target-platform=ohos-arm64 --flavor phone
    - flutter build ohos --target-platform=ohos-arm64 --flavor wearable
    - flutter build ohos --target-platform=ohos-arm64 --flavor car
  parallel:
    matrix:
      - DEVICE: [phone, wearable, car]

publish_health_hsp:
  only:
    changes:
      - packages/features/health_analysis/**
  script:
    - cd packages/features/health_analysis
    - flutter build hsp --release
    - agc-cli upload-hsp health_analysis.hsp

// tools/arch_lint/bin/check.dart
void main() {
  final graph = DependencyGraph.load('pubspec.lock');
  
  // 规则1：features/ 之间不能互相依赖
  for (var module in graph.modules.where((m) => m.isFeature)) {
    assert(!module.dependencies.any((d) => d.isFeature), 
           'Feature modules must not depend on each other');
  }
  
  // 规则2：core/ 不能依赖 features/
  assert(!graph.core.dependencies.any((d) => d.isFeature),
         'Core must not depend on features');
}