Flutter+OpenHarmony 智能家居开发：多设备验证、BUG 修复与打包发布流程

2.2 依赖确认（无需新增，仅验证）

Day13 无需新增任何外部依赖，仅需确认 Day12 集成的所有依赖正常加载。完整依赖清单如下：

dependencies:
  flutter: sdk: flutter
  dio: ^5.4.0
  json_annotation: ^4.8.1
  provider: ^6.1.1
  get_it: ^7.2.0
  logger: ^1.1.0
  device_info_plus: ^9.1.0
  flutter_windowmanager: ^0.2.0
  permission_handler: ^11.0.1
  shared_preferences: ^2.2.2
  objectbox: ^2.0.0
  objectbox_flutter_libs: ^2.0.0
  connectivity_plus: ^5.0.2
  mqtt_client: ^10.0.0
  crypto: ^3.0.3
  flutter_local_notifications: ^16.1.0
  workmanager: ^0.5.1
  timezone: ^0.9.2
  flutter_native_timezone: ^2.0.0
  flutter_svg: ^2.0.9
  pin_code_fields: ^8.0.1
  image_picker: ^1.1.0
  path_provider: ^2.1.2
  encrypt: ^5.0.3
  fl_chart: ^0.55.2
  intl: ^0.19.0
  ohos_atom_service: ^1.0.0
  url_launcher: ^6.2.5
dev_dependencies:
  flutter_test: sdk: flutter
  json_serializable: ^6.7.1
  build_runner: ^2.4.6
  flutter_lints: ^2.0.0
  objectbox_generator: ^2.0.0

验证依赖是否正常的方法：在项目根目录执行以下命令，无报错即说明依赖正常：

flutter pub get
flutter clean && flutter pub get

若出现依赖冲突，优先升级冲突依赖至兼容版本；若鸿蒙平台编译失败，升级 Flutter for OpenHarmony 插件至最新版本，同时确认鸿蒙 SDK 已更新至 API10+。

2.3 验证设备与工具准备（关键必做）

2.3.1 测试设备（三类终端，缺一不可）

1. 鸿蒙手机：屏幕尺寸 6.7 英寸，鸿蒙系统 API10+，已开启 USB 调试，已连接网络；
2. 鸿蒙平板：屏幕尺寸 11 英寸，鸿蒙系统 API10+，已开启 USB 调试，已连接网络；
3. DAYU200 开发板：已刷入鸿蒙系统（API10+），已开启 USB 调试，已连接网络，已安装基础版 APP。

2.3.2 调试与打包工具

1. Flutter DevTools：开启性能监控、内存监控、布局检查、日志查看功能；
2. 鸿蒙 IDE（DevEco Studio）：更新至最新版本，确保支持鸿蒙 API10 + 打包；
3. USB 数据线：3 条，分别连接手机、平板、开发板与电脑；
4. 日志查看工具：Flutter 日志、鸿蒙系统日志；
5. 签名工具：DevEco Studio 内置签名工具；
6. 性能测试工具：鸿蒙系统自带的性能监控工具；
7. 文档编辑工具：Markdown 编辑器。

2.4 工程结构优化（清理冗余，规范归档）

Day13 作为收尾环节，需先清理工程中的冗余代码、冗余资源，优化工程结构。

2.4.1 工程结构优化方案

lib/
├── core/ # 核心工具模块
│   ├── mqtt/
│   ├── objectbox/
│   ├── constants/
│   └── ...
├── data/ # 数据层
│   ├── models/
│   └── repositories/
├── domain/ # 业务层
│   └── providers/
├── ui/ # UI 层
│   ├── pages/
│   │   ├── main/
│   │   ├── home/
│   │   └── ...
│   └── widgets/
├── utils/ # 新增：全局通用工具类
│   ├── common_utils.dart
│   └── log_utils.dart
├── app.dart
└── main.dart

2.4.2 冗余清理操作

1. 删除测试页面：删除 TestPage、DemoPage 等测试页面；
2. 删除冗余组件：删除未使用的组件、测试组件；
3. 删除冗余资源：删除 assets 目录下未使用的图片、图标、字体文件；
4. 清理冗余代码：删除注释掉的代码、未使用的变量、未使用的方法；
5. 整合工具类：将分散在各个模块的通用工具方法整合到 utils 目录下。

2.4.3 代码注释规范

1. 类注释：每个类顶部添加注释，说明类的作用、核心功能；
2. 方法注释：每个公共方法顶部添加注释，说明方法的作用、参数含义、返回值；
3. 变量注释：关键变量添加注释，说明变量的含义、用途；
4. 复杂代码注释：对于逻辑复杂的代码块，添加行内注释；
5. BUG 修复注释：修复 BUG 后，在修改位置添加注释，说明 BUG 描述、修复时间、修复方案。

三、核心模块一：开源鸿蒙多设备运行验证

