Flutter固件更新插件flutter_ota的使用

flutter_ota 是一个用于通过Flutter应用程序对ESP32设备进行无线（Over-The-Air, OTA）更新的插件。它简化了BLE通信和OTA更新过程，提供了用户友好的体验。

功能特性

• 支持从二进制文件或URL进行固件更新。
• 实现了一个进度流来跟踪更新进度。
• 兼容不同的固件类型。
• 使用Bluetooth Low Energy (BLE)与ESP32设备通信。

安装步骤

1. 在你的pubspec.yaml文件中添加以下依赖：

   dependencies:
     flutter_ota: ^1.0.0
   

2. 运行以下命令安装包：

   pub get
   

使用方法

1. 导入必要的库

import 'package:flutter_ota/flutter_ota.dart';
import 'package:flutter_blue_plus/flutter_blue_plus.dart';

2. 连接到ESP32设备

使用flutter_blue_plus包连接到ESP32设备。

3. 创建Esp32OtaPackage实例

提供必要的特征值（characteristics）：

// 替换为你的ESP32 BLE服务和特征的实际UUIDs
BluetoothService service = ...;
BluetoothCharacteristic dataCharacteristic = ...;
BluetoothCharacteristic notifyCharacteristic = ...;

Esp32OtaPackage otaPackage = Esp32OtaPackage(notifyCharacteristic, dataCharacteristic);

4. 选择固件更新类型和固件类型

根据需要设置updateType和firmwareType。

5. 如果firmwareType设为1，则提供二进制固件文件路径；如果设为3，则提供固件下载URL。

6. 调用updateFirmware方法

await otaPackage.updateFirmware(
  device,
  updateType,
  firmwareType,
  service,
  dataCharacteristic,
  notifyCharacteristic,
  binFilePath: binFilePath,
  url: url,
);

7. 监听percentageStream以追踪更新进度

StreamSubscription subscription = otaPackage.percentageStream.listen((progress) {
  print('OTA update progress: $progress%');
});

// 更新UI...

await subscription.cancel();

8. 检查firmwareUpdate属性确定更新是否成功

if (otaPackage.firmwareUpdate) {
  print('OTA update successful');
} else {
  print('OTA update failed');
}

示例代码

下面是一个完整的示例，展示了如何使用flutter_ota包启动OTA更新：

import 'dart:io';
import 'package:flutter/material.dart';
import 'package:flutter_blue_plus/flutter_blue_plus.dart';
import 'package:flutter_ota/flutter_ota.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: NewOTAUpdatePage(),
    );
  }
}

class NewOTAUpdatePage extends StatefulWidget {
  @override
  _NewOTAUpdatePageState createState() => _NewOTAUpdatePageState();
}

class _NewOTAUpdatePageState extends State<NewOTAUpdatePage> {
  // 假设HomePageController已经初始化并包含了gBleDevice和gBleServices
  HomePageController homePageController = HomePageController();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("OTA Update")),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          Center(
            child: FeedbackEnabledButton(
              onTap: () async {
                BluetoothDevice? device = homePageController.gBleDevice;
                List<BluetoothService> services = homePageController.gBleServices;

                if (device == null || services.isEmpty) {
                  print("设备未连接或服务不可用");
                  return;
                }

                for (var service in services) {
                  // 根据实际UUID调整
                  if (service.uuid.toString() == 'fb1e4001-54ae-4a28-9f74-dfccb248601d') {
                    var characteristics = service.characteristics;
                    BluetoothCharacteristic? notifyUuid, writeUuid;

                    for (var c in characteristics) {
                      if (c.uuid.toString() == 'fb1e4003-54ae-4a28-9f74-dfccb248601d') {
                        notifyUuid = c;
                      } else if (c.uuid.toString() == 'fb1e4002-54ae-4a28-9f74-dfccb248601d') {
                        writeUuid = c;
                      }
                    }

                    if (notifyUuid != null && writeUuid != null) {
                      Esp32OtaPackage esp32otaPackage = Esp32OtaPackage(notifyUuid, writeUuid);

                      await esp32otaPackage.updateFirmware(
                        device,
                        2, // Update Type
                        2,
                        service,
                        notifyUuid,
                        writeUuid,
                        binFilePath: "assets/helllo.ino.bin",
                      );

                      showDialog(
                        context: context,
                        builder: (_) => AlertDialog(
                          title: Text('OTA Update Progress'),
                          content: StreamBuilder<int>(
                            stream: esp32otaPackage.percentageStream,
                            builder: (_, snapshot) {
                              double progress = snapshot.data?.toDouble() ?? 0.0;
                              return LinearProgressIndicator(value: progress / 100);
                            },
                          ),
                        ),
                      );
                    }
                  }
                }
              },
            ),
          ),
        ],
      ),
    );
  }
}

// 假设的HomePageController类定义
class HomePageController {
  BluetoothDevice? gBleDevice;
  List<BluetoothService> gBleServices = [];
}

请注意，以上代码仅为演示目的，并假设了一些前置条件如设备和服务已预先获取。在实际应用中，你需要确保这些数据正确无误地被填充。