多设备运行验证是 Day13 的核心任务之一，也是 APP 落地的关键前提。本节将按「鸿蒙手机→鸿蒙平板→DAYU200 开发板」的顺序，逐一完成全场景验证。

3.1 鸿蒙手机运行验证（API10+）

鸿蒙手机是用户最常用的终端，验证重点是「功能完整性、交互流畅性、UI 适配性」。

3.1.1 验证前置操作

1. 将鸿蒙手机通过 USB 数据线连接至电脑，开启 USB 调试模式；
2. 在电脑上执行以下命令，安装 APP 至手机：

flutter run -d 设备 ID --ohos

3. 安装完成后，启动 APP，授予所有所需权限，确保 APP 正常启动，无闪退、无报错。

3.1.2 全场景验证内容与步骤

验证内容覆盖所有核心功能，按「APP 启动→用户中心→首页→设备管理→场景联动→定时任务→数据统计→原子化服务→后台运行→异常处理」的顺序逐一验证。

3.1.2.1 APP 启动验证

1. 点击手机桌面 APP 图标，启动 APP，观察启动速度（正常启动时间应≤3 秒）；
2. 验证启动过程：无白屏、无黑屏、无闪退，启动页显示正常；
3. 验证登录状态：若已登录，重启 APP 后应保留登录状态；
4. 验证启动异常：关闭网络后启动 APP，应显示网络异常提示，无闪退。

3.1.2.2 用户中心功能验证

1. 未登录状态：验证手机号登录、密码登录、注册功能、错误场景提示；
2. 已登录状态：验证头像修改、昵称修改、密码修改、退出登录、个人中心菜单跳转。

3.1.2.3 首页聚合页验证

1. 跳转至首页，验证 UI 布局：常用设备快捷入口、最近执行场景、即将触发定时任务正常显示；
2. 验证常用设备操作、最近执行场景、即将触发定时、下拉刷新、空状态。

3.1.2.4 设备管理功能验证

1. 跳转至「设备」Tab，验证设备列表、筛选、搜索；
2. 验证设备详情页：设备控制、参数调节、设备操作日志、设备异常记录、设备分享；
3. 验证批量控制、设备在线/离线状态变化。

3.1.2.5 智能场景功能验证

1. 跳转至「场景」Tab，验证场景列表、执行、开关、编辑、删除、联动、空状态。

3.1.2.6 定时任务功能验证

1. 跳转至「定时」Tab，验证定时列表、触发、开关、编辑、删除、重复、通知、后台保活、空状态。

3.1.2.7 数据统计功能验证

1. 跳转至数据统计页面，验证统计总览、设备使用统计、图表类型切换、数据缓存、空数据。

3.1.2.8 鸿蒙原子化服务验证

1. 启动鸿蒙原子化服务，验证启动速度、页面显示、设备控制、场景执行、跳转主 APP、后台运行、权限。

3.1.2.9 后台运行与通知验证

1. 将 APP 切换至后台，保持后台运行（≥12 小时）；
2. 验证后台保活、定时触发、异常通知、MQTT 通信。

3.1.2.10 异常处理验证

1. 网络异常、设备离线、数据库异常、操作异常场景下的表现。

3.2 常见问题与解决方案（实测踩坑）

在鸿蒙手机验证过程中，大概率会遇到以下问题：

问题 1：APP 启动白屏时间过长（超过 5 秒）

• 原因分析：APP 启动时初始化操作过多（如 MQTT 连接、本地数据库初始化、权限申请、数据加载），所有操作同步执行，导致启动卡顿。
• 解决方案：优化启动初始化逻辑，将初始化操作分优先级，异步执行，避免同步阻塞，同时添加启动页过渡动画。

具体代码修改（优化 app.dart 启动逻辑）：

import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
// ... 其他导入

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  bool _isInitialized = false;
  bool _isLogin = false;

  @override
  void initState() {
    super.initState();
    _initAppAsync();
  }

  Future<void> _initAppAsync() async {
    try {
      await _initBasic();
      _initCoreServices();
      _initNonCoreServices();
      setState(() {
        _isInitialized = true;
      });
    } catch (e) {
      LogUtils.e("APP 初始化失败：$e");
      setState(() {
        _isInitialized = true;
      });
    }
  }

  Future<void> _initBasic() async {
    await OhosDeviceAdapter.instance.init();
    await ObjectBoxInstance.instance.init();
    _isLogin = await UserProvider.instance.checkLoginStatus();
    LogUtils.d("基础初始化完成，登录状态：$_isLogin");
  }

  void _initCoreServices() async {
    await MqttManager.instance.init();
    await DeviceProvider.instance.init();
    await StatisticsProvider.instance.init();
    LogUtils.d("核心服务初始化完成");
  }

  void _initNonCoreServices() async {
    await Future.delayed(const Duration(seconds: 1));
    LogUtils.d("非核心服务初始化完成");
  }

  @override
  Widget build(BuildContext context) {
    if (!_isInitialized) {
      return MaterialApp(
        home: Scaffold(
          body: Center(
            child: Text("智能家居 APP 启动中..."),
          ),
        ),
      );
    }
    return MaterialApp(
      title: "Flutter+OpenHarmony 智能家居",
      theme: ThemeData(primarySwatch: Colors.blue),
      home: _isLogin ? const MainTabPage() : const LoginPage(),
      debugShowCheckedModeBanner: false,
    );
  }
}

问题 2：头像上传后，重启 APP 头像消失

• 原因分析：头像路径仅保存在内存中，未持久化到本地数据库，重启 APP 后，内存数据丢失。
• 解决方案：将头像路径保存到 ObjectBox 本地数据库（User 模型中），重启 APP 后，从数据库中读取头像路径。

具体代码修改（完善 User 模型，添加头像路径字段）：

@Entity()
class User {
  @Id(assignable: true)
  int id;
  String phone;
  String password;
  String nickname;
  String avatarPath; // 新增：头像本地存储路径
  // ... 其他字段

  User({
    this.id = 0,
    required this.phone,
    required this.password,
    this.nickname = "智能家居用户",
    this.avatarPath = "assets/images/ic_default_avatar.png",
    // ... 其他默认值
    required this.createTime,
    required this.updateTime,
  });

  void updateAvatarPath(String newAvatarPath) {
    avatarPath = newAvatarPath;
    updateTime = DateTime.now().millisecondsSinceEpoch;
  }
}

问题 3：数据统计图表加载卡顿，切换时间筛选时闪退

• 原因分析：统计数据未做缓存，每次切换筛选条件都要重新计算；图表渲染时数据量过多，未做分页加载。
• 解决方案：新增统计数据缓存机制；图表数据分页加载；优化数据计算逻辑。

具体代码修改（新增统计数据缓存工具）：

class StatisticsCacheTool {
  static StatisticsCacheTool? _instance;
  static StatisticsCacheTool get instance => _instance ??= StatisticsCacheTool._internal();
  StatisticsCacheTool._internal();

  final Map<String, dynamic> _cache = HashMap();

  void cacheStatisticsData({
    required String timeFilter,
    required String dimension,
    required dynamic data,
  }) {
    try {
      final cacheKey = "$timeFilter\_$dimension";
      _cache[cacheKey] = {
        "data": data,
        "cacheTime": DateTime.now().millisecondsSinceEpoch,
      };
    } catch (e) {
      _logger.e("统计数据缓存失败：$e");
    }
  }

  dynamic getCachedStatisticsData({
    required String timeFilter,
    required String dimension,
  }) {
    try {
      final cacheKey = "$timeFilter\_$dimension";
      if (!_cache.containsKey(cacheKey)) {
        return null;
      }
      final cacheData = _cache[cacheKey]!;
      final cacheTime = cacheData["cacheTime"];
      final currentTime = DateTime.now().millisecondsSinceEpoch;
      if (currentTime - cacheTime > StatisticsConstants.statisticsCacheTime) {
        _cache.remove(cacheKey);
        return null;
      }
      return cacheData["data"];
    } catch (e) {
      _logger.e("获取缓存统计数据失败：$e");
      return null;
    }
  }
}

具体代码修改（优化数据统计计算逻辑，添加缓存调用）：

Future<Map<String, dynamic>> getDeviceStatistics(String timeFilter) async {
  final cachedData = StatisticsCacheTool.instance.getCachedStatisticsData(
    timeFilter: timeFilter,
    dimension: "device",
  );
  if (cachedData != null) {
    return cachedData;
  }
  final operationLogs = await DeviceProvider.instance.getAllDeviceOperationLogs();
  final devices = await DeviceProvider.instance.getAllDevices();
  final statisticsData = StatisticsTool.instance.calculateDeviceStatistics(
    operationLogs: operationLogs,
    devices: devices,
    timeFilter: timeFilter,
  );
  StatisticsCacheTool.instance.cacheStatisticsData(
    timeFilter: timeFilter,
    dimension: "device",
    data: statisticsData,
  );
  return statisticsData;
}

具体代码修改（图表数据分页加载，优化渲染逻辑）：

class DeviceStatisticsChart extends StatefulWidget {
  final String timeFilter;
  final Map<String, dynamic> statisticsData;
  const DeviceStatisticsChart({
    super.key,
    required this.timeFilter,
    required this.statisticsData,
  });

  @override
  State<DeviceStatisticsChart> createState() => _DeviceStatisticsChartState();
}

class _DeviceStatisticsChartState extends State<DeviceStatisticsChart> {
  int _currentPage = 0;
  final int _pageSize = 5;
  // ... 后续逻辑
